前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者爲智能體擴展能力。在構建智能體時，記憶的可靠性是核心難點。傳統的記憶方式往往依賴存儲原始文檔，這不僅佔用大量上下文，還容易導致檢索到的信息缺乏上下文關聯或存在偏差。
DeepBrain 不同於文檔存儲，它存儲的是判斷——即從會議、訪談和講座中提煉出的結論。每個判斷都附帶證據鏈，能夠回溯到原始錄音，並在不同場合進行交叉驗證。dsh-deepbrain 插件將 DeepBrain 的這套“組織第二大腦”能力引入 DSH，讓智能體能夠讀取這些判斷、引用經過逐字驗證的引語、查詢人員的履歷，並借用 DeepBrain 的分析方法。
插件定位¶
dsh-deepbrain 是 DeepSeek Harness 的記憶插件，由 qiuyiwu1989-star 維護，採用 MIT 許可證。它的核心價值在於爲 DSH 智能體提供經過結構化處理的記憶層：判斷、證據鏈和逐字驗證的引用。
該插件不存儲原始文檔，僅存儲經過處理的判斷；所有調用均爲實時調用，不進行緩存。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness。
- 安裝插件：
使用以下命令將插件安裝到指定 profile（默認爲 web）：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:qiuyiwu1989-star/dsh-deepbrain
安裝完成後請重啓 profile。
- 配置環境變量：
DeepBrain 需要賬號和 API Key。建議優先通過環境變量設置，而非寫入配置文件（防止密鑰泄露到日誌或截圖）：
export DEEPBRAIN_API_KEY=lj_live_xxx
核心功能¶
該插件向 DSH 註冊了 6 個 MCP 工具。智能體不需要調用服務端提供的 27 個原始工具，插件負責將它們裁剪爲適合 LLM 使用的形狀，避免模型因工具過多而胡亂選擇導致上下文爆炸。
-
deepbrain_brief
- 用途：當你不確定該問什麼時，先描述當前情況，讓 DeepBrain 決定你需要了解哪些關鍵信息。
-
deepbrain_topics
- 用途：瀏覽索引或拉取某個主題的摘要。這是大多數寫作和分析工作的終點。
-
deepbrain_quotes
- 用途：獲取可歸因的引用，每一條都經過與錄音的逐字驗證。
-
deepbrain_person
- 用途：查詢人員名單或某人的歷史立場，建議在談判或會議前使用。
-
deepbrain_ask
- 用途：提出具體問題並獲取帶來源的回答。慢速問題會自動等待結果。
-
deepbrain_call
- 用途：逃生通道。當上述五個工具無法覆蓋需求時，直接調用任何 DeepBrain MCP 工具。
- 注意：如果
tool參數爲空，會列出當前 API Key 允許調用的所有工具。
配置示例¶
在 DSH 的 profile 配置中添加如下內容：
- insert:
- id: deepbrain
name: 'dsh-deepbrain'
config:
endpoint: 'https://shennao.zaowuyun.com/api/mcp'
apiKey: '' # 留空表示讀取 DEEPBRAIN_API_KEY 環境變量
timeoutMs: 120000 # 多步驟檢索可能耗時較長，建議設置超時
passthrough: true # 設爲 false 則不註冊 deepbrain_call
API 權限與調用限制¶
DeepBrain API Key 是有作用域的，服務器會根據 Key 的權限修剪可用的工具集。
- brain.ask：讀取判斷、引用、人物信息、方法庫。這是大多數使用場景所需的基礎權限。
- transcript.read / transcript.write：讀取或寫入原始錄音文本。
- brain.propose：寫入判斷（這些判斷會進入收件箱，需人工審覈）。
只有在明確通過 deepbrain_call 請求寫入操作，且 Key 擁有 brain.propose 權限時，纔會執行寫入。
重要限制：
* 無緩存：所有調用均爲實時請求。判斷可能會被覆蓋或失效，緩存會導致模型獲取過時結論。
* 無寫入權限：除非使用 deepbrain_call 並具備 brain.propose 權限，否則插件不會向 DeepBrain 寫入任何數據。
* 無客戶端 UI：這是一個僅提供工具註冊的 Host-only 插件，不包含前端界面。
已知問題¶
在乾淨的 profile 環境中（未啓用 auto-install-peers），可能會遇到 Cannot find package '@deepseek-ai/cordis' 的錯誤。
這是因爲該插件依賴 @deepseek-ai/dsh-tools，而後者將 @deepseek-ai/cordis 聲明爲 peer dependency。DSH 本身通常提供 cordis，但在特定環境下可能未自動安裝。解決方法是啓用自動安裝 peer 依賴：
pnpm config set auto-install-peers true
該插件有意不依賴自己的 cordis 副本，以避免 DI 容器上下文/服務身份分裂。
總結¶
dsh-deepbrain 解決了智能體記憶缺乏結構化驗證的問題。它將 DeepBrain 的“判斷”能力轉化爲 DSH 可用的工具，使智能體能夠基於經過驗證的證據進行推理和引用。對於需要處理大量會議記錄、訪談內容，並希望智能體具備可靠記憶能力的開發者，這是一個實用的工具。
