前言¶
在 DSH 裏做長期學習或面試複習時，常見做法是依賴會話上下文或通用記憶插件。上下文會隨窗口截斷而丟失；純記憶類插件往往缺少「每條結論對應哪份材料、哪一頁」的結構化出處，模型也容易在庫外內容上裝成已掌握。dsh-study-mode 把 agent 預設「學習模式」和側邊欄「學習知識庫」面板打在一個 npm 包裏：回答時先查本地主題庫，命中標出處，庫裏沒有則標「未驗證」，需要查證才聯網並標日期。維護者爲 waspqj，在 DSH 插件生態中歸類爲「記憶」；源碼與發佈以 GitHub 倉庫 waspqj/dsh-study-mode 與 npm 包 dsh-study-mode 爲準（MIT 許可，package.json 當前版本 0.3.26）。
這是什麼¶
一句話：學習模式（study-mode）agent 預設 + 側邊欄知識庫面板——把知識沉澱進按主題劃分的本地庫，提問時檢索優先，查到了標出處，查不到標未驗證。
一個包包含兩樣東西：
| 組件 | 作用 |
|---|---|
| agent 預設「學習模式」 | 新建會話時選用；回答順序爲主題庫 → 全局主題 → 模型知識（標未驗證）→ 按需聯網（標日期） |
| 側邊欄「學習知識庫」面板 | 書本圖標：按主題瀏覽、搜索、互鏈、歸檔 / 恢復 / 刪除 / 手動新增、AI 校驗補充 |
與「功能清單更長」的同類方案相比，README 強調三條取捨：查不到不裝作知道；每條卡片帶結構化出處（文件 / 網頁 / 用戶口述 + 頁碼等）；卡片正文可用 [[另一張卡的標題]] 互鏈，形成「鏈接 / 被引用」關係網。檢索爲本地 BM25，不調模型、不聯網、不上傳內容；不做向量庫、不依賴 Python 模型。
核心功能¶
回答與標記¶
選用「學習模式」預設後，模型會自行查庫。回答中常見三種標記：
| 標記 | 含義 |
|---|---|
[主題:名稱] |
命中知識庫，有出處可查原文 |
[模型知識·未驗證] |
庫裏沒有對應條目，使用模型知識 |
[網絡:日期] |
經聯網查證 |
命中卡片時，對話下方可展示卡片摘要、出處與覈實狀態，以及「相關知識點」等已建鏈鄰居。卡片上提供「AI 校驗補充」「編輯」「問一下」等動作。
入庫與補全¶
- 需要入庫時對模型說「把這條記下來」——先預覽卡片，點「確認寫入 N 條」批量落盤；也可展開單張逐條確認。
- 庫裏缺條目時，對話下方會出現補全提議，可勾選、改主題，同意後出預覽再確認寫入。
- 側邊欄面板支持手動新增、全庫搜索、按主題瀏覽；未覈實條目需點兩次「覈實」（第一次上膛，第二次才生效），批量覈實同樣二次確認。
面板與互鏈¶
左側爲主題列表（各主題可有獨立顏色），右側按出處分組展示卡片，組內可按頁碼排序；組頭可「連成一組」形成鏈式視圖，右上角可切「平鋪」。面板頂部可單獨指定插件用於 AI 校驗、檢索重排的模型。
知識庫默認路徑：
~/.dsh/learn/
├── settings.json
└── topics/<主題>/kb.jsonl
可通過環境變量 DSH_LEARN_ROOT 改根目錄；條目爲 JSONL，便於 grep 或自行腳本處理。插件只寫該目錄，README 說明不與其它記憶 / 知識庫插件衝突；預設僅在主動選擇「學習模式」的會話中生效。
安裝與啓用¶
命令行安裝（資料原文）：
dsh plugin --profile web add dsh-study-mode
也可在 DSH「插件」頁 →「添加插件」→「安裝第三方插件」，填寫 npm 包名 dsh-study-mode，或 GitHub / Gitee 的 git+https://… 地址、tarball、本地目錄等（Gitee 須帶 git+ 前綴）。國內可在安裝源選擇 npmmirror 等鏡像。裝完後需重啓 DSH。勿與開發副本同時安裝同一 id 的包。
裝完建議覈對四點：插件頁中 dsh-study-mode 已啓用；新建會話預設列表有「學習模式」；側邊欄有書本圖標；面板左側主題、右側條目、頂部搜索框正常。
典型用法¶
- 新建會話，選擇「學習模式」預設，直接提具體問題（例如「間隙鎖是什麼」）——不必先說「查一下知識庫」，避免多餘工具往返。
- 要把對話結論入庫，說「把這條記下來」，預覽後確認寫入。
- 接受或調整模型提出的補庫提議，預覽後寫入。
- 點側邊欄書本圖標維護庫：搜索、歸檔、互鏈、覈實、AI 校驗補充。
問法上，README 建議：具體問題不限定領域；範圍性問題可帶領域（如「MySQL 8.0 的常考點」）；數字與參數以卡片原文爲準；同一問題 10 分鐘內重複問會走檢索緩存。學習模式比普通模式多檢索相關往返，token 主要花在工具往返而非 BM25 本身。
適用場景與注意¶
適合：需要把課件、筆記、口述要點沉澱成本地主題庫，並在對話中優先引用、明確區分「庫內已覈實 / 未驗證 / 聯網查證」的學習與複習場景。
注意：
- 插件在 DSH 進程權限下運行，安裝前應閱讀源碼與 MIT 許可證，確認行爲邊界（不後臺抓文件、不默認聯網抓取、不上傳庫內容）。
- 庫默認在本機
~/.dsh/learn，換機器不自動同步，需自行備份或設置DSH_LEARN_ROOT。 - 社區目錄頁 skillhub.cn/plugins/waspqj/dsh-study-mode 與 dsh-plugin.org 爲生態收錄入口，與 DeepSeek / 幻方無官方從屬關係；DSH 理念是「一切皆插件」。
自定義 agent 人設與檢索協議可編輯包內 cordis.patch.yml 中 preset-study → config.plugins → persona → config.prefix，改完重啓 DSH；可用 npm run check 做接線自檢。
結尾¶
dsh-study-mode 用「檢索優先 + 出處 + 未驗證標註 + 本地 JSONL 主題庫」把學習對話和可維護的知識卡片綁在一起。進一步瞭解可查看插件目錄頁與 GitHub README：
- 目錄頁：https://www.skillhub.cn/plugins/waspqj/dsh-study-mode
- GitHub：https://github.com/waspqj/dsh-study-mode
