如何更新本知識庫（增量更新流程）

flowchart LR
  R[refresh.sh<br>webclaw 重新擷取] --> D[比對 manifest 來源指紋<br>列出變更/新 URL]
  D --> E[人手或 Agent 更新<br>data/models/*.yaml / data/pages/*.md]
  E --> G[kbgen.py<br>重新生成 md/json/manifest/changelog]
  G --> B[build_site.sh<br>重建 site/]
  B --> U[上傳 Google Drive]

目錄角色

路徑	角色	可否手改
`data/models/<modality>/*.yaml`	模型資料（技巧、模板、`example_ref` 指向原文）	✅ 主要編輯處
`data/pages/**.md`	手寫頁面範本（`@@REF {json}@@` 逐字擷取、`[[src:來源id]]` 來源連結）	✅
`data/sources.yaml`	來源登記（id、標題、URL、發佈日期）	✅
`_raw/`	擷取的原文（webclaw、git clone、X）	由 refresh.sh 更新
`image/ video/ audio/ cli-mcp/ plugins-updates/ automation/ README.md`	生成輸出	❌ 會被覆寫
`manifest.json`	每個輸出檔的 sha256、first_seen、last_changed；來源指紋	自動
`changelog.md`	每次有變更自動加一條	自動（只增不刪）
`site/`	靜態網站	自動

指令

cd /workspace/higgsfield-kb
./refresh.sh                     # 1. 重新擷取並報告變更來源（不改輸出）
# 2. 按報告更新 data/ 下的 YAML / 頁面
.venv/bin/python tools/kbgen.py  # 3. 重新生成（警告會列出擷取失敗的 REF）
./build_site.sh                  # 4. 重建網站

規則

只加入有來源的提示與功能；未核實者標 ⚠️。
新模型：在對應 YAML 加一個條目（slug、name、cli_ids、catalog_keys、techniques…）。
原文改版導致 REF 擷取失敗時，生成器保留上次的 prompts.json 值並發出警告。
被移除的模型資料夾不會自動刪除，只會警告。
時間一律以 HKT 記錄；存取日期寫在 kbgen.py 的 ACCESS_DATE。