Video Stabilizer 即時影片防震 2.9.6

2.9.6 持續效能不足提醒（本機更新）
有效播放期間持續約5秒跟不上時，圖示加上琥珀色外框與驚嘆號，單次顯示4秒提示。
開啟面板可看實測輸出／來源fps，並依證據區分處理負擔、來源掉幀、緩衝不足或原因未明。
處理負擔過高時提示降低Q（取樣長寬比例）或YouTube解析度；按鈕只定位Q或展開播放效能。
所有數值都由使用者決定，程式不自動調整Q、解析度、啟用狀態或任何其他設定。
恢復順暢約10秒後解除提醒；起播、跳轉、暫停、廣告與背景期間不累計。
已由補接恢復的影片回呼缺口不會單獨觸發提醒，圖示也不持續閃爍。
12種介面語言、當地數字格式、阿拉伯文由右至左版面與螢幕閱讀器提示皆已支援。
最後套用設定、我的預設及目前參數都會保留。

2.9.5 關閉面板時的影格節奏修正（本機更新）
影片回呼漏交付時，以原生影格時間戳記補接；相同影格不重複分析。
採一般畫布合成，同一張擷取影格完成分析與輸出。
暫停、跳轉、背景、失敗與停用會停止補接；既有參數與原生核心不變。

2.9.4 沿用最後套用設定（本機更新）
「套用」會同時保存已確認設定；換片、新分頁、重整與重開瀏覽器都沿用。
「我的預設」僅作手動還原用；「啟用」立即生效並保存，草稿仍須套用。
讀取／保存失敗會顯示重試；不因失敗把目前已套用值改回預設。
首次升級尚無最後套用紀錄時，以原有個人預設為起點；舊版未保存僅按Apply的值。
以下舊版紀錄保留供追溯。

2.9.3 核心載入修正
防震核心改由擴充功能隨附資料載入，不再從 YouTube 頁面請求擴充功能的 WASM 檔案。
相較 2.9.2，防震運算、預設值與個人設定維持原狀；資料缺漏或損壞仍會顯示錯誤並恢復原圖。
從 2.8 以前升級時，舊格式的處理設定改用新版系統預設；schema9／format2 個人預設可沿用。
更新時請完整替換原安裝資料夾內的檔案，重新載入擴充功能，再刷新既有 YouTube 分頁。
安裝包：Video-Stabilizer-2.9.3.zip；對應原始碼：Video-Stabilizer-2.9.3-source.zip。
2026-11-05 使用者回報 2.9.3 沒有再出現 Chrome Errors，防震正常，並授權正式公開。
這是使用者實際使用回報；Edge 仍未驗證。
以下版本說明為歷史記錄。


2.9.2 正式名稱調整（本機交付，尚未公開發布）
正式名稱改為 Video Stabilizer（原 YouTube Steady）。完整功能免費，可自願單次贊助，沒有訂閱。
適用於桌面版 Google Chrome 的 YouTube；Microsoft Edge 尚未驗證。
防震計算、預設值、單組個人預設與儲存識別碼不變。請更新原安裝資料夾中的檔案，
重新載入擴充功能，再重新整理 YouTube，以沿用同一安裝身分與個人設定。
安裝包：Video-Stabilizer-2.9.2.zip；完整對應原始碼：Video-Stabilizer-2.9.2-source.zip。
既有公開儲存庫網址保留；以下舊版本說明僅供追溯。

2.9.1 先套用，再保存
只有表單與目前採用值不同時，「套用」才可按。改回原值就恢復停用。
「系統預設」與「還原我的預設」只將數值載入表單，包含預設中的啟用狀態；按套用才生效。未套用就關閉、Esc或入口關閉，會取消這些修改，恢復最後一次已套用值；若本次沒有套用過，就回到開啟設定前。
「設為我的預設」放在「套用」旁邊，只有沒有未套用修改時才可按；只保存已確認的參數，供之後影片使用。無效輸入不能保存，須先修正並套用，或關閉取消。
手動切換啟用、語言與圖示仍即時生效。處理失敗時另提供「重試」，不用變更參數。
預設值、儲存格式與防震核心不變。驗證見validation/apply-confirm-browser-2.9.1.json；以下版本說明為歷史記錄。

