diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..8b3993b --- /dev/null +++ b/.gitattributes @@ -0,0 +1,8 @@ +# raw/ 是 hash 釘選的 provenance 帳本(AGENTS.md §1.4 / §9 / §14): +# git 一律不得正規化其換行,否則 checkout 後磁碟 bytes 會與 manifest 的 +# SHA-256 不符,讓 --verify 對帳失準(本專案 core.autocrlf=true)。 +# 轉換器已在寫入時以 write_bytes 固定為登記的那份 bytes;此處把同樣的 +# 保證延伸到 git 的 checkin/checkout。 +raw/originals/** -text +raw/converted/** -text +raw/manifest.json -text diff --git a/AGENTS.md b/AGENTS.md index 6be8464..c301c64 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,7 +28,8 @@ SHA-256 至 `raw/manifest.json`(結構見 §9),轉換檔條目必須回指原始檔 hash。 wiki 頁面引用來源必須帶 `source_ref`(格式見 §3.3)。登記的 hash 必須等於檔案在 磁碟上的實際 bytes(UTF-8,換行不轉換——轉換器一律以 write_bytes 寫入所登記的 - 那份 bytes,不受平台 CRLF 影響);完整性以 §14 `--verify` 稽核。 + 那份 bytes,不受平台 CRLF 影響;git 亦以 `.gitattributes` 對 `raw/**` 關閉換行 + 正規化,避免 checkout 重新引入 CRLF);完整性以 §14 `--verify` 稽核。 5. **HITL 閘門**:所有 wiki 層的變更以 git branch + PR 形式提交,經人工審核後才 合併至 main。攝入腳本永遠不直接 commit 到 main。lint 絕不擅自刪檔,一律標記 待人工核准。