暫時以 0d53fc958e3885dbb3e127bf3f169eb937847a27 視為 transmux 版本 beta 2。
確認結論
已在 /Volumes/Data/Github/SyncnextProjects/Syncnext 核對:0d53fc958e3885dbb3e127bf3f169eb937847a27 可以作為 transmux beta 2 的整理節點,但它本身是 docs commit,只新增版本提交報告;實際功能基線是其 parent 1d2a55545b527bc50acab2b55a05037cf0afd706,以及報告內的 77034944..1d2a5554 範圍。
- 0d53fc95:2026-02-23,subject 為 docs(project): 新增版本提交報告文件;父提交是 1d2a5554。
- 功能範圍報告目前在 Docs/Reports/commit_report_1.153_to_current.md;原始 commit 內路徑是 Docs/commit_report_1.153_to_current.md,後續經 Docs 重構移入 Reports。
- 0d53fc95 已是 main 的 ancestor,且可被 v1.158+477 之後版本包含;因此它適合標記為 beta 2 baseline,不適合作為當前最終 transmux 狀態。
Beta 2 範圍
- 基準分支:feature/transmux-p3-simple-baseline。
- 比較範圍:77034944..1d2a5554;不含 1.153 起點,含 1d2a5554。
- 時間區間:2026-02-21 到 2026-02-23。
- Commit 數:71;統計為 feat 34、fix 14、refactor 13、docs 8、build 1、chore 1。
- 功能截止點:1d2a5554,修正 Preflight 分類邏輯與 transmux 路由決策。
核心能力
- P3 proxy-only 原則:Virtual VOD / EVENT 的時間語義由本地 HLS proxy 表達,避免依賴 Player 層 workaround。對應文件:Docs/SPEC/transmux_dev.md。
- Virtual VOD 判定:只有上游是 HLS、EXTINF 時間線完整、存在 ENDLIST、且總時長可信時才輸出 VOD;否則輸出 EVENT。
- Seek runtime:segment request 被視為 seek signal,proxy 維持 low/high watermark 播放窗口,而不是只補單一片段。基準參數為 backBuffer=2、prefetchLead=4、seekBoostLead=16、restartThreshold=4、longPollTimeout=10s。
- Relay simple mode:TransmuxRelayManager 當前 relaySimpleMode=true,simple 路徑保留較低複雜度,同時已有候選 host、第一輪 hedge、circuit 記錄與 host pool 預載。對應文件:Docs/Reports/transmux_relay_mode_comparison_report.md。
- 可觀測性:路由、Preflight、playlist 語義、window、relay fetch、FFmpeg net/readWait、RTF、download/transcode cost 都有 Transmux 日誌,用於弱網與 seek 問題定位。
目前主線後續變更
- 75748672 後新增 PlayerEngineMode:split、transmuxSmart、transmuxGlobal、relaySmart;設定頁顯示 AVPlayer + KSPlayer、Transmux Engine(智能)、Transmux Engine(全局)、全局網絡代理 + 智能解碼。
- transmuxSmart:Preflight 判定 AVPlayer 可直接播時走遠端 AVPlayer,其餘走 Transmux。transmuxGlobal:始終優先走 Transmux。relaySmart:優先走 Relay,並保留智能解碼決策。
- 14b7c408 後,Transmux 播放失敗不再自動 fallback 到 KSPlayer;PlayerExtension 與 Coordinator 都會記錄 fallback disabled,目的是保留正確錯誤報告能力。
- fastlane/changelog.txt 目前 1.162 條目也明確列出:Transmux 引擎不 fallback 到 KSPlayer,以及新增基於 Transmux 衍生的弱網絡引擎 + Transmux 智能解碼組合。
判定與後續使用
- 筆記中的原句可以保留,但建議精確表述為:0d53fc95 是 transmux beta 2 的開發整理節點;真正的 beta 2 功能截止是 1d2a5554。
- 若要復盤 beta 2,優先看 Docs/Reports/commit_report_1.153_to_current.md、Docs/SPEC/transmux_dev.md、Docs/SPEC/transmux_seek_runtime_spec.md、Docs/Reports/transmux_relay_mode_comparison_report.md。
- 若要判斷當前發版行為,應以 main / v1.162+482 附近的 PlayerEngineMode、TransmuxCoordinator、PlayerExtension 與 fastlane/changelog.txt 為準,不應只看 beta 2 節點。
更新日期:2026-04-26。
Loading...