11# 路線圖
22
33> 本 repo 後續工作的單一真相源。做完一項,就在同一個 commit 刪掉那一列;新工作只加在這裡。
4- > 上游審查於 2026-11-10 接續到 commit ` c149730819437fbf0d8fda7de6952293bcf69c50 ` (PR #7452 、issue #7451 );逐筆裁決見 [ 接續缺口清冊] ( docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md ) 。CI/告警保留現況段既有日期快照。
4+ > 上游審查於 2026-11-10 接續到 commit ` 9e346f9bb793fe53684d7437ac4bed79b11aaa54 ` (PR #7468 、issue #7465 );逐筆裁決見 [ 接續缺口清冊] ( docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md ) 。CI/告警保留現況段既有日期快照。
55
66## 現況
77
@@ -65,6 +65,8 @@ HyperFrames 將 HTML、CSS 與動畫渲染為影片,本線保留 Windows 渲
6565
66662026-11-10 以 fork ` 4a7d1594d ` 接續,審完 ` ad6f7858f..c14973081 ` (上游 tip)共 8 個 commit、PR #7452 與 issue 軸無新增:採用 3 個 commit(#7249 、#7110 、#7000 ),延後 2 個 commit(#7444 、#7452 ),不適用 3 個 commit(#7257 、#7443 、#7450 );10 筆釘選移動(7 筆轉 closed,3 筆換 head),monitored 維持 165 筆。逐筆證據見 [ 接續缺口清冊] ( docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md#2026-11-10接續至-c14973081上游-tip ) 。
6767
68+ 2026-11-10 以 fork ` f3cab380a ` 再接續,審完 ` c14973081..9e346f9bb ` (上游 tip)共 12 個 commit、PR #7453 –#7468 與 issue #7457 –#7465 :採用 6 個 commit(#7338 ` createStagingDir ` 修 Windows 暫存資料夾超過 260 字元、#7459 Studio 渲染取每帳號渲染鎖、#7463 、#7454 、#7456 、#7439 ),#6732 本線 2026-10-30 已移植而無新增改動,延後 2 個 commit(#7455 、#7437 ),不適用 3 個 commit(#7453 、#7269 、#7464 );11 筆釘選移動(6 筆轉 closed,5 筆換 head),新釘 #7462 、#7466 、#7467 、#7468 ,monitored 由 165 增為 169 筆。逐筆證據見 [ 接續缺口清冊] ( docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md#2026-11-10接續至-9e346f9bb上游-tip ) 。
69+
6870## 近期:可以直接動手
6971
7072| 項目 | 為什麼 | 驗收方式 |
@@ -74,16 +76,18 @@ HyperFrames 將 HTML、CSS 與動畫渲染為影片,本線保留 Windows 渲
7476
7577## 中期:等條件成立再做
7678
77- | 項目 | 觸發條件 | 驗收方式 | 建議執行者 | 證據 |
78- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ---------------------------------------------------------------------------------------- |
79- | 成組採用 blur differential harness 與 CI fail-closed(#6967 /#7302 ) | 採用缺少的 differential/callback/crop fixtures,或擴大 blur CI 驗收時 | 同採 Chrome/drawElementImage/ffmpeg 缺失負例、inside blur 非空、held-card slide-out 與 serial producer lane;Windows/CI、逐幀結果及 producer 雙樹全套比對通過 | Codex | docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md 水位 9e2510bda |
80- | 重訪 seam 速度量測與 screenshot 畫格確定性(#7021 /#7111 ) | 上游提供修正,或本線以預設 seam stamp 出現失配/重現 worker 或 seek 順序像素差異 | #7021 用固定 x/y/z seam 比較視覺速度與 gate 的前後 0.1 秒平均;#7111 用固定離線素材比對 1/3 workers、反向 seek 的 RGBA,且 CSS animation 不重啟;未重現不直接改預設或採 display: none workaround | Codex | docs/DECISIONS.md 2026-11-04 issue 軸 |
81- | 分批採用 2026-10-30 已審上游內容 | 需要本輪延後功能/修正,或安排下一批產品同步 | 以兩份清冊(2026-10-29 的 107 個 commit、2026-11-02 的 195 個 commit,後者標明各筆補丁對現行工作樹是否衝突)的採用/略過裁決為起點,產品基底落後上游 616 檔;先處理 CLI 工廠相依、安全與遙測邊界、Windows 分歧及已撤回 #6736 ,保留發布 guard;產品 build、受影響測試、渲染與維護 gate 通過,不以審查水位代替已同步 | Codex | docs/UPSTREAM_REVIEW_2026-11-02.md;tools/upstream_baseline.json |
82- | 消除 tsup 帶入的 esbuild 延後風險 | tsup 相容線有修正版、維護者決定升主版本,或本線開始使用 esbuild serve | 用 bun 重解受影響鏈,核對 bun.lock 中實際版本與 serve 呼叫;build、受影響套件測試通過,不只看 GitHub 依賴圖 | Codex | docs/DECISIONS.md「Dependabot 安全更新」esbuild 延後;GHSA-g7r4 -m6w7-qqqr |
83- | 加入 Windows 可見視窗探測 | 上游 #6613 已合併;本線適用性評估已記錄,尚未移植產品與探測 | 依 #6613 移植時保留程序所有權與 Puppeteer 鎖檔分歧;探測只歸屬本次程序,正常 render 不開可見視窗,刻意開視窗負例失敗,其他渲染驗收保留 | Codex | docs/UPSTREAM_REVIEW_2026-10-29.md「指定 5 個 PR」;.github/workflows/windows-render.yml |
84- | 處理 freeze 鎖殘留與 junction 使用需求 | 實際遇到被終止後 EEXIST,或維護者要求專案位於 junction | 先重現,再定義 stale lock 所有權與安全解除條件;不可刪除仍運作程序的鎖,junction 不能造成專案外寫入,相關安全回歸通過 | Claude Opus | 深掃報告(2026-10-2x)「觀察」;packages/cli/src/media-use/lib/freeze-publisher.mjs |
85- | 重建 Frost 產物與調整 PR/edit-accuracy 配套 | 需要改該區塊打包檔,或維護流程改走相關 PR/CI job | Frost 依鎖檔重建且產物檢查通過;PR 基準不再釘舊 PR;只在啟用對應 job 時採其測試,不改測試消除差異 | Codex | docs/DECISIONS.md:340、353;scripts/comment-check-base.mjs |
86- | 驗證分段 MOV 與媒體下載失敗行為 | 使用 HF_SEGMENTED_CAPTURE 輸出 MOV,或上游合併 #6481 /#6606 對應修正 | 單一固定素材重現,MOV 可讀且時長/畫格符合設定;下載失敗有明確錯誤,不靜默少元素;正常 render 與 preview 回歸通過 | Codex | docs/DECISIONS.md「issue 軸」#6481 、#6606 |
79+ | 項目 | 觸發條件 | 驗收方式 | 建議執行者 | 證據 |
80+ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | --------------------------------------------------------------------------------------------- |
81+ | 成組採用 blur differential harness 與 CI fail-closed(#6967 /#7302 ) | 採用缺少的 differential/callback/crop fixtures,或擴大 blur CI 驗收時 | 同採 Chrome/drawElementImage/ffmpeg 缺失負例、inside blur 非空、held-card slide-out 與 serial producer lane;Windows/CI、逐幀結果及 producer 雙樹全套比對通過 | Codex | docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md 水位 9e2510bda |
82+ | 重訪 seam 速度量測與 screenshot 畫格確定性(#7021 /#7111 ) | 上游提供修正,或本線以預設 seam stamp 出現失配/重現 worker 或 seek 順序像素差異 | #7021 用固定 x/y/z seam 比較視覺速度與 gate 的前後 0.1 秒平均;#7111 用固定離線素材比對 1/3 workers、反向 seek 的 RGBA,且 CSS animation 不重啟;未重現不直接改預設或採 display: none workaround | Codex | docs/DECISIONS.md 2026-11-04 issue 軸 |
83+ | 分批採用 2026-10-30 已審上游內容 | 需要本輪延後功能/修正,或安排下一批產品同步 | 以兩份清冊(2026-10-29 的 107 個 commit、2026-11-02 的 195 個 commit,後者標明各筆補丁對現行工作樹是否衝突)的採用/略過裁決為起點,產品基底落後上游 616 檔;先處理 CLI 工廠相依、安全與遙測邊界、Windows 分歧及已撤回 #6736 ,保留發布 guard;產品 build、受影響測試、渲染與維護 gate 通過,不以審查水位代替已同步 | Codex | docs/UPSTREAM_REVIEW_2026-11-02.md;tools/upstream_baseline.json |
84+ | 消除 tsup 帶入的 esbuild 延後風險 | tsup 相容線有修正版、維護者決定升主版本,或本線開始使用 esbuild serve | 用 bun 重解受影響鏈,核對 bun.lock 中實際版本與 serve 呼叫;build、受影響套件測試通過,不只看 GitHub 依賴圖 | Codex | docs/DECISIONS.md「Dependabot 安全更新」esbuild 延後;GHSA-g7r4 -m6w7-qqqr |
85+ | 加入 Windows 可見視窗探測 | 上游 #6613 已合併;本線適用性評估已記錄,尚未移植產品與探測 | 依 #6613 移植時保留程序所有權與 Puppeteer 鎖檔分歧;探測只歸屬本次程序,正常 render 不開可見視窗,刻意開視窗負例失敗,其他渲染驗收保留 | Codex | docs/UPSTREAM_REVIEW_2026-10-29.md「指定 5 個 PR」;.github/workflows/windows-render.yml |
86+ | 處理 freeze 鎖殘留與 junction 使用需求 | 實際遇到被終止後 EEXIST,或維護者要求專案位於 junction | 先重現,再定義 stale lock 所有權與安全解除條件;不可刪除仍運作程序的鎖,junction 不能造成專案外寫入,相關安全回歸通過 | Claude Opus | 深掃報告(2026-10-2x)「觀察」;packages/cli/src/media-use/lib/freeze-publisher.mjs |
87+ | 讓本線獨有的四個獨立腳本也走長路徑暫存資料夾(` freeze-publisher.mjs ` 、` image-normalize.mjs ` 、` core/src/figma/freeze.ts ` 的子行程腳本、` inline-project-publisher.mjs ` ) | 實際在超過 260 字元的專案路徑遇到 ` mkdtemp ` 失敗,或這些腳本改為可 import ` @hyperframes/core/atomic-file ` | 先在 Windows 用 280 字元以上的專案路徑重現四處之一失敗,再改用 ` createStagingDir ` (或腳本內複製同一段長路徑前綴邏輯)並從 ` noBareMkdtemp.test.ts ` 的 ALLOWED 移除該檔;該測試與受影響腳本的既有測試通過 | Codex | docs/DECISIONS.md 2026-11-10「連續水位 ` 9e346f9bb ` 」;packages/core/src/noBareMkdtemp.test.ts |
88+ | 量測擷取與軟體 H.264 編碼重疊時的 CPU 過度訂閱(上游 issue #7458 ) | 本線 Windows 真實渲染出現整機卡頓,或上游提出修正 | 在 Windows 以固定素材量 ` workerCount ` 加編碼執行緒數對擷取時間、總時間與前景回應的影響;x264 位元流取決於執行緒數(` softwareEncoderThreads.ts:5 ` ),任何預算調整都要比對輸出位元組與確定性,不以未量測的程式碼檢視為依據 | Codex | ` gh issue view 7458 ` ;packages/producer/src/services/render/stages/encodeStage.ts:299 |
89+ | 重建 Frost 產物與調整 PR/edit-accuracy 配套 | 需要改該區塊打包檔,或維護流程改走相關 PR/CI job | Frost 依鎖檔重建且產物檢查通過;PR 基準不再釘舊 PR;只在啟用對應 job 時採其測試,不改測試消除差異 | Codex | docs/DECISIONS.md:340、353;scripts/comment-check-base.mjs |
90+ | 驗證分段 MOV 與媒體下載失敗行為 | 使用 HF_SEGMENTED_CAPTURE 輸出 MOV,或上游合併 #6481 /#6606 對應修正 | 單一固定素材重現,MOV 可讀且時長/畫格符合設定;下載失敗有明確錯誤,不靜默少元素;正常 render 與 preview 回歸通過 | Codex | docs/DECISIONS.md「issue 軸」#6481 、#6606 |
8791
8892## 刻意不做
8993
0 commit comments