DSH应该支持CLI

[huazhikui]

我认为DSH应该支持CLI，便于用户构建自动化流程，特别是不同harness协作。只是使用ACP还不足以满足herdr这类工具的集成使用。

[jinsiyu]

也有headless吧

[PerryLink]

DSH 其实已经有 CLI，只是"多轮续跑"确实是空缺口。master（c291e7961）现状：

已有：

• launcher：dsh --profile <name> [args...]，透传参数给 profile 应用（apps/cli/src/args.ts:144-149）；dsh web 别名（:175）；dsh plugin --profile <name> add/remove/why（:190-201）；--dump-config 系列（:148-149）。
• headless 一次性执行：dsh --profile headless "任务" —— 新会话 session-<uuid>（packages/bundle/headless/src/index.ts:186），跑完 whenIdle → 输出最终消息到 stdout → exit 0/1（:194-212）；只接受 task 位置参数（headless/src/startup.ts:31-40），无续跑参数。
• profile 表里有 acp/web/headless（packages/boot/app-boot/src/profile.ts:106-130）。

缺口（对 herdr 类编排）：headless 每次运行都是新会话、没有 resume；多轮需要走 packages/client/connection 的 RPC 或 API gateway（调用与鉴权方式我未逐一验证，未验证）。ACP 是编辑器协议，和编排器是不同层，不能替代。

所以更准确的诉求是两条：① headless 支持 --resume <sessionId>（或"继续最近会话"）；② 文档化 headless/Connection 的契约。这两个都是具体、可落地的 feature request，建议在 Ideas 或开新帖细化。

[PerryLink]

补充更正：这条我在最新 master（0d1f5000，2026-09-15）上复核后发现，headless 的续跑缺口已经被上游补上了，原作者不必再提 ①。

实现方式不是 --resume <sessionId>，而是 --session-id <id>：

• 入口：packages/bundle/headless/src/startup.ts:44 --session-id <id>（"adopt the persisted Session with this id; an unknown id is an error"）；同批还加了 --json（:43）与 stdin 任务（:45，- 读 stdin）。
• 执行：packages/bundle/headless/src/index.ts:279 agents.resume({ resumeSessionId: sessionId, agentOptions, setup })；:342 起 config.sessionId ?? \session-${randomUUID()}`——不传 --session-id` 仍是全新会话（原帖那半句依然成立）。
• 语义边界（不是无脑 adopt）：缺 sessionPersistence 时在 :256-257 fail loud，缺 sessionQuery 时在 :261-263 fail loud；:286-291 未知 id 直接报错，而不是静默开一段空历史；packages/bundle/headless/README.md:145 还拒绝 cwd 不符、子代理/fork 会话、预设不匹配，以及进程内已活着的同 id Agent。
• 相关提交：ba6a90d2f2（引入：feat(headless): add stdin task, --session-id, and --json run events）、ea84ad31b6、a5c21a69b8、755b44bbcd、b3756a89d1、0ca42f3b78、127d2c8eb5（加固）。

所以诉求应改为：② 文档化 headless / Connection 的契约（这条仍然有效）。外加可选的一条新建议：--session-id 目前只支持点名一个已知 id，没有"继续最近会话"的便捷形式（--continue / --last），对 herdr 类编排每次都得自己记住 id，这个仍然可以提。

另外：原帖引用的行号也已整体位移——packages/bundle/headless/src/index.ts:186 → :342、:194-212 → :353-380、packages/boot/app-boot/src/profile.ts:106-130 → :140-151；apps/cli/src/args.ts 的行号（:144-149、:175、:190-201）未变。

[PerryLink]

补充更正（对照 dsh-v0.1.6-alpha.2 / ddefc45fb）：上一条里关于 apps/cli/src/args.ts 行号的判断已经过期。该文件的 dsh <name> 简写（1d6534a810 + 7d4188b450，2026-09-15 08:49Z，早于那条评论约 7 小时）整体位移了行号，而且 dsh web 这个专用子命令已被通用简写取代（帮助文案里仍保留 dsh web 字样）：

• 启动器透传参数与 --profile / --from-default-profile / --patch：args.ts:144-149 → :152-157
• --dump-config / --dump-default-config：:148-149 → :156-157
• dsh web 别名：:175 → 已改为通用简写 :186-188（program.parse 之前把首个位置参数展开为 --profile <name>），dsh web 现在只出现在帮助文案 :82
• dsh plugin：:190-201 → :171-183

其余部分（headless 的 --session-id / --json / stdin、agents.resume、README 的 adopt 边界、profile.ts 的表）在 HEAD 上仍然成立。只补一处精度：packages/boot/app-boot/src/profile.ts 的模板表现在是 :134-151（acp 在 :136-138），此前写的 :140-151 起点偏高。