# knowledge_base 範例：說明

這是作者「Markdown 筆記庫（Obsidian vault）在主機上的配套」專案的文件（去個資版），加上筆記庫自己的守則 `vault-AGENTS.md`（正本放在筆記庫裡、跟著筆記走）。拿掉的：主機名、VPN 網址與 IP、使用者名稱、雲端資料夾名、分享頁的專案名、具體筆記的檔名與主題。

檔案：

- `AGENTS.md` — 專案的指路（三行）：守則在筆記庫裡，先讀它。
- `DESIGN.md` — 主機上的配套：網頁版、自動重建、同步、分享版 PDF、公開分享頁、備份、坑。**沒有 STATUS**：做了什麼記筆記庫的 `log.md`。
- `vault-AGENTS.md` — 筆記庫的守則：目錄、寫東西的最短流程、去處怎麼判斷、格式、`index.md` 與 `log.md`、誰在寫、機器上的配套只指路。

示範重點：

1. **「沒有 STATUS」的例外怎麼成立**：這個資料夾只是筆記庫的配套工具，進度記在筆記庫的 `log.md`，決定記 `journal/`，在 root DESIGN 承認即可。
2. **筆記／to-do／工作日誌怎麼跟專案分工**：專案的事實與狀態進專案文件；值得長期記住、不屬於任何專案的知識進 `wiki/`；使用者的 to-do 一份 `todo.md`；每天一篇工作日誌由跟使用者對話的 session 寫。
3. **多個專案的 agent 共寫一本筆記的規矩**：frontmatter 一定要齊、`log.md` 每次寫東西加一行並標「誰」、`index.md` 自動產生不手改、帳號密碼一律不進筆記。
4. **守則跟著資料走**：筆記庫搬到別台機器，守則不用改；只有機器綁定的配套（網頁版、備份）要重做。
5. **坑的寫法**：例如 Google Drive 大檔上傳逾時的解法與「不要自己 new Http 塞進去」的反例。