前言¶
DSH 插件生態強調「一切皆插件」。對於中文 DSH 用戶來說，一個常見需求是把學習資料、文字轉寫和音頻轉寫放進當前會話中複習，而不是額外搭建一套複雜的外部系統。
dsh-project-knowledge-review 是一個面向中文 DSH 用戶的獨立本地知識複習插件。它把文字、OCR 和 ASR 資料保存到本地資料庫，在回答前優先檢索本地 evidence；在 strict 模式下，如果證據不足會明確拒答。
這是什麼¶
下面是這個插件的基本信息。
- 插件名：
dsh-project-knowledge-review - 定位：面向中文 DSH 用戶的獨立本地知識複習插件
- 維護者：HeWhenJay
- 許可證：MIT
- 生態位置：DSH 插件生態中的社區項目。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
這個插件主要提供以下能力：
- 零配置本地資料庫，首次使用時自動創建 v2 存儲
- 證據優先問答：先檢索本地 evidence，再根據 evidence 回答
- strict 模式下，證據不足時明確拒答
- 文字、OCR、ASR 入庫後生成 Markdown 自動提要
- 可過濾導入元數據、RAG 模板和純時間戳
- 兩級分類：系統初分類與用戶可調整的二次分類
- 側欄知識庫獨立工作區，可查看詳細摘要和原始內容
- 安全 Markdown 預覽，支持渲染視圖和 Markdown 源碼視圖，不執行 HTML 或腳本
- 可選 OCR / ASR，默認關閉
- 啓用 OCR / ASR 時需要顯式開啓，並配置 DSH 憑據
- 輕量 JSONL 索引、單文檔原文文件、遊標分頁和按需原文讀取
- v1 舊庫自動遷移到 v2，並保留原始備份
- 插件只提供檢索 evidence 和系統約束，最終答案由當前會話模型生成
安裝與啓用¶
先安裝插件。安裝命令如下：
dsh plugin --profile web add dsh-project-knowledge-review
安裝後，重新啓動當前 DSH Web 進程並刷新頁面。
首次使用時，插件會自動創建 v2 存儲。默認本地存儲路徑是：
~/.dsh/project-knowledge-review/knowledge.json
默認不需要數據庫、向量模型、賬號登錄或項目 Token。
如果使用 OCR 或 ASR，需要顯式開啓。步驟如下：
- 打開“設置 → 知識複習”
- 開啓對應服務
- 配置 Base URL 與模型名稱
- 將 API Key 保存到 DSH 憑據庫
API Key 不寫入插件設置 JSON，也不會回顯。
典型用法¶
添加文字資料¶
在 DSH 對話中直接粘貼文字，並說明加入知識庫的信息：
把下面內容加入知識庫，標題是……，來源是……：
（粘貼你有權使用的文字）
這一步會把你提供的文字資料加入本地知識庫。
基於知識庫複習¶
在對話中直接提問：
根據我的知識庫解釋……
插件會先檢索本地 evidence，再讓當前會話模型根據 evidence 回答。
查詢知識庫概覽¶
可以問下面這些問題：
我的知識庫有多少份資料？
知識庫資料保存在哪裏？
知識庫是否與當前項目共享？
這些查詢用於查看資料數量、存儲位置和共享範圍。
在側欄瀏覽資料¶
點擊側欄“知識庫”，可以搜索本地資料，並按系統分類或個人分類瀏覽。
閱讀時可以在下面幾組視圖之間切換：
- 摘要 / 原始內容
- 渲染 / Markdown 源碼
安全 Markdown 預覽不執行 HTML 或腳本。
切換回答策略¶
在“設置 → 知識複習”中，可以切換回答策略：
reference：允許當前會話模型補充通用知識，但需要區分知識庫證據和模型補充strict：沒有足夠證據時明確拒答
適用場景與注意¶
這個插件適合這些場景：
- 你希望把中文學習資料、筆記、文字轉寫或音頻轉寫放在本地知識庫中複習
- 你希望回答前優先使用本地 evidence
- 你希望在 strict 模式下，避免當前會話模型在證據不足時給出知識結論
使用前需要注意：
- 插件以當前 DSH 進程權限運行，安裝前應先檢查源碼和 MIT 許可證
- 請只導入自己編寫、公開授權或已確認有權使用的資料
- 插件不會連接、安裝或識別任何外部項目，
sharedWithCurrentProject始終爲false - OCR / ASR 默認關閉，啓用後只接受公開 HTTP(S) 圖片 URL 或公開可直接下載的音頻 URL
- OCR / ASR 會拒絕 URL 用戶信息、非 HTTP(S) 協議、本機地址和私有網絡地址
- 安全 Markdown 預覽不執行 HTML 或腳本
- v1 舊庫會自動遷移到 v2，並保留原始備份
結尾¶
dsh-project-knowledge-review 提供了一個較輕量的本地知識複習路徑：本地資料庫、證據優先問答、Markdown 預覽和二次分類。
相關入口如下：
- 插件線索給出的目錄頁：https://www.skillhub.cn/plugins/HeWhenJay/dsh-project-knowledge-review
- GitHub：https://github.com/HeWhenJay/dsh-project-knowledge-review
