Wiki 安裝教程 2/6｜建立知識庫，完成第一次收錄

第一，建立一個結構清晰的個人知識庫資料夾。第二，寫好一份最小的 AGENTS.md 規則檔，並確認 AI 在動手前已讀取規則。第三，完成一次由「原始筆記」到「Wiki 頁」的收錄，並用真實檔案內容核對結果。

1. 1用 Finder（Mac）或檔案總管（Windows）在你容易找到的位置建立一個新的空資料夾，命名為 my-wiki。這個資料夾只放知識庫，不放其他檔案。
2. 2打開 CodeBuddy 編輯器，用「開啟資料夾」開啟 my-wiki。
3. 3在編輯器內打開整合終端機，確認終端機目前所在位置就是 my-wiki。

確認所在位置，Mac 輸入：

pwd

Windows PowerShell 輸入 Get-Location；命令提示字元（cmd）輸入 cd。預期結果：顯示的路徑末端是 my-wiki。確認無誤後，啟動 CLI：

codebuddy

這一步的重點：CLI 只應操作 my-wiki 這個資料夾。之後所有指令都在這個範圍內進行。

在 CodeBuddy 對話輸入以下要求（整段複製）：

請在這個資料夾建立我的個人知識庫結構：
1. raw/ 放未整理的原始資料
2. wiki/ 下放四個子資料夾：sources（來源摘要）、concepts（概念）、entities（人物與組織）、analyses（我的分析與判斷）
3. 根目錄建立 AGENTS.md（工作規則）、index.md（全庫索引）、log.md（變更紀錄）
規則：raw/ 內的原始檔案永遠唯讀，不得修改；任何變更先列出計畫，等我確認才執行；每次變更在 log.md 記一行。
請先列出你打算建立的完整清單，等我確認才動手。

預期結果：AI 先列出計畫。你確認後它才建立。完成後，在編輯器左邊的檔案總管逐一打開檢查：資料夾與檔案是否真的存在、內容是否如要求。

AGENTS.md 是你與 AI 之間的工作規則。要注意：工具不一定會自動載入這個檔案，所以每次開始工作前，你要明確要求 AI 先讀它。以下是本教學採用的最小範本，可按需要修改：

# 工作規則
1. raw/ 內的原始檔案唯讀，不得修改或刪除。
2. 任何建立或修改檔案的動作，先列出計畫，等我確認才執行。
3. Wiki 頁必須註明資料來自 raw/ 哪個檔案。
4. 每次變更在 log.md 記一行：日期、動作、涉及的檔案。
5. 不確定的資料寫「未確認」，不要猜。

把以上內容存進 my-wiki/AGENTS.md 後，在 CodeBuddy 對話輸入：

請先閱讀 AGENTS.md，用自己的話重述裡面的規則。在我確認你已明白之前，不要建立或修改任何檔案。

預期結果：AI 重述的規則與你寫的一致。不一致就指正它，直到一致為止。

先用編輯器手動建立 raw/sample-notes.md，貼入這段示範筆記（不含任何敏感資料）：

# 2026-10-18 讀書筆記
主題：為什麼要把經驗寫下來
- 腦記不住的細節，文字可以留住
- 寫下來的判斷，日後可以檢查當時想得對不對
- 知識庫的價值在於累積，不在於單篇完美

然後在 CodeBuddy 對話輸入：

請按 AGENTS.md 的規則，把 raw/sample-notes.md 收錄進 Wiki：
1. 先列出你打算建立的檔案與內容大綱，等我確認。
2. 確認後，在 wiki/sources/ 建立這份筆記的來源摘要頁，註明來源檔案。
3. 如內容涉及值得獨立成頁的概念，在 wiki/concepts/ 建立；沒有就不要硬建。
4. 更新 index.md 與 log.md。

預期結果與核對：不要只看對話回覆。在檔案總管逐個打開新建的 Wiki 頁，親眼確認內容真的對應示範筆記、有註明來源；再打開 index.md 與 log.md，確認有對應紀錄。

CodeBuddy CLI 文件：https://www.codebuddy.ai/docs/cli/installation （中文：https://www.codebuddy.cn/docs/cli/installation ） 連結內容於 2026-10-18 核實；官方頁面如有更新，以官方為準。