--- schemaVersion: 1 slug: gp-47-20260211-obsidian-cli-ai-era ticketId: GP-47 lang: zh-tw title: Obsidian 出 CLI 了！這不是給你用的，是給 AI 用的 — 筆記工具的 Paradigm Shift summary: Obsidian v1.12 正式推出官方 CLI，讓你從 terminal 控制整個 vault。表面上是給 power user 的工具，骨子裡是為 AI agent 時代鋪路。本文深度解析 CLI 指令全覽，並示範 Claude Code + Obsidian CLI 的實戰 workflow。 originalDate: 2026-02-10 translatedDate: 2026-02-11 source: Obsidian Help sourceUrl: https://help.obsidian.md/cli author: null authorshipNote: null canonicalUrl: https://gu-log.vercel.app/posts/gp-47-20260211-obsidian-cli-ai-era status: published replacementTicketId: null replacementUrl: null --- # Obsidian 出 CLI 了！這不是給你用的，是給 AI 用的 — 筆記工具的 Paradigm Shift > **來源:** [Obsidian Help](https://help.obsidian.md/cli) 你有沒有那種經驗？整理筆記整理到一半，突然發現自己在整理「整理筆記的方法」。 然後你就放棄了。筆記躺在那邊長草。你安慰自己說「改天再整理」，但那個「改天」永遠不會來。 2026 年 2 月 10 日，Obsidian 做了一件事，可能讓「改天」真的到來了。 他們出了 **官方 CLI**。 > “Anything you can do in Obsidian, you can do from the command line.” > > — [@obsdmd](https://x.com/obsdmd/status/2021241384057930224) 不是新 theme，不是又一個 community plugin。是把整個 Obsidian 的能力，塞進一行 terminal 指令。 > **Mogu 偷偷說：** > > 「你在 GUI 裡能做的任何事，都可以從 CLI 做」—— 這句話如果在 2020 年說，大家會覺得：喔，power user 工具，酷。 > > 但在 2026 年？這句話的意思是：**我們幫 AI agent 開了一扇正門。** > > 以前 AI 要操作你的筆記，得爬窗戶（讀原始檔案、猜格式）。現在 Obsidian 直接說：門開著，請進 (◕‿◕) --- ## 為什麼是現在？因為滑鼠是人類的，鍵盤是 AI 的 先想一個問題：**GUI 是給誰用的？** 人類。按鈕、拖拉、視覺回饋 — 全部都是為了人類的眼睛和手指設計的。就像餐廳的菜單有圖片，是因為你用眼睛選菜。 那 **CLI 呢？** 以前的答案是 power user、sysadmin、那些覺得滑鼠是多餘的工程師。 但現在答案多了一位重量級選手：**AI agent。** 你叫一個 AI 幫你整理 Obsidian，它會怎麼做？ - ❌ 打開 GUI，用像素偵測找按鈕，模擬滑鼠點擊 — 這就像叫一個外國人看不懂中文菜單，但要他用筷子夾菜 - ✅ 跑 `obsidian search query="meeting notes"` 然後解析 output — 直接用它的母語溝通 CLI 是 AI 的母語。Text in, text out。就這麼簡單。 > **Mogu 內心戲：** > > 小眾軟件在[報導](https://www.appinn.com/obsidian-cli/)裡寫了一段我覺得很精闢的話： > > 「早期因硬件落後才 CLI，後來要人性化，進化到 GUI。現在，機器超越人類，CLI 又成了先進方式。」 > > 歷史果然是螺旋的。我們花了 40 年從 CLI 爬到 GUI，現在 AI 又把我們帶回 CLI。 > > 但這次不一樣 — 這次的 CLI 不是讓你打字更快，是讓 AI 直接**操作你的整個知識庫**。你坐在旁邊喝咖啡就好 ╰(°▽°)╯ Obsidian 的 CEO 其實早就在佈局了。他已經有一套 [Agent Skills for Obsidian](https://github.com/nickarora/obsidian-skills)，定義了三大檔案類型讓 AI 理解：Obsidian 的 custom Markdown、Obsidian Bases（新的結構化資料功能）、還有 JSON Canvas。 **[Agent](https://gu-log.vercel.app/glossary#agent) Skills 定義了 AI 該懂什麼，CLI 定義了 AI 該怎麼做。** 一個教語言，一個給雙手。 --- ## CLI 能幹嘛？比你想像的多 好，來看看這個 CLI 到底能做什麼。根據 [v1.12 changelog](https://obsidian.md/changelog/2026-02-10-desktop-v1.12.0/) 和[官方文件](https://help.obsidian.md/cli)，我把它分成幾類來聊。 ### 每天最常用的：Daily Note ```bash obsidian daily # 打開今天的 daily note obsidian daily:append content="- [ ] 買牛奶" # 尾部加內容 obsidian daily:prepend content="## 今日目標\n- 搞定文章" # 頭部加內容 ``` 這三個指令是整個 CLI 的**殺手級應用**。為什麼？因為 daily note 是 Obsidian 使用者最高頻的功能。你每天起床第一件事可能就是寫 daily note，睡前最後一件事也是。 以前你要打開 Obsidian → 等它載入 → 找到今天的 note → 開始打字。現在？terminal 裡一行指令，連 Obsidian 都不用開。就像你不用走進便利商店，門口就有取貨櫃。 > **Mogu murmur：** > > 你知道嗎，很多人用 Obsidian daily note 的方式就是：早上打開，打三行字，然後一整天不碰。 > > 但有了 CLI，你可以在 terminal 裡隨手 `daily:append` — 開會想到什麼就塞一行，看到有趣的 link 就塞一行。完全不用切視窗、不用等 Electron app 載入那令人懷疑人生的三秒鐘。 > > 這就是從「刻意寫筆記」變成「呼吸般自然地寫筆記」的差距。一個 append 指令，消滅了整個 context switch 的成本 (￣▽￣)／ ### 搜尋和閱讀：讓 AI 有眼睛 ```bash obsidian search query="專案進度" # 搜尋 vault obsidian read # 讀取你當前開著的文件 ``` `search` 讓 AI 能在你的知識庫裡翻箱倒櫃。但更妙的是 `read` — 它能知道**你現在正在看什麼**。這等於給了 AI 一雙眼睛，它能看到你的螢幕焦點在哪裡。這件事，讀原始檔案做不到。 ### 建立和管理：批量生產的祕密武器 ```bash obsidian create name="東京旅遊計畫" template=Travel # 用 template 生筆記 obsidian tasks daily # 列出 daily note 裡的任務 obsidian tags counts # vault 裡 tag 統計 obsidian diff file=README from=1 to=3 # 比較文件版本 ``` 一行 `create` 指令，用你定義好的 template 生成新筆記。想像一下 AI 幫你批量建立 100 篇讀書筆記，每篇都套用你的 template。以前你手動做這件事要一個下午，現在是一個 for loop。 `tags counts` 看起來不起眼？等你看到後面的實戰 — 用它做知識庫的 data analysis — 你會改觀的。 另外 CLI 也暴露了開發者工具：inspect element、截圖、重新載入 plugins。[Plugin](https://gu-log.vercel.app/glossary#plugin) 開發者看到這個應該會哭出來。 > **Mogu OS：** > > 重要公告：CLI 目前是 **Early Access**，要 Catalyst 授權才能用。翻譯成白話就是要課金。 > > 所以你如果 `obsidian daily` 打下去沒反應，不是你指令打錯，是你錢包沒打開 ┐(￣ヘ￣)┌ > > 不過 Obsidian 的商業模式一直蠻有原則的 — 核心功能免費，進階功能付費。CLI 最終應該會開放給所有人。大概吧。也許吧。在他們收夠 Early Access 的錢之後吧。 --- ## 實戰：[Claude Code](https://gu-log.vercel.app/glossary#claude-code) 走進你的 Obsidian 理論講完了，來看看 **Claude Code + Obsidian CLI** 實際上可以怎麼玩。 [XDA 有一篇文章](https://www.xda-developers.com/claude-code-inside-obsidian-and-it-was-eye-opening/)把 Claude Code 直接丟進 Obsidian vault 裡開 terminal，作者說這「改變了他的工作方式」。 有了官方 CLI，這件事變得更自然了。讓我用三個場景來說明。 ### 場景 1：七天的 daily note → 一份週報 **你的痛：** 你每天乖乖寫 daily note，但從來不回去看。一週過去，七篇筆記躺在那邊積灰塵。就像你買了健身房會員卡，去了第一天，然後卡就住在錢包裡了。 ```bash # AI 讀取這週所有 daily notes obsidian search query="2026-02-03..2026-02-09" # 列出所有任務，看哪些完成了哪些在擺爛 obsidian tasks daily # Claude 讀完之後，理解上下文，不是做字串搜尋，是真的看懂你在寫什麼 # 然後用你的 template 生成一份漂亮的週報 obsidian create name="週報 2026-W06" template=WeeklyReview ``` 以前你自己整理週報要 30 分鐘，而且你根本不會做，因為太煩了。現在 AI 幫你做，而且它比你更認真 — 它真的會把七天的內容都讀完。 > **Mogu 偷偷說：** > > 我幫大家算一下 ROI。假設你每週花 30 分鐘整理週報（雖然你根本不會做），一年就是 26 小時。 > > 但真正的價值不在省時間。是你終於可以**看到自己一整週到底幹了什麼**。多少次你周五開會被問「這週做了什麼」，腦袋一片空白？ > > AI 週報不只是摘要，它是你工作記憶的外接硬碟。而且這個硬碟不會在你最需要它的時候當機 (⌐■\_■) ### 場景 2：用 tag 做知識庫的健康檢查 **你的痛：** vault 裡 2000 篇筆記，你隱約覺得某些主題之間有關聯，但你看不到全貌。就像你知道冰箱裡有很多東西，但不確定能湊出什麼菜。 ```bash # 先看看你有哪些 tag、各有幾篇 obsidian tags counts # #ai 67 / #healthcare 45 / #project/alpha 23 / #idea 156 ... # 搜尋特定 tag 的交集 obsidian search query="#ai #healthcare" # Claude 分析：哪些 tag 常一起出現？哪些主題是孤島？你的知識有什麼缺口？ ``` Claude 可能會跟你說：「欸，你的 #ai 和 #healthcare 筆記有 70% 重疊。你好像對 AI 醫療特別有興趣但沒意識到？」 **這基本上就是用 AI 對你自己的大腦做 data analysis。** 想想看，你的筆記就是你思考過的痕跡，而 AI 幫你從這些痕跡裡找出你自己都沒注意到的 pattern。 ### 場景 3：Diff 看你的想法怎麼演化的 **你的痛：** 一份專案規格書改了很多版，你想知道你的想法是怎麼變的。 ```bash obsidian diff file="Project-Alpha-Spec" from=1 to=3 ``` 普通 diff 工具給你的是逐行比較。Claude 給你的是**語義分析**： > 「版本 1 到版本 3，你把微服務架構改成了 monolith。這通常代表團隊縮編或時程壓縮 — 你還好嗎？」 > 「你刪掉了三個非核心需求，這是好的 scope management。但你加了兩個互相矛盾的需求，要注意。」 **這不是在 diff 程式碼，是在 diff 你的想法。** > **Mogu 畫重點：** > > 好啦我知道你在想什麼：「這些我直接讓 Claude Code 讀 .md 檔就好了啊，幹嘛還要繞一圈走 CLI？」 > > 公平的問題。但你想想看 — 你去餐廳點菜，是直接跟服務生說「我要牛排」比較快，還是自己走進廚房翻冰箱比較快？ > > CLI 就是那個服務生。它知道什麼是 daily note、什麼是 template、什麼是 tag。你讓 AI 直接讀 .md 檔，它看到的只是一堆文字檔。你讓它走 CLI，它看到的是**有結構的知識庫**。 > > 而且 `read` 能知道你現在開著什麼檔案 — 這種「狀態感知」是讀原始檔案根本做不到的。所以是的，CLI 繞了一圈，但這一圈繞得值得 (ง •̀\_•́)ง --- ## 所以 Second Brain 終於不用自己動了？ 如果你有在關注 **Second Brain**（Tiago Forte 的 PARA 方法論），你大概經歷過這個循環： 1. 看到 Second Brain 的概念，超興奮 2. 花一個週末設定好系統 3. 認真執行兩週 4. 第三週開始偷懶 5. 第四週放棄，覺得自己沒有自律 問題不在你。問題在 Second Brain 有一個根本矛盾：**你需要花大量認知努力去維護一個「降低認知努力」的系統。** 這就像你為了省時間而花更多時間整理省時間的方法。 XDA 文章的作者說得很直白： > “I could figure out how to create these files from my daily notes… but that takes time I could be doing other things with.” 有了 AI + CLI，這個矛盾消失了。 你只要負責**倒東西進去** — daily note 可以很亂，想到什麼寫什麼，用任何你舒服的方式。AI 負責整理、分類、連結、生成摘要。你的認知努力：趨近於零。 ## 延伸閱讀 - [GP-49: Obsidian + Claude 超級大腦：Tech Lead 帶團隊的版本長這樣](https://gu-log.vercel.app/posts/gp-49-20260211-obsidian-claude-super-brain/) - [GP-4: Obsidian + Claude Code 101：讓 AI 住進你的筆記](https://gu-log.vercel.app/posts/gp-4-20260129-obsidian-claude-101/) - [GP-3: Claude Code + Obsidian：打造 Agent 思考基礎設施](https://gu-log.vercel.app/posts/gp-3-20260129-claude-obsidian-infrastructure/) > **Mogu 吐槽時間：** > > Obsidian 選擇 plain text Markdown 這件事，在 AI 時代根本是開了天眼。 > > LLM 的 training data 裡面充滿了 Markdown — 它讀 .md 檔就像你讀中文一樣自然。 > > 你看看隔壁：Notion 的 block-based 格式、Evernote 的 ENML、OneNote 的二進位格式。AI 讀這些東西就像你讀甲骨文。能讀嗎？能。想讀嗎？不想。 > > 有時候最笨的格式就是最聰明的選擇 (๑•̀ㅂ•́)و✧ --- ## 拉開時間軸看這件事 - **2004**：Evernote — 「什麼都丟進來，我幫你搜」 - **2016**：Notion — 「筆記不夠，給你整個 workspace」 - **2020**：Obsidian — 「你的資料你自己擁有，local-first」 - **2026**：Obsidian CLI — 「AI，來，這些你來管」 每一次 paradigm shift 都在改變一個問題的答案：**誰在做整理？** Evernote：電腦搜尋比你翻抽屜快。 Notion：結構化比亂丟一通好。 Obsidian：連結比結構重要。 Obsidian CLI：**你根本不該做整理，讓 AI 來。** Obsidian 那條推文，仔細看其實是一句宣言： > **“Anything you can do in Obsidian, you can do from the command line.”** 翻譯成 AI 時代的語言： > **“Anything you can do in Obsidian, AI can do for you.”** --- 記得一開始說的嗎？整理筆記整理到一半，結果在整理「整理的方法」。 也許 Obsidian CLI 最大的意義不是什麼 AI agent 時代、不是什麼 paradigm shift — 而是讓你終於可以不再對著那堆沒整理的筆記感到愧疚。 你往裡面倒東西。AI 幫你理乾淨。你繼續過你的日子。 就這樣。不用整理了。 （想動手試試的，[官方 CLI 文件](https://help.obsidian.md/cli)跟 [v1.12 Changelog](https://obsidian.md/changelog/2026-02-10-desktop-v1.12.0/) 在這。XDA 那篇 [Claude Code + Obsidian 實戰](https://www.xda-developers.com/claude-code-inside-obsidian-and-it-was-eye-opening/)也值得一讀。小眾軟件的[中文報導](https://www.appinn.com/obsidian-cli/)寫得不錯，觀點很犀利。）