dsh-cybernetics: DeepSeek Harness 控制論內核

前言¶

DeepSeek Harness (DSH) 的 Cordis 插件。作者爲 boomzikazita。該插件基於《工程控制論》機制，實現觀察者、前饋、反饋控制迴路、穩定閥和能控性檢查。它旨在爲智能體提供類似物理系統的動態穩定性調節能力。

該插件通過經典控制迴路運行：

觀測器：內存狀態按 session 分區，並使用 JSONL 格式持久化至 ~/.dsh/cybernetics/state_log.ndjson。
前饋控制：通過 tools/pre-execute 規則表攔截工具調用，支持白名單和參數正則匹配。
反饋校正：捕獲 tools/result 事件，計算 delta 值並使用 EMA（指數移動平均）濾波。根據失敗率觸發檔位自適應和發散/振盪檢測。
執行器：提供以下命令供外部調用：
- cybernetics_snap：快照狀態
- cybernetics_status：狀態概覽
- cybernetics_check：能控性檢查
- cybernetics_sandbox_mode：沙箱模式控制

通過 bundle 方式安裝，推薦使用標準命令：

dsh plugin --profile web add /home/boom/Deepseek/dsh-cybernetics

關鍵約束：插件目錄下的 node_modules 必須軟鏈到 DSH 的全局宿主目錄，嚴禁在插件目錄內自行執行 pnpm install。否則會導致 TOOL_RUNTIME_SCHEDULER Symbol 不匹配，引發調度崩潰。

核心參數位於 cordis.patch.yml，主要控制反饋濾波和閾值判定：

EMA 濾波：alpha (默認 0.2)
檔位閾值：
- fast：閾值 5
- deep：閾值 4
- conservative：閾值 3
穩定性判定：
- 升檔/降檔閾值：escalateAt (0.6) / deescalateAt (0.15)
- 降檔防抖：deescalateStreak (5)
- 發散判定：divergenceStreak (3)
振盪與冗餘：
- oscillationWindow / oscillationRatio (10 / 0.7)
- redundantWindow (20)
熵值告警：
- entropyWarnAt / entropyRecoverAt (1.0 / 1.5)

基於 v4.2 及開發經驗，以下問題需特別注意：

依賴軟鏈：必須將宿主的 node_modules 軟鏈到插件目錄，避免依賴副本衝突。
waterfall 監聽器：必須顯式 return next()，否則會斷鏈導致後續工具調度失效。
rc.6 defineTool 簽名：參數結構爲 execute(args, exec)，輸出結構爲 output:{schema, render}。工具列表應通過 ctx.tools.schemas() 獲取。
HMR 副作用：修改插件後，dsh web 的熱重載會回滾 ctx.tools.register 的副作用，必須重啓 dsh web 才能生效。
穩定閥缺陷：存在積分飽和問題（計數器跨輪累計不重置），可能導致系統鎖死。
TRANSPORT 報錯：根因是 tools/pre-execute 注入消息破壞了角色交替約束。需移至 agent/pre-step 使用 createUserMessage 構造消息。
參數字段名：rc.6 版本中，參數字段名爲 arguments 而非 args。讀取參數時需優先使用 execArgsText 以避免 exec.args 爲 undefined。

安裝後，可以通過以下步驟驗證插件狀態：

    node --check index.js && node --check core.mjs
    node -e "import('./index.js').then(m => console.log(m.name, m.inject))"

    cybernetics_status

        grep boot-recover ~/.dsh/cybernetics/state_log.ndjson | tail -1

*   檢查冗餘事件聚合（A1 修復生效後，冗餘計數應不再驟降）：

        grep redundant-burst ~/.dsh/cybernetics/state_log.ndjson | tail -1