dsh-shadow-mind：DeepSeek Harness 的並行認知運行時

前言¶

DeepSeek Harness（DSH）採用插件化架構，在開發多智能體工作流時，如果僅依賴單一主代理，往往難以實現獨立的審查、事實覈查或並行認知處理。dsh-shadow-mind 是一個移植自 pi-shadow-mind 的 DSH 插件，它在 DSH 運行時中實現了並行認知能力。

該插件在主代理的每個回合結束後，通過心跳調度器隨機激活配置好的“陰影代理”。這些陰影代理擁有獨立的責任、工具權限和運行超時，能夠在主代理進行任務處理的同時，提供獨立的視角和輔助工作。

核心功能¶

插件目前包含以下已實現的核心能力：

心跳調度：在主代理的每次回合結束後，根據配置的概率隨機激活已啓用的陰影代理。
受限工具陰影：陰影代理僅接收經過清理的主會話軌跡和顯式的工具白名單。默認白名單爲只讀，可配置其他工具以擴大訪問範圍。
單次運行超時：每個陰影運行都有 timeout_seconds（或配置默認值）的限制，超時運行會被中斷並釋放槽位。
生命週期清理：通過 subagent/end 事件移除已完成的陰影運行，確保活躍計數準確。
管理工具：通過模型工具即可創建、更新、刪除、列出、啓用或禁用陰影定義。
配置工具：通過模型工具讀寫全局配置，寫入前會驗證合併結果。
暫停/恢復/紀元：支持 /shadow pause 和 /shadow resume 命令。暫停會終止正在運行的陰影；新的用戶輸入會遞增紀元並取消上一紀元的運行。
自動切換：通過 /shadow auto on|off 命令控制心跳激活功能。
工具調用參數脫敏：在將工具調用參數轉發給陰影代理前進行脫敏處理，防止憑證泄露。

安裝與啓用¶

DSH 插件通過 Cordis 組合（配置文件或代理預設）加載。安裝步驟如下：

使用以下命令將包安裝到指定的 DSH 配置文件中：

dsh plugin --profile web add @winterchenhuan/dsh-shadow-mind@latest

重啓 DSH 服務，插件即可加載。

若用於本地開發，需先構建包：

cd /path/to/dsh-shadow-mind
npm install
npm run build
dsh plugin --profile web add /path/to/dsh-shadow-mind

配置¶

全局配置存儲在 ~/.dsh/settings.yaml 的 shadow-mind: 節中。同時，陰影定義文件位於 ~/.dsh/agent/shadow-minds/ 目錄下。

全局配置示例¶

shadow-mind:
  heartbeatProbability: 0.33
  maxParallelShadows: 2
  defaultShadowTimeoutSeconds: 120
  defaultThinkingLevel: low

主要配置項包括：
* heartbeatProbability：每次回合激活陰影的概率（0 到 1）。
* maxParallelShadows：允許同時運行的陰影數量上限。
* defaultShadowTimeoutSeconds：未在定義中設置超時時使用的默認秒數。

陰影定義示例¶

---
id: grounded-reviewer
name: Project Grounding Checker
enabled: true
activation_probability: 0.6
run_with_model: openai/gpt-5-mini
thinking_level: low
tools:
  - read
  - grep
  - glob
---

檢查主代理的聲明是否得到當前工作區的支持。如果沒有值得報告的內容，回覆：NOT_RELEVANT。

使用方法¶

安裝並重啓 DSH 後，通過 Web 界面啓動服務：

dsh web

常用命令¶

插件通過 /shadow 命令提供統一的控制接口：

/shadow status：查看當前狀態（激活/暫停、自動模式、紀元、運行數量等）及配置診斷。
/shadow list：列出已定義的陰影。
/shadow probe <id> [tools]：手動運行指定陰影（不等待心跳），可選指定工具列表。
/shadow auto on|off：開啓或關閉心跳自動激活。
/shadow pause：暫停所有陰影運行。
/shadow resume：恢復陰影運行。

操作流程¶

使用 /shadow status 確認插件已加載。
使用 /shadow list 查看可用的陰影定義。
使用 /shadow probe grounded-reviewer 手動測試一個陰影是否正常工作。
在主代理對話中，只要自動模式開啓，陰影將按配置概率在主代理回合後自動激活。

注意事項¶

當前狀態：這是一個功能原型。核心的心跳調度、受限工具、超時、生命週期清理和管理工具均已驗證可用。
寫入權限：持久化寫入受 DSH 審批服務控制，當該服務掛載時，操作需要用戶批准。
安全機制：工具調用參數在轉發給陰影前會被脫敏；工具結果會被總結。
許可協議：插件使用 MIT 許可證。作爲插件，它以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。

該插件是 DSH 生態中實現多代理並行認知的實用組件，適合需要在主代理旁增加獨立審查或計算能力的場景。相關文檔與源碼可參考 DeepSeek Harness 生態目錄或 GitHub 倉庫。