---
title: "這本筆記怎麼用（守則）"
type: guide
created: <日期>
updated: <日期>
---
# 這本筆記怎麼用（給人，也給 agent）

> 這份守則跟著筆記走。任何人、任何專案的 agent 要在這裡讀寫，先看完這份就夠，不需要別的文件。
> 機器上的配套（同步、網頁版、腳本）不是筆記的一部分，只在第 8 節指個路。
> 守則本身要改，先跟使用者談過再改，改完在檔尾「修訂」記一行。

## 1. 這是什麼

使用者的第二大腦：腦子裝不下的事記在這裡，要用的時候請 AI 來搜。

- 一律 Markdown。Obsidian 只是檢視器，agent 直接讀寫檔案，不經過 Obsidian。
- 這一包（`vault/` 加旁邊的 `sources/`）拿到哪台機器都能用，搬家整包一起搬。
- 分類與顆粒度由 agent 決定，使用者透過 `index.md` 與 `log.md` 把關；有問題他會主動講，不用等他 review。

## 2. 目錄

```
<根目錄>/                 # 目前是 ~/data/
├── vault/               # Obsidian 開這一層。只放乾淨的 Markdown 與附件
│   ├── AGENTS.md        # 本守則
│   ├── index.md         # 總目錄：從各筆記的 frontmatter 產生（第 6 節）
│   ├── log.md           # 流水帳：誰、哪天、動了哪個檔、做了什麼。只往後加
│   ├── todo.md          # 使用者的 to-do（Obsidian Tasks 格式）
│   ├── wiki/            # 知識：整理過的主題筆記，會一直改
│   ├── archive/         # 歷史：一篇原文一篇筆記，不拆不併
│   │   └── 登錄/        # 登錄簿：只記「存過什麼」，一行一筆
│   ├── journal/         # 對話與決策紀錄：寫完不改，只能加附記
│   └── attachments/     # 筆記真的引用到的圖與 pdf
└── sources/             # 在 vault 外，Obsidian 不看
    ├── raw/             # 原檔：匯出、照片、使用者給的檔。永久保存、不修改
    └── staging/         # raw 轉成的 Markdown 全文，一篇對一篇；可從 raw 重做
```

原則：髒的在外面、乾淨的進 vault；原檔不可變、可讀版可重做；中間產物不進 vault，免得汙染搜尋與關係圖。

## 3. 寫東西的最短流程

1. **決定去處**（第 4 節）：知識進 `wiki/`，歷史進 `archive/`，只值得記一行的進 `archive/登錄/`，對話與決定進 `journal/`。
2. **照格式寫**（第 5 節）：frontmatter 一定要齊。
3. **原檔要封存**：使用者給的檔案放進 `sources/raw/uploads/YYYY-MM/<主題>/`，筆記的 `source:` 指過去。文件類先轉成 `sources/staging/` 的 Markdown 再引用；照片直接指 raw。
4. **`log.md` 末尾加一行**：`- YYYY-MM-DD | 檔案 | [誰] 做了什麼`，`[誰]` 寫專案名或 agent 名。
5. **新標籤**也在 `log.md` 記一筆。
6. `index.md` 不用手改（主機上 vault 一變動就自動重建；別的環境照第 6 節手動加一行）。

不確定的事不要卡住等回答：寫進筆記的 `> [!note] 待確認` 框，回報時列出來，然後繼續做。

## 4. 去處怎麼判斷

| 去處 | 標準 | 怎麼處理 |
|---|---|---|
| `wiki/` | 是**知識**，而且是使用者自己寫或加註的：以後會再用、能跟別的主題連起來 | 化整為零：一篇原文可拆進多篇主題，多篇可併成一篇；附出處 |
| `archive/` | 是**歷史**：他自己寫的研究、計畫、紀錄（旅遊研究、比較表、一次性清單） | 一篇原文一篇筆記，清格式、加日期與標籤，不拆不併 |
| `archive/登錄/` | **網頁剪貼**（別人寫的文章）與**零碎備忘**（一句話、店名） | 不搬全文。一行：標題、日期、原網址、一句話說它是什麼，連到 staging 全文。價值在「知道自己查過什麼」 |
| `journal/` | **對話與決策**：使用者說「記下來」、某次調查的結論、某段工作的回顧 | 記結論與決定，不是逐字稿。寫完不改；結論要用就回流 `wiki/`，wiki 連回 journal |
| 不留 | 空白、完全重複 | `log.md` 記一行就好 |

- 拿不準時進 `archive/登錄/`，不丟。「沒有文字只有圖」的頁不算空白。
- **帳號、密碼、證件號碼**：舊資料裡挖出來的一律不進 vault，挑出來另外問使用者。
  例外：**使用者自己明確叫你記某組帳密時**，提醒一聲就直接記（他已經衡量過），記入處加 `> [!warning]` 框；對外分享版一定要剔除。
