dsh-ops-kit:面向證據的 DSH 插件運維包

前言

在 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。

適用場景與注意

適合以下場景:

  1. 在 DSH profile 中加入本地上下文搜索時,需要來源證據而不是自由文本回憶。
  2. 在編排研究、多智能體、基準或發佈任務前,需要一份從 scope 到 handoff 的計劃結構。
  3. 在插件發佈前,需要生成發佈清單,並用 doctor 對照檢查倉庫。
  4. 在排查終端 prompt 握手或 persistent-bash 兼容性時,需要只讀診斷和受保護熱修路徑。

注意:

  1. 插件以當前 DSH 進程權限運行,配置 roots 時要保持窄範圍。
  2. 不要把 roots 指向 credential 目錄。
  3. 默認保守不等於無需人工審查;涉及熱修、發佈等動作時,仍應保留可複覈記錄。
  4. 已覈實資料未給出可確認的目錄頁 URL;引用目錄入口時,以 DSH 社區目錄中的實際收錄爲準。

參考

  • GitHub:https://github.com/LeslieWylie/dsh-ops-kit
  • 社區目錄頁:已覈實資料未提供固定 URL,可按 dsh-ops-kit 在 DSH 社區目錄中查找。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