前言¶
DeepSeek Harness（DSH）採用插件化架構，支持通過插件擴展智能體的能力。在開發場景中，智能體通常運行在 WSL 環境下，而本地文件系統（如 Windows 上的 Obsidian 倉庫）屬於 Windows 系統資源。dsh-wsl-obsidian 插件解決了這一跨環境調用問題，使 WSL 中的 DSH Agent 能夠直接操作 Windows 端的 Obsidian 倉庫。
插件定位¶
該插件是 DeepSeek Harness 生態中的一個獨立工具，由開發者 173787247 維護，開源協議爲 MIT。它作爲 dsh-wsl-kit 套件的可選組件，默認未包含在標準安裝腳本中。
核心能力¶
插件提供了以下功能模塊，用於在 WSL 環境中控制 Windows 的 Obsidian：
- obsidian_status：解析倉庫路徑，確認路徑類型，並定位
Obsidian.exe的位置。 - obsidian_list：列出倉庫中的所有 Markdown 文件。
- obsidian_search：在倉庫中進行不區分大小寫的子字符串搜索。
- obsidian_read：讀取指定筆記的內容。
- obsidian_write：創建新筆記或覆蓋現有筆記。
- obsidian_append：向現有筆記追加內容。
- obsidian_open：通過 PowerShell 調用 Windows 的
obsidian://open協議打開筆記（僅支持 WSL）。
前置條件與注意事項¶
- 環境要求：需要安裝 DeepSeek Harness 版本
>= 0.1.2。 - 路徑限制：所有文件路徑必須是相對於倉庫的（例如
Inbox/Note.md），插件拒絕絕對路徑或包含../的相對路徑。 - 文件系統限制：倉庫必須存儲在 Windows NTFS 文件系統上（如
C:\或D:\）。如果在 WSL 中掛載倉庫（如\\wsl$\...），會破壞 Obsidian 的文件監聽機制。 - 配置回退：如果未配置
vaultPath，插件會嘗試通過/mnt/c/.../AppData/Roaming/obsidian/obsidian.json讀取 Windows 端的默認倉庫配置。
安裝與啓用¶
插件默認不在安裝腳本中，需手動添加。執行以下命令進行安裝：
dsh plugin --profile web add github:173787247/dsh-wsl-obsidian
安裝完成後，重啓 dsh web 並開啓一個新會話，即可在工具列表中看到 obsidian_* 系列指令。
配置示例¶
在 DSH 的配置文件中添加以下片段以啓用插件並指定倉庫路徑：
- id: dsh-wsl-obsidian
name: dsh-wsl-obsidian
config:
enabled: true
vaultPath: "/mnt/d/Notes/MyVault"
vaultName: "MyVault"
timeoutMs: 20000
說明：
vaultPath建議直接填寫 WSL 中訪問 Windows 分區的路徑（如/mnt/d/...），插件會自動處理路徑轉換。
佈局建議¶
爲確保最佳兼容性，建議按以下步驟搭建環境：
- 在 Windows 上安裝 Obsidian 桌面應用。
- 在
C:或D:盤創建或打開倉庫（不要將倉庫建在 Linux 發行版所在的磁盤分區）。 - 在 WSL 中通過
/mnt/c/...或/mnt/d/...訪問該倉庫路徑，並在配置中填寫對應的 WSL 路徑。
結語¶
dsh-wsl-obsidian 提供了從 WSL 環境直接讀寫 Windows Obsidian 倉庫的能力。對於需要在本地知識庫中進行自動化操作的 DSH Agent 開發者，這是一個必要的連接工具。
