# 用 AI 協作把 Joplin 筆記流程做成 CLI：從切換桌面到單一 VS Code 視窗的知識管理工作流

By [雞蛋糕的前端修煉屋](https://paragraph.com/@gcake) · 2026-02-16

---

我最近完成並發佈了一個小專案：把日常開發學習的筆記流程，收斂成三個指令（`learn / til / weekly`），讓「寫 Markdown → 一鍵產生筆記 → 自動同步」在終端機完成。整個腳本開發過程幾乎採用 vibe coding 節奏：先跑起來、再重構、邊用邊修，把體感摩擦降到最低。

靈感：Threads 上的 AI + Markdown 知識管理
--------------------------------

起點很單純：我在 Threads 看到有人分享「用 AI 協作 + Markdown 格式筆記」來做知識管理的做法，強調的是可累積、可搜尋、可重用。那一刻我意識到，我平常已經在用 VS Code、Copilot、Perplexity 來加速開發了，卻還在用相對原始的方式記錄與沉澱知識；如果能把這兩條流程（開發與筆記）再黏緊一點，長期效益會非常大。

痛點：從切換視窗到單一視窗
-------------

我過去的流程大概經歷了三個階段：

1.  **第一階段**：寫到一半要記筆記，就切換視窗、切換 macOS 桌面、把內容貼進筆記工具。
    
2.  **第二階段**：開始刻意降低滑鼠依賴，練習用鍵盤快速鍵操作，讓「開發」跟「記錄」切換更快，但仍然有上下文切換的成本。
    
3.  **第三階段（這次）**：目標是「單一 VS Code 視窗完成整個流程」，終端機直接產生筆記到指定筆記本，並把格式做成一致的 Markdown 模板。
    

要解的其實不是技術難題，而是日常流程裡那些看似微小、累積起來很可觀的摩擦。

技術選擇：為什麼最終選擇全 CLI 方案
--------------------

一開始我想過用 **Joplin API + VS Code 的 Joplin 套件**混合使用，因為理論上這樣可以直接在 VS Code 裡操作筆記。

但實測後發現：

*   **API 產生的筆記只有標題，內容為空**
    
*   **筆記不屬於任何筆記本**，會散落在根目錄
    
*   **混合使用 API 與 CLI 時會有同步衝突**，無法確保一致性
    

嘗試了幾種組合後，我發現只有 **全 CLI 方案** 才能真正做到：

*   ✅ 筆記內容完整寫入
    
*   ✅ 正確進入指定筆記本
    
*   ✅ 自動同步不衝突
    
*   ✅ 完全自動化的工作流
    

這個「踩坑→試錯→收斂」的過程其實很典型：最簡單、最穩定的方案，往往是最原生、最直接的那一條路。

Joplin 本身就提供終端機版本，能用 `mkbook` 建筆記本、`use` 切筆記本、`mknote` 建筆記、`set` 寫入內容等指令直接操作資料結構，這讓「腳本化筆記」變得可行且乾淨。 [joplinapp](https://joplinapp.org/help/apps/terminal/) 另外，Joplin 對 Markdown 的支援很完整，並且可以同時顯示 Markdown 原文與渲染後的內容，這正好符合我想用純文字累積知識的方向。 [joplinapp](https://joplinapp.org/help/apps/markdown/)

解法：把筆記流程變成指令
------------

因此我把常用場景收斂成三個命令：

*   `learn "標題"`：建立一篇「學習文章／長文整理」到指定筆記本（例如 post/Blog）。
    
*   `til "概念"`：把「Today I Learned」以固定格式追加到當天的每日筆記（不存在就自動建立）。
    
*   `weekly "週報標題"`：自動計算當週日期範圍，產生週回顧模板（統計、下週計畫、反思）。
    

內容來源則統一從剪貼簿讀取：我在 VS Code 寫好 Markdown（或請 AI 協作整理）後複製，接著只要下一條指令就能落到正確的筆記本與格式中。

開發過程：vibe coding 的迭代節奏
----------------------

這個專案很適合用 vibe coding 的方式推進，因為需求非常「使用者體感導向」：只要覺得卡，就回來改腳本；只要覺得順，就立刻固定成模板。

整體節奏大概是：

1.  **先做出能跑的版本**：能成功產生筆記、寫入內容、同步。
    
2.  **再做一致性與可維護性**：把 `learn / til / weekly` 全面重構成同一套配置檔讀取、`--help` 說明、錯誤訊息、Debug 模式、跨平台日期處理。
    
3.  **最後才做「可發佈」**：驗證腳本語法、確認權限、完成 commit、補齊文件與安裝流程、加入 MIT 授權，讓別人 clone 後就能用。
    

我也用實際的端到端輸出來驗證：三個指令都成功回報 Note ID、正確進到指定筆記本，並完成同步；這種「每次改完就用真實流程跑一次」的回饋速度，是這次能很快打磨到順手的關鍵。

實際效果：從三步驟到一步驟
-------------

改善前的流程：

    1. 在 VS Code 寫 Markdown
    2. 切換到 Joplin Desktop（Command + Tab / 切換桌面）
    3. 找到正確筆記本
    4. 新增筆記
    5. 貼上內容
    6. 加標籤、設定格式
    7. 等待同步
    8. 切回 VS Code 繼續開發
    

改善後的流程：

    1. 在 VS Code 寫 Markdown → pbcopy
    2. 終端機執行：til "概念名稱"
       ✅ 自動建立/追加到今日筆記
       ✅ 自動進入正確筆記本
       ✅ 自動套用格式與標籤
       ✅ 自動同步
    3. 繼續開發
    

**上下文切換從 8 步降到 2 步，而且完全不離開 VS Code 視窗。**

推廣：適合誰、怎麼開始
-----------

如果你符合其中一個狀況，這套流程特別值得試：

*   你本來就以 **VS Code + Terminal** 為主工作環境，想把知識管理變成「開發流程的一部分」。
    
*   你討厭記筆記時的**上下文切換**，但又不想降低筆記品質與一致性。
    
*   你想把 **AI 協作產出的內容**（摘要、重構、重點整理）快速沉澱成可搜尋、可回顧的 Markdown 筆記。
    
*   你正在用或想試用 **Joplin** 做為主力筆記工具，並希望透過 CLI 提升效率。
    

### 最小可行的使用方式

    # 1. 安裝（一行指令）
    curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/joplin-dev-workflow/main/install.sh | bash
    
    # 2. 在 VS Code 寫好一段 Markdown → 複製到剪貼簿
    echo "Promise.allSettled() 不會因為單一失敗而中斷" | pbcopy
    
    # 3. 執行指令
    til "Promise.allSettled() 特性"
    
    # 4. 打開 Joplin → 筆記已經在正確位置、帶著一致格式 ✅
    

未來規劃：從手動複製到全自動生成
----------------

目前的版本採用 **剪貼簿工作流**：需要先寫好或整理好內容，再複製並執行指令。

但這只是第一步。

等我學習了更多 AI 工具與整合技術後，下一階段想嘗試的是：

### 🔮 自動掃描 + AI 生成技術筆記

讓系統自動掃描以下來源：

*   **Git commit 記錄**：分析 commit message、diff、新增/修改的檔案
    
*   **既有筆記內容**：從 Joplin 筆記庫中抓取相關脈絡與關鍵字
    
*   **Copilot 對話記錄**：提取開發過程中與 AI 的技術討論
    

然後自動生成「技術筆記初稿」，只需要：

1.  **審稿**：檢查 AI 生成的內容是否準確
    
2.  **編輯**：補充脈絡、調整結構、加入個人見解
    
3.  **發佈**：一鍵同步到 Joplin
    

### 為什麼這很重要？

現在我會在 Perplexity、Copilot、Claude 等多個 AI 對話中反覆討論同一個技術問題，每次都要「下指令 → 得到回應 → 整理成筆記」。

如果能讓系統自動整合這些對話、commit、既有筆記，產出結構化的技術筆記初稿，我就可以把時間花在「思考與驗證」而非「複製貼上與格式整理」。

這會是一個更接近「AI 協作知識管理」終極形態的實驗。

### 技術挑戰

*   如何從 Copilot/Cursor 等工具提取對話記錄？
    
*   如何解析 Git commit 並關聯到技術脈絡？
    
*   如何用 LLM 整合多個來源並產生結構化筆記？
    
*   如何設計「審稿介面」讓人類快速確認與編輯？
    

目前還在探索階段，但這是我希望這個專案演進的方向。

**如果你對這個方向有興趣、有經驗或有建議，非常歡迎交流！**

開放與協作
-----

專案已發佈在 GitHub，採用 MIT License，歡迎使用、修改、提 issue 或 PR：

🔗 **GitHub Repository**: `https://github.com/gcake119/joplin-dev-workflow`

如果你也在思考如何降低「開發與知識管理之間的摩擦」，或對這套流程有任何建議與改進想法，非常歡迎交流！

* * *

**寫於 2026.02.16，使用 Perplexity + VS Code + Joplin CLI 完成全文，並透過** `learn` **一鍵產生為筆記。** 🚀

* * *

---

*Originally published on [雞蛋糕的前端修煉屋](https://paragraph.com/@gcake/joplin-dev-workflow)*