2.9.0 精簡介面與單組我的預設
「啟用」直接切換防震與原圖；「顯示區域」與「還原我的預設」並排。C與cutoff維持常用，其餘參數收在「進階」。
「套用」只改本片；「設為我的預設」會先驗證並套用面板上的數值，再保存為之後影片使用的唯一一組預設，不必先按套用。
按關閉、Esc或播放器入口關閉設定，都會取消未套用的修改。已套用的設定保留；啟用、語言及圖示選項仍即時生效。
移除原圖比較、上次套用復原、上一組預設備份、取消修改按鈕與「我的預設」區塊。還原按鈕載入目前保存的那一組；尚未保存時停用。「系統預設」只將本片恢復為系統值，不覆寫個人預設。
長說明改為滑鼠提示，詳細來源／區域數據移入播放效能；錯誤、容量與參數限制仍會顯示。現有目前預設保留，舊備份不再讀取，下一次保存會改為只有一組。
系統預設與原生核心維持2.8.1；驗證見validation/ui-simplify-browser-2.9.0.json。以下版本說明為歷史記錄。

2.8.1 介面排列與系統預設
常用區依序為補償上限C%、cutoff頻率、我的預設。
進階依序為阻尼、偵測模式、中央區R%、取樣Q%、中央優先、搜尋S%、可信度、大位移懲罰、插值、倍率、播放器圖示、語言。
系統預設：C15%、cutoff0.5Hz、damping0.3、中央單區、R85%、Q30%、中央優先關閉、各區S30%、trust4、stab1、雙線性插值、1.00倍、顯示播放器圖示；語言維持跟隨瀏覽器。
中央優先保留顯示，在中央單區時停用，切到多區模式即可使用。
目前schema9／format2的「我的預設」與備份保留。更新後按「還原通用預設」可採用上述數值；另按「設為我的預設」才供之後影片沿用。語言、圖示偏好與既有復原流程保留。
原生核心及5秒疊圖機制不變。驗證見validation/ui-defaults-browser-2.8.1.json；以下版本說明為歷史記錄。

2.8.0 各區搜尋與秒數週期
S改為每個region自身來源長寬的百分比，各區、各軸獨立按取樣格點限制，最大略小於50%；不再用最小格的上限限制全部區域。C仍採整幅來源長寬百分比。新版通用預設為S25%、十字五區、R50%、Q25%、C3%、1.00倍、cutoff1Hz、damping0.9及雙線性插值。

黃色雙向箭頭取代S方形框：中心點代表零位移，水平與垂直箭頭長度顯示實際搜尋距離，也允許斜向位移。調整S時顯示一個區域的實際像素範例；仍使用5秒獨立疊圖，不進入分析或輸出影格。

cutoff週期改用秒：小於1秒顯示一位小數，1秒以上取整數；極短的正週期顯示「<0.1秒」以免誤示為零。數字輸入與保存單位仍是Hz。

依本次要求，2.8不載入舊版處理設定或舊的個人預設備份，首次啟用使用新版通用預設；語言及圖示偏好另存。新建立的「我的預設」與本片復原可正常使用。舊雙軸、舊取樣與「改用R/S/C」模式已移除，全部採用新定義。驗證見validation/region-search-browser-2.8.0.json。以下舊版相容性說明為歷史記錄。

2.7.2 對數刻度、毫秒週期與常用區
cutoff滑桿改為對數刻度：相同移動距離代表相同頻率倍率。保留0.0001–5 Hz滑桿範圍及0.0001–120 Hz精確輸入，儲存單位仍為Hz，數值精度仍為四位小數。方向鍵移動對數範圍的1%，Shift或Page鍵為十步；數字框仍可按原步距精調Hz。極低頻率端保留連續滑桿位置，避免四位小數的量化讓滑塊跳回或按鍵卡住。

欄位顯示週期＝1000 ÷ Hz的毫秒換算，例如1 Hz＝1000 ms、2 Hz＝500 ms；這是頻率倒數，不是處理延遲或濾波時間常數。

常用區保留cutoff、補償上限C%與偵測模式。中央區大小R、取樣比例Q、Zoom移至「進階參數」，展開後仍可完整調整。搬移／收合不改任何設定值；若進階欄位有無效草稿，按套用會自動展開指出。原圖比較、復原、我的預設及舊自訂值保留。驗證見validation/log-cutoff-browser-2.7.2.json。

2.7.1 精簡截止頻率介面
將cutoff移至常用區，只保留同一組數字與滑桿，移除輕／中／重按鈕及重複的強度狀態。滑桿以左「重」、右「輕」提示方向，「中」對準通用預設1 Hz；低值跟隨運鏡較慢，實際效果仍受C及影片影響，並非每段影片都會隨數值降低而更穩。

