PandaColour/dsh-cmd-starter 预览 preview

PandaColour/dsh-cmd-starter

Plugin插件 Native原生 ⭐ 2 Prompts & Skills提示词与技能

为deepseek-harness提供一个命令行启动工具,支持--append-prompt、--resume等类似claude的命令。

Project Overview项目介绍

dsh-cmd-starter is a native DeepSeek Harness bundle that adds Claude Code-style headless scheduling capabilities to the platform. It builds on the official @deepseek-ai/dsh-headless profile, turning the default one-off task entry point into a scriptable CLI that supports external orchestration. It adds a range of useful command line parameters not available in the base headless profile, including the ability to append temporary prompts, resume existing sessions, name sessions for easy recovery, output structured JSON, and override model parameters for each run. All parameters follow the same naming and behavior convention used by the Claude Code CLI, making it familiar for users who already work with that tool.

The original purpose of this plugin is to enable DeepSeek Harness integration with the panda-pipline framework, which is an orchestration tool written in Python that drives coding agents like Claude, Codex, and Cursor into automated work pipelines. By adding the Claude Code-compatible CLI parameters to dsh, this plugin makes DeepSeek Harness behave just like any other supported coding agent from the perspective of panda-pipline. It can be launched as a subprocess with subprocess.Popen, output structured results, and resume sessions between runs, just like the other agents in the pipeline, so it fits seamlessly into existing pipeline workflows that already use other coding agents.

To install this plugin, you need to have Node.js version ^22.19 || >=24 installed on your system, along with a global installation of the latest dsh CLI (installed via npm i -g @deepseek-ai/dsh@next). The install command is dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter, which pulls the bundle directly from this GitHub repository. If your first install attempt is blocked by pnpm's allowBuilds check, you just need to add the required entry to ~/.dsh/profiles/headless/pnpm-workspace.yaml and run the install command again.

这是一个适配 Claude Code 风格的 DeepSeek Harness 无头调度 bundle,基于官方 @deepseek-ai/dsh-headless 配置文件开发,将原来的一次性任务入口升级为可脚本化调用的 CLI。它新增了临时追加提示词、恢复已有会话、会话命名别名、JSON 结构化输出、可覆盖模型参数等多项调度参数,完全对齐 Claude Code 的常用调用规范。

这个插件最初是为了配合 panda-pipline 开发的,panda-pipline 是一个用 Python 直接驱动 Claude、Codex、Cursor 这类编码 Agent,将它们编排成工作流水线的框架。dsh-cmd-starter 的作用是让 DeepSeek Harness 也能被这套 Python 流水线统一调度,和其他编码 Agent 一样作为可编排单元使用。

使用要求是安装 Node.js 版本 ^22.19 || >=24,并且已经全局安装最新版的 dsh。安装命令为 dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter。如果首次安装被 pnpm 的 allowBuilds 拦截,只需要按提示补全配置后重新安装即可。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter

把 PandaColour/dsh-cmd-starter 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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,已全局安装 dsh(npm 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 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 --output-format json
claude --model <m> dsh --profile headless --provider <p> --model <m>

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-git-workflow 下一个 Next dsh-release-proof →