dsh-cmd-starter
面向 DeepSeek Harness 无头模式（dsh 0.2.x）的 Claude-Code 风格 CLI 调度工具包：在官方 --json 运行流之上提供 --append-prompt、--resume、--continue、--name 以及按运行设置模型覆盖。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:PandaColour/dsh-cmd-starter#37dd414d3d6315fdc0dc3db9d754f551dbe91173Cmd Starter 以 dsh-cmd-starter 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Claude-Code 风格的 DeepSeek Harness 无头调度 bundle（dsh 0.2.x）。它在官方 @deepseek-ai/dsh-headless profile 之上，把一次性任务入口升级成可脚本化的 CLI：
--append-prompt <text>：本次运行临时追加系统提示词（可重复；不落盘、不进会话历史）--resume <session-id|name>：恢复已有会话（支持 id 或 --name 别名）-c, --continue：续最近的会话--name <name>：给会话起持久化别名，之后 --resume <name> 恢复--json：stdout 输出官方同款 NDJSON 运行事件流（session / status / text / thinking / tool_call / tool_result / final）--provider / --model / --max-tokens / --effort：覆盖本次运行的模型参数这个插件是为了支持 panda-pipline 而开发的。panda-pipline 是一个用 Python 直接驱动 Claude / Codex / Cursor 这类编码 agent，把它们编排成流水线干活的框架。
dsh-cmd-starter 的角色，是让 DeepSeek Harness 也能被同一套 Python 流水线驱动——通过补齐 Claude-Code 风格的 --resume / --continue / --name / --append-prompt 调度参数，使 dsh 在 Python 眼里和 claude / codex / cursor 一样，是一个「可以用 subprocess.Popen 启动、带结构化输出、能按会话恢复」的可编排单元。
官方 headless 现在已内置 --session-id（按 id 精确恢复）和 --json（NDJSON 运行事件流）。本插件替换官方的 headless-startup / headless-runner 两行（headless 只能有一个参数解析器），因此：
| 能力 | 归属 |
|---|---|
任务参数、--json（事件流语义） | 保留，与官方一致 |
--session-id | 不再提供，用 --resume <id> 替代（额外支持别名） |
stdin 任务（-） | 不再提供，任务走命令行参数 |
--output-format json（0.1.x 的单行对象） | 已移除，改用 --json 事件流 |
--append-prompt / -c / --name / --resume / 模型覆盖 | 插件新增，官方没有 |
要求：Node ^22.19 || >=24，dsh 0.2.1-rc.2（插件 peerDependencies 已对齐；版本不匹配会被运行时跳过）。
dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter
首次
add若因 pnpm 的allowBuilds拦截，按提示在~/.dsh/profiles/headless/pnpm-workspace.yaml里补allowBuilds键后重跑。
# 一次性任务（等价官方 headless）
dsh --profile headless "run the tests"
# 本次运行临时加一条系统提示词（可多次 --append-prompt）
dsh --profile headless --append-prompt "be terse" "explain this code"
# 输出官方同款 NDJSON 运行事件流（首行 session 事件带 sessionId）
dsh --profile headless --json "run the tests"
# => {"type":"session","sessionId":"session-xxx","cwd":"..."}
# => {"type":"status","phase":"turn_start","turn":1}
# => {"type":"text","text":"..."}
# => {"type":"final","text":"..."}
# 恢复会话 / 续最近会话
dsh --profile headless --resume session-xxx "continue"
dsh --profile headless -c "continue"
# 命名会话，之后按名字恢复
dsh --profile headless --name review "review this PR"
dsh --profile headless --resume review "continue the review"
# 覆盖模型参数
dsh --profile headless --provider deepseek-official --model deepseek-v4-flash --max-tokens 8192 "task"
| Claude CLI | dsh-cmd-starter |
|---|---|
claude -p "prompt" | dsh --profile headless "prompt" |
claude -r <name> | dsh --profile headless --resume <session-id-or-name> |
claude -c | dsh --profile headless -c "..." |
claude -n, --name <name> | dsh --profile headless --name <name> "..." |
claude --append-system-prompt <t> | dsh --profile headless --append-prompt <t> |
claude --output-format json | dsh --profile headless --json（事件流，非单对象） |
claude --model <m> | dsh --profile headless --provider <p> --model <m> |
--append-prompt 是临时的：通过 agent 作用域的 systemPrompt.section() 注入，进程退出即消失，绝不写入 session 日志。连续两次运行互不残留；只有 --resume/-c 才会延续对话历史。--name 的别名是持久的：存在 $DSH_HOME/cmd-starter/aliases.json（原子写），跨进程有效。--resume <value> 先查别名表，命中就映射到 session id，未命中就把 <value> 当 session id。别名只指向 session，不进入会话历史。--json 的字段：与官方 @deepseek-ai/dsh-headless --json 一致——首行是 session（含 sessionId、cwd），随后是 status（turn/step 边界与 usage）、text / thinking / tool_call / tool_result，最后是 final（与默认模式打印的正文完全一致）。每条记录都是提交点（只见已落盘的 assistant 消息），单事件有 8KB 字符串 / 32KB 行上限，final 不受限。--json 模式下不再往 stderr 打 reasoning 流。见 examples/schedule.py（用 --json 事件流取 sessionId 和最终正文）。
谢谢支持 联系方式: panda.colour@qq.com