附錄 D：變更紀錄
本附錄為白皮書之完整版本歷史。格式遵循 Keep a Changelog 慣例。
v0.5 — 2026-08-30
新增
- 第 9 章 §9.1.3「CIR 完整報告全文 NOAEL 抽取」(zh-TW + en 雙語)— 不經 PubChem、直接對 CIR 入口站取索引／狀態頁／附件 PDF;偏好完整報告、跳過「Re-review Not Opened」彙編;pypdf 抽文字、掃描件誠實排除;關鍵頁模式(每份約 US$0.10);Claude 強制 tool-use 抽取最低全身性重複劑量 NOAEL 與逐字證據;三道 sanitize(單位家族、≤ 10,000、數字必逐字出現在 PDF);涵蓋守門(名稱變體比對,不掛錯報告);回灌快取供 cascade 第 0 階與報告 §5-1 逐字引用;截至 2026-08-30 的實際效果(326 份報告、189 份含數值 NOAEL、1,331 個快取成分列帶 CIR NOAEL、在用成分 71% 已連結);只抽在用成分與供應商層級失敗不計次的韌性設計。
- 第 9 章 §9.1.4「舊路徑的退場」;圖 9.1 補齊 EPA / CIR / SCCS / CosIng 節點。
修正
- 第 9 章 §9.1.1 由「四大資料庫」更新為「七大資料源 + OECD 索引」(PubChem、EPA CompTox ToxValDB、ECHA C&L + ECHA CHEM、CIR、SCCS、CosIng、TFDA),與官網、法規參考頁一致;「內容」欄改寫為本系統實際取用的部分,並補失敗契約。
- 第 14 章 §14.6、第 15 章 §15.1 / §15.3:「CIR 全文擷取層幾乎是空的」改為已於 v0.5 填實,列出殘餘限制;EPA ToxValDB backfill 定位為 CIR 無數值時的第二權威源。
- 主 / zh-TW / en README 目錄摘要、引用版本同步至 v0.5.0;
CITATION.cff 與 .zenodo.json 摘要補七大資料源與 CIR 全文抽取。
v0.4 — 2026-08-24
新增
- 第 17 章「標示與宣稱合規引擎」(zh-TW + en 雙語)— §7 法定標示要素與 §10 認定準則的雙法源分工、Claude Vision tool-use 擷取 21 欄位 + 全成分(保持標籤原始順序)+ 驗證標章(含純圖案)、L0030099 262 條官方詞句語料(附件一 34 / 附件二 15 類 184 / 附件三 8 群 24 / 附件四 20)、CJK 相容字元與跨行限值兩個抽取坑、五態判定(red/amber/pending_data/green/gray)、官方源 VIEWSTATE 指紋陷阱、只提示不阻擋與具結歷程、六個真實假陰性。
- 第 18 章「計費模型與服務履約」(zh-TW + en 雙語)— 以產出而非席次計價的理由、付費身分跟著餘額走(取代「曾付款即永久付費」)、產品位棘輪制的刻意不對稱、防套利階梯退費(純函式無 DB)、委外履約層與「SA 簽署必綁一份具體報告」約束。
- 第 19 章「營運可觀測性與邊緣拓撲」(zh-TW + en 雙語)— 易失證據問題、沿用 audit_logs 而不另開表的理由、遙測須用獨立交易、保留期邊界寫在 DB trigger、CDN + L4 分流拓撲下兩種常見 IP 取法皆錯、同一根因造成三種不同傷害(遙測失義 / 防爆破塌成全域鎖 / 簽署證據可偽造)、收斂單一來源與行為驗證。
修正
- 第 16 章章末導覽「下一章」由附錄 A 改指第 17 章。
- 英文版 4 章(ch13–ch16)的導覽頁尾字串由
**Navigation** 改為 **Nav** —— assets/pdf/concat.sh 的剝除規則是 ^\*\*Nav\*\*,**Navigation** 不匹配,導致這 4 條導覽漏進英文 PDF。
- 主 / zh-TW / en README 目錄、章數(16→19)、引用版本同步至 v0.4.0。
v0.3 — 2026-07-06
新增
- 第 14 章「毒理安全評估引擎」（zh-TW + en 雙語）— NOAEL 六階 fallback cascade（數值 → read-across 借值 → 結構相似 RDKit Tanimoto ≥ 0.50 → 定性權威 → TTC → data_gap）、MoS 邊際計算、經皮吸收 DAp 修正（固定油 50%→5%，精油/小分子負控）、fail-safe 非對稱原則（寧偽陽不偽陰、硬閘門覆蓋、review 必附因）、顯示層每成分必顯明確安全依據。
- 第 15 章「法規正確性」（zh-TW + en 雙語）— EU 揭示門檻 vs 濃度上限（positional parser 剝揭示子句、62 列重算保 7 真值）、TFDA/EU/CIR 權威階層（TFDA 有限值達標 → EU 降 advisory；TFDA 無限值 → EU binding 防偽陰）、EPA ToxValDB backfill（sanity ceiling 10000、flag verdict fail-closed）、ECHA C&L 結構化採集（1125 分類 → 421 基因毒 + 684 CMR 自動封鎖）、重金屬鹽補洞、降級限值絕不造偽陰鐵則。
- 第 16 章「自駕進化與計算基準文獻化」（zh-TW + en 雙語）— agreement_rate → 1.0 定義、非對稱學習（false-safe 自動收緊 / over-flag 須人審）、無簽核功能的誠實邊界、確定性引擎 + resolved-cache + 主動 re-grounding 三塊真自主、tox_reference 計算基準文獻化 SSOT、對抗式紅隊。
修正
- 第 13 章章末導覽「下一章」由附錄 A 改指第 14 章。
- 主 / zh-TW / en README 目錄、章數（13→16）、Schema.org
about / keywords、引用格式版本同步至 v0.3.0。
v0.2 — 2026-04-30
新增
- 第 13 章「PIF 合規引擎深度解析（Phase 22–23）」（zh-TW + en 雙語）— 覆蓋 11 個 sub-phase 累積之合規能力：
- §13.1 生命週期 5 階段重組（pre_launch / development / manufacturing / post_launch / signing）
- §13.1.2 業者類型 × 16 項責任歸屬矩陣（4 × 16 = 64 格）
- §13.1.3 7 步驟工作流自動推導 + 委外建議
- §13.2 PIF 版本管理 V0/V1/V2/V3 快照
- §13.2.2 變更偵測（formula / process / packaging fingerprints, SHA-256）
- §13.2.3 一鍵 V2/V3 草案
- §13.2.4 文件時效自動追蹤（GMP / 試驗報告 / §12 通報倒數）
- §13.3 跨 Item lint 引擎 14 條規則 R1–R14（含 R1 進階過濾）
- §13.4 罰則對照表（§22–§25 罰鍰範圍 NT$3 萬至 NT$500 萬）
- §13.5 SA 簽章 metadata（method / hash / ip / cert ref）
- §13.6 合規 PIF PDF 14 頁一鍵產出（WeasyPrint A4 + Noto Sans CJK）
- §13.6.6 e2e 真實數據雙路徑驗證（依編號 / 依階段）
- 附錄 B 新增 §B.1.9 PIF 合規引擎端點（共 14 條新端點）：
- 責任矩陣 2 條
- 工作流與委外 4 條
- V0–V3 版本快照 5 條
- 跨 Item lint 1 條
- 合規 PDF 2 條
變更
- 第 12 章末段「導覽」連結由「附錄 A」改為「第 13 章」
- 附錄 A 起始「導覽」連結由「第 12 章」改為「第 13 章」
- README TOC 加入第 13 章
- CITATION.cff version 由
0.1 升至 0.2，date-released 更新為 2026-04-30
對應 Commits
- 母 repo
VincentLinB/pif：Phase 22.0 → Phase 23E（commits ac44591, 7618936, 8755f8d, 43d649e, 91190a2 等）
- 白皮書 repo：本次 v0.2 commit
已知限制
- 第 13 章引用之效能數據（PDF 14 頁 2-3 秒、PDF 大小 640-690 KB）為實測值；其他 Phase 22-23 端點之延遲尚未 benchmark
- 跨 Item lint R1–R14 規則表為 PIF AI 對 ITRI 講義之解讀；其他 SA 解讀可能略有差異，歡迎透過 GitHub issue 討論
v0.1 — 2026-04-19
新增
- 首次公開草稿，採
baiyuan-tech/geo-whitepaper 相容格式
- 12 章正文：
- Ch.01 摘要與核心命題
- Ch.02 台灣化粧品 PIF 法規背景
- Ch.03 PIF 16 項深度解析
- Ch.04 系統全局架構
- Ch.05 前端技術棧
- Ch.06 後端技術棧
- Ch.07 AI 引擎（含 Claude Code 協同實踐）
- Ch.08 資料庫與多租戶隔離
- Ch.09 毒理資料 Pipeline
- Ch.10 中心 RAG 整合架構（方案 C+，含 L1 Wiki + L2 向量 RAG）
- Ch.11 安全模型
- Ch.12 路線圖、部署與開源策略
- 4 個附錄：
- 附錄 A 縮寫與術語對照（50+ 條）
- 附錄 B API 端點完整清單
- 附錄 C 參考文獻
- 附錄 D 變更紀錄（本檔）
- Mermaid 圖表 15+ 張：跨 ER、flowchart、sequence、state、gantt、pie
- AI-friendly 結構化資料：每章 YAML frontmatter + 每 README 嵌入 Schema.org
TechArticle JSON-LD
- 英文版（en/）同步提供全部章節對應翻譯（Phase 2 完成）
CI 與工具
.github/workflows/build-pdf.yml：Pandoc + XeLaTeX + Noto CJK 雙語 PDF 建置（matrix strategy: zh-TW, en）.github/workflows/lint.yml：markdownlint + lychee 連結檢查.markdownlint.jsonc：linting 規則對齊 geo-whitepaperassets/pdf/concat.sh：章節合併腳本（剝掉 frontmatter、JSON-LD、nav footer）CITATION.cff：GitHub 自動辨識引用資訊
授權
- 白皮書採 CC BY-NC 4.0
- 底層軟體（PIF AI code）採 AGPL-3.0
已知限制
- PIF AI 部分效能指標仍標示為「目標值」，等待 Phase 1 GA 後之正式 benchmark（見 §1.4.1）
- 英文章節為機器輔助翻譯 + 人工校對，法規術語可能仍需當地律師審閱（尤其 §2.5 國際比較）
- 圖表部分於 PDF 建置時 Mermaid 會被剝除並替換為「[See online version]」提示，因 XeLaTeX 不原生支援 Mermaid
對應 Commits（於 baiyuan-tech/pif 與 baiyuan-tech/pif-whitepaper 兩 repo）
f33392e — feat(i18n): extend locales to Japanese, Korean, French with language dropdown- （RAG 整合 commit，待 push）— feat(rag): central RAG integration (Scheme C+) backend
- （白皮書 commit，待 push）— docs: initial whitepaper v0.1 draft with 12 chapters + 4 appendices
未來計畫
v0.2（預計 2026-09）
- Phase 1 GA 後之實測 benchmark 數據置換「目標值」
- SA 電子簽章章節擴充
- 新增章節：「法規變更監測與通知機制」（配合 Phase 3）
- 新增多國語版翻譯校對（ja, ko, fr 原為 i18n UI 完成，白皮書本體尚未譯）
v1.0（預計 2026-12）
- 配合 Phase 2 GA 上線時發布
- 包含首批客戶案例研究（匿名化）
- 與學術界合作的正式同儕審查版本
導覽 ← 附錄 C：參考文獻 · 返回 zh-TW README →