前言¶
DSH(DeepSeek Harness)的會話能幹活,但它的記憶存在哪裏、怎麼跨會話複用,官方並沒有一個統一答案。常見的做法是自己搭一套帶數據庫的方案,或者每次在對話裏重貼一遍上下文;兩者都不便宜:前者要運維,後者靠人肉維護。
這次介紹的插件 xxwjxx-1210/dsh-brain-hub 屬於社區目錄(skillhub.cn)上「記憶」分類下的插件,分類爲記憶,項目星標數很低。它的定位很明確:Markdown 當數據庫,git 當同步。記憶就是你磁盤上的一堆 .md 文件,不引入數據庫,也不依賴專門雲服務。維護者是 xxwjxx-1210,插件以 MIT License 發佈,運行時零依賴,dist/ 就是源碼,可以直接讀。
下面按「這個包裏有什麼東西、怎麼裝、怎麼配、日常怎麼用、有哪些注意」來講。
它把三件事放進了一個包¶
插件要解決的痛點是:網頁版 DeepSeek 聊天聊得深,DSH 能執行任務,但兩邊記憶不通,人得在中間來回貼東西。插件把記憶庫、卡片確認、網頁版筆記三層做進一個包:
| 層 | 幹什麼 |
|---|---|
| 記憶庫 | MEMORY.md 核心記憶常駐注入系統提示;notes/*.md 一張卡一個文件;index.json 索引;寫一次自動 commit + push |
| 卡片確認 | 網頁版按規則拆好的卡片先進 inbox/,你逐張過一眼,再決定「存到雲端」還是「只存本地」 |
| 網頁版筆記 | 側欄網頁版對話的進度存成 progress.md,舊稿滾進 history/(保留最近 20 份),正文尾部再回灌進系統提示 |
會話頂欄會多一枚腦形圖標,點開是一條四步流水線:
- 打開網頁版:在 DSH 側欄打開
chat.deepseek.com - 讓網頁版整理成卡片:把提煉規則發給網頁版,等它按格式吐出卡片
- 逐張確認並保存:彈窗裏每張卡都有「看看全文 / 保存這張 / 不要了」
- 備份到雲端:
commit+push,有推完的提交會自動補推
每一步都有狀態行(第幾步、共幾步、當前卡在哪),第 3 步會顯示生成狀態:幾點生成幾張、跳過幾張。流水線的第 2 步依賴側欄瀏覽器自動化,登錄、頁面加載有問題時會失敗,插件會把失敗階段、頁面地址、輸入框狀態一起顯示出來。
設計上有一個值得注意的取捨:不查重。同一主題想存幾次就存幾次,文件名衝突會自動加 -2、-3 後綴,既不覆蓋也不靜默跳過。這對「第二大腦」是合理的默認,因爲索引和 memory_search 的存在讓你隨時能找回舊的那一份。
安裝與啓用¶
插件提供三種安裝來源,下面命令來自 README 原文:
# 從 npm(推薦)
dsh plugin --profile <profile> add dsh-brain-hub
# 從 GitHub
dsh plugin --profile <profile> add "github:xxwjxx-1210/dsh-brain-hub#main"
# 或從本地 tgz
dsh plugin --profile <profile> add file:/絕對路徑/dsh-brain-hub-0.2.6.tgz
其中 npm 安裝對應 README 裏推薦的路徑;本地 tgz 那條命令裏的 0.2.6 來自 README 示例文件名。裝完必須在系統托盤徹底退出 DSH 再啓動——前端 bundle 只在啓動時加載,熱重載換不掉它。升級插件步驟相同。
裝好後配置寫在 profile 層。注意不要把配置寫進 node_modules/<包>/cordis.patch.yml,那個文件會在下次安裝時被覆蓋:
backend: git # git | folder | local
memoryDir: 'D:\notes\memory' # 記憶庫(git 倉庫);默認 $DSH_HOME/memory
notesDir: 'D:\notes\webds' # 網頁版筆記;默認 $DSH_HOME/dsh_memory
remote: 'https://github.com/<你>/<私有倉庫>.git'
branch: main # 默認 main
coreLimit: 3000 # 核心記憶注入上限(字符)
autoPull: true # 啓動時 pull --rebase
autoPush: true # 寫入後自動 push
readOnly: false # true 時所有寫工具直接拒絕
injectProgress: true # 把 progress.md 尾部注入系統提示
remote 留空也能跑,只是不推送,純本地記憶庫同樣可用。
第一次點頂欄腦形圖標會彈新手引導:三步用法加三種雲端存法,選一種後給出可直接粘貼的 YAML 片段,點「知道了,開始用」後不再出現,標記寫進 <memoryDir>/hub.json。
三種雲端存法,按你對備份的態度選¶
backend 字段決定記憶庫怎麼備份出去,三種方案覆蓋「想有版本歷史」「不想碰 git」「內容敏感」三種需求:
| backend | 存哪 | 要 git 嗎 | 適合誰 |
|---|---|---|---|
git(默認) |
記憶庫目錄 → 推自己的私有倉庫 | 要 | 多設備同步、想有版本歷史 |
folder |
記憶庫目錄直接放在 OneDrive / 堅果雲這類已同步的文件夾 | 不要 | 不想碰 git,讓同步盤負責上傳 |
local |
只在這臺電腦 | 不要 | 內容敏感,不聯網備份 |
# git
config:
backend: git
remote: 'https://github.com/<你>/<私有倉庫>.git'
# OneDrive / 同步盤
config:
backend: folder
memoryDir: 'C:\Users\<你>\OneDrive\brain-hub'
# 只存本機
config:
backend: local
folder 模式下流水線第 4 步不執行 git commit,只提示文件已保存到同步盤。
逐張過卡:雲端和本地分開¶
確認窗口裏每張卡都有兩個按鈕:
- 存到雲端:寫入
notes/,進 git,會推送。 - 只存本地:寫入
private/,.gitignore裏永久排除,任何情況下都不會被推送。
判斷標準 README 給得很直接:這張卡被同事或客戶看到,你會不會緊張?真實客戶名、報價、聯繫方式、未公開項目走本地;方法論、判斷標準、脫敏案例走雲端。
如果網頁版那邊卡住——沒登錄、彈「使用環境異常」、側欄沒加載完——插件還留了兩條不依賴自動注入的兜底路徑:菜單裏可以「複製整理規則」自己粘貼到網頁版,也可以「收進網頁版最後的回答」直接讀取當前對話正文、拆卡片、進入第 3 步確認。第 2 步徹底不通時流程仍然走得完。
數據格式與給模型用的工具¶
一張卡片就是一個 Markdown 文件,帶 frontmatter:
---
id: 20261105-120000-標題
title: "標題"
tags: 標籤A, 標籤B
created: 2026-11-05T12:00:00.000Z
updated: 2026-11-05T12:00:00.000Z
uploaded: true
---
# 標題
正文
notes/ 的格式與 dsh-memory-github 兼容,可以直接接手舊庫;private/ 同格式,只是不進 git。
插件暴露給模型的工具共九個:memory_write、memory_search、memory_read、memory_list、memory_stats、memory_core、memory_update、memory_forget、memory_sync。readOnly: true 時寫類工具直接返回拒絕文案,不產生提交。客戶端與宿主之間走 RPC,POST /api/plugin-rpc/brain-hub,信封 { type:"client-request", rpcId, method, payload:{ endpoint, payload } },端點包括 status、hub.settings、hub.rename、cards.list、cards.save、cards.read、cards.update、cards.discard、cards.upload、progress.save、progress.read、progress.history、memory.sync、prompt.get、prompt.save。
適合誰,以及幾點注意¶
適合這類人:已經在用 DSH、同時習慣在網頁版 DeepSeek 上長談,想把聊出來的判斷、流程、結論沉澱成可檢索的文件庫,又不打算爲此搭數據庫的人。backend: folder 讓不熟 git 的人也能用,local 給內容敏感的場景兜底。
用之前建議先確認下面幾點:
- 插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。本插件是 MIT License,
dist/就是源碼,零運行時依賴,審查成本不高。 - 項目星標數很低,屬於個人維護的插件,長期維護節奏沒有保證。它不查重、不做向量檢索,搜索是標題/標籤/正文加權打分,檢索體驗不要拿語義搜索來期待。
- 網頁版那一半依賴側欄瀏覽器自動化,需要先在側欄登錄
chat.deepseek.com,且 DSH 每次重啓都要重新登錄一次;DeepSeek 對內嵌環境可能彈「使用環境異常」,這時第 2 步會失敗,需要走菜單裏的兜底路徑。 - 拆卡質量取決於提示詞。規則在
<memoryDir>/prompts/distill.md,面板裏可以直接改,改完立刻生效,不用重啓。 - 只支持單倉庫單分支,多人協作要靠 git 自己解決衝突。
- 不覆蓋不靜默跳過的策略意味着重複主題會留下多份卡,清理依賴
memory_forget主動操作,不要指望自動合併。
工具列表和 RPC 端點來自 README,實際字段以你安裝到的插件版本爲準。
小結¶
dsh-brain-hub 的價值在於把「記憶」這件事拆到最樸素的存儲上:Markdown 文件、git 同步、逐張確認、雲端和本地分開。它沒有數據庫,沒有向量庫,也沒有複雜的同步協議——文件名衝突加後綴、搜索按字段加權打分,這些取捨換來的是一套讀得懂、改得動、備份策略自己定的記憶層。
目錄頁:https://www.skillhub.cn/plugins/xxwjxx-1210/dsh-brain-hub
源碼與文檔:https://github.com/xxwjxx-1210/dsh-brain-hub