前言¶
在 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 社區目錄中查找。