滑桿仍為0.0001–5 Hz，精確輸入仍接受0.0001–120 Hz。調整只改cutoff，C與其他自訂參數保持原值。原圖比較、五次復原及我的預設均保留；保存功能及範圍說明收在摺疊區。既有2.7.0保存的cutoff/C組合不自動換算或覆寫。驗證見validation/cutoff-browser-2.7.1.json。

以下2.7.0三段組合說明為歷史記錄；本版已移除同時調整cutoff與C的三個按鈕。

2.7.0 輕／中／重、原圖比較與可復原設定
輕／中／重先形成草稿，按「套用本片」才生效。只調整截止頻率與C：輕為1.5 Hz／2.5%，中為1 Hz／3%，重為0.6 Hz／5%；模式、R、Q、S、倍率、阻尼、信心及插值保留自訂值。這些是經測試的起點，尚未加入場景辨識。越重跟隨運鏡越慢，也可能露出更多黑邊；不是所有影片都適合重度。

「比較原圖」只切換顯示，背景分析繼續；「返回防震」顯示最新完成影格，不切換啟用、不改影片或聲音，也不寫設定或增加復原記錄。跳轉及同片換畫質保留比較；套用、換片或處理失敗會結束比較。

「取消修改」丟棄尚未套用的草稿。「復原上次套用」還原整組處理參數，保留本次觀看最近五次不同的套用記錄。「還原通用預設」套用中度、十字五區、R50%、Q25%、S6.25%、C3%、1.00倍及雙線性插值；「本片使用我的預設」載入個人保存值。這兩項只改本片，也能復原。

「本片」指這次觀看：換片或重新整理會載入「我的預設」，清除本片復原記錄；其他已開啟影片保持當時設定。按「設為我的預設」才永久保存目前已採用值，供之後的影片使用；有草稿時須先套用。「復原上次儲存的預設」恢復前一組個人預設，但不改正在看的影片；要用它請再按「本片使用我的預設」。

升級讀取既有自訂設定，保留原始儲存紀錄。舊版雙軸設定仍按原值運算，明確選擇「改用R／S／C」並套用後才轉換；語言及圖示偏好另外保存。儲存失敗時本片參數仍有效，可以重試；讀取失敗時禁止覆寫未知的個人預設。完整驗證見validation/profiles-browser-2.7.0.json；以下舊版說明的保存行為，以本節的新範圍為準。

2.6.0 參數界限與可移動圖示
精確輸入可使用最多四位小數，與滑桿的常用範圍／步距分開。聚焦滑桿不會把超出常用範圍的精確數值改掉。原有設定、預設1.00倍及雙線性插值保留。

R可為0–100%；0適用X或自適應四角，中央／十字沒有可用區域時不能套用。Q為0.0001–100%，每軸至少8樣本，顯示實際尺寸；容量超限不套用，運算慢不擅改Q。S要求值0–50%，有效值依取樣格點限制。C要求值0–204800%，依來源長寬共同限制在每軸65536像素內，保留要求值並顯示有效上限；C與S獨立。

倍率支援0.0001–32768，這是本版驗證的輸入界限，不是所有瀏覽器的理論極限；小於1倍時以黑底遮住下方未縮放的原片。截止頻率可輸入0.0001–120 Hz，有效值不超過目前處理影格率一半。阻尼支援0至最大有限單精度浮點數；信心門檻0.1–100，大位移懲罰0–10。極端組合改用穩定積分，避免反覆數值重設；一般設定維持原生對照精度。

圖示會避開實際控制列，可拖曳或用方向鍵移動（Shift加大步距），Home或「還原圖示位置」回到自動位置。進階的「顯示播放器圖示」可隱藏入口，防震仍繼續。隱藏後從擴充功能工具列視窗按「開啟播放器設定」即可恢復。位置按播放器可用範圍的比例保存，縮放及全螢幕會重算。移動／隱藏不重設分析，還原處理預設值也保留圖示偏好。

2.5.2 補償幅度外框
紫色半透明框帶呈現 C：左右每側厚度為影片來源寬度乘 C%，上下每側為來源高度乘 C%；中央內框的長寬各扣除兩側。C 越大框帶越厚，C＝0 不顯示；兩側重疊時填滿畫面，但不更改 C 數值。舊雙軸設定依原本水平／垂直幅度顯示。