- **改別人寫的筆記**：wiki 可以補充、更正，不要整篇重寫；journal 不改，只能在末尾加「附記（日期）」。都要記 log。

## 5. 筆記格式

### frontmatter（每篇都要）

```yaml
---
title: 筆記標題
type: wiki | archive | journal
created: 2026-09-06          # archive 用原文日期；沒有就用寫入日期並註明
updated: 2026-09-06
tags: [tech/linux, obsidian]
source:                       # 出處，可多個；wiki 一定要有
  - sources/staging/<來源>/<檔>.md
  - sources/raw/uploads/2026-09/<主題>/
  - "[[journal/2026-09-06-<主題>]]"
  - "2026-09-19 對話（使用者口述）"
status: draft | reviewed      # draft = 使用者還沒看過
---
```

- `status`：agent 整理舊資料、或替使用者寫的，都是 `draft`。**使用者本人在對話裡當場交代、他自己就是內容來源的**（例如工作日誌、to-do），直接 `reviewed`。
- 內文用 `[[名稱]]` 互連；圖片 `![[attachments/xxx.jpg]]`。
- 手稿轉寫：結果存 `staging/`，筆記 `source` 指 staging，`status: draft` 直到使用者校對。
- 照片複製進 `attachments/` 時順手轉正（EXIF 旋轉烤進像素），raw 不動。

### 命名

- `wiki/`：主題名，不帶日期。
- `archive/`、`journal/`：`YYYY-MM-DD-<主題>.md`。archive 的日期是原文日期，journal 是對話當天。
- `attachments/`：`<所屬筆記名>-<序號>.<副檔名>`。分享版 PDF 檔名帶日期（同名覆蓋，手機會拿到舊快取）。

### 標籤與目錄

- 資料夾按**種類**分（wiki／archive／journal），不按主題分。主題用標籤與連結表達。
- 標籤小寫、用 `/` 分層（`tech/linux`、`project/<name>`）。工作日誌一律加 `worklog`。
- 某主題的筆記多到一頁塞不下，就拆一篇 `wiki/<主題>.md` 當該主題的目錄（MOC），tags 加 `moc`。
- 顆粒度先粗後細：一個主題一篇，超過一個螢幕再拆。

## 6. index.md 與 log.md

**`index.md`** 是使用者的入口，整份從各筆記的 frontmatter 產生，不要手工維護。主機上 vault 一有變動就自動重建；別的環境沒腳本時，就在對應區塊照既有格式手動加一行，下次重建會被同樣的內容取代。

**`log.md`** 是流水帳，只往後加，一行一事：

```
- 2026-09-19 | wiki/<主題>.md、attachments/<主題>-30.jpg | [knowledge_base] 補〈某節〉專節
```

新標籤、丟掉的原文、改了別人的筆記，都在這裡留一行；使用者靠這裡抽查。

## 7. 誰在寫這本筆記

這本筆記是**共用的**：使用者的每個專案（每個 agent）都可以寫，規矩就是第 3 節。固定寫入者：

| 寫入者 | 寫哪些 | 備註 |
|---|---|---|
| root agent（`~/projects/` 開的 session） | `journal/YYYY-MM-DD-工作日誌.md`、`todo.md` | 日誌一律 `reviewed`、tags 含 `worklog` |
| knowledge_base（主機上的配套工具） | 搬舊資料、整理 wiki／archive、附件、分享版 PDF | 見第 8 節 |
| 其他專案 | 該專案產出的紀錄與知識 | log 標專案名 |

- `todo.md` 整份是使用者的 to-do：他交代的、或他自己在 Obsidian 加的。任何 agent 都可以替他加一條（格式：`- [ ] 事情 📅 到期日 ➕ 加入日 #project/xxx`），agent 自己的工作不放這裡。
- 手機用 Remotely Save 同步這個 vault：大量搬檔時提醒使用者手機先別編輯（同步是「新的贏」）。

## 8. 機器上的配套（不屬於筆記，只是指路）

跟這台機器綁在一起、換機器就要重做的東西，寫在那台機器的專案資料夾，不寫在這裡：

- `~/projects/knowledge_base/DESIGN.md` — 網頁版、index 自動重建、WebDAV 同步、每週備份、分享版 PDF、公開分享頁。
- 備份：每週把整個 `~/data/` 加密上傳雲端硬碟；換機器要重建這條。手機的同步只是工作副本，不算備份。
- 基礎設施慣例：`~/projects/INFRA.md`。

搬到別台機器時：整包搬 `~/data/`，本守則不用改；上面那些配套要在新機器另外做。

## 修訂

- <日期>：第一版。由原 `~/projects/knowledge_base/DESIGN.md` 搬進 vault 改寫；原則沒變，只把機器相關的拿掉、補上「多專案共寫」的規矩與 journal 去處。