歷史記錄 · 2026-08-04¶
重大重構里程碑¶
2026-08-04 ─ Provider root-scoped UGC 讀取與通用供應面隔離(issue 000178)¶
決策檔:D-20260804-01
ugc_read_enabled、root deny 與 DMCA unpin 改由 app 的 root-scoped block API 實際執行。
公版不再公開 Kubo gateway/RPC;app Bitswap 只供 ledger blocks,pin ingestion 取得的 UGC 不
回填該 store。共享 child 必須依仍合法的 root context 取得,單一 provider 下架不擴散到其他
provider 或玩家本機。
2026-08-04 ─ Canonical multi-block UnixFS UGC(issue 000175)¶
決策檔:D-20260804-02
UGC 改以 1 MiB fixed-chunk canonical UnixFS root 定址,CAR 保存完整 DAG;client 以有界 first-valid-wins 合併房內/Bitswap 與玩家所選 root-scoped provider 的 blocks,完整重組與 canonical re-import 後才進 sanitizer。Pinning 支援 dag-pb ingestion/Kubo codec 並公布精確 profile capability;LRU 分開記 logical GLB 與 physical DAG bytes。
2026-08-04 ─ Pinning 邏輯/實體配額與共同 Admission(issue 000154)¶
決策檔:D-20260804-03
Pinning 配額改採雙計量:per-signer/per-root 使用 logical referenced bytes,provider 全域容量 使用 root-attributed incremental physical bytes。API、checkpoint reconcile、replacement 與 cluster pin/unpin 共用 admission,且只在底層操作成功後更新 QuotaLedger 與可觀測狀態。
2026-08-04 ─ Pinning Template 資源政策(issue 000162)¶
決策檔:D-20260804-04
公版 Compose/Kubernetes base 不硬編一組假裝通用的 CPU/RAM requests/limits;資源配置改由 operator 選用 override/overlay,並提供 sizing、量測、故障注入與 app-level hard bounds。 同 issue 的 Kubo routing 裁決已由既有 D-20260804-01 承載,不在本 ADR 重複建立權威。