C 不受搜尋範圍 S 限制。框帶是柔性補償幅度參考，實際補償可能短暫超出，並非裁切或保證不露黑的安全區。白色裁切框與實際補償箭頭仍分別顯示。草稿較淡，套用後加深；保留 5 秒顯示、套用才儲存及停用／換片清除。檢查紀錄見validation/compensation-browser-2.5.2.json。

2.5.1 滑桿與參數同色對映
九個數值參數皆有滑桿，並保留原本的精確輸入框。拖曳或點選可快速調整，數字與滑桿同步更新；直接輸入的有效細小數值不會被滑桿粗略步距覆寫。滑桿方向鍵微調，Shift或PageUp／PageDown加大步距，Home／End到上下限，按鍵不會傳到YouTube快捷鍵。

R標籤、滑桿與九宮格框線為藍色；Q與取樣文字為青綠色；S與搜尋框為黃色；C與補償框／箭頭為紫色；放大倍率與可視裁切框為白色。正在調整的項目也在預覽標題以同色標示。候選／已分析／採用狀態使用填色及灰／藍／綠圓點，不再把R框線改成綠色。沒有固定區域框的參數使用中性色。

聚焦數值或滑桿即可查看對應範圍，不會因此改值。拖曳沿用5秒預覽與草稿機制，仍須按套用才儲存；預設值、運算方式與舊設定相容性不變。檢查紀錄見validation/sliders-browser-2.5.1.json。

2.5.0 單一R／S／C與5秒區域預覽
R決定中央長寬比例及其餘九宮格；S是以整幅來源長寬為基準的單一搜尋百分比；C是單一柔性補償百分比。移除自訂寬高、Analysis layout、自動／手動搜尋選單及各軸獨立欄位。新預設為十字五區、R50%、Q25%、S6.25%、C3%、1.00倍。S6.25沿用舊R50配置窄格的搜尋量，C3接近舊3.125／2.7778%；它們是經測試的起點，不是原版預設或通用最佳值。

S超過最小候選區可辨識的範圍時，以共同上限限制，顯示有效比例並保留原輸入。各區仍需依取樣格點取整。C控制平滑後累積補償，保留原生柔性限制，可能短暫超出；S與C不必相等。

任何有效處理參數改動都會立即顯示範圍，最後一次改動後5秒內淡出；按套用或「顯示範圍」可再看5秒。虛線是尚未套用的草稿，實際範圍則使用本幀選區與一致結果。灰色為候選、藍色為分析／預定、綠色為本幀採用；黃色表示搜尋位移範圍，紫色表示柔性補償幅度及目前補償箭頭，白色表示預計可視裁切。Q以樣本尺寸標籤表示，調整Q不會縮小分析框。

搜尋框不表示額外取樣範圍，補償框不是硬邊界。畫框會跟隨真正影片內容、黑邊、平移、放大與鏡像；圖層獨立、不攔截滑鼠、不進入分析或輸出影格。跳轉、換片、關閉補償及停用擴充功能時會清除。

舊設定仍依原幾何、各軸數值與取樣方式運算。按「改用R／S／C」先產生草稿，按套用才儲存；原兩軸比例相同時保留該值，無法等價時顯示新的起始值供調整，原各軸資料留存但不再參與簡化模式。語言、平滑、信心等其他偏好保留。驗證見validation/overlay-browser-2.5.0.json。

2.4.1 停用清理與破圖修正（歷史）
Chrome停用或重新載入擴充功能後，舊腳本會在下一次播放器檢查或頁面事件時退出，移除控制項與防震畫面、停止回呼及事件監聽，取消尚未完成的核心載入。背景分頁的計時器可能被Chrome延後，回到分頁時也會檢查。重新啟用後，請重新整理既有YouTube分頁以載入新腳本；這次更新也需要刷新一次，才能清除已經存在的2.4.0舊腳本。

播放器圖示改為內嵌原有向量圖，不再依賴擴充功能圖片網址，也不會退回YouTube的/icons路徑。WASM改成先讀取完整資料再編譯，移除串流載入與重複讀取；真正載入或編譯失敗仍顯示錯誤，可套用參數重試。偵測核心、預設值與既有儲存參數不變。

在播放器取消「啟用」仍會保留灰色入口，方便重新啟用；在Chrome管理頁停用整個擴充功能則會清除入口。測試範圍及尚待實機確認事項見validation/lifetime-2.4.1.json。

