用 Headless 跑一次性任务

Headless 是一次性任务入口，不是交互式聊天界面。它创建新的持久 Agent/Session，提交一个任务，等待 Agent 停稳并 flush Session，最后把一条非空 assistant 文本打印到终端。

最短命令

已安装 CLI：

dsh --profile headless "summarize this workspace"

源码方式：

pnpm run build
pnpm dsh --profile headless "summarize this workspace"

任务不能为空。多个位置参数会拼成完整任务。

输出与退出行为

• 最终 turn/end 原因为 completed：退出码 0；
• 其他结束原因：退出码 1；
• 成功运行时 stderr 为空；
• 缺失或全空白任务：用法错误。

Headless 不会挂载 Host、HTTP Server、Web Runtime 或浏览器客户端，也不会打开监听端口。但它仍有 Profile 提供的文件、Shell 与其他工具权限。

本站独立运行记录

2026-08-14，本站以 DSH 0.1.0-rc.5 对本地源码执行只读 Headless 验收。命令返回了正确的中文仓库摘要，退出码为 0，且未产生文件修改。API Key 没有打印或写入测试报告。

这是本机特定版本的验收结果，不能泛化成其他系统、网络、模型或任务必然成功。

适合与不适合

适合：一次性仓库摘要、生成报告、受控的批处理或 CI smoke。当前入口每次创建新 Session，不支持交互式追问；若需要程序控制、权限回调或多轮协议，优先看 Python SDK 或 ACP 示例。