GEAR Wiki原創示範教學約 10 分鐘

第 6/6 集LLM Wiki 教學中心

Wiki 安裝教程 6/6|日常維護與備份

建立收錄、查詢、健康檢查與備份的日常節奏,學會完整複製知識庫並在測試資料夾驗證復原。

開始閱讀與練習

從這個問題開始

知識庫的價值來自累積,累積需要維護。這最後一課建立兩個習慣:固定的維護節奏(收錄、核對、查詢、健康檢查),以及真正可靠的備份(完整複製、驗證復原)。完成後,你的 Wiki 不止能用,還能長久地用。

準備的工具與材料

  • 已完成第 1 至 5 課
  • 電腦上有足夠空間存放一份知識庫副本
  • 約 20 分鐘

本課完成後,你能做到

第一,按固定節奏維護知識庫:收錄新資料、核對結果、帶引用查詢、定期健康檢查。第二,完整備份整個知識庫,並在另一個測試資料夾實際驗證復原可用。第三,說清楚為什麼雲端同步不等於備份。

系統概念配套影片 · GEAR EP04(第 5、6 課共用);工作流與備份操作見本文。 在 YouTube 觀看

日常維護節奏

維護不是一套系統指令,而是你寫在 AGENTS.md 裡、用自然語言要求 AI 執行的約定。建議節奏如下:

  1. 收錄:新資料先放 raw/,再按第 2 課的方法收錄,AI 先列計畫、你確認才執行。
  2. 核對:每次收錄後親眼打開新檔案,確認內容、來源標註、index.md 與 log.md 紀錄。
  3. 查詢:需要資料時,要求 AI 附出處。例如:
在 CodeBuddy 對話輸入
請在 Wiki 查出與「能量管理」相關的內容,每項附上來源檔案路徑;不要修改任何檔案。
  1. 健康檢查:每月一次,要求 AI 先報告、後修正。例如:
在 CodeBuddy 對話輸入
請為 Wiki 做健康檢查,只報告不修改:
1. 有沒有內容互相矛盾的頁
2. 有沒有標註了來源、但來源檔案不存在的失效引用
3. 有沒有重複收錄的來源
4. index.md 有沒有漏列的頁
列出問題清單,等我決定怎樣處理。

規則要改時(例如調整 AGENTS.md),先說明改動原因,確認後才改,並在 log.md 記錄。不要因為一次答錯就即興加規矩——先弄清是規則不清,還是單次失誤。

備份與復原

先等待 AI 寫檔工作結束並儲存所有檔案,再開始複製,避免備份只有一部分更新。

備份的原則:完整複製、註明日期、驗證復原。

  1. 用 Finder 或檔案總管,把整個 my-wiki 資料夾複製一份,新資料夾命名加日期,例如 my-wiki-backup-2026-10-18。要包含全部內容:.codebuddy(隱藏資料夾也要)、AGENTS.md、index.md、log.md、raw/、wiki/。
  2. 驗證復原:把備份複製到另一個測試位置(例如 my-wiki-restore-test),用編輯器打開,隨機打開幾個 raw/ 與 wiki/ 檔案,確認內容完整可讀。
  3. 確認備份可用後,才可刪除測試資料夾。永遠不要在唯一原庫上做復原實驗,也不要用備份覆蓋原庫。

完成清單

官方參考

CodeBuddy CLI 文件:https://www.codebuddy.ai/docs/cli/installation (中文:https://www.codebuddy.cn/docs/cli/installation ) CodeBuddy Skills 文件:https://www.codebuddy.ai/docs/cli/skills 連結內容於 2026-10-18 核實;官方頁面如有更新,以官方為準。

接著讀,也接著練習。