dsh-brain-hub:把 DSH 的記憶建成一堆 Markdown 文件

前言

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 份),正文尾部再回灌進系統提示

會話頂欄會多一枚腦形圖標,點開是一條四步流水線:

  1. 打開網頁版:在 DSH 側欄打開 chat.deepseek.com
  2. 讓網頁版整理成卡片:把提煉規則發給網頁版,等它按格式吐出卡片
  3. 逐張確認並保存:彈窗裏每張卡都有「看看全文 / 保存這張 / 不要了」
  4. 備份到雲端: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 給內容敏感的場景兜底。

用之前建議先確認下面幾點:

  1. 插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。本插件是 MIT License,dist/ 就是源碼,零運行時依賴,審查成本不高。
  2. 項目星標數很低,屬於個人維護的插件,長期維護節奏沒有保證。它不查重、不做向量檢索,搜索是標題/標籤/正文加權打分,檢索體驗不要拿語義搜索來期待。
  3. 網頁版那一半依賴側欄瀏覽器自動化,需要先在側欄登錄 chat.deepseek.com,且 DSH 每次重啓都要重新登錄一次;DeepSeek 對內嵌環境可能彈「使用環境異常」,這時第 2 步會失敗,需要走菜單裏的兜底路徑。
  4. 拆卡質量取決於提示詞。規則在 <memoryDir>/prompts/distill.md,面板裏可以直接改,改完立刻生效,不用重啓。
  5. 只支持單倉庫單分支,多人協作要靠 git 自己解決衝突。
  6. 不覆蓋不靜默跳過的策略意味着重複主題會留下多份卡,清理依賴 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