open-sea-skin-dsh 2.0.6 → 2.0.7

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+# 2.0.7
+
+## Added — 「性能」分组：帧预算的四个开关
+
+- 新增分组「性能」（在「毛玻璃」与「高级」之间）：帧调度器、遮挡暂停、WebGL2 自适应；「高级」里追加窗口缩放防抖与毛玻璃刷新方式。
+- 帧调度器把逻辑从渲染节拍里拆出来：帧率上限低于屏幕刷新率时，不再每帧空转星空、船队和相机。
+- 遮挡暂停在窗口被盖住 / 切到后台时停掉渲染循环（或降到 10 fps），回到前台立即续上，时钟不跳。
+- WebGL2 回退不再硬编码 1.0 像素比 / 30 fps / 0.6 比例，改用与画质档一致的自适应，并在降档后锁 30 秒防抖。
+- 窗口缩放防抖 150ms：拖动窗口边缘时先拉伸旧画面，停手后再按新尺寸重建，避免连串重建。
+- 毛玻璃刷新方式：实时 / 静态（保留底色、停掉每帧取样）/ 关闭。
+
+## Changed — 渲染比例改为探针升档
+
+- 旧判据 `fps > TARGET_FPS + 6` 在帧率上限附近永远不可达（读数被上限钳住），比例呈现「只会降不会升」的棘轮。
+- 现在每个窗口向上探 3%，用下一个窗口裁决；保不住的退回比例并把冷却翻倍（4 → 8 → 16 → 32 秒）。
+- 保住的步进后静默 24 秒再做下一次，且不追最后 1.5% 的余量——每次裁决都要重分配绘制缓冲，那一下就是一帧闪烁，间隔太短会被读成卡顿。
+- 切换画质档会清空在飞的探针。
+
 # 2.0.6
 
 ## Fixed — 浏览器模块 id 改为 npm 包名

package/README.en.md

@@ -1,8 +1,8 @@
-# Open Sea Skin · Lab (2.0.4)
+# Open Sea Skin · Lab (2.0.7)
 
 **A living ocean skin** for DeepSeek Harness Desktop and Web: waves that follow your session load, a sky driven by real ephemeris data, a star field built from a real catalogue, and boats that are your running subagents.
 
