← PKM 教學

PKM 第 4 講:我的筆記庫怎麼建起來,步驟、外掛和踩過的坑

發布 2026-11-01・更新 2026-11-02・約 7 分鐘讀完

這一講講我的筆記庫怎麼一步步建起來:先做什麼、後做什麼,裝了哪些外掛,AI 每次幫我整理一份資料時做了哪些事,還有踩過的坑。最後是給你的最小起步版。四種整理方法本身,看第 1 講;整套系統長什麼樣子、AI 助理怎麼分工,看第 3 講。

內容寫到 2026-10-24 為止。課堂約 30~40 分鐘;最後的「最小起步版」可以當課堂練習。

先講結論

Obsidian 是一套筆記軟體,它把放筆記的資料夾叫做 vault。我的 vault 是半年裡邊用邊長出來的,沒有一開始就設計好。

第一天只有幾個資料夾,加上一份寫給 AI 看的說明書。之後每踩一次坑,就多一條規則,或多一支自動檢查的小工具。

建置時間線

  1. 骨架(第一週)
  2. 2026-04-26建好 vault,寫好給 AI 看的說明書
    搭出 wiki 區的骨架(AI 整理出來的頁面放這裡)
  3. 2026-04-27概念頁改成照「領域/類型」分兩層資料夾放
    92 頁一次搬完
  4. 2026-04-28開始寫每日日誌
  5. 規矩(第一個月)
  6. 2026-05-02AI 寫檔之前,先給我看
  7. 2026-05-03用 Quartz(把筆記轉成網站的工具)做的公開網站上線
  8. 2026-05-06收件匣只留一個
  9. 2026-05-07原始檔照 PARA 四個櫃子歸位
  10. 2026-05-08規則拆成獨立的檔案
  11. 2026-05-11git(保存每一個版本、隨時能退回的工具)只在一台電腦上用
  12. 2026-05-128 個 wiki 技能定版
  13. 成熟(之後)
  14. 2026-08-11AI 每次開工不再全部讀一遍,看這次要做什麼,只讀需要的
  15. 2026-09-19筆記範本收進「資源」資料夾
    停用公開網站的部署
  16. 2026-10-22整個 vault 的圖表統一配色
  17. 2026-10-23每台裝置的設定各放一份
    最外層資料夾只准放清單上的東西(白名單)
    名詞對照表合併成一份
  18. 2026-10-24附件改用分類資料夾放

上課可以強調:時間線上的每一步,都是先遇到問題,才加規則。例如 05-02 的「寫檔前先給我看」,是因為 AI 寫錯以後再修,比事先看一眼麻煩得多。

工具與外掛

外掛是幫 Obsidian 多加功能的擴充程式。先說 Obsidian 本身:桌機、iPad、iPhone 都有裝,vault 放在 iCloud 上,幾台裝置之間自動同步。

外掛(桌機 12 個) 用來做什麼 新手需要嗎
Dataview 寫一小段查詢,自動列出清單、做成總覽頁,例如最近更新的頁、還沒審的草稿、沒有任何頁面連到的孤兒頁 必裝
Templater 套用範本,例如每日筆記、會議紀錄 建議裝
Omnisearch 搜尋所有筆記的內文。要搜 PDF 和圖片裡的字,另外裝 Text Extractor 建議裝
Tasks 把散在各頁的待辦事項集中起來看 有在記待辦再裝
Calendar 側邊放一個月曆,點日期就打開那天的筆記 選用
QuickAdd 按一下,就把新筆記放到指定的位置 選用
Meta Bind 在筆記裡放按鈕、輸入框 選用
PDF++ 在 PDF 上畫重點、引用到筆記裡 讀很多 PDF 再裝
Excalidraw 手繪白板 選用
Auto Embed 貼上網址,自動把內容嵌進筆記 選用
File Color、Iconize 幫資料夾上色、加小圖示 純粹好看
  • 手機只裝 4 個:Dataview、Meta Bind、QuickAdd、File Color。手機主要拿來看,還有快速記一下,裝太多會變慢。
  • 外觀:自己加了兩段樣式設定(CSS)。一段讓表格多的頁面版面放寬,一段讓圖表統一用深色配色。
  • 收集:瀏覽器裝了 Obsidian Web Clipper(一鍵把網頁存成筆記的瀏覽器擴充功能),做了三個範本:一般網頁、YouTube、GitHub,存下來的全部進收件匣。範本改過以後,要在瀏覽器裡重新匯入一次。
  • AI:用 Claude Code(可以直接讀寫電腦裡檔案的 AI 工具),加上我把 Karpathy 的做法打包成的 wiki 技能。技能就是教 AI 照固定步驟做某件事的說明,我的有這幾個:把資料收進來整理、健康檢查、查詢、修補、把長文拆成概念頁、審草稿、把 YouTube 影片轉成報告。原本還有一個「同步到 Notion」,用起來不順手,2026-10-24 停用。

