obsidian 是做什麼的?
用於處理本機 Obsidian 知識庫。Obsidian 知識庫是一個包含 Markdown 檔案及 .obsidian/ 設定的一般資料夾。
來源
- 應用程式設定檔:
~/Library/Application Support/obsidian/obsidian.json - 預設知識庫名稱:
obsidian - 常見的本機知識庫路徑:
~/obsidian - 官方 CLI:
obsidian - 知識庫指令會從目前工作目錄解析知識庫;請在
~/obsidian目錄下執行。
初步檢查
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
全域指令如 version 和 vaults 可在知識庫外運作。知識庫內容指令若在 ~/obsidian 之外執行,可能會顯示 Vault not found.。請使用 obsidian commands 而非 obsidian help 來探索 CLI 功能。
如果 obsidian 顯示 CLI 已停用:
- 先請使用者啟用設定 -> 一般 -> 進階 -> 命令列介面。
- 若你已確認應用程式設定檔結構,
~/Library/Application Support/obsidian/obsidian.json中應包含"cli": true。 - 更改應用程式層級的 CLI 設定後,請重新啟動 Obsidian。
讀取工作流程
建議使用官方 CLI 進行具 Obsidian 感知的查詢:
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json
當你已經知道路徑且需要精確的位元組內容時,可直接讀取檔案系統:
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"
當資料的新鮮度或知識庫選擇很重要時,請回報你使用了哪個來源。
寫入工作流程
選擇影響範圍最小的寫入路徑:
- 新增筆記:
obsidian create path="Folder/Note.md" content="..."。 - 附加/前置內容到每日筆記:
obsidian daily:append content="..."。 - 簡單的筆記編輯:在 Markdown 檔案上使用
apply_patch。 - 重新命名/移動筆記:建議使用
obsidian move path="Old.md" to="Folder/New.md",以便連結能自動更新。 - 寫入後開啟 UI:僅在有用或使用者要求時才加上
open。
常用指令:
cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- 後續事項"
對於多行內容,建議在知道路徑後,直接使用 apply_patch 編輯 .md 檔案。避免為了長篇文字而使用不必要的 shell 引號。
Bases、Canvas、外掛
先使用 CLI 探索:
cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
對於 .canvas、.base 和 .json 檔案,盡可能以結構化資料讀取/編輯。編輯後請保持格式穩定並驗證 JSON。
安全事項
- 請勿大量改寫知識庫。應使用精確的路徑並檢視差異。
- 除非使用者要求或任務明確與設定/外掛相關,否則請勿編輯
.obsidian/。 - 除非明確要求,否則請勿刪除筆記;建議使用垃圾桶而非永久刪除。
- 請勿透過 Obsidian URI/CLI 路徑建立隱藏的點開頭資料夾筆記。
- 除非任務是要重構 frontmatter 和 wikilink,否則請保留它們。
- 若有多個知識庫,請勿猜測;請使用
obsidian vaults和obsidian.json。