前言¶
在 DSH 裏做智能體或長期協作時，常見做法是各自把對話摘要、文檔片段放在本機技能或私有目錄裏。檢索口徑不一致、重複上傳、誰寫了什麼難以追溯，跨成員對齊成本偏高。DeepSeek Harness 社區插件 dsh-shared-kb（維護者 kunjienie50-creator，分類：記憶）把「庫」收攏到管理員本機上的一個 Hub：成員只裝插件、粘貼邀請碼，上傳與檢索走同一套 inbox-triage 規範，AI 側通過 skb_* 工具按摘要→目錄→全文的順序取數。下面介紹它的定位、能力與啓用方式；安裝命令與字段均來自項目 README 與 package.json（當前版本 0.3.0，許可證 MIT）。
這是什麼¶
一句話：你的電腦當 Hub（hub.js，默認端口 8787），團隊成員在 DSH 側欄「共享知識庫」連上邀請碼即可共享素材與成文文檔；數據落在 Hub 機器的數據目錄（默認 ~/.dsh-shared-kb），Hub 本身零第三方依賴，node hub.js 即可運行。
與「每人各存各的、靠拷貝同步」相比，這裏統一了整理規則、署名、去重（sha256）和管理員審計；與向量 RAG 方案相比，作者有意採用字段加權與 skb_recall / skb_search(compact) 分層檢索，以保持 Hub 單進程、無 embedding 依賴（README 第八節說明了取捨）。
目錄頁：skillhub.cn 插件頁
源碼：GitHub kunjienie50-creator/dsh-shared-kb
核心功能¶
Hub 與成員模型¶
- 管理員在本機啓動 Hub，管理成員、輪換令牌、刪除文檔/素材、查看統計；成員憑邀請碼（形如
skb1.…，內含 Hub 地址、令牌與名字）連接。 - 每人一個令牌，文檔自動署名；管理員不可移除自己，至少保留一名管理員。
- 上傳文本會調用上傳者自己的模型按 inbox-triage 整理（十類分類、≤10 字 summary、置信度、2~4 條要點）；失敗進入「待整理」，可由 agent 補做。同一 sha256 只存一份。
DSH 側欄與私有庫¶
- 側欄書本圖標「共享知識庫」：拖拽或上傳素材、搜索、閱讀、篩選（分類、上傳者、重要性、團隊/私有/全部）。
- 私有庫：選擇「僅自己可見」或寫入本機
~/.dsh/shared-kb-private，不上傳 Hub；檢索時可一併命中並標註私有。 - 重要資料置頂：標重要須手寫推薦語（≥10 字），全員頂部提醒；讀過全文後才能自行取消置頂。
- 收藏夾、評論與 @、歷史版本對比、批量下載/刪除、每週簡報：與賬號相關能力按 README 描述在頁面與工具中提供。
隨插件安裝的技能¶
安裝後自動帶上 4 個技能：shared-kb（團隊版收件箱），以及 long-dialogue-knowledge、controversy-analysis、idea-synthesis，用於長對話、爭議、靈感類成文後再「存進團隊庫」。
模型工具（節選）¶
| 工具 | 作用 |
|---|---|
skb_recall |
按主題一次取多篇摘要與要點（優先使用） |
skb_search |
檢索；compact=true 僅目錄 |
skb_read |
讀全文；讀團隊文檔會記「已讀」 |
skb_upload / skb_commit |
上傳原件與成文（commit 爲唯一成文入口） |
skb_admin |
管理員：成員、刪文檔、統計等 |
完整列表見 README「六、工具」。
安裝與啓用¶
插件在 DSH ≥ 0.2.0、Node.js ≥ 20 環境下使用；Hub 建議在裝過 DSH 的機器上運行。安裝插件前請自行查看源碼與 MIT 許可證；插件與 Hub 以當前用戶/進程權限讀寫本機目錄，勿將 8787 端口無防護暴露公網（令牌即全部權限）。
1. 管理員：啓動 Hub¶
雙擊啓動（推薦）
- macOS：
install/啓動知識庫.command - Windows：
install/啓動知識庫.bat
首次輸入管理員名字後，會打印成員訪問地址與插件安裝地址；關閉窗口即停止服務。
或命令行
node hub.js --data ~/.dsh-shared-kb --add-member 你的名字 --admin --url http://<這臺電腦的局域網IP>:8787
node hub.js --data ~/.dsh-shared-kb --port 8787 --host 0.0.0.0 --url http://<局域網IP>:8787
將 URL 換成成員實際能訪問的地址：同 Wi-Fi 用局域網 IP，異地可用 Tailscale 或內網穿透；README 明確不建議把 8787 直接暴露公網。
2. 成員：安裝插件¶
三種方式任選其一（裝完按提示重啓 DSH）：
- 市場（上架後）：在 dshmarket 搜索「共享知識庫」。
- GitHub：在插件頁「添加 / 安裝」粘貼：
github:kunjienie50-creator/dsh-shared-kb
- Hub 直連：粘貼 Hub 提供的安裝包地址，例如：
http://<你的Hub地址>:8787/install/dsh-shared-kb-0.3.0.tgz
3. 成員：連接¶
打開側欄「共享知識庫」→ 粘貼管理員發放的邀請碼 → 連接。無需額外配置文件或命令行。
典型用法¶
收素材與成文¶
- 在「共享知識庫」頁面拖入文件或點「上傳素材」；或對 AI 說「把這個存進團隊庫」。
- 上傳前選擇 團隊共享 或 僅自己可見；可勾選「先不整理」直接進待整理（不消耗模型），之後再點「整理」或讓 AI「把待整理的整理一下」。
- 長對話、爭議、靈感分別用隨插件安裝的三個技能產出內容，再指令「存進團隊庫」。
查資料（頁面與對話）¶
- 頁面內搜索，或篩選分類、上傳者、重要性等。
- 對話中 AI 宜先
skb_recall，不夠再skb_search，最後skb_read讀全文。
管理員日常¶
側欄「共享知識庫」→ 右上角 管理：概覽、加成員（生成邀請碼）、移除成員、輪換令牌、設置對外地址、刪文檔、清理素材、分類統計；亦可在對話中調用 skb_admin。
備份時打包 Hub 數據目錄（含 config.json、state.json、docs/、comments/、raw/）；各成員私有庫在各自 ~/.dsh/shared-kb-private，需分別備份。
適用場景與注意¶
適合：小規模團隊（README 建議約 5~20 人）在同一 Harness 生態下共享規範化的知識條目，管理員能接受在本機常駐 Hub。
限制（來自 README）
- 單進程文件存儲；上千篇後作者建議考慮 SQLite FTS5 等方案。
- 自動整理主要針對純文本；PDF/Word/掃描件需先用 office/OCR 類技能轉文本再入庫。
- 無實時協同編輯；併發修改靠版本與衝突提示，不互相覆蓋。
- 檢索不做向量庫；規模在幾十到幾百篇時作者認爲現有分層工具鏈更省依賴、對精確串更穩。
DSH 社區目錄（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件 star 數隨倉庫變化，撰寫時 GitHub 顯示爲 0。
結尾¶
dsh-shared-kb 把團隊知識收攏到管理員本機 Hub，用邀請碼降低成員接入成本，用 inbox-triage 與 skb_* 工具統一整理與檢索路徑；需要 centralized 備份與權限時，由管理員在 Hub 與側欄管理中完成。
