前言¶
用 DeepSeek Harness（DSH）寫代碼、調智能體時，上下文往往散落在會話裏；若筆記在 Obsidian 或其它目錄裏，要在瀏覽器對話和本地文件之間來回切換，引用路徑和段落也不方便。DSH 生態裏已有偏大綱、反向鏈接的 Obsidian 類插件；dsh-obsidian-notes 走的是另一條路線：在 Web 右欄提供 Obsidian 風格的本地 vault 樹、高保真預覽與編輯，並把整篇筆記或選中段落交給對話區，筆記始終留在本機目錄，不導入、不離開機器。
下面介紹該插件的定位、能力與安裝用法。事實以 GitHub 倉庫 README 與 package.json 爲準；社區目錄頁：skillhub.cn/plugins/revive123456/dsh-obsidian-notes。DSH 社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-obsidian-notes（npm 包名 dsh-obsidian-notes，當前 release 0.5.2，MIT）由維護者 revive123456 發佈，在 SkillHub 分類爲「記憶」。它面向 DeepSeek Harness 0.2.1+ 的 Web UI（或桌面端），在側欄注入 Notes 面板：指向本機某一文件夾中的 Markdown，在同一界面裏瀏覽、搜索、編輯，並引用到聊天輸入框。
README 明確說明不做的事：無反向鏈接、無大綱面板、無圖譜、無數學 / Mermaid / 嵌入塊渲染；若這些優先，應使用真實 Obsidian vault 或生態內 DedsecLemon/dsh-obsidian。
核心功能¶
Vault 側欄與編輯¶
- 懶加載目錄樹；單擊打開筆記，可新建、重命名、刪除筆記與文件夾；按標題與正文搜索；顯示實時筆記數量。
- 帶行號的 Obsidian 式預覽：表格對齊、帶 info string 的圍欄代碼、嵌套列表與任務列表、各級標題、setext 標題、分隔線；可點擊
[[wikilinks]]（含別名與#section）。 - Callout：支持 13 種 canonical 類型（如
note、warning、tip等）及 15 種 Obsidian 別名（如summary、tldr、important等），> [!type] title語法。 - 編輯保存：行號源碼視圖；按鈕或 Ctrl/Cmd+S 保存。YAML frontmatter 不在編輯器中展示，保存時原樣拼回；外部對 YAML 的修改會保留。
截圖粘貼與附件¶
編輯時 Ctrl/Cmd+V 粘貼圖片：寫入配置的附件目錄，並插入 Obsidian 原生 ![[Pasted image <timestamp>.png]]（單張上限 20 MB），在真實 Obsidian 中仍可用。附件目錄支持四種位置模式（vault 根、固定文件夾、與筆記同目錄、筆記下子目錄）；可隱藏僅含圖片的文件夾、可選清理孤兒文件；更改目錄時會移動已有截圖並重寫 vault 內所有嵌入。
與對話聯動¶
- ⤴ Cite to chat：在 composer 插入
@/abs/path/to/note.md（無法觸達 composer 時回退到剪貼板）。 - 在預覽或編輯器中選中文字：出現 Ask / Explain 條，提示詞包含絕對路徑、行號範圍、引用片段（最多 1500 字符）與你的問題。
會話與工作區整理¶
側欄可對 session 重命名、歸檔或永久刪除；可批量選擇 session（歸檔/刪除）或 workspace（刪除註冊及其 session 日誌）。README 在此段後截斷，具體 UI 行爲以倉庫文檔爲準。
安裝與啓用¶
環境要求：
- DeepSeek Harness 0.2.1 或更新（Web 或桌面）。
- CLI 安裝還需 pnpm（
npm i -g pnpm或corepack enable）以及 Node.js^22.19 || >=24（與package.json的engines一致）。 - 帶 bundle 層的插件在啓動時組裝，安裝後必須重啓 DSH 宿主（桌面端需退出再打開）；僅刷新頁面不夠。
桌面端（npm 已發佈後）¶
- 打開 Settings → Plugins。
- 搜索
dsh-obsidian-notes並安裝。 - 重啓 DeepSeek Harness。
若搜索無結果，改用 CLI 或源碼路徑安裝。
CLI（npm 已發佈後）¶
npm i -g pnpm
dsh plugin --profile web add dsh-obsidian-notes
# 重啓宿主後再啓動，例如：
dsh web
dsh plugin add 會把包記入 $DSH_HOME/profiles/web/package.json，profile patch 在下次啓動時生效。
從源碼安裝（npm 未發佈或需本地構建時）¶
README 建議不要用 bare github: spec 安裝：pnpm ≥ 10 默認會阻止 lifecycle（prepare），從而跳過生成 lib/client.js 的構建。應 clone 後本地 npm i 再安裝路徑：
git clone https://github.com/revive123456/dsh-obsidian-notes.git
cd dsh-obsidian-notes
npm i
dsh plugin --profile web add "$(pwd)"
# 重啓 dsh web
卸載：
dsh plugin --profile web remove dsh-obsidian-notes
然後重啓宿主。若曾用手動 cordis.patch.yml 方式安裝，見倉庫 docs/legacy-install.md。
典型用法¶
首次指定 vault¶
打開側欄底部的 Notes 行。若尚未配置 vault：
- 📂 打開目錄選擇器；
- 📋 粘貼絕對路徑。
默認 vault 爲 $DSH_WORKSPACE/obsidian_vault；若無該變量，則爲啓動 dsh web 時工作目錄下的 ./obsidian_vault。
寫筆記並交給對話¶
- 在樹中打開或新建
.md，在帶行號編輯器中修改，保存。 - 需要模型讀整篇時，用 Cite to chat 把
@路徑寫入 composer。 - 只需某段時，在預覽或編輯器中選中文字，用 Ask 或 Explain，確認提示詞中含路徑、行號與引用後再發送。
粘貼截圖¶
在編輯器中粘貼剪貼板圖片，插件寫入附件目錄並插入 ![[Pasted image …]]；之後在 Obsidian 中打開同一 vault 仍一致。
適用場景與注意¶
適合： 已在用或打算用本地 Markdown vault、希望在 DSH Web 側欄高保真預覽 callout 與表格、並頻繁把筆記或段落塞進同一窗口對話的開發者。
注意：
- 插件以當前 DSH 進程權限 讀寫你配置的目錄；安裝前請查看源碼與 MIT 許可證，並只指向可信路徑。
- 與
dsh-obsidian的能力邊界不同：本插件強調渲染保真、截圖嵌入、note-to-chat，而非反向鏈接與大綱。 - 重啓宿主是啓用 bundle 的必要步驟；Node 與 DSH 版本需滿足 README 與
package.json要求。
結尾¶
dsh-obsidian-notes 把 Obsidian 風格的本地筆記面板放進 DSH Web 右欄：vault 樹、行號預覽/編輯、callout 與表格、截圖粘貼、引用到聊天，以及 session/workspace 批量整理。需要細節與截圖時，見 GitHub README（含 中文版 README.zh.md）與 SkillHub 目錄頁。