AI 整理一份資料時,做了哪些事

這是整個 vault 最核心的動作,英文叫 ingest,意思是把資料收進來整理。我只要說一句「處理收件匣裡的 X」,AI 就會照下面三段做:

一次整理的流程:① 先看清楚(讀原始檔、判斷是什麼樣的資料;英文資料和網頁剪報先另做一份報告,附上查證表)→ 給我看打算拆成哪些概念 → ② 編譯成概念頁(每個概念建一頁、互相連起來、圖片下載到自己電腦)→ ③ 收尾(更新地圖和頁數統計、寫日誌、原始檔照 PARA 歸位)

每個概念頁的最上面,都有一段固定格式的欄位(技術上叫 frontmatter,Obsidian 叫它屬性)。AI 和 Dataview 都靠它來分類、篩選:

---
title: "累進式摘要"
domain: productivity      # 領域:一個主題只開一個,不開同義詞
type: pattern             # 類型:固定 8 種(流程、概念、角色、文件、技巧、系統、規則、人物)
status: draft             # 草稿 → 已審(人批准)→ 過時
source:
  - "[[原始檔名]]"        # 來自哪份原文
created: 2026-04-27
updated: 2026-04-27
---

為什麼類型只准 8 種:類型是給程式篩選用的。只要開了「不好歸類就開一個新類型」的先例,它就變成另一套標籤,查詢和檢查會一起失靈。

從零開始的步驟

步 做什麼 我花多久穩定下來
1 建 vault,開這幾個資料夾:00-Inbox(收件匣)、10-Notes~50-Archive(照 PARA 分的櫃子)、wiki(放 AI 整理出來的頁面)、Attachments(附件) 第一天
2 寫一份給 AI 看的說明書(檔名叫 CLAUDE.md):資料夾怎麼分、哪些不能改、整理的步驟、改東西之前要先問我。其他 AI 工具(Codex、Gemini)的說明書只寫一句「去讀 CLAUDE.md」,這樣規則只有一份 第一天先寫出大概,之後一直加
3 裝 Dataview、Templater,做一個首頁,列出每個領域有幾頁、最近更新了什麼、哪些草稿還沒審 第一週
4 裝 Web Clipper,範本全部設定成存進收件匣 第二週
5 每天收一點,讓 AI 整理一點。每次都先看它打算怎麼做,再讓它寫 到現在都是
6 加上健康檢查:找出孤兒頁、點了會失效的壞連結、被提到但還沒寫的概念,最後算一個 0~100 的分數 第二週
7 多台裝置:內容用 iCloud 同步;git 只在一台電腦上用,也不放在雲端同步的資料夾裡 第三週
8 加上自動檢查:AI 寫完檔就檢查格式、收工時掃一遍有沒有同步衝突、開工時檢查設定是不是落後了 第二個月起
9 (進階)一直開著待命的 AI 助理、排好時間讓它晚上自動整理、用手機問它問題 第五個月起

踩過的坑

