Obsidian Wiki 基礎日常使用指南
Obsidian Wiki 基礎日常使用指南
這篇只說明 ar9av/obsidian-wiki 最基本的運作方式與日常怎麼用。
官方 Repo：https://github.com/ar9av/obsidian-wiki
中文好讀版：https://github.com/Ar9av/obsidian-wiki/blob/main/README_TW.md
1. Obsidian Wiki 是什麼？
obsidian-wiki 是一套讓 AI Agent 維護 Obsidian 知識庫的工作方式。
它的核心概念很簡單：
你在專案中學到東西
↓
AI Agent 幫你整理
↓
寫進 Obsidian Vault
↓
之後可以查詢、更新、連結
它不是單純把聊天紀錄塞進 Obsidian，而是把值得保留的知識整理成 Markdown 筆記，並用 [[wikilinks]] 互相連起來。
2. 它怎麼運作？
日常可以把它想成三層：
原始資料
例如專案程式碼、README、debug 紀錄、文件、對話
整理後的 Wiki
例如 concepts/、projects/、skills/、references/
查詢與維護
例如 wiki-query、wiki-update、wiki-ingest、wiki-status
AI Agent 的工作是：
- 讀懂目前的專案或資料。
- 判斷哪些內容值得留下。
- 更新或新增 Obsidian 筆記。
- 幫筆記補上相關連結。
- 維護
index.md、hot.md、log.md等索引與狀態檔。
Obsidian 的工作是：
- 讓你閱讀筆記。
- 讓你用 graph view 看連結。
- 讓你手動補充、修正、整理內容。
3. 第一次只需要做什麼？
通常只需要做一次 setup：
obsidian-wiki setup --vault /path/to/your/obsidian-vault
如果你是在 AI Agent 裡，也可以直接說：
set up my wiki
setup 之後，系統會知道你的 Obsidian Vault 在哪裡，後續指令都會寫入同一個 vault。
pip 安裝、PATH 設定與除錯的完整步驟見 obsidian-wiki 安裝與設定筆記。
4. 每天最常用的四個動作
4.1 把目前專案整理進 Wiki
在任一專案目錄中，對 Agent 說：
/wiki-update
適合用在：
- 完成一個 feature 後。
- 修完一個 bug 後。
- 做完一次架構調整後。
- 想把專案重點整理成長期知識時。
也可以加上明確要求：
/wiki-update
整理這個專案的架構、重要決策、踩坑紀錄與可重用模式。
4.2 查詢以前整理過的知識
在任何地方問：
/wiki-query 我以前怎麼處理登入 token refresh 的問題？
或：
/wiki-query 這個 vault 裡有哪些 Next.js 相關筆記？
它會從已整理的 Obsidian Wiki 中找答案，而不是只依賴當下聊天記憶。
4.3 匯入既有文件或筆記
如果你有一批 Markdown、文件或資料想整理進 wiki：
/wiki-ingest
建議一次處理一個明確範圍：
/wiki-ingest Tool
或：
/wiki-ingest 這份 README
重點是不要一次丟太多。先整理小範圍，確認品質，再擴大。
4.4 看目前 Wiki 狀態
想知道目前有哪些內容、哪些來源可能需要更新：
/wiki-status
適合用在：
- 想確認 wiki 是否有新內容。
- 想知道哪些資料還沒整理。
- 想檢查目前 vault 的健康狀態。
5. 一個最簡單的日常節奏
開始工作前
先查以前是否有相關經驗：
/wiki-query 以前處理過類似的問題嗎？
工作中
正常寫程式、debug、查資料，不需要一直操作 wiki。
工作完成後
整理這次值得留下的知識：
/wiki-update
整理這次工作的重點、決策、踩坑與下次可以重用的做法。
偶爾維護
更新索引與熱點摘要：
/daily-update
6. 什麼內容值得放進 Wiki？
值得放：
- 架構決策。
- Debug 流程。
- 重要 trade-off。
- 專案特有知識。
- 可重用的操作步驟。
- 常見錯誤與解法。
不太值得放：
- 一次性的聊天碎片。
- 完整程式碼貼文。
- 沒有結論的中途推理。
- 很快會過期的暫時資訊。
判斷原則：
下次遇到類似問題時，這份筆記會不會省下時間？
會，就值得整理。
7. 使用規則
/wiki-query
先問以前知道什麼。
/wiki-update
做完事情後，把新知識整理回去。
/wiki-ingest
有現成文件時，把它整理進 wiki。
/wiki-status
偶爾檢查 wiki 現況。
這樣就夠開始用了。
8. 進階功能（選用）
日常四個動作夠用之後，repo 裡還有幾個值得知道的進階能力：
- 多 vault 切換：用
@name前綴把單次指令指到別的 vault，例如@work update wiki或wiki-query @personal 我知道哪些關於 X 的事，不會改變預設 vault。 - 跨 Agent 歷史搜尋：
/wiki-claude、/wiki-codex、/wiki-hermes、/wiki-pi等指令可以針對特定主題去挖對應 Agent 的原始歷史記錄，直接整理成 wiki 頁面並回答問題；/memory-bridge diff則能比較不同 Agent 各自貢獻了什麼知識。 - provenance 標記：每個知識點會標記是 extracted（來源明講）、
^[inferred]（AI 推論）還是^[ambiguous]（來源矛盾），頁面 frontmatter 有provenance:統計區塊，wiki-lint會抓出推論過多的頁面。 - QMD 語意搜尋（選用）：預設用 Grep/Glob 就能運作，若裝了 QMD 並在
.env設定QMD_WIKI_COLLECTION/QMD_PAPERS_COLLECTION，wiki-query與wiki-ingest會多跑一輪語意搜尋，找到用詞不同但概念相關的頁面。 - 圖譜相關：
/wiki-export匯出成 JSON / GraphML / Neo4j / 互動網頁；graph-colorize（說「幫我上色圖譜」）依 tag、分類或 visibility 幫 Obsidian 的 graph view 上色。 - 瀏覽器擷取：repo 內建一個免安裝的 Chrome extension（
extensions/brain-capture/），可以把網頁或選取文字直接存進 vault 的_raw/，之後用/wiki-ingest整理成正式頁面。 - 其他維護型指令：
/wiki-dashboard（建立 Bases 動態儀表板）、/wiki-synthesize（找出概念間還沒補齊的連結）、/wiki-rebuild（封存重建整個 wiki）。