前言¶
在 DSH 這類「一切皆插件」的智能體工作流裏，對話記憶常有兩個痛點：一是模型可見內容裏混入思考鏈、工具噪聲和系統注入；二是多個 DSH 對話、多個助手視角之間缺少穩定的 session 與 peer 邊界。
下面介紹 dsh-honcho-memory。它針對這兩個問題，提供 Honcho v3 記憶適配和共享知識庫能力。
這是什麼¶
dsh-honcho-memory 是 kingcharleslzy-ai 維護的 DSH 插件，許可證爲 MIT。它的定位是 DeepSeek Harness（DSH）的 Honcho v3 記憶適配器與共享知識庫插件。
需要先說清邊界：這個 npm 包不是 Honcho 後端，也不會替你安裝 Honcho。使用前必須有 DSH 能訪問的 Honcho v3 服務。只有安裝 DSH 插件、沒有 Honcho API/數據庫/後臺 deriver 時，記憶不會工作。
核心功能¶
下面列出已覈實能力：
- 自動保存真實用戶消息和模型可見回答，並過濾思考鏈、工具噪聲和系統注入。
- 每個 DSH 對話默認映射到獨立 Honcho session。
- 每輪召回 session summary、用戶模型、peer card、本地結論和共享知識。
- 提供七個 DSH 工具：
memory_store
memory_search
memory_context
memory_reason
memory_profile
memory_dream
memory_status
- 保留方向性視角，例如
deepseek -> user，不把不同助手僞裝成同一個 peer。 - 使用
shared-knowledge -> user/shared-knowledge作爲可選的 canonical 共享層。 - 相似結論只在讀取時去重；整理工具默認 dry-run，不會靜默刪除後端數據。
- 使用 Honcho 官方 v3 HTTP API，目標 Node.js 20 或更高版本。
- 安裝包內置零運行時依賴的
dsh-honcho-memory-core，不需要再單獨安裝 core。
先準備 Honcho¶
下面是兩種前置方案，二選一。
方案 A：使用 Honcho 官方託管服務¶
使用官方託管服務時，把插件配置指向官方 API：
baseUrl: https://api.honcho.dev
apiKey: YOUR_HONCHO_API_KEY
方案 B：自託管官方 Honcho¶
按 Plastic Labs 官方倉庫的 Docker 方式部署官方 Honcho。部署後做健康檢查，結果應返回：
{"status":"ok"}
如果 Honcho 在另一臺機器上，應確保 DSH 進程能訪問該地址，並使用 HTTPS、VPN 或 SSH 隧道保護網絡鏈路；不要把未鑑權的 Honcho 端口直接暴露到公網。
安裝與啓用¶
安裝命令示例如下：
dsh plugin --profile web add dsh-honcho-memory
這裏使用 --profile web 是資料給出的示例；其他 DSH profile 是否適用，需要結合你的 profile 配置判斷。
安裝後，在對應 DSH profile 的 cordis.patch.yml 中覆蓋配置。至少應確認 baseUrl、workspace、userPeer、aiPeer 指向你實際使用的 Honcho 服務和 peer 約定。
啓用後檢查¶
重啓 DSH 後，調用：
memory_status({"check":"health"})
然後確認以下幾項：
1、Honcho API 可用；
2、workspace、userPeer、aiPeer 與你的配置一致；
3、queue 從 pending/in-progress 進入 completed；
4、新對話能夠用 memory_store 寫入，並被 memory_search 找回。
工具使用注意¶
七個工具中，memory_status 用於狀態檢查；memory_store 和 memory_search 用於寫入與讀取驗證。
memory_dream 可能消耗後端 LLM 資源，必須明確：
confirm=true
數據與隱私¶
- 插件會把啓用範圍內的 DSH 對話發送到你配置的
baseUrl。 - 插件本身不包含維護者賬號、服務器地址或用戶身份默認值，也不提供遙測服務。
- Honcho 後端可能把內容發送給其配置的 embedding、summary、deriver 或 dialectic 模型提供商；隱私邊界取決於你自己的 Honcho 部署和模型配置。
- 插件會在當前 DSH 進程中運行，因此安裝前應檢查源碼和 MIT 許可證，並確認你願意將對話發送到所選 Honcho 服務。
升級與兼容¶
- 目標 API 爲 Honcho v3。
- Node.js 要求 20 或更高版本。
- 0.5.2 起默認值不包含維護者身份或機器配置。
- 從 0.5.1 或更早版本升級前，需確認舊數據實際所在位置，並把
baseUrl、workspace、userPeer寫進自己的cordis.patch.yml。 - 0.5.2 不會遷移、重命名或刪除已有 Honcho 數據；只有繼續使用相同 backend、workspace 和 peer ID，纔會召回原有記憶。
- 本插件不是 Plastic Labs 官方發佈的 DSH 集成；Codex、Hermes 等其他客戶端的安裝與配置也不由本插件完成。
開發與驗證¶
開發驗證可按下面命令執行：
npm install
npm test
npm run audit:public
npm run smoke
npm run smoke:dsh
npm run tidy:messages
其中 tidy:messages 與整理工具保持一致，默認 dry-run，不會靜默刪除後端數據。
適用場景與注意¶
適合已經在 DSH 中使用 Honcho v3，或準備自託管 Honcho 的開發者。它適合需要把 DSH 對話接入獨立記憶後端，同時保留 peer 視角與共享知識層的使用者。
注意：
- 插件以當前 DSH 進程權限運行，並會把啓用範圍內的對話發送到配置的
baseUrl。 - 安裝前應檢查源碼和許可證。
- 如果只安裝插件而沒有完整 Honcho v3 服務，記憶不會工作。
結尾¶
dsh-honcho-memory 的價值在於把 DSH 的消息、session、peer 視角和共享知識接入 Honcho v3，同時把後端部署、隱私邊界和升級數據位置留給使用者自己確認。
GitHub：
https://github.com/kingcharleslzy-ai/dsh-honcho-memory
社區目錄頁地址未在本次已覈實資料中給出；DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，可在目錄中搜索 dsh-honcho-memory。
