DragonsHoard 公開站同步
內容分四種處理方式,判準見 .claude/specs/public-site-eligibility.md:直接同步(wiki 常青主題、skill、raw/雜記寶庫、raw/evergreen/topics,逐項確認後原樣複製)、逐檔審查後同步(xcripts/,需先掃描敏感資訊)、改寫後同步(.claude/specs/,不得逐字鏡像)、合成內容(materials/、chaos/,不複製真實檔案,改用示範素材)。
步驟
-
確認工作目錄:執行
git status --porcelain。master有未 commit 異動時停止並回報;工作目錄乾淨才切換至public-site。 -
確認同步範圍:讀取
wiki/projects/active/RambleWiki公開站/_index.md的現況與技術參考,以其中目前定義的白名單、來源/目的路徑對應及同步慣例為準,不自行擴大同步範圍。 -
比對差異(直接同步/逐檔審查類):針對 wiki 常青主題、skill、
raw/雜記寶庫、raw/evergreen/topics、xcripts/,比較白名單來源在master與public-sitecontent/對應內容的差異,列出本次新增或變更的候選內容。若目標檔案先前已經公開過,先比對content/現有版本本身有沒有相對master的刻意刪改(可能是之前排除範圍判定過的結果);有的話只套用這次真正新增的差異,不得整檔用master版本覆蓋,避免重新引入先前已排除的內容。 -
逐項核對(直接同步/逐檔審查類):讀取
.claude/specs/public-site-eligibility.md,依其定義的一律排除/逐項人工確認範圍,逐項核對候選清單,決定要不要排除;xcripts/額外逐檔掃描密鑰、token、checkpoint 狀態、個人化路徑或機器識別資訊,含此類資訊的檔案整檔排除或先去識別化,不得原樣公開。 -
產出改寫版本(改寫類):
.claude/specs/系列若本次有變更需要同步,先產出不點名具體排除類別的抽象改寫版本,交使用者確認內容不會反洩漏排除判準後,才可寫入content/;原始詳細版本不同步。 -
準備合成內容(合成類):
materials/、chaos/不從 master 複製真實檔案。如本次要新增或更新這兩個資料夾在公開站的示範內容,向使用者確認要使用的示範素材(新素材或先前已核准的既有示範內容),確認後才寫入對應content/路徑。 -
同步內容:只同步使用者確認可公開的候選內容(含直接同步、逐檔審查通過、改寫版本、合成內容)至
public-sitecontent/的對應位置;依_index.md定義的路徑與命名慣例處理。不得 merge 整個 master 或同步白名單以外內容。 -
處理公開連結:檢查本次同步內容中的 Wikilink;指向未公開內容的連結改為純文字,不在公開站留下不可用連結或私人路徑資訊。
-
驗證:執行
npx quartz build,依_index.md的技術參考檢查建置與公開站連結結果。驗證失敗則停止並回報。 -
建立 commit:列出實際準備提交的同步內容與 commit message,取得使用者確認後才建立 commit。
-
部署確認:commit 完成後,明確詢問是否 push。只有使用者確認後才 push;push 會觸發 Netlify 公開部署。
-
收尾:完成後切回
master,回報實際同步、排除、改寫、合成與未處理的內容。