前言¶
在 DSH「一切皆插件」的模式下,一个常见的工程风险是智能体过早断言:在还没有来源证据时声称“我记得”,在计划未校验时声称“可以执行”,在基准结果未核验时声称“通过”,在发布检查未完成时声称“安全”。
dsh-ops-kit 围绕这个问题做 DSH 插件包:它给 DSH profile 提供一组用于证据驱动 memory、编排计划、基准操作、仓库审计和插件发布流程的能力包与工具。下面介绍它的定位、安装方式、核心工具和几个需要注意的配置点。
这是什么¶
dsh-ops-kit 是一个可复用的 DeepSeek Harness bundle,由 LeslieWylie 维护,许可证为 MIT。
它面向 DSH 插件生态,解决的核心问题是:让智能体在声称“记忆”“计划”“基准结果”“发布安全”之前,先落到可检查的证据、清单或诊断结果上。资料说明它默认保守:不静默创建 issue、调用远程 API、启动 benchmark、修改仓库或读取 credentials。
安装与启用¶
官方安装命令如下:
dsh plugin --profile <profile> add dsh-ops-kit
运行环境要求来自 package.json engines:
node >=22.19.0
由于插件会以当前 DSH 进程权限运行,安装前建议先检查源码、许可证,以及 dsh-terminal-hotfix 这类会执行热修动作的命令。
核心能力¶
下面是已核实的能力包/工具列表:
| 工具 | 作用 |
|---|---|
dsh_ops_capability_catalog |
列出插件包包含的能力包 |
dsh_ops_workflow_plan |
生成 scope → baseline → context → execute → verify → handoff 计划 |
dsh_ops_skill_read |
读取打包的完整 skill 定义 |
dsh_ops_memory_search |
在受限本地 Markdown/code 根目录中搜索既有上下文,并提供来源证据 |
dsh_ops_repository_audit |
审计 Git 清洁度、未跟踪文件和 credential-path 卫生 |
dsh_ops_release_checklist |
生成完整 DSH 插件发布清单 |
dsh_ops_plugin_doctor |
对照清单检查插件仓库 |
dsh_ops_runtime_doctor |
检查官方终端 / persistent-bash prompt 兼容性 |
dsh-terminal-hotfix |
提供受保护的终端 prompt 热修命令 |
其中,dsh_ops_memory_search 和 dsh_ops_repository_audit 标记为 read-only。
dsh_ops_release_checklist 用来生成发布清单,dsh_ops_plugin_doctor 用来对照清单检查插件仓库。一个偏“说明发布需要什么”,一个偏“检查插件仓库是否做到了”。
本地 roots 配置¶
使用 dsh_ops_memory_search 或 dsh_ops_repository_audit 时,建议把 roots 配置为窄目录,不要指向 credential 目录:
- id: dsh-ops-kit
config:
roots:
- <project-root>
- <memory-root>
如果未配置 roots,工具默认使用 DSH 进程工作目录。资料说明,credential-like paths 和常见 run/secret 目录会被拒绝或跳过。
验证与终端 prompt 热修¶
安装或变更后,可以运行以下验证命令:
pnpm install --offline --ignore-scripts
pnpm build
pnpm typecheck
pnpm test
如果出现官方终端与 persistent-bash 的 prompt 兼容性问题,先检查再应用热修:
dsh-terminal-hotfix --check
dsh-terminal-hotfix --apply
应用后重启 DSH。资料说明,dsh-terminal-hotfix 不由插件 loader 运行,也不静默编辑 dependencies。
适用场景与注意¶
适合以下场景:
- 在 DSH profile 中加入本地上下文搜索时,需要来源证据而不是自由文本回忆。
- 在编排研究、多智能体、基准或发布任务前,需要一份从
scope到handoff的计划结构。 - 在插件发布前,需要生成发布清单,并用 doctor 对照检查仓库。
- 在排查终端 prompt 握手或 persistent-bash 兼容性时,需要只读诊断和受保护热修路径。
注意:
- 插件以当前 DSH 进程权限运行,配置
roots时要保持窄范围。 - 不要把
roots指向 credential 目录。 - 默认保守不等于无需人工审查;涉及热修、发布等动作时,仍应保留可复核记录。
- 已核实资料未给出可确认的目录页 URL;引用目录入口时,以 DSH 社区目录中的实际收录为准。
参考¶
- GitHub:
https://github.com/LeslieWylie/dsh-ops-kit - 社区目录页:已核实资料未提供固定 URL,可按
dsh-ops-kit在 DSH 社区目录中查找。