DeepSeek Harness plugin

dsh-cmd-starter

Claude-Code style CLI scheduling bundle for DeepSeek Harness headless: --append-prompt, --resume, --continue, --output-format json, and model overrides.

Jump to install

Source facts

Repository
PandaColour/dsh-cmd-starter
Latest update
Aug 14, 2026
Category
Development & Runtime
GitHub stars
3
Format
bundle
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/PandaColour/dsh-cmd-starter
Plugin: dsh-cmd-starter
Author: PandaColour

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-cmd-starter

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 而开发的。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,已全局安装 dshnpm i -g @deepseek-ai/dsh@next)。

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"

# 输出 JSON,含 sessionId(供 Python 抓取)
dsh --profile headless --output-format json "run the tests"
# => {"sessionId":"session-xxx","finalResponse":"...","finishReason":"completed"}

# 恢复会话 / 续最近会话
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 的对应关系

Claude CLIdsh-cmd-starter
claude -p "prompt"dsh --profile headless "prompt"
claude -r <name>dsh --profile headless --resume <session-id-or-name>
claude -cdsh --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 jsondsh --profile headless --output-format 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,不进入会话历史。
  • --output-format json 的字段(命名对齐 SDK 协议):sessionId(驼峰)、name(仅 --name 时)、finalResponsefinishReasoncompleted | max-tokens | blocked | aborted | error)、errorCode(仅 error 时)。

Python 调度

见 [examples/schedule.py](examples/schedule.py)。

感谢支持

![谢谢支持](weixin.jpg) 联系方式: <panda.colour@qq.com>