2.4.0 十字五區、比例取樣與負擔預覽（歷史）
常用畫面只保留四項：偵測模式、中央範圍R、取樣比例Q、放大倍率。語言、截止頻率、阻尼、中央優先、補償上限與手動搜尋收進進階。新預設為十字五區、R=50%、Q=25%、自動搜尋及1.00倍。

R決定取樣位置與涵蓋範圍；Q分別套用到每格來源寬、高。Q=50%約保留25%像素樣本，Q=25%約保留6.25%。同一Q會跟著360p到4K解析度變動，不再套用128／256像素上限。Q=100%保留全部來源樣本，奇數尺寸亦可處理；極小比例仍有內部最少8個樣本的限制，實際尺寸只供診斷查看。

十字五區使用中央、上中、下中、左中、右中，可避開四角疊圖；X五區、中央單區與自適應仍可選。中央優先是進階選項。十字亦可能碰到下方字幕或大型移動主體，無法保證所有構圖；R=100%仍只有全畫面單區。

Q先以25%作起點，再依片源與觀看感受調整。介面會在套用前更新估計分析負擔與工作資料記憶體；基準為1080p、R50%、十字五區、Q25%。它是FFT工作量估計，不是CPU百分比或預測fps。實際速度還受來源讀回、解碼、繪圖、FFT尺寸與硬體影響，請展開播放效能看實測fps／毫秒。Q加倍約有四倍樣本，計算量通常增加更多。

運算慢時維持使用者選定Q，持續處理影格並顯示較慢提示，不自動調低精度或停用防震；處理中的新影格會略過，因此顯示延遲可能增加，動作的時間細節可能減少。套用新設定會重新開始效能統計，預期的長處理間隔不會反覆清除參考。無法讀取、畫布失效或超出核心容量時仍恢復原圖，可降低Q或修正來源後重試。

既有設定保留原X排列／中央優先、幾何及固定精度。按「改用比例取樣」後才採Q，按套用才儲存。舊像素值只供檢視，不能直接調整；進階選百分比會依當前影片換算後開放調整，影片未載入或超出範圍則保留原值。想直接使用新方式可按還原預設；語言仍保留。

測量與限制見validation/sampling-browser-2.4.0.json。高Q的4K影格分析與刻意加延遲的恢復測試，均不能當成連續4K/60fps滿速保證。新版已支援4K的100%取樣；內部工作區按需成長，單軸最大8192樣本、WASM記憶體最大2GiB，超出時明示錯誤而非偷偷降低Q。

360p至4K的合成移動前景測試在Q25%通過。額外測試的216p片源在Q25%誤差較大，提高到Q50%後改善，因此25%是起點，並非所有畫質與內容的保證。多區一致性也會依來源長寬限制容忍量，避免低解析度把不同移動混為一組；無須另設參數。

2.3.0 單一中央比例與九宮格（歷史）
「中央區大小 R」分別套用到影片寬度和高度，其餘空間由左右、上下平分，形成不重疊的九宮格。R=50%、片源1024×768 時，中央為512×384，四角為256×192，上下中格為512×192，左右中格為256×384。50%是長寬比例，中央面積是整幅的25%；33.3333%可形成近似等大的九格。奇數像素餘數會分配到兩側，不留縫隙。

中央單區、中央重點、平衡五區及自適應網格共用核心；模式只決定啟用區域與空間權重，區域大小不會自動增加票數。各區分別保留前一影格、計算尺寸、搜尋範圍與位移換算，合併成來源像素後只平滑一次。標準每軸最多128樣本，精細最多256；中央單區另可選「原始精度」，每軸最多1024，能直接讀取亮度時保留原路徑。

新預設為 R=50%、平衡五區、自動搜尋、標準取樣、1.00倍。進階設定可選「中央比例／九宮格」或「自訂寬度／高度」，搜尋可選自動或手動；只有需要時才顯示各軸數字。阻尼移至進階。既有設定保留自訂幾何、手動搜尋、單位與精度；切換配置或按還原預設才採新方式。

小於32個來源像素的寬或高不參與偵測；所有啟用區域都太小時恢復原圖並提示，可提高R、調整視窗或改模式後套用重試。R=100%只剩全畫面單區，無法再靠其他區域排除移動前景。各區實際涵蓋、取樣與搜尋值可在進階查看。

