dsh-obsidian-board：把本地 Obsidian 變成 DSH 的本地知識庫對話面板

下面介紹 dsh-obsidian-board。這是一個 DeepSeek Harness (DSH) 插件，它將本地的 Obsidian vault 變成一個專門的 RAG 對話面板。該插件屬於“雙半插件”：宿主端負責文件索引和 BM25 檢索，瀏覽器端負責 UI 渲染和交互。

核心能力¶

本地檢索與索引
檢索完全在本地運行，使用 BM25 算法配合 CJK 大二分詞。基於文件修改時間（mtime）進行增量索引，處理 10,000 個筆記的庫時，全量掃描耗時不到 1 秒，增量更新約 50 毫秒。支持標題和路徑權重提升。

引用與交互
回答中包含 [n] 引用標記或下方的芯片。點擊這些標記或芯片，可以在右側源面板中打開對應的筆記。源面板寬度可拖拽調整，雙擊可重置。

輸出與控制
停止按鈕在檢索、規劃、生成（包括模型靜默期）階段均有效。停止後的回覆顯示爲中性狀態，而非報錯。回答中斷後會標記爲“interrupted”並提供重試按鈕。

隔離與安全
面板歷史記錄存儲在瀏覽器本地命名空間，不會寫入 DSH 的主會話日誌。第三方材料（如公網收集、vendor 目錄）會被降權，優先檢索用戶自己的筆記。無網絡依賴，不包含嵌入模型。

安裝與啓用¶

先執行安裝命令：

dsh plugin --profile web add "dsh-obsidian-board"

桌面端用戶需將 --profile web 替換爲 --profile desktop。

配置與使用¶

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中配置 vault 路徑：

- insert:
    - id: dsh-obsidian-board
      name: dsh-obsidian-board
      config:
        vaultPath: "D:\\notes\\MyVault"   # 絕對路徑，~ 也可用
        topK: 8                           # 每次引用的塊數
        chunkLimit: 1200                  # 單個塊的字符限制

配置完成後，在 DSH 側邊欄的“Panels”組中點擊 Obsidian。首次點擊會彈出目錄選擇器或設置卡片，選擇或輸入本地 vault 路徑即可建立連接。

典型用法如下：
1. 詢問筆記內容："我的筆記裏關於 X 是什麼？"
2. 總結特定內容："總結 #tag 下的觀點"
3. 點擊回答中的 [1] 或下方芯片，打開右側源面板查看原文。

注意事項¶

• 檢索機制：目前僅支持 BM25 檢索，不支持語義嵌入搜索。
• 歷史記錄：面板歷史存儲在瀏覽器本地，重啓 DSH 宿主後，歷史會從宿主內存恢復。
• 依賴要求：需要 @deepseek-ai/dsh-typert-protocol >= 0.1.5-rc.1。