前言¶
用 DeepSeek Harness（DSH）做開發或日常問答時，手頭往往還有一套 Obsidian 筆記：日記、項目記錄、待辦列表。對話默認工作目錄通常不是筆記庫，文件沙箱也會擋住直接改 Markdown。常見做法是手動切換目錄、複製粘貼，或另開腳本橋接。
下面介紹社區插件 Obsidian 筆記（倉庫 SuzukaWu/dsh-obsidian-notes）：由維護者 SuzukaWu 發佈，分類爲「記憶」。它在 Host 進程裏直接讀寫筆記庫內的 Markdown，註冊六個 obsidian_* 工具；不依賴同步服務、數據庫，也不爲此聯網。桌面端、網頁端、微信端會話均可使用。
這是什麼¶
插件讓任意一個 DSH 對話讀寫本地 Obsidian 筆記庫，無需把會話工作目錄切到筆記庫。筆記仍是你硬盤上的文件；路徑限制在筆記庫內，並跳過 .obsidian、.git、.trash、assets、node_modules 等目錄。
核心功能¶
寫日記與項目筆記¶
- 日記：向當天日記追加一條；按當前小時自動選「早上 / 下午 / 晚上」段（名稱可配）。日記不存在時，按分段模板自動創建。
- 項目筆記：追加內容時可自動落在
#### 年/月/日小標題下；筆記或目錄不存在時自動創建（可通過dateHeading關閉日期小標題）。
與手寫習慣一致的標記¶
done: true寫成- ~~已完成~~important: true寫成- ==重點==
讀取、搜索與任務勾選¶
- 按路徑讀筆記，或按日期讀日記；支持
offset/maxLines分頁。 - 整庫全文搜索（不區分大小寫），返回「文件:行號: 內容」。
- 按修改時間倒序列出筆記，可限定目錄。
obsidian_mark_done按文字匹配已有列表項，劃掉或取消劃掉（默認在今天的日記裏查找）。
只讀與安全¶
開啓 readOnly 後只註冊讀取類工具，不寫入。所有操作限定在配置的筆記庫根路徑內。
安裝與啓用¶
從插件市場安裝¶
在 DSH 插件市場搜索 Obsidian 筆記 安裝。
從源碼安裝¶
克隆倉庫後，在插件目錄執行：
cd dsh-obsidian-notes
dsh plugin --profile desktop add .
也可在插件管理器中使用「安裝 bundle」，目標填克隆後目錄的絕對路徑。新安裝可熱加載；未生效時重啓一次應用。
運行環境要求（見 package.json）：Node >=20，DSH ^0.2.1-rc.1 || ^0.2.2-alpha.2。
配置¶
最省事的方式：打開 設置 → 筆記，點「選擇文件夾…」選定筆記文件夾，保存後工具立刻切換到新路徑。
細項在 設置 → 插件 → Obsidian 筆記 → 配置：
| 字段 | 默認值 | 含義 |
|---|---|---|
vault |
（空） | 筆記庫根目錄絕對路徑；未填時讀環境變量 OBSIDIAN_VAULT。 |
dailyFolder |
日記 |
日記子目錄（相對根目錄），留空表示根目錄。 |
sections |
["早上","下午","晚上"] |
日記分段時間標題，按當前小時選擇。 |
dateHeading |
true |
往普通筆記追加時自動加 #### 年/月/日 小標題。 |
readOnly |
false |
只註冊讀取類工具，永不寫入。 |
工具一覽¶
| 工具 | 作用 |
|---|---|
obsidian_append |
追加記錄：寫今天日記，或用 path 寫指定筆記；支持 done、important、date、section、heading。 |
obsidian_read |
按 path 或 date 讀筆記/日記；分頁參數 offset、maxLines。 |
obsidian_search |
整庫全文搜索。 |
obsidian_list |
按修改時間列出筆記，可限定目錄。 |
obsidian_mark_done |
按文字匹配劃掉/取消劃掉列表項。 |
obsidian_info |
查看筆記庫路徑、筆記數、頂層目錄、今天日記狀態與當前配置。 |
典型用法¶
以下表述可直接在對話裏使用（README 示例）：
- 「幫我把「讀完《設計心理學》第 3 章」記到今天的日記裏，標成完成」
- 「在 項目/讀書筆記 裏記一條：週四整理第三章」
- 「搜一下筆記裏所有提到「番茄鍾」的地方」
- 「把今天日記裏「清理收件箱」劃掉」
約定按中文個人筆記習慣設默認值，分段名、是否加日期小標題等均可改成適配你自己的庫。
適用場景與注意¶
適合誰：已在用 Obsidian 做 PKM、日記或項目筆記，又希望 DSH 對話裏用自然語言追加、搜索、勾選待辦，而不想維護單獨同步層。
權限與信任：插件以當前 DSH Host 進程權限讀寫本地文件。安裝前請閱讀源碼與 MIT 許可證；敏感筆記庫可先用 readOnly: true 試讀。
生態說明：DSH 社區插件目錄（如 SkillHub 上的條目頁）由社區維護，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-obsidian-notes（當前 package 版本 0.2.0）把 Obsidian 筆記庫接進 DSH 工具層：六類 obsidian_* 操作、可圖形化選庫、可只讀。
目錄頁：https://www.skillhub.cn/plugins/SuzukaWu/dsh-obsidian-notes
源碼與文檔：https://github.com/SuzukaWu/dsh-obsidian-notes
