7.1 CLI 模式
本节目标
认识 dsh 的命令行玩法：一次运行、自定义配置、插件管理，脱离图形界面也能用。
图形界面之外，还有命令行
整本书都在讲 Web UI，但 dsh 不只有图形界面。dsh 命令本身是一个多模式启动器，除了 dsh web，还有几个有意思的模式。
四种入口模式
| 命令 | 干什么 | 适合 |
|---|---|---|
dsh web | 启动图形界面（整本书的主角） | 日常交互 |
dsh --profile headless "任务" | 跑一次任务，打印结果后退出 | 自动化、脚本、CI |
dsh --profile <名字> | 启动指定配置档案 | 自定义场景 |
dsh plugin --profile <名字> <参数> | 管理该档案的插件 | 插件安装维护 |
headless：一句话跑完一个任务
最有意思的是 headless 模式。它不需要界面，一条命令把任务干完就退出：
sh
dsh --profile headless "总结当前目录下这个项目的结构"跑完后终端里直接打印 agent 的回答，适合写进脚本、定时任务、CI 流水线。可以把它理解成 dsh 的"命令行版"。
profile：你的专属配置档案
dsh 用 profile 管理不同的运行配置。每个 profile 是一套独立的插件组合和配置：
web和headless是内置的，首次使用自动初始化- 其他 profile 通过
dsh plugin命令创建 - 每个 profile 有自己的插件、补丁和配置，互不干扰
运行 headless 需要什么
和图形界面一样需要模型密钥。headless 模式通过环境变量读取：
sh
export DEEPSEEK_API_KEY="你的密钥"
dsh --profile headless "任务"常见问题
问：图形界面和 CLI 能同时用吗？
能。它们共用同一套 dsh 安装，只是入口不同。
问：CLI 适合新手吗？
日常干活用图形界面更直观。CLI 是给自动化和进阶场景的，先知道有这些模式就行，用到再学。
小结
dsh是四模式启动器：web、headless、自定义 profile、插件管理- headless 一条命令跑完任务打印结果，适合自动化
- profile 是一套独立的配置档案，web 和 headless 是内置的
CLI 了解了，下一节把权限和沙箱的底层讲透。