前言¶
在 DeepSeek Harness（dsh）裏跑智能體時，上下文往往只存在於當前會話：換 profile、關終端或新開一輪對話，之前沉澱的偏好、項目約定和跨會話事實很難自動回到 prompt 裏。若再單獨維護一套「記憶服務」，還要自己對接注入時機、MCP 調用觀測和 token 統計，成本和耦合都會上去。
下面介紹社區插件 dsh-vibe-assistant-bridge（npm 包名 dsh-vibe-assistant-bridge）。它在 dsh 宿主內運行，通過本機 loopback HTTP 與 Vibe Assistant（智管）通信：在 agent 步進前注入共享記憶、上報 MCP 邊界與用量、在回合結束時觸發採集，並註冊 recall / skill 等原生工具。Vibe Assistant 未啓動時，後臺能力會靜默降級，工具返回可讀錯誤，不干擾正常對話。
這是什麼¶
dsh-vibe-assistant-bridge 是由維護者 Zafer-Liu 開源的 dsh 插件，在 SkillHub 等社區目錄中歸類爲「記憶」。運行時僅依賴 Node 內置模塊（零運行時 npm 依賴），默認連接 http://127.0.0.1:9420。
它解決的是：讓 dsh 會話與本地、隱私優先的 Vibe Assistant 工作臺對齊——共享 L2/L3 記憶注入、會話結束後的 L0→L1 抽取觸發，以及通過 dsh 工具訪問記憶中心與已發佈 Skill 庫，而不必在 dsh 側重複實現同一套 HTTP 協議。
環境與依賴¶
安裝前請確認：
- dsh 版本：
>=0.2.0 <0.3.0（開發者預覽階段；README 說明每經覈驗發佈會放寬引擎範圍） - Node.js：
>=22 - 完整能力需要本機運行 Vibe Assistant（注入、遙測、採集、工具）
核心功能¶
六項能力彼此獨立，各自 try/catch 隔離，可在配置裏單獨關閉（見下文「配置」）。
| 能力 | 在 dsh 側的機制 | Vibe Assistant 端點 |
|---|---|---|
| 記憶注入 | agent/pre-step：首步近似 SessionStart 注入 L3+L2；後續步按內容 digest 去重，相同內容不重複注入 |
POST /memory/context?event=… |
| MCP 觀測 | session/event 中 tool/call 與 tool/result 成對；命名空間 mcp__<server>__<tool>；僅上報調用邊界與成功/失敗，不上報參數或結果體 |
POST /mcp/observation |
| Token 用量 | 每條帶 usage 的 assistant/message 記一條用量，模型名來自 model/selection 事件 |
POST /telemetry/usage |
| 會話採集觸發 | agent/turn-stopping 通知智管在回合關閉後立即做 L0→L1 抽取，不必等掃描週期 |
POST /collect/trigger |
| 記憶工具 | 原生工具 recall_memory、get_user_profile |
POST /memory/recall、POST /memory/profile |
| Skill 工具 | 原生工具 list_shared_skills、read_shared_skill |
POST /skills/list、POST /skills/read |
當 endpoint 不可達時：注入可回退到本地快照（默認路徑見配置表）；後臺上報靜默丟棄；四個工具失敗並提示例如「Vibe Assistant is not running or unreachable at http://127.0.0.1:9420」。
安裝與啓用¶
dsh 桌面（Web UI）：打開 Plugins → Add plugin，粘貼 npm 包名：
dsh-vibe-assistant-bridge
CLI：建議固定版本（桌面端 pnpm 相對 @latest 可能滯後最多約 24 小時）：
npx @deepseek-ai/dsh plugin --profile desktop add --save-exact dsh-vibe-assistant-bridge@0.1.0
從 Git 引用或本地目錄（倉庫已附帶編譯好的 lib/，無需 build）：
# from a GitHub ref
npx @deepseek-ai/dsh plugin --profile desktop add git+https://github.com/Zafer_Liu/dsh-vibe-assistant-bridge.git
# from a local checkout
npx @deepseek-ai/dsh plugin --profile desktop add ./dsh-vibe-assistant-bridge
卸載：
dsh plugin --profile desktop remove dsh-vibe-assistant-bridge
社區目錄頁（與 DeepSeek / 幻方無官方從屬關係，僅爲獨立插件站點）：https://www.skillhub.cn/plugins/Zafer-Liu/dsh-vibe-assistant-bridge
配置¶
默認無需改配置。若要覆蓋，在 profile 的 cordis.patch.yml 中編輯該插件行的 config（用戶層 patch 寫同 id 行，後層覆蓋前層）。插件在 patch 中的 id 爲 vibe-assistant-bridge。
| 字段 | 類型 | 默認值 | 說明 |
|---|---|---|---|
endpoint |
string | http://127.0.0.1:9420 |
Vibe Assistant 本機 HTTP |
timeoutMs |
number | 2000 |
每次 bridge 請求超時 |
maxInflight |
number | 8 |
併發 fire-and-forget 上報上限 |
maxPending |
number | 512 |
等待 call_end 的工具調用記憶上限 |
snapshotPath |
string? | ~/.dsh/profiles/desktop/plugins/vibe-assistant-memory-snapshot.md |
離線注入回退；null 關閉 |
features.injection |
boolean | true |
記憶注入 |
features.observation |
boolean | true |
MCP 觀測 |
features.usage |
boolean | true |
Token 用量上報 |
features.collect |
boolean | true |
會話採集觸發 |
features.tools |
boolean | true |
四個記憶/Skill 工具 |
僅關閉用量上報的示例：
- id: vibe-assistant-bridge
config:
features:
usage: false
典型用法¶
- 本機啓動 Vibe Assistant，確認 HTTP 監聽與
endpoint一致（默認 9420）。 - 按上文安裝插件並啓用 desktop profile（或你使用的 profile）。
- 正常在 dsh 中對話：首步及後續 agent 步會自動拉取並注入共享記憶（內容不變則不再注入）。
- 需要主動查記憶或 Skill 時，在會話中讓模型調用已註冊工具：
recall_memory、get_user_profile、list_shared_skills、read_shared_skill（需features.tools爲 true 且智管可達）。 - 若智管臨時不可用，仍可能從
snapshotPath讀到上次緩存的記憶片段用於注入；觀測與採集不會阻塞會話。
README 未提供單獨的可複製「端到端演示腳本」；行爲以上表事件與 HTTP 映射爲準。
適用場景與注意¶
適合：已在或計劃使用 Vibe Assistant 做本地記憶與治理，並希望 dsh 會話自動享受注入、MCP 邊界觀測、token 歸因與回合後採集，同時通過 dsh 原生工具訪問同一記憶與 Skill 庫的開發者。
注意：
- 插件隨 dsh 宿主進程運行，具備該進程權限；安裝前請閱讀 GitHub 源碼 與 MIT 許可證。
- dsh 生態理念是「一切皆插件」；SkillHub 等爲社區目錄，並非 DeepSeek 官方應用商店。
- 當前 npm 版本爲 0.1.0，與 dsh 開發者預覽版本區間綁定，升級 dsh 或插件時請對照 README 的
engines.dsh範圍。
結尾¶
dsh-vibe-assistant-bridge 把 dsh 的 agent 生命週期事件和 Vibe Assistant 的 HTTP API 對齊：共享記憶注入、合規的 MCP 觀測、用量與會話採集，以及 recall / skill 工具，且智管離線時不拖垮會話。
- 目錄頁：https://www.skillhub.cn/plugins/Zafer-Liu/dsh-vibe-assistant-bridge
- 倉庫：https://github.com/Zafer-Liu/dsh-vibe-assistant-bridge
