Skip to content

Commit d2edf95

Browse files
SanHsienclaude
andcommitted
docs(upstream): review c149730..9e346f9; adopt heygen-com#7338 and five more; advance watermark
Twelve commits, PRs 7453-7468, issues 7457-7465 and eleven pin moves are recorded with their evidence in the continued ledger, DECISIONS and UPSTREAM. Adopted: heygen-com#7338, heygen-com#7459, heygen-com#7463, heygen-com#7454, heygen-com#7456 and the heygen-com#7439 docs; heygen-com#6732 was already ported. Deferred: heygen-com#7455, heygen-com#7437. Not applicable: heygen-com#7453, heygen-com#7269, heygen-com#7464. The watermark moves to 9e346f9, PR heygen-com#7468, issue heygen-com#7465; four new PRs are pinned and the eleven moved pins re-pinned at their current heads. FORK.md records the fork-only differences in the heygen-com#7338 port; the roadmap tracks the standalone scripts that keep a bare mkdtemp and issue heygen-com#7458. Co-Authored-By: Claude Sonnet <[email protected]>
1 parent bf266f3 commit d2edf95

6 files changed

Lines changed: 319 additions & 27 deletions

File tree

‎FORK.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,8 @@
5050

5151
2026-11-04 另最小移植上游 #7115:FFmpeg 啟動失敗的診斷依序顯示 exit code、OS error code 或 signal,保留既有 Windows DLL 提示與取消行為;差異限 `packages/cli/src/browser/preflight.ts` 與回歸測試。整批同步含此修正時移除這段差異,見 [接續裁決](docs/UPSTREAM_REVIEW_2026-11-04_CONTINUED.md)。
5252

53+
2026-11-10 另採用上游 #7338:`@hyperframes/core/atomic-file` 的 `createStagingDir` 取代 25 處專案路徑旁的裸 `mkdtemp`,修 Windows 暫存資料夾超過 260 字元失敗;與上游的差異限三處:`packages/cli/src/capture/videoNormalization.ts` 也改用 `createStagingDir`(上游已無此檔)、`packages/core/src/noBareMkdtemp.test.ts` 的 ALLOWED 另列本線獨有的四個獨立腳本(`freeze-publisher.mjs`、`image-normalize.mjs`、`core/src/figma/freeze.ts`、`inline-project-publisher.mjs`),以及 `fontCompression.ts`、`download.ts` 的 import 區塊手工合併。上游產品同步包含這些檔時移除這段差異,細節見 [維護決策](docs/DECISIONS.md)。
54+
5355
## 分支與 remote
5456

5557
- `origin/main`:SanHsien 維護線,也是唯一長期分支。

‎ROADMAP.md‎

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
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

6666
2026-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

Comments
 (0)