PandaColour/dsh-cmd-starter
30最近提交 2026年8月14日
dsh-cmd-starter DSH 插件
dsh-cmd-starter 是 DSH 插件，在官方 headless profile 基础上增加了可脚本化的 CLI 命令。它添加了 --resume、--continue、--name、--append-prompt 和 --output-format json 等标志，使 DeepSeek Harness 能像 Claude CLI 一样通过子进程控制。专为支持 Python 驱动的 agent 流水线（如 panda-pipline）而设计。
如何安装 dsh-cmd-starter DSH 插件
dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter复制不会执行命令。安装 dsh-cmd-starter DSH 插件前请核对仓库和版本。
dsh-cmd-starter DSH 插件数据来源
dsh-cmd-starter DSH 插件快照日期：2026年8月16日
discovered
dsh-cmd-starter DSH 插件能做什么
- 通过 --resume 按 ID 或名称别名恢复会话
- 通过 -c/--continue 继续最近一次会话
- 通过 --name 持久化会话别名，跨进程有效
- 输出单行 JSON，包含 sessionId、finalResponse 和 finishReason
- 每次运行可覆盖模型参数（--provider、--model、--max-tokens、--effort）
- 临时追加系统提示词（--append-prompt），不持久化
dsh-cmd-starter DSH 插件适合哪些场景
- 在 Python 中通过 subprocess.Popen 脚本化 DSH，获取结构化 JSON 输出
- 将 DeepSeek Harness 集成到 CI/CD 流水线或自动化工作流中
- 跨多个终端会话恢复长时间运行的对话
- 为会话命名，便于在复杂多任务编排中快速回忆
- 无需修改配置文件即可进行不同模型配置的 A/B 测试
dsh-cmd-starter DSH 插件适合谁
- 希望以编程方式从脚本驱动 DeepSeek Harness 的开发者
- 熟悉 Claude CLI、希望在 DSH 上获得类似命令行体验的用户
dsh-cmd-starter DSH 插件的限制
- 需要全局安装 `dsh`（`npm i -g @deepseek-ai/dsh@next`）和 Node.js ^22.19 或 >=24
- 首次安装可能因 pnpm 的 allowBuilds 限制失败，需要手动修改工作区配置
- 仅支持 headless profile，无法直接与其他 profile 配合使用
- --append-prompt 仅在进程调用期间临时生效，不会影响会话历史
dsh-cmd-starter DSH 插件的仓库 README 摘录
以下文字摘自 dsh-cmd-starter DSH 插件的上游仓库 PandaColour/dsh-cmd-starter 的 README，版权归原作者，仅作引用。
Claude-Code 风格的 DeepSeek Harness 无头调度 bundle。它在官方 `@deepseek-ai/dsh-headless` profile 之上，把一次性任务入口升级成可脚本化的 CLI： - `--append-prompt <text>`：本次运行临时追加系统提示词（可重复；不落盘、不进会话历史） - `--resume <session-id>`：恢复已有会话（支持 id 或 `--name` 别名） - `-c, --continue`：续最近的会话 - `--name <name>`：给会话起持久化别名，之后 `--resume <name>` 恢复 - `--output-format json`：stdout 输出单行 JSON，含 `sessionId` - `--provider / --model / --max-tokens / --effort`：覆盖本次运行的模型参数 ## 为什么做这个 这个插件是为了支持 [panda-pipline](https://github.com/PandaColour/panda-pipline) 而开发的。`panda-pipline` 是一个用 Python 直接驱动 Claude / Codex / Cursor 这类编码 agent，把它们编排成流水线干活的框架。 `dsh-cmd-starter` 的角色，是让 **DeepSeek Harness** 也能被同一套 Python 流水线驱动——通过补齐 Claude-Code 风格的 `--resume` / `--continue` / `--name` / `--append-prompt` / `--output-format json` 调度参数，使 `dsh` 在 Python 眼里和 `claude` / `codex` / `cursor` 一样，是一个「可以用 `subprocess.Popen` 启动、带结构化输出、能按会话恢复」的可编排单元。 ## 安装 要求：Node `^22.19 || >=24`，已全局安装 `dsh`（`npm i -g @deepseek-ai/dsh@next`）。 ```sh dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter ``` > 首次 `add` 若因 pnpm 的 `allowBuilds` 拦截，按提示在 > `~/.dsh/profiles/headless/pnpm-workspace.yaml` 里补 `allowBuilds` 键后重跑。 ## 用法 ```sh # 一次性任务（等价官方 headless） dsh --profil
阅读完整 README仓库未声明许可，使用前请先与作者确认。
dsh-cmd-starter DSH 插件常见问题
如何安装 dsh-cmd-starter？
首先确保已安装 Node.js ^22.19 或 >=24，并全局安装 dsh（`npm i -g @deepseek-ai/dsh@next`）。然后运行 `dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter`。如果首次添加因 pnpm 的 allowBuilds 限制失败，请按照提示在 `~/.dsh/profiles/headless/pnpm-workspace.yaml` 中添加 allowBuilds 键，然后重试。
没有 dsh 基础工具能用 dsh-cmd-starter 吗？
不能。dsh-cmd-starter 是扩展官方 @deepseek-ai/dsh-headless profile 的插件。你必须先安装 dsh（DeepSeek Harness CLI）并确保 headless profile 可用。该插件在此基础上添加命令，无法独立运行。
如何按名称恢复会话？
在启动会话时使用 `--name <别名>` 为其赋予持久化别名。之后使用 `--resume <别名>` 恢复该会话。别名存储在 `$DSH_HOME/cmd-starter/aliases.json` 中，跨进程有效。如果传入的值不是别名，则直接作为 session ID 处理。
--output-format json 返回什么内容？
JSON 输出包含字段：`sessionId`（驼峰格式）、`name`（仅当使用 --name 时）、`finalResponse`、`finishReason`（取值为：completed、max-tokens、blocked、aborted、error）以及 `errorCode`（仅在错误时出现）。输出为单行 JSON 打印到 stdout，便于脚本解析。
--append-prompt 在不同运行间会持久化吗？
不会。--append-prompt 是临时的，它通过 agent 的 systemPrompt.section() 注入，进程退出即消失，不会写入会话日志。只有使用 --resume 或 -c 才会延续之前的对话历史。