2.3.0 驗證紀錄在 validation/ratio-browser-2.3.0.json，包含初期未達標情況與修正後結果。新預設的合成1080p/30畫素測試輸出約30fps、該區間掉幀0/313，剩餘抖動速度約為原來的28.7%；35項程式測試含360張原單區完整流程對照。4K及直式測試涵蓋擷取影格的分析與繪出，並非連續4K/60fps效能保證。

2.2.0 比例參數與分區偵測（歷史）
新增「中央重點（五區）」、「平衡（五區）」及「自適應九宮格（最多選五區）」。各區保留自己的前一張影格，合併一致位移後只平滑一次；不會把不同位置或隔了多張的影格互相比對。中央重點在一致群組內給中央兩倍權重，平衡則使用相同空間權重。九宮格依紋理及位置分布選區，不必每張都對九區做完整位移運算。

新設定預設「平衡五區、畫面百分比、標準取樣、1.00 倍」。水平參數依片源寬度，垂直參數依片源高度計算；播放器在螢幕上變大或變小不影響分析。來源解析度改變時會重算各區並重設影格參考。比例可維持類似涵蓋範圍，實際品質仍取決於畫面內容。

既有自訂設定原樣保留為「像素、原始單區」。要保留自訂數值並使用新方式，請在「進階參數」切換為畫面百分比，再選取分區模式，按「套用參數」。換算以當前影片尺寸及有效值為準；影片未載入或換算超出範圍時會提示並保留原值。要一次採用新預設，按「還原預設值」，語言仍保留。

每區涵蓋範圍與實際運算取樣分開：標準每區最多 128×128，精細最多 256×256。精細可改善細小位移的解析能力，但運算較重。面板會顯示片源、每區涵蓋像素、取樣尺寸、選取區數與實際搜尋範圍。

2.1.6 工具列彈出視窗修正
修正工具列圖示點開後，視窗過窄、標題逐字換行的問題。彈出視窗使用明確的 332 像素外框與 16 像素內距；更新後關閉並重新點開圖示即可載入新排版。已檢查真正的 Chrome popup、非 YouTube 分頁提示，以及 12 種語言在三種起始寬度下的排版。

2.1.5 精簡播放器入口
右下角只顯示相機防震圖示，按下即可開啟設定；滑鼠提示及螢幕閱讀器名稱保留。關閉防震或回復原圖時，圖示會變灰並降低亮度，提示文字也會反映狀態。可用 Tab 選取、Enter／空白鍵開啟，Escape 關閉面板。

2.1.4 防震圖示
薄荷綠底、深色相機、鏡頭中央的播放符號與兩側防震弧線，作為 Chrome 工具列、擴充功能清單、彈出視窗、播放器按鈕及網站的共同辨識圖示。工具列提供 16／20／24／32／48／128 像素 PNG，向量原稿在 src/brand/icon.svg。更新擴充功能並重新整理 YouTube 後顯示新圖示；原有文字標籤與語音輔助名稱保留。

2.1 多語系介面
預設依瀏覽器語言，未支援時以英文顯示。播放器與擴充功能彈出視窗都有語言選單，可手動切換並儲存。首批支援英文、繁簡中文、日文、韓文、西班牙文、巴西葡萄牙文、法文、德文、俄文、阿拉伯文與印地文。
切換語言會保留尚未套用的參數與正在播放的防震狀態。支援小數點、小數逗號、阿拉伯／波斯／天城體及全形數字，不要輸入千分位。方向鍵可微調數值，Shift 加方向鍵可調十個單位；Escape 關閉面板並回到原按鈕。還原預設值會保留所選語言。
英文分享說明見 README.txt；新增翻譯方式見 TRANSLATING.txt。2.1.3 將可對應的參數還原為 DePan 原始預設，縮放改為 1.00 倍；固定 512 視窗與雙線性插值保留。更新不覆蓋已儲存的自訂值；按「還原預設值」才會套用新值。

