前言¶
DeepSeek Harness (DSH) 插件，用於編排用戶擁有的 DeepSeek 網頁歷史到本地知識庫的同步流水線。它把已有的同步邏輯搬到同源控制頁，實現一鍵運行、查看狀態與日誌、跑完整性體檢。
核心能力¶
- 使用 DSH subprocess：起你配置的命令。
- 讀狀態與日誌：展示進度。
- 完整性體檢：跑你指定的體檢命令。
- 拉取會話：用 DSH 憑據服務裏的
userToken調chat.deepseek.com，拉取會話列表。只取新增/續聊的線程，規範化成conversations/*.md+conversations.l+catalog.json。 - 插件內檢索：對知識庫進行檢索。
- 全量回填：支持全量回填。
安裝¶
安裝標準 dsh.bundle 插件，零依賴、無客戶端構建步驟。
dsh plugin --profile web add github:284022719/dsh-kb-sync
安裝後重啓 DSH。要求 DSH 提供 webServer 與 subprocess 服務（0.2.x 默認都有），Node ≥ 20。
使用¶
打開控制頁：http://127.0.0.1:<DSH Web 端口>/__dsh-kb-sync/。
- 粘貼 userToken：粘貼一次，它只進 DSH 憑據服務，不落明文文件。
- 拉取新對話（增量）：只取新增或續聊的線程，生成文件。
- 全量回填：走官方導出包，解析後合併到知識庫。
- 檢索：在頁面內檢索知識庫。
- 運行已有同步腳本 / 體檢 / 刷新狀態：通過控制頁操作。
安全與限制¶
插件分爲兩半：一半讀憑據值、會出網；另一半不讀憑據、不出網。
紅線：讀憑據值 + 有網絡。這是“自己拉取”那一半的必然結果。紅線默認應擋住，如需繼續使用需在設置中確認風險。
不做什麼：
* 不把 token 寫進任何文件/日誌/響應。
* 不訪問 chat.deepseek.com 之外的任何地址。
* 不讀憑據文件正文，只讀修改時間。
* 不註冊提示詞段落，不改核心 bundle，無安裝腳本。
限制：
* 純 host 半部，需要宿主提供 subprocess 服務。
* 狀態是輪詢（運行中 3 秒一次）。
* 界面文案目前是中文。
* Node >= 20。
更多信息¶
- 目錄：https://www.skillhub.cn/plugins/284022719/dsh-kb-sync
- 倉庫：https://github.com/284022719/dsh-kb-sync