坑 發生什麼 學到什麼
檢查工具只看最外面一層資料夾 一次漏掉 95 頁,健康分數是假的 會掃資料夾的工具,一定要一路掃到最裡面
中文檔名在 Mac 上,電腦內部存的方式不一樣 看起來一樣的檔名,程式比對時卻對不上 比對檔名之前,先把編碼統一(Unicode 正規化)
Windows 預設的文字編碼不是 UTF-8 小工具在 Mac 上好好的,拿到 Windows 中文全變亂碼 讀寫檔案一律指定 UTF-8。在一種系統上驗過,不代表換一種也沒問題
iCloud 同步衝突 冒出一大堆「檔名 2.md」這種副本,最多一次清掉 3,083 個 每台裝置的 Obsidian 設定分開放;收工時自動掃一遍有沒有衝突副本
在 Obsidian 裡搬檔,它會自動改寫連結 連結被改成一長串相對路徑,之後資料夾一調整就斷了 搬完把連結改回只寫檔名,再比對每一頁被別頁連到的次數(反向連結)有沒有變少
同步工具的「刪除多餘檔案」選項 連不該刪的設定資料夾也一起刪了 只要是會刪東西的指令,都要配一份一條一條看過的「不准刪」清單(排除清單)
把 git 放在 iCloud 資料夾裡 冒出 70 多個衝突檔 雲端同步和 git 合不來。git 只在一台電腦上用,而且放在同步資料夾外面
以為刪掉的東西能從垃圾桶救回來 放在 iCloud 上的 vault,垃圾桶會被清掉 垃圾桶不是備份
圖表裡的文字用 1. 開頭 被當成編號清單,整張圖畫不出來 圖表文字裡有特殊符號,一律加上引號
規則寫了,AI 照樣漏掉 剛寫下「改規範之前要先登記」,十分鐘後 AI 自己就漏了 靠記性的規則靠不住,重要的要做成自動檢查

上課時,這張表比外掛清單更值得講。外掛大家都會裝,踩過的坑才是經驗。

給學員:最小起步版

第一週,做到這樣就好:

我的知識庫/
├── 00-Inbox/        ← 所有收進來的東西先放這
├── 10-Notes/        ← 自己寫的想法
├── 20-Projects/     ← 有截止日的事
├── 30-Areas/        ← 長期照顧的領域
├── 40-Resources/    ← 參考資料
├── 50-Archive/      ← 用不到但要查得到
├── wiki/            ← AI 整理出的概念頁
└── CLAUDE.md        ← 給 AI 看的說明書

給 AI 的說明書 CLAUDE.md,第一版寫這幾段就夠了:

# 這個資料夾的規矩

## 結構
- 00-Inbox:收件匣,內容不准改,處理完搬到 PARA 對應資料夾
- wiki/:你(AI)整理出的概念頁,一個概念一頁
- 其他 PARA 資料夾:我的原始檔,不准刪、不准改、不准改名

## 整理收件匣時
1. 讀完原始檔,先列出要拆成哪幾個概念,給我看
2. 我確認後,每個概念建一頁,標出來源,連到相關的舊頁面
3. 在 wiki/日誌.md 記下今天做了什麼

## 一律要先問我
- 新建或大改任何檔案
- 刪除或搬移任何檔案

第一週的練習:

  1. 用 Web Clipper 收 5 篇你真的有共鳴的文章,存進收件匣
  2. 請 AI 整理其中一篇。先看它打算拆成哪些概念,再讓它動手寫
  3. 打開 Obsidian 的關係圖(把頁面和連結畫成一張網的畫面),看新的概念頁連到哪些舊頁面
  4. 週末問 AI 一個問題,要它「只根據 wiki 回答、附上來源」

做完這四件事,你就有一個會慢慢長大的知識庫了。之後遇到問題再加規則。不要一開始就把我的規則全部抄過去,那些是我半年踩坑的結果,你還沒踩到那些坑。

課堂討論題

  1. 你的筆記要放在雲端的筆記軟體,還是自己電腦裡的純文字檔?各自得到什麼、失去什麼?
  2. 哪幾件事你絕對不讓 AI 自己決定?把它寫進你的說明書。
  3. 看「踩過的坑」那張表,哪一個你覺得自己也會踩?