播放驗證：2.1.3 的新預設、保存／還原、合成影片與多語介面檢查見 validation/defaults-browser-2.1.3.json。首輪直接開啟分頁的畫素測試失敗；經前景入口重測後 18 項全通過，約 30.1 fps、該區間掉幀 0/312，兩輪皆留存。這不代表已驗證安裝版 YouTube 或所有影片。
本次 2.2.0 的 28 項程式測試、分區／比例設定、多解析度、跳轉與失敗恢復驗證見 validation/regions-browser-2.2.0.json。最終預設的合成 1080p/30 測試剩餘抖動速度約為原來的 32.6%，輸出 30.1 fps、該區間解碼掉幀 0/313；另一次 8 秒無畫素回讀的播放對照為 30 fps、掉幀 0/240。較早未達標的嘗試也保留；4K 測試僅驗證擷取影格的分析與繪出，不能當作連續 4K 播放保證。
先前 2.1 的多語系介面、原版核心對照與合成影片驗證見 validation/public-validation.json。當時合成 1080p/30 的前景播放對照，新版約 29.2 fps、舊版約 29.4 fps，兩版與原始播放均出現掉幀，嚴格門檻未通過。這些數字不能當成所有電腦的流暢度保證。

先前 2.0 排程修正版的 YouTube 實測為 1080p/30、1 倍速輸出 30 fps，原播放器掉幀 2/959；1080p/24 的正常播放、換片及跳轉亦通過。1080p/24 開兩倍速需要 48 fps，預設 512 視窗約 44.8 fps，256 視窗約 37.9 fps，均未完全達標。這些是舊版紀錄；兩倍速仍須依實測判斷，不能把縮小視窗當成保證解法。測試快照中的總掉幀是累計值，請比較各量測區間的差值。

一般播放器與全螢幕支援；子母畫面（PiP）、投放／Cast 使用原始影片。HDR 輸出尚未校準。DRM 或禁止讀取的影格會保持原始畫面，不繞過限制。運算較慢時維持所選比例並顯示實測速度；輸出畫布或容量失效時恢復原圖，可降低Q後按「套用參數」重試，換回正常串流會重新開始。

更新與還原
目前未封裝路徑仍是本資料夾下的 extension，沒有另做捷徑。
更新後在 Chrome「擴充功能 → 管理擴充功能」，按「Video Stabilizer」（舊名稱「YouTube Steady／YouTube 即時防震」）卡片的重新載入圓箭頭，再重新整理 YouTube 頁面。
所有程式及核心都在本機，不需要開啟開發用伺服器。
若要退回較舊版本，請保留設定備份。舊版無法完整辨識Q與十字模式，需採用該版預設或相容的舊設定備份；新版不提供直接輸入絕對像素的操作。

原始碼、授權與驗證
LICENSE.txt / NOTICE.txt：GNU GPL v2 或更新版本、DePan / FFTW / Emscripten 來源。
README-build.txt：建置及測試方法。
validation/native-conformance.json：360 張原版 DLL 對照。
validation/i18n-browser.json：12 種語言、數字輸入、錯誤恢復及縮小面板測試。
validation/media-v2.1.json：實際輸出畫素、影格配對、跳轉、失敗恢復等合成影片測試，含未達標項目。
validation/public-validation.json：本版對外分享的驗證摘要與限制。舊版的本機瀏覽器紀錄與登入畫面不放入分享套件。

本版沿用目前 MPC-HC 所用 DePanEstimate / DePanStabilize method=0 的水平、垂直運算移植成 WebAssembly。每張擷取影格先分析、再用該張影格的補償繪出。聲音、播放進度、暫停、跳轉、倍速及一般全螢幕仍由 YouTube 控制，不用先轉檔或下載整部影片。

日常操作
1. 開啟一般 www.youtube.com/watch 影片。播放器右下方會有相機防震圖示。
2. 按圖示打開面板。取消「啟用防震補償」立即恢復原圖；重新勾選即恢復防震。
3. 修改數值後按「套用」，或在數值欄按 Enter，立即生效並保存供換片、新分頁與重新開啟沿用。「設為我的預設」另存一組已確認值，供日後手動還原。
4. 「還原我的預設」載入唯一保存值；「系統預設」載入下列系統值。兩者都只填入表單，按套用才生效；未套用就關閉會取消，也不改寫已保存的個人預設，也不修改MPC-HC或steady.avs。
5. 關閉、Esc或入口關閉會取消未套用的參數修改。「進階」可展開，內容較長時在面板內捲動；詳細數據可在播放效能查看。

重要參數與玩法

放大倍率 zoom：預設 1.00（不放大）
  1.00 顯示完整原始尺寸，補償後邊緣可能露黑。
  可自行調高倍率以裁切畫面、遮住部分黑邊。
  放大是在防震輸出後執行，不改變分析像素與補償量。

截止頻率 cutoff：預設 0.5 Hz
  0.70：平滑較強，追隨鏡頭較慢，補償量與露邊可能增加。
  1.80：較跟隨原鏡頭，補償較溫和，仍保留較多晃動。
  覺得觀看不舒服時可先試 1.80，再比較關閉防震的原片。