-![version](https://img.shields.io/badge/version-2.0.4-138b8b) ![license](https://img.shields.io/badge/license-MIT-138b8b) ![upstream](https://img.shields.io/badge/upstream-d--dev0101%2Fopen--sea--skin-6c7f8a)
+![version](https://img.shields.io/badge/version-2.0.7-138b8b) ![license](https://img.shields.io/badge/license-MIT-138b8b) ![upstream](https://img.shields.io/badge/upstream-d--dev0101%2Fopen--sea--skin-6c7f8a)
 
 ---
 
@@ -10,12 +10,12 @@
 
 This project is a **rebuilt fork (Lab branch)** of **[d-dev0101/open-sea-skin](https://github.com/d-dev0101/open-sea-skin)** (author **d-dev0101**, MIT licence) at version **1.2.7**. It is **not** an official upstream release and is not maintained by upstream.
 
-It keeps upstream's rendering foundation (three.js WebGPU + TSL ocean, sky, clouds, glass approach) and rebuilds the wave driver, astronomical sky, star field, boat fleet and the whole settings panel on top of it, up to **2.0.4**. All current code, shaders, panel and tests are maintained here — please file issues against **this** repository, not upstream.
+It keeps upstream's rendering foundation (three.js WebGPU + TSL ocean, sky, clouds, glass approach) and rebuilds the wave driver, astronomical sky, star field, boat fleet and the whole settings panel on top of it, up to **2.0.7**. All current code, shaders, panel and tests are maintained here — please file issues against **this** repository, not upstream.
 
 - Upstream: [d-dev0101/open-sea-skin](https://github.com/d-dev0101/open-sea-skin) · fork point `v1.2.7`
 - Upstream licence: MIT, full text in [`LICENSE`](LICENSE); required third-party notices in [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)
 - Why the fork exists and how to fall back: [`docs/FORK.md`](docs/FORK.md)
-- Current version: **2.0.4** (tag `v2.0.4`). 2.0.0 stays the frozen baseline and its tag still resolves to the source; the 2.0.0–2.0.3 releases are off the shelf, so only the newest installable package is published
+- Current version: **2.0.7** (tag `v2.0.7`). 2.0.0 stays the frozen baseline and its tag still resolves to the source; the 2.0.0–2.0.3 releases are off the shelf, so only the newest installable package is published
 
 ---
 
@@ -58,12 +58,6 @@ Or install straight from GitHub (builds from this source tree):
 dsh plugin add github:BeckChiang/open-sea-skin
 ```
 
-To skip the source build on your machine, use the prebuilt tarball from the Release (no `allowBuilds` approval needed):
-
-```powershell
-dsh plugin add https://github.com/BeckChiang/open-sea-skin/releases/download/v2.0.4/open-sea-skin-2.0.4.tgz
-```
-
 ### Option 2: local link (for development)
 
 1. Clone into the DSH plugin directory:
@@ -83,8 +77,8 @@ dsh plugin add https://github.com/BeckChiang/open-sea-skin/releases/download/v2.
 **Verify**: the console should print
 
 ```text
-[open-sea-skin] client lab-2.0.4
-[open-sea-skin] ocean lab-2.0.4
+[open-sea-skin] client lab-2.0.7
+[open-sea-skin] ocean lab-2.0.7
 ```
 
 ---

package/README.md

@@ -1,8 +1,8 @@
-# Open Sea Skin · Lab（2.0.4）
+# Open Sea Skin · Lab（2.0.7）
 
 **实时海洋皮肤** —— 给 DeepSeek Harness 桌面版 / Web 用的一层会呼吸的海面：浪跟着你的会话负载起伏，天光按真实星历走，星空是真的星表，船是你正在跑的子智能体。
 
-![version](https://img.shields.io/badge/version-2.0.4-138b8b) ![license](https://img.shields.io/badge/license-MIT-138b8b) ![upstream](https://img.shields.io/badge/upstream-d--dev0101%2Fopen--sea--skin-6c7f8a)
+![version](https://img.shields.io/badge/version-2.0.7-138b8b) ![license](https://img.shields.io/badge/license-MIT-138b8b) ![upstream](https://img.shields.io/badge/upstream-d--dev0101%2Fopen--sea--skin-6c7f8a)
 
 ---
 
@@ -10,12 +10,12 @@
 
 本项目是基于 **[d-dev0101/open-sea-skin](https://github.com/d-dev0101/open-sea-skin)**（作者 **d-dev0101**，MIT 许可）**1.2.7** 版本**重新构建的 Lab 分支（fork）**，**不是上游官方版本**，也不由上游维护。
 
-它沿用了上游的渲染底座（three.js WebGPU + TSL 的海面、天空、云与毛玻璃思路），在底座之上重做了海浪驱动、天文日照、星空、船队与整块设置面板，演进到 **2.0.4**。原生代码、着色器、面板与测试都由本仓库维护，出现的问题请提到**本仓库**而不是上游。
+它沿用了上游的渲染底座（three.js WebGPU + TSL 的海面、天空、云与毛玻璃思路），在底座之上重做了海浪驱动、天文日照、星空、船队与整块设置面板，演进到 **2.0.7**。原生代码、着色器、面板与测试都由本仓库维护，出现的问题请提到**本仓库**而不是上游。
 
 - 上游项目：[d-dev0101/open-sea-skin](https://github.com/d-dev0101/open-sea-skin) · 分叉起点：`v1.2.7`
 - 上游许可：MIT，全文见 [`LICENSE`](LICENSE)；必须保留的第三方署名见 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)
 - 为什么分叉、改了什么、怎么回退上游：[`docs/FORK.md`](docs/FORK.md)
-- 当前版本：**2.0.4**（tag `v2.0.4`）。2.0.0 是冻结基线，tag 仍可检出源码；2.0.0–2.0.3 的发布包与 Release 已下架，只保留最新一版的可安装包
+- 当前版本：**2.0.7**（tag `v2.0.7`）。2.0.0 是冻结基线，tag 仍可检出源码；2.0.0–2.0.3 的发布包与 Release 已下架，只保留最新一版的可安装包
 
 ---
 
@@ -62,12 +62,6 @@ dsh plugin add open-sea-skin-dsh
 dsh plugin add github:BeckChiang/open-sea-skin
 ```
 
-不想让本机走源码构建的话，用 Release 上的预构建包（免 `allowBuilds` 授权）：
-
-```powershell
-dsh plugin add https://github.com/BeckChiang/open-sea-skin/releases/download/v2.0.4/open-sea-skin-2.0.4.tgz
-```
-
 ### 方式二：本地 link（改代码用）
 
 1. 把仓库放到 DSH 插件目录：
@@ -87,8 +81,8 @@ dsh plugin add https://github.com/BeckChiang/open-sea-skin/releases/download/v2.
 **确认生效**：控制台第一行会出现
 
 ```text
-[open-sea-skin] client lab-2.0.4
-[open-sea-skin] ocean lab-2.0.4
+[open-sea-skin] client lab-2.0.7
+[open-sea-skin] ocean lab-2.0.7
 ```
 
 ---

package/README.zh.md

@@ -1,11 +1,11 @@
-# Open Sea Skin · Lab 分支说明（2.0.4）
+# Open Sea Skin · Lab 分支说明（2.0.7）
 
 这是 [open-sea-skin](https://github.com/d-dev0101/open-sea-skin)（MIT，作者 d-dev0101）1.2.7 的**重新构建版（fork）**，装在 DSH 桌面版的 `desktop` profile 里。首页与安装说明见 [`README.md`](README.md)，本文是该版本的技术说明。
 
 上游只提供「海面 + 夕阳 + 玻璃界面」；本分支在它的地基上重做了五块：**负载驱动的波浪**、**真实天文的天色与星空**、**跟着会话变化的船队**、**可逐项取舍的性能开关**、**可折叠且带解释的设置面板**。
 
 - 上游版本：1.2.7
-- 本分支版本：**2.0.4**（2.0.0 是冻结基线；本文档是该版本的完整说明。2.0.0–2.0.3 的发布包已下架）
+- 本分支版本：**2.0.7**（2.0.0 是冻结基线；本文档是该版本的完整说明。2.0.0–2.0.3 的发布包已下架）
 - 许可：MIT（见 `LICENSE`）；上游必须保留的署名见 `THIRD_PARTY_NOTICES.md`
 - 开发位置：`C:\Users\<你>\DSH\plugins\open-sea-skin-lab`，profile 用 `link:` 安装
 - 默认档：**画质「省电」（0.85× 像素比）+ 30 fps 上限**，夜间核显占用多数时候低于 20%
@@ -44,7 +44,7 @@
    ```
 3. 重启桌面端或按 F5 刷新窗口。
 
-**确认生效**：控制台第一行有 `[open-sea-skin] client lab-2.0.4` 与 `[open-sea-skin] ocean lab-2.0.4`。
+**确认生效**：控制台第一行有 `[open-sea-skin] client lab-2.0.7` 与 `[open-sea-skin] ocean lab-2.0.7`。
 
 ---
 

package/native-dist/ocean.js

@@ -871,6 +871,17 @@ function applySunMessage(d) {
   if (typeof d.quality === 'string') applyQuality(d.quality);
   // 1.5.27: frame rate is a budget dial of its own, on top of the resolution one
   if (Number.isFinite(Number(d.fps))) applyFpsCap(Number(d.fps));
+  // 2.0.7 performance switches (panel: "性能" group + advanced rows)
+  if (d.perfScheduler !== undefined) perfScheduler = d.perfScheduler !== false;
+  if (d.webgl2Adaptive !== undefined) webgl2Adaptive = d.webgl2Adaptive !== false;
+  if (d.resizeDebounce !== undefined) resizeDebounce = d.resizeDebounce !== false;
+  if (typeof d.pauseWhenObscured === 'string' && PAUSE_MODES.includes(d.pauseWhenObscured)) {
+    const modeChanged = pauseMode !== d.pauseWhenObscured;
+    pauseMode = d.pauseWhenObscured;
+    // the switch may flip while the window is already in the background, so the
+    // loop state has to be re-evaluated now, not on the next occlude event
+    if (modeChanged && loopStarted && renderer) applyObscuredLoop();
+  }
   const t = Number(d.t);
   if (sunMode === 'manual') {
     manualTimeOfDay = d.auto !== true;
@@ -1400,6 +1411,13 @@ if (SKIN) {
       // daylight is carried by oss-sun now; a sea tick must never move the sun
     }
     if (d && d.type === 'oss-sun') applySunMessage(d);
+    if (d && d.type === 'oss-active') {
+      // The panel watches its own window: a covered browser window never tells
+      // the iframe (it is not a tab) and never takes focus, so this is the only
+      // signal that the skin went to the background.
+      obscured = d.active === false;
+      applyObscuredLoop();
+    }
     if (d && d.type === 'oss-glass') applyGlassMessage(d);
     if (d && d.type === 'oss-boats') applyBoatsMessage(d);
     if (d && d.type === 'oss-fleet') {
@@ -1503,6 +1521,35 @@ let renderScale = 1;
 // contract §3.4: the frosted glass caps the adaptive scale, it never raises it
 let SCALE_CAP = 1;
 
+// 2.0.7 performance switches. Every one of them defaults to the shape the user
+// already knows, so a profile written by 2.0.6 keeps the 2.0.6 frame.
+let perfScheduler = true;
+let pauseMode = 'pause'; // pause | throttle | off
+let webgl2Adaptive = true;
+let resizeDebounce = true;
+let webglFallback = false;
+let webglLatchUntil = 0;
+let obscured = false;
+let nextDue = 0;
+let currentQuality = 'balanced';
+
+// 2.0.7: under a frame cap the meter can never climb above the cap, so "did the
+// GPU have headroom?" cannot be read from fps alone. The governor therefore
+// spends one window at a higher scale and watches whether that window costs
+// frames; a failed probe walks the scale back and doubles the wait before the
+// next attempt, so a machine that is genuinely at its limit is not prodded.
+// Every verdict reallocates the drawing buffer (setPixelRatio + setSize), which
+// reads as a one-frame blink on the water. That blink is why a proven step is
+// followed by a long hold: the governor climbs in a few visible steps and then
+// stops, instead of pulsing the sharpness every couple of seconds.
+let probeState = 0; // 0 = idle, 1 = one window raised, waiting for the verdict
+let probeBackoff = 4; // windows to wait after a failed probe (4 → 64 s)
+let probeBaseScale = 1;
+const PROBE_STEP = 1.03;
+const PROBE_BACKOFF_MAX = 32;
+const PROBE_HOLD = 12; // 24 s of quiet after a step is kept
+const PROBE_CAP_EPS = 0.015; // do not hunt the last 1.5 % of the cap
+
 function applyResolutionScale(scale) {
   renderer.setPixelRatio(BASE_PIXEL_RATIO * scale);
   renderer.setSize(window.innerWidth, window.innerHeight);
@@ -1520,6 +1567,7 @@ const QUALITY_PRESETS = {
 // 60 fps, and every frame is a full-screen fill: halving the rate halves the
 // GPU time. SKIN defaults to 30; the standalone demo keeps its old cap.
 const FPS_OPTIONS = [30, 60, 90, 120];
+const PAUSE_MODES = ['pause', 'throttle', 'off'];
 let fpsCap = SKIN ? 30 : 60;
 
 function applyFpsCap(cap) {
@@ -1541,6 +1589,10 @@ function applyFpsCap(cap) {
 function applyQuality(level) {
   const preset = QUALITY_PRESETS[level];
   if (!preset || !renderer) return;
+  currentQuality = level;
+  // a quality switch re-clamps the scale: any probe in flight is meaningless now
+  probeState = 0;
+  probeBackoff = 4;
   PIXEL_RATIO_CAP = REDUCED_MOTION ? Math.min(preset.pixelRatio, 0.9) : preset.pixelRatio;
   BASE_PIXEL_RATIO = Math.min(window.devicePixelRatio || 1, PIXEL_RATIO_CAP);
   TARGET_FPS = REDUCED_MOTION ? 18 : preset.targetFps;
@@ -1551,7 +1603,40 @@ function applyQuality(level) {
   applyFpsCap(fpsCap);
 }
 
+// 2.0.7: one place that decides whether the loop should be running. `throttle`
+// keeps the loop alive and lets the gate in animate() stretch the step to 10 fps,
+// so the sky keeps advancing and coming back does not jump; `pause` stops it
+// outright, which is what actually drops the GPU to idle when DSH is covered.
+function applyObscuredLoop() {
+  if (!loopStarted || !renderer) return;
+  // Never pause before the first frame is on screen: the loader is only taken
+  // down by a rendered frame, so a pause here would read as a broken skin.
+  if (!firstFrameShown) return;
+  if (obscured && pauseMode === 'pause') {
+    renderer.setAnimationLoop(null);
+    return;
+  }
+  if (document.hidden) return;
+  lastFrameTime = performance.now();
+  lastRenderAt = 0;
+  nextDue = 0;
+  renderer.setAnimationLoop(animate);
+}
+
 function animate(now) {
+  // 2.0.7: the whole tick is gated, not just the draw. On a 144 Hz panel the
+  // star billboards, the orbit controls and the fleet used to run 144 times a
+  // second so that 30 frames could be presented. The due time is advanced in
+  // whole frame steps (nextDue += step) instead of being snapped to `now`, and
+  // that matters: a 30 Hz budget sampled on a 144 Hz vsync grid lands on 6.9
+  // ticks, and resetting the anchor to `now` turned that into an alternating
+  // 2/1 cadence. A long stall resyncs instead of trying to catch up in a burst.
+  if (perfScheduler) {
+    const step = obscured && pauseMode === 'throttle' ? Math.max(FRAME_MS, 100) : FRAME_MS;
+    if (now + 0.5 < nextDue) return;
+    if (now - nextDue > step * 4) nextDue = now;
+    nextDue += step;
+  }
   // high-resolution timestamp -> delta, clamped so hitches never cause jumps
   const dt = Math.min((now - lastFrameTime) / 1000, 0.1);
   lastFrameTime = now;
@@ -1588,8 +1673,11 @@ function animate(now) {
     }
   }
 
-  // frame cap: skip work when the display fires faster than 60 Hz
-  if (now - lastRenderAt < FRAME_MS - 0.5) return;
+  // frame cap: with the smart scheduler the work above is already gated, so
+  // only the legacy path still needs the mid-tick early return
+  if (!perfScheduler) {
+    if (now - lastRenderAt < FRAME_MS - 0.5) return;
+  }
   lastRenderAt = now;
 
   postProcessing.render();
@@ -1632,10 +1720,51 @@ function animate(now) {
         renderScale = Math.max(MIN_SCALE, +(renderScale * 0.97).toFixed(3));
         applyResolutionScale(renderScale);
         adaptHold = 4;
-      } else if (fpsNow > TARGET_FPS + 6 && renderScale < SCALE_CAP) {
+        // a real drop cancels any running probe and resets the backoff: next
+        // time the frame is healthy we start probing from the near end again
+        probeState = 0;
+        probeBackoff = 4;
+        // 2.0.7: a WebGL2 post chain is dearer than the WebGPU one, so once the
+        // governor has walked down there it is not allowed to walk straight
+        // back up and oscillate. The latch only gates the climb, never the drop.
+        if (webglFallback) webglLatchUntil = now + 30000;
+      } else if (
+        fpsNow > TARGET_FPS + 6
+        && renderScale < SCALE_CAP
+        && (!webglFallback || now > webglLatchUntil)
+      ) {
+        // uncapped headroom: the meter itself proved there is room
         renderScale = Math.min(SCALE_CAP, +(renderScale * 1.015).toFixed(3));
         applyResolutionScale(renderScale);
         adaptHold = 4;
+        probeState = 0;
+        probeBackoff = 4;
+      } else if (probeState === 1) {
+        // verdict on the probe we started last window: holding the target under
+        // a cap means the extra pixels were free, so the step is kept
+        if (fpsNow >= TARGET_FPS - 4) {
+          probeState = 0;
+          probeBackoff = 4;
+          adaptHold = PROBE_HOLD;
+        } else {
+          renderScale = probeBaseScale;
+          applyResolutionScale(renderScale);
+          probeState = 0;
+          probeBackoff = Math.min(PROBE_BACKOFF_MAX, probeBackoff * 2);
+          adaptHold = probeBackoff;
+        }
+      } else if (
+        fpsNow >= TARGET_FPS - 2
+        && renderScale < SCALE_CAP - PROBE_CAP_EPS
+        && (!webglFallback || now > webglLatchUntil)
+      ) {
+        probeBaseScale = renderScale;
+        renderScale = Math.min(SCALE_CAP, +(renderScale * PROBE_STEP).toFixed(3));
+        applyResolutionScale(renderScale);
+        probeState = 1;
+        adaptHold = 1; // judge it in the very next window
+      } else {
+        adaptHold = 1; // between the dead bands: look again in two seconds
       }
     }
   }
@@ -1664,7 +1793,7 @@ function animate(now) {
   }
 }
 
-const OCEAN_BUILD = 'lab-2.0.4';
+const OCEAN_BUILD = 'lab-2.0.7';
 
 // How often the frame reports its own state to the host page.
 const STATE_POST_MS = 400;
@@ -1853,10 +1982,30 @@ async function boot() {
     }
 
     // --- lifecycle: resize ---------------------------------------------------
-    window.addEventListener('resize', () => {
+    const rebuildForResize = () => {
       camera.aspect = window.innerWidth / window.innerHeight;
       camera.updateProjectionMatrix();
       applyResolutionScale(renderScale);
+    };
+    // 2.0.7: dragging a window edge fires resize every pixel, and every one of
+    // them reallocated the render targets. The old canvas is stretched over the
+    // viewport while the drag is in flight (no gap, no black band) and the
+    // targets are rebuilt once, 150 ms after the drag settles.
+    let resizeTimer = 0;
+    window.addEventListener('resize', () => {
+      if (!resizeDebounce) {
+        rebuildForResize();
+        return;
+      }
+      if (!resizeTimer && renderer && renderer.domElement && renderer.domElement.style) {
+        renderer.domElement.style.width = '100%';
+        renderer.domElement.style.height = '100%';
+      }
+      if (resizeTimer) window.clearTimeout(resizeTimer);
+      resizeTimer = window.setTimeout(() => {
+        resizeTimer = 0;
+        rebuildForResize();
+      }, 150);
     });
 
     // --- lifecycle: pause when the tab is hidden -------------------------------
@@ -1864,11 +2013,11 @@ async function boot() {
       if (!loopStarted) return;
       if (document.hidden) {
         renderer.setAnimationLoop(null);
-      } else {
-        lastFrameTime = performance.now();
-        lastRenderAt = 0;
-        renderer.setAnimationLoop(animate);
+        return;
       }
+      // a minimized window is hidden first and covered second; coming back
+      // re-runs the same decision the panel's activity signal uses
+      applyObscuredLoop();
     });
 
     // --- initialize the GPU and start rendering --------------------------------
@@ -1877,13 +2026,23 @@ async function boot() {
     if (renderer.backend.isWebGPUBackend !== true) {
       // WebGPU 不可用时 three 自动回退 WebGL2 backend：两种 backend 都允许渲染
       // （2026-08-23 webgui 冒烟测试：用户浏览器无 WebGPU → 纯 WebGPU 检查导致初始化失败）。
-      PIXEL_RATIO_CAP = 1.0;
-      BASE_PIXEL_RATIO = Math.min(window.devicePixelRatio || 1, PIXEL_RATIO_CAP);
-      FRAME_RATE_CAP = 30;
-      FRAME_MS = 1000 / FRAME_RATE_CAP;
-      TARGET_FPS = 28;
-      renderScale = 0.6;
-      applyResolutionScale(renderScale);
+      webglFallback = true;
+      if (webgl2Adaptive) {
+        // 2.0.7: no hardcoded 30 fps / 0.6 any more. The panel's tier is applied
+        // as-is and the governor walks it down if WebGL2 cannot hold it; the
+        // 30 s latch in the governor stops it from climbing back immediately.
+        webglLatchUntil = performance.now() + 30000;
+        if (QUALITY_PRESETS[currentQuality]) applyQuality(currentQuality);
+        else applyQuality('balanced');
+      } else {
+        PIXEL_RATIO_CAP = 1.0;
+        BASE_PIXEL_RATIO = Math.min(window.devicePixelRatio || 1, PIXEL_RATIO_CAP);
+        FRAME_RATE_CAP = 30;
+        FRAME_MS = 1000 / FRAME_RATE_CAP;
+        TARGET_FPS = 28;
+        renderScale = 0.6;
+        applyResolutionScale(renderScale);
+      }
     }
 
     loopStarted = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-sea-skin-dsh",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "type": "module",
   "description": "实时海洋皮肤 · Realtime ocean theme for DeepSeek Harness Desktop and Web",
   "repository": {

package/plugin/client.js

@@ -96,6 +96,13 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
     colLeft: Object.freeze({ on: true, strength: 28 }),
     colRight: Object.freeze({ on: true, strength: 28 }),
     perf: false,
+    // 2.0.7 performance switches: every one of these can be turned off and the
+    // 2.0.6 frame comes back unchanged
+    perfScheduler: true,
+    pauseWhenObscured: 'pause',
+    webgl2Adaptive: true,
+    resizeDebounce: true,
+    glassBlurMode: 'live',
     boats: true,
     boatSpread: 2,
     boatPace: 1,
@@ -158,6 +165,11 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       glassMode: '渲染器内 = 毛玻璃在 WebGPU 里做（可逐栏、可调半径）；CSS 模糊 = 交给浏览器，省 GPU 但只有一档。',
       glassStyle: '模糊的取样形状：高斯最自然、盒式最省、双层更厚、径向中间清楚边缘糊、磨砂有颗粒、玻璃砖成块。',
       perf: '性能模式：一键关掉毛玻璃与额外采样，只保留海面与天空。',
+      perfScheduler: '智能帧调度：把整帧逻辑（星点朝向、船只、相机）也按帧率上限节流，不再在 144Hz 屏上空跑；时间仍按真实时钟推进，海面不会跳。',
+      pauseWhenObscured: '后台停止渲染：DSH 窗口被别的窗口盖住时停画或降频。停止最省电，降频保留 10fps 让天色继续走，关闭则一直满帧。',
+      webgl2Adaptive: '无 WebGPU 时自适应：没有 WebGPU 的机器不再被死钉在 30fps / 0.6×，而是按画质档位跑并由自适应调节；关掉即回到旧的固定降级。',
+      resizeDebounce: '窗口缩放防抖：拖动窗口边缘时先拉伸旧画面，停手 150ms 后再按新尺寸重建渲染目标，避免每像素重建一次。',
+      glassBlurMode: '毛玻璃刷新方式：实时 = backdrop-filter 每帧重新取样（最好看也最贵）；静态 = 只保留底色、不再实时取样；关闭 = 连接底色一起去掉。仅在「CSS 模糊」模式下生效。',
       frost: '背景模糊总开关。关掉后三栏与外壳都不再糊，但设置面板仍保留 9px 底模糊以便阅读。',
       cols: {
         left: '左侧栏（会话/项目列表）。',
@@ -255,6 +267,13 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       secMeteor: '流星',
       secClouds: '云',
       secAdvanced: '高级',
+      secPerf: '性能',
+      perfScheduler: '智能帧调度',
+      pauseWhenObscured: '后台停止渲染',
+      webgl2Adaptive: '无 WebGPU 时自适应',
+      resizeDebounce: '窗口缩放防抖',
+      glassBlurMode: '毛玻璃刷新方式',
+      perfNote: '这一组只管「什么时候不画」与「画多快」，不改画面本身；想改像素预算用下面的画质档位，想改帧率上限用帧率档。',
       skyTone: '夜色倾向',
       domeAmount: '穹顶弧度',
       starSize: '星点大小',
@@ -316,6 +335,8 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       sunModes: { real: '真实时钟', manual: '手动' },
       grades: { off: '关', low: '少', mid: '中', high: '多' },
       glassModes: { render: '渲染器内', css: 'CSS 模糊' },
+      pauseModes: { pause: '停止', throttle: '降频', off: '关闭' },
+      glassBlurModes: { live: '实时', static: '静态', off: '关闭' },
       levels: { off: '关', weak: '弱', medium: '中', strong: '强' },
     },
     en: {
@@ -364,6 +385,11 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       glassMode: 'Renderer = blur inside WebGPU (per column, real radius); CSS = the browser does it: cheaper, one radius only.',
       glassStyle: 'Kernel shape: gaussian is the most natural, box the cheapest, double thicker, radial sharp centre, frost grainy, tile blocky.',
       perf: 'Performance mode: drops the glass and extra taps, keeps water and sky.',
+      perfScheduler: 'Smart frame scheduler: the per-frame logic (star billboards, boats, camera) runs at the frame cap too, instead of 144 times a second on a 144 Hz panel to present 30 frames. Time still advances on the wall clock, so the sea never jumps.',
+      pauseWhenObscured: 'Stop in background: when another window covers DSH, stop drawing or slow down. Stop saves the most; throttle keeps 10 fps so the sky keeps moving; off always runs at full rate.',
+      webgl2Adaptive: 'Adaptive without WebGPU: a machine without WebGPU is no longer pinned to 30 fps / 0.6x; it runs the chosen tier and lets the governor adjust. Off restores the old fixed fallback.',
+      resizeDebounce: 'Debounce resize: while you drag a window edge the old frame is stretched; the render targets are rebuilt 150 ms after you let go, not once per pixel.',
+      glassBlurMode: 'Glass blur refresh: live = backdrop-filter re-samples every frame (best looking, most expensive); static = keep the fill, drop the live sample; off = drop the fill too. Only applies in CSS blur mode.',
       frost: 'Master background blur. Off leaves all columns sharp, while the settings panel keeps a 9px floor so it stays readable.',
       cols: {
         left: 'Left column: the session and project list.',
@@ -461,6 +487,13 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       secMeteor: 'Meteors',
       secClouds: 'Clouds',
       secAdvanced: 'Advanced',
+      secPerf: 'Performance',
+      perfScheduler: 'Smart frame scheduler',
+      pauseWhenObscured: 'Stop in background',
+      webgl2Adaptive: 'Adaptive without WebGPU',
+      resizeDebounce: 'Debounce resize',
+      glassBlurMode: 'Glass blur refresh',
+      perfNote: 'This group only decides when to stop drawing and how fast to draw; it never changes the picture itself. Pixel budget stays on the quality tier below, the frame cap stays on its own dial.',
       skyTone: 'Night tint',
       domeAmount: 'Dome curve',
       starSize: 'Star size',
@@ -522,6 +555,8 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
       sunModes: { real: 'Real clock', manual: 'Manual' },
       grades: { off: 'Off', low: 'Low', mid: 'Mid', high: 'High' },
       glassModes: { render: 'In renderer', css: 'CSS blur' },
+      pauseModes: { pause: 'Stop', throttle: 'Throttle', off: 'Off' },
+      glassBlurModes: { live: 'Live', static: 'Static', off: 'Off' },
       levels: { off: 'Off', weak: 'Weak', medium: 'Mid', strong: 'Strong' },
     },
   });
@@ -557,6 +592,10 @@ window.__ModuleLoader__.load({ id: "open-sea-skin-dsh", factory: (require) => {
   const TZ_MODES = ['system', 'longitude', 'manual'];
 const QUALITY_LEVELS = ['high', 'balanced', 'low'];
 const FPS_LEVELS = [30, 60, 90, 120];
+// 2.0.7: how the surface behaves while it is in the background, and how the CSS
+// glass fallback refreshes itself
+const PAUSE_MODES = ['pause', 'throttle', 'off'];
+const GLASS_BLUR_MODES = ['live', 'static', 'off'];
 
 // 2.0.4: a tier carries a suggested cap so the two dials never disagree on the
 // first click. The cap stays its own dial: changing it afterwards does not move
@@ -649,6 +688,11 @@ const PRESET_FPS = { high: 90, balanced: 60, low: 30 };
       colLeft: normalizeColumn(source.colLeft, DEFAULTS.colLeft),
       colRight: normalizeColumn(source.colRight, DEFAULTS.colRight),
       perf: source.perf === true,
+      perfScheduler: source.perfScheduler !== false,
+      pauseWhenObscured: PAUSE_MODES.includes(source.pauseWhenObscured) ? source.pauseWhenObscured : DEFAULTS.pauseWhenObscured,
+      webgl2Adaptive: source.webgl2Adaptive !== false,
+      resizeDebounce: source.resizeDebounce !== false,
+      glassBlurMode: GLASS_BLUR_MODES.includes(source.glassBlurMode) ? source.glassBlurMode : DEFAULTS.glassBlurMode,
       boats: source.boats !== false,
       boatSpread: clamp(source.boatSpread, 0.2, 3, DEFAULTS.boatSpread),
       boatPace: clamp(source.boatPace, 0.3, 2.5, DEFAULTS.boatPace),
@@ -687,6 +731,19 @@ const PRESET_FPS = { high: 90, balanced: 60, low: 30 };
 
   function blurCss(state) {
     if (!state.frost || state.glassMode !== 'css' || state.perf) return '';
+    const columns = 'body [data-slot="sidebar"], body .dshDesktopSidebarSurface, body [data-rightbar-col], body .dshDesktopDetailsSurface';
+    // 2.0.7: a backdrop-filter is re-sampled by the compositor every frame the
+    // scene under it changes, which is every frame. `static` keeps the frosted
+    // fill (painted by glassCss) but stops re-sampling; `off` also drops the
+    // column fill, so the columns read as plain windows.
+    if (state.glassBlurMode === 'static') {
+      return `/* static glass: fill stays, the live backdrop sample does not */
+${columns} { -webkit-backdrop-filter: none !important; backdrop-filter: none !important; }`;
+    }
+    if (state.glassBlurMode === 'off') {
+      return `/* glass blur off: no live sample and no column fill */
+${columns} { -webkit-backdrop-filter: none !important; backdrop-filter: none !important; background-color: transparent !important; }`;
+    }
     const column = (selector, key) => {
       const entry = state[key];
       // one radius for the frame, each column takes a share of it
@@ -1075,6 +1132,12 @@ body:not([data-ds-dark-theme]) #${IDS.button}.active { color:#0a4f4d; border-col
         overflow: seaOverflow(),
         quality: state.quality,
     fps: state.fps,
+        // 2.0.7 performance switches; glassBlurMode stays on this side, it only
+        // rewrites our own CSS and never reaches the renderer
+        perfScheduler: state.perfScheduler,
+        pauseWhenObscured: state.pauseWhenObscured,
+        webgl2Adaptive: state.webgl2Adaptive,
+        resizeDebounce: state.resizeDebounce,
         glow: state.glow,
       });
     };
@@ -1709,6 +1772,11 @@ body:not([data-ds-dark-theme]) #${IDS.button}.active { color:#0a4f4d; border-col
       frame.addEventListener('load', () => {
         postSun();
         postGlass();
+        // a fresh frame boots believing it is on screen; correct that at once
+        if (typeof postActive === 'function') {
+          lastActive = null;
+          postActive();
+        }
         postBoats();
           postToOcean(state.waveMode === 'manual' ? state.sea : seaValue);
         // The frame boots with one boat on the water; the poll below reposts the
@@ -1718,6 +1786,34 @@ body:not([data-ds-dark-theme]) #${IDS.button}.active { color:#0a4f4d; border-col
         if (glassTimer) window.clearInterval(glassTimer);
         glassTimer = window.setInterval(postGlass, 1500);
       }, { once: true });
+      // 2.0.7: forward whether this window is actually the one on screen. The
+      // surface lives in an iframe, which is never a tab: it sees neither
+      // visibilitychange (that one it does see) nor focus (that one it never
+      // gets), so a covered DSH window looked identical to an idle one and the
+      // sea kept drawing at full rate behind whatever was on top. Debounced,
+      // because alt-tabbing flickers focus and stopping/starting per flicker
+      // would cost more than it saves.
+      let activeTimer = 0;
+      let lastActive = null;
+      const postActive = () => {
+        const active = !document.hidden && document.hasFocus();
+        if (active === lastActive) return;
+        lastActive = active;
+        post({ type: 'oss-active', active });
+      };
+      const scheduleActive = () => {
+        if (activeTimer) window.clearTimeout(activeTimer);
+        activeTimer = window.setTimeout(postActive, 500);
+      };
+      window.addEventListener('focus', scheduleActive);
+      window.addEventListener('blur', scheduleActive);
+      document.addEventListener('visibilitychange', scheduleActive);
+      surfaceCleanups.push(() => {
+        window.removeEventListener('focus', scheduleActive);
+        window.removeEventListener('blur', scheduleActive);
+        document.removeEventListener('visibilitychange', scheduleActive);
+        if (activeTimer) window.clearTimeout(activeTimer);
+      });
       ownsSurface = true;
       return true;
     };
@@ -1836,11 +1932,18 @@ body:not([data-ds-dark-theme]) #${IDS.button}.active { color:#0a4f4d; border-col
 <p class="oss-sub" data-copy="colsNote"></p>
 ${switchRow(pid('perf'), 'perf')}
           <p class="oss-sub" data-copy="glassNote"></p>`)}
+        ${group('secPerf', `
+          ${switchRow(pid('perf-scheduler'), 'perfScheduler')}
+          ${segRow(pid('pause-mode'), 'pauseWhenObscured', [['pause', 'pauseModes.pause'], ['throttle', 'pauseModes.throttle'], ['off', 'pauseModes.off']])}
+          ${switchRow(pid('webgl2-adaptive'), 'webgl2Adaptive')}
+          <p class="oss-sub" data-copy="perfNote"></p>`)}
         ${group('secAdvanced', `
           <p class="oss-sub" data-copy="perfGroup"></p>
           ${segRow(pid('quality'), 'qualityMode', [['high', 'quality.high'], ['balanced', 'quality.balanced'], ['low', 'quality.low']])}
           ${rangeRow(pid('glow'), 'glow', 0, 100, 1)}
         ${segRow(pid('fps'), 'fpsMode', [['30', 'fps.30'], ['60', 'fps.60'], ['90', 'fps.90'], ['120', 'fps.120']])}
+${switchRow(pid('resize-debounce'), 'resizeDebounce')}
+          ${segRow(pid('glass-blur-mode'), 'glassBlurMode', [['live', 'glassBlurModes.live'], ['static', 'glassBlurModes.static'], ['off', 'glassBlurModes.off']])}
 <p class="oss-sub" id="${pid('perf-out')}"></p>
           <div class="oss-row"><button type="button" class="oss-reset" id="${pid('make-default')}" data-copy="makeDefault"></button></div>
           <p class="oss-sub" id="${pid('default-out')}"></p>
@@ -1857,6 +1960,9 @@ ${switchRow(pid('perf'), 'perf')}
       const moonBox = el('moon');
       const perfBox = el('perf');
       const frostBox = el('frost');
+      const schedulerBox = el('perf-scheduler');
+      const webgl2Box = el('webgl2-adaptive');
+      const resizeDebounceBox = el('resize-debounce');
       const milkyOut = el('milky-out');
       const boatsBox = el('boats');
       const meteorBox = el('meteor');
@@ -1970,6 +2076,9 @@ ${switchRow(pid('perf'), 'perf')}
         moonBox.checked = state.moon;
         perfBox.checked = state.perf;
         if (frostBox) frostBox.checked = state.frost;
+        if (schedulerBox) schedulerBox.checked = state.perfScheduler;
+        if (webgl2Box) webgl2Box.checked = state.webgl2Adaptive;
+        if (resizeDebounceBox) resizeDebounceBox.checked = state.resizeDebounce;
         if (meteorBox) meteorBox.checked = state.meteor;
       if (daylightBox) daylightBox.checked = state.starsDaylight;
         if (boatsBox) boatsBox.checked = state.boats;
@@ -1984,6 +2093,8 @@ ${switchRow(pid('perf'), 'perf')}
       // every performance button unlit even though one of them was in effect
       setSeg(el('quality'), state.quality);
       setSeg(el('fps'), String(state.fps));
+      setSeg(el('pause-mode'), state.pauseWhenObscured);
+      setSeg(el('glass-blur-mode'), state.glassBlurMode);
       if (milkyOut) milkyOut.textContent = milkyText();
         for (const [key, entry] of Object.entries(columns)) {
           const entryState = state[key];
@@ -2159,6 +2270,8 @@ ${switchRow(pid('perf'), 'perf')}
       case pid('glass-style'): return { glassStyle: value };
             case pid('quality'): return { quality: value, fps: PRESET_FPS[value] || state.fps };
       case pid('fps'): return { fps: Number(value) };
+            case pid('pause-mode'): return { pauseWhenObscured: value };
+            case pid('glass-blur-mode'): return { glassBlurMode: value };
             default: return null;
           }
         })();
@@ -2225,6 +2338,24 @@ ${switchRow(pid('perf'), 'perf')}
         updateGlass();
         postGlass();
       });
+      if (schedulerBox) {
+        on(schedulerBox, 'change', () => {
+          void save({ perfScheduler: schedulerBox.checked });
+          postSun();
+        });
+      }
+      if (webgl2Box) {
+        on(webgl2Box, 'change', () => {
+          void save({ webgl2Adaptive: webgl2Box.checked });
+          postSun();
+        });
+      }
+      if (resizeDebounceBox) {
+        on(resizeDebounceBox, 'change', () => {
+          void save({ resizeDebounce: resizeDebounceBox.checked });
+          postSun();
+        });
+      }
       const makeDefaultBtn = el('make-default');
       const defaultOut = el('default-out');
       const refreshDefaultOut = () => {
@@ -2568,7 +2699,7 @@ ${switchRow(pid('perf'), 'perf')}
   // Stamped into both halves so a report can name which copy the browser is
   // actually running: the panel and the frame are loaded by different paths and
   // a stale one looks exactly like a bug.
-  const SKIN_BUILD = 'lab-2.0.4';
+  const SKIN_BUILD = 'lab-2.0.7';
 
   exports.name = 'open-sea-skin-client';
   exports.inject = ['slots'];