阻尼 damping：預設 0.3
  調整慣性平滑的反應與回彈，可在目前值附近小幅調整。
  先固定 cutoff 再改 damping，較容易看出差別。

補償上限 C：預設15%
  分別乘上片源寬、高，控制平滑後的整體補償幅度。沿用柔性限制，短暫可能超出；設0會停止兩軸補償。

中央區大小 R：預設50%
  中央寬高各占來源的R%，其餘空間由兩側平分，所有模式共用此九宮格。R=100%只剩一區，無法以其他區塊排除移動主體。

搜尋範圍 S：預設6.25%
  水平搜尋±片源寬×S%，垂直搜尋±片源高×S%，不再使用各格四分之一。若超出共同可用上限，顯示有效值而不覆寫輸入。S控制前後影格的可搜尋位移，與補償幅度C分開。

可信度門檻 trust：預設 4%
  調高（例如 6）較保守，較容易重設補償；調低（例如 3）較願意接受位移，也更容易接受錯誤估計。
  分區模式需至少兩區位移一致，並取得可靠區塊的多數支持，再檢查聯合可信度；這是判斷分數，並非成功機率。只有一區可靠、相互衝突、換鏡或可信度不足時重設。中央單區及舊自訂模式保留原版信心驟降檢查；新九宮格多區使用跨區一致性判斷，避免小格在快速抖動時各自誤判換鏡。

大位移可信度懲罰 stab：預設 1
  調高會降低大幅位移估計的可信度，較容易改用原圖；0 不做這項懲罰。

次像素插值 subpixel：預設 1（雙線性）
  1 可顯示非整數像素補償，較平順。
  0 使用最近點與整數像素位移，可比較銳利度，但細小補償可能階梯狀跳動。

常用起點
• 本版預設：中央單區／R=85%／Q=30%／各區S=30%／C=15%，1.00 / cutoff 0.5 / damping 0.3。
• 想跟隨運鏡更快：提高cutoff，再套用本片並比較原圖。
• 想跟隨運鏡更慢：降低cutoff，再套用本片並比較原圖。
• 想保留整幅：zoom 1.00，可容許邊緣露黑。
• 細小位移較難辨識：提高Q並比較實際畫面、處理時間及fps。
• 機器負載高：可降低Q、使用1倍速或關閉防震；系統不會自動替你調低Q。

效果範圍與限制
這是 DePan 平移演算法的瀏覽器移植，不是直接載入 AviSynth Filter 或原生 DLL。原版的 method=0 慣性濾波、FFT 相關、次像素估計及柔性限制保留；本版固定 range=0、method=0，不估旋轉或鏡頭縮放，不使用前後影格填邊。

參數依 src/vendor/depan 的上游原始碼：DePanStabilize 的 cutoff=1.0、damping=0.9、dxmax=60、dymax=30。本版以 1920×1080 將像素預設換成比例；縮放 1.00 不額外放大。分區取樣與合併為本擴充功能新增，並非 AviSynth 原版功能；單區原版對照仍保留。自動視窗及 subpixel=2（三次插值）尚未移植，輸出保留 subpixel=1（雙線性插值）。MPC-HC / steady.avs 的設定獨立保留。

前景大量移動、低紋理、轉鏡、變焦、滾動快門扭曲，可能無法只靠平移改善。防震並不保證每部片看起來更舒服，請用播放器內「比較原圖」比較。

每張畫面的處理需要時間，會增加小幅顯示延遲。1080p/30 本機合成測試接近 30 fps；4K、60 fps、倍速、其他分頁負載與更大分析視窗須依實測判斷。播放器自身掉幀與防震輸出 fps 會分開顯示。

2.1.2 自由單次贊助與公開發布
已設定擁有者提供的公開連結 https://paypal.me/TrumanSun，並核對頁面顯示 Sun Truman（@TrumanSun）。播放器、彈出視窗與下載頁提供自由單次贊助，支持者在 PayPal 決定金額，每次付款個別確認，沒有定期訂閱。金流手續費及地區限制仍依 PayPal 規則；台灣帳戶間無法用 PayPal 做境內轉帳。設定方式與 GitHub 免費公開流程見 PUBLISHING.txt。驗證涵蓋公開收款人頁面與連結，沒有實際付款，也未驗證帳戶收款資格或銀行提領。
