🖥️ dsh-idle-crt

十分钟没动静，给终端亮一块显像管。

DSH 闲着、并且超过设定时间没人碰鼠标键盘时，页面盖上一块 CRT 板——辉光字、扫描线、循环反色扫掠；在窗口里点一下或按个键就消失。

来源声明：本项目是 justawebsite/dsh-splash-crt 的衍生改造（adaptation）。 上游把它做成「启动一闪而过的 CRT 闪屏」，本插件把它改成「待机时才出现的屏保」， 并补上了空闲检测、输入语义、与其它插件的共存层、设置页与 GPU 合成。 画面部分（CRT 着色器、反色扫掠、辉光字排版）源自上游，MIT 协议，版权归其作者。 详细改动与致谢见 来源与致谢。

为什么是它

系统屏保管不了「这一页」。Windows 的屏保是从整机层面等的，可 DSH 在跑长任务时你未必想让它盖掉进度；反过来，你去泡杯咖啡回来，系统屏保又不会告诉你「这十分钟 Agent 没在干活，可以放心走开」。

这个插件只做一个很窄的判断：DSH 里没有正在跑的会话（宿主给出 busy=false），并且这个页面十分钟没人碰过鼠标键盘——两个条件都满足，才盖板。有活干时它一次都不会出现；你回来点一下，它立刻淡出，页面还是原来的页面。

不抢焦点、不劫持输入：只在窗口内点击/按键/触摸/右键时才收板；滚轮只锁滚动；鼠标移动默认不收起，只让整个画面跟着指针做一点点视差微动（followMouse，可关）。没有全局快捷键，没有常驻在别的插件里的钩子。

零依赖、全 GPU：运行时零依赖；文字只在上板时栅格化一次，之后每帧只有一个 drawArrays，RTX 4060 上 p50/p99 都是 16.7 ms（满 60 fps）。

一眼

一轮完整循环 38 秒（预热 → 白色反色扫掠 → 停留 → 黑色反向扫掠 → 停留），这里 12.5 fps、560×315 抽样（8.8 MB）；真实画布是 60 fps 的全屏 GPU 合成。

网速一般的话看这两个小一点的版本（内容一样，尺寸与帧率不同）：

• 4 MB 版 · 480×270 · 8.33 fps
• 2 MB 版 · 320×180 · 8.33 fps
• 竖版海报（2160×3240，可当桌面/宣传图）

| 预热瞬间 | 设置 → 待机屏保 | |---|---| | | |

快速开始

要求：DSH 0.2 及以上，浏览器端支持 WebGL（这机器上基本都满足）。

从 npm 装（推荐）

dsh plugin --profile desktop add dsh-idle-crt

或者链一个本地目录（改代码时更方便）

dsh plugin --profile desktop add link:G:/DSH/dsh-idle-crt

装完重启一次 DeepSeek Harness（客户端模块清单在启动时扫描），之后：

装好之后 30 秒自检

1. 打开 设置 → 待机屏保，能看到开关和参数，就说明设置页注册成功；
2. 点 立刻看一眼：板子应该盖上来，按任意键或点一下消失；
3. 想验证「无人时才出现」，把阈值临时改成 1 分钟，别碰页面等一分钟；看完记得在设置页点「恢复默认」。

只想临时看效果、不装插件：node tools/preview-server.mjs 8791，打开 http://127.0.0.1:8791/tools/preview.html。

什么时候出现，什么时候消失

出现（两个条件同时满足）

1. DSH 没有正在跑的活（busy=false）；
2. 距离上一次页面内输入超过阈值（默认 10 分钟），且标签页是可见的。

消失

• 在窗口里点一下、按一个键、触摸一下、右键一下 —— 立刻淡出；
• 鼠标只是移动不算（默认如此），但画面会跟着指针轻轻偏一点（followMouse，默认开）——像隔着一层玻璃看，动画照常走；这是刻意的：「动一下鼠标就收起」的老式屏保，在被远程桌面、被猫碰到的桌子上是灾难；配置里可改回老行为（dismissOnMove）；
• 滚轮只锁住页面滚动，不收起画面——滚动一下往往只是「人在看」。

不会出现的情况：页面里有全屏元素、有打开的模态框（aria-modal）、有面积 ≥ 视口 20% 的正在播放的视频；标签页在后台。别的插件也可以主动按住它（见下节）。

和别的插件共存

这类「全屏覆盖层」最容易跟主题、宠物、HUD 打架，所以这里是显式处理的：

• 叠得上去：挂载时量一遍 body 下所有大面积浮层的最大 z-index，取 max+10；之后 MutationObserver 盯新挂的层 + 每 500 ms 复查，别人的 HUD 后挂也会被追上（单调不回退）。收板后页面原状。
• 自动让路：全屏、aria-modal 对话框、占视口 ≥20% 的播放中视频。小尺寸的装饰视频（例如宠物挂件那种 440×248 的循环动画）不算——否则屏保永远不出现。
• 合作信号：板子盖着时 <html data-dsh-idle-crt="active">，别的动画插件可以据此暂停自己的动画；收板即清除。
• 请它让一让：window.__DSH_IDLE_CRT__.hold('reason') / .release('reason')（成对使用），整页禁用用 window.__DSH_IDLE_CRT_SUPPRESS__ = true。
• 调试接口：__DSH_IDLE_CRT__.snapshot()、.show()、.hide()、.setBusy(v)、.setIdleMs(ms)、.activity()。

配置

设置页是「设置 → 待机屏保」；也可以直接写 $DSH_HOME/idle-crt.settings.json，或者改插件行配置（cordis.patch.yml）。 优先级：设置页写下的文件 > 插件行配置 > 内置默认。

| 键 | 类型 | 默认 | 说明 | |---|---|---|---| | enabled | bool | true | 总开关 | | idleMs | number | 600000 | 多久没输入才出现（ms），设置页按分钟填 | | pollMs | number | 1500 | 向宿主查询 busy 的间隔（ms） | | fadeInMs | number | 320 | 出现时的淡入 | | fadeOutMs | number | 600 | 消失时的淡出 | | bootMs | number | 1400 | 显像管「点亮预热」时长 | | wipeStartMs | number | 4000 | 画面出现后多久开始第一次反色扫掠 | | wipeMs | number | 14000 | 一程扫掠多久（白、黑各一程，交替循环） | | wipeHoldMs | number | 5000 | 每程扫完停留多久 | | scanlineIntensity | number | 1 | 扫描线强度 0–2 | | promptText | string | PRESS ANY KEY TO CONTINUE | 底部提示语（留空用默认，最长 80 字符） | | dismissOnMove | bool | false | 鼠标移动也收起（老式屏保行为） | | followMouse | bool | true | 画面跟着鼠标轻微偏移（视差微动；不打断动画、不会因此收起） |

改完点「保存」：画面参数当场热更新，同时写进 $DSH_HOME/idle-crt.settings.json，下次开 DSH 仍然生效。

工作原理

两个半边：

• 宿主半边（lib/index.js）：订阅 agent/status 与 api-session/status 维护「哪些会话在跑」，并在每次 state.json 请求时用 agents.list() 重算一遍兜底；对外只暴露 /dsh-idle-crt/{state,settings}.json 与画面脚本。
• 浏览器半边（lib/plate.js，自举脚本 + 一个独立客户端模块 lib/client.js 提供设置页）：控制器盯着输入与 state.json，够条件才挂载画面。

画面本身是一条 GPU 管线：

1. 文字（DEEPSEEK / HARNESS / TUI 行 / 底部提示 / 辉光 / 扫描线洞）在挂载时画进两张离屏图层，上传成两张纹理——只在窗口尺寸或提示语变化时重做；
2. 每帧只设几个 uniform、一次 drawArrays：预热斜坡、灯管闪烁、亚像素摆动、提示语渐显与呼吸、扫描线、滚动亮带、颗粒、暗角、RGB 色散、反色扫掠与青色边界、淡出，全部在片元着色器里；
3. 指针视差也是采样坐标上的两个数（uParallax），整帧一起偏，不重绘、不动时间轴；
4. 没有任何逐帧的 2D 绘制或纹理上传。

性能

1440×900、6 秒稳态采样（rAF 间隔）：

| 版本 / 路径 | 平均 | p50 | p99 | |---|---|---|---| | 0.1.4 每帧重画 2D（SwiftShader） | 90.3 ms | 83.4 | 150 | | 0.1.5 层缓存 + 隔帧上传（SwiftShader） | 41.4 ms | 49.9 | 83.3 | | 0.2.0 全 GPU 合成（SwiftShader，软渲染上限） | 32.5 ms | 33.3 | 50 | | 0.2.0 全 GPU 合成（RTX 4060 / ANGLE D3D11） | 16.6 ms | 16.7 | 16.8 |

真机上 p99 与 p50 相同——满帧 60 fps。复测：node tools/diag-perf-gpu.mjs 8791 gpu（会打印实际 renderer 名字）。

兼容性

| 项 | 情况 | |---|---| | DSH | ≥ 0.2；0.2.2-rc.1 桌面端实测 | | 运行时 | Electron 桌面端、浏览器 Web 都行（要有 WebGL） | | 渲染 | WebGL2 优先，自动回退 WebGL1；内部渲染宽度封顶 1600 px（保 60 fps） | | 同场实测 | dsh-theme-mls-desktop（主题壳/设置面板）、dsh-pet（小尺寸循环视频）、billion-context / 上下文洞察（大面积深色画布）、dsh-better-display（高 z-index HUD）、archive-manager | | 不适用 | CLI/TUI（没有页面）、无 WebGL 的环境 |

已知限制

• 只统计 DSH 页面内的输入。系统别处动鼠标不算——这是设计，不是 bug。
• 不上锁、不遮系统屏。它盖的是 DSH 这一页；要锁整机请用系统屏保/锁屏。
• DSH 窗口在后台、或标签页不可见时不会出现（没有理由给一个看不见的页面做动画）。
• 视差幅度固定 ±1.2% 视口，暂不可调。
• 「正在播的视频」让路阈值是视口面积 20%：介于两者之间的中号视频会挡住屏保（有意的保守）。
• 内部渲染宽度封顶 1600 px：4K 全屏会略软，换来的是满帧。

常见问题

十分钟没动，为什么没出现？ 按顺序查：① 是不是有任务在跑（宿主 busy=true）；② 标签页是不是在后台；③ 页面里有没有全屏、模态框、大视频；④ 是不是别的插件调了 hold() 或设了 __DSH_IDLE_CRT_SUPPRESS__；⑤ 设置页开关是不是被关了。window.__DSH_IDLE_CRT__.snapshot() 会直接告诉你 mode / busy / blocked / idleFor。

想立刻看效果，不想等十分钟？ 设置页点「立刻看一眼」；或在控制台 __DSH_IDLE_CRT__.show('demo')（不会修改你的阈值）。

会不会拖慢 DSH？ 不会：板子只在盖住时跑，逐帧只有一个 drawArrays；收起后不留 rAF、不留 DOM。真机 p99 16.8 ms。

和主题/宠物/截图插件打架吗？ 不会互相覆盖：板子会爬到现有最高浮层之上，并在全屏、模态框、大视频出现时自动让路；别的插件也可以 hold() 让它等一等。见和别的插件共存。

鼠标一动就消失，能改回来吗？ 能。设置页打开「鼠标移动也能收掉」（dismissOnMove），回到老式屏保行为。

能只在某个工作区生效吗？ 暂不支持（按窗口/页面生效）。需要的话可以提 issue。

怎么卸载？ dsh plugin --profile desktop remove dsh-idle-crt，再删掉 $DSH_HOME/idle-crt.settings.json（不删也无害）。

会不会发网络请求？ 不会。插件没有任何外发请求，设置只写本地一个 json 文件；详见数据与信任。

开发

npm install                      # 只装 esbuild（其余零依赖）
node tools/build.mjs             # src/client/index.js -> lib/plate.js
node tools/preview-server.mjs 8791
# 打开 http://127.0.0.1:8791/tools/preview.html   （可加 ?bare=1 / ?freeze=screen1:6 / ?idle=2）

目录：

lib/index.js        宿主半边：busy 跟踪、设置读写、路由
lib/bootstrap.js    注入到页面 <body> 的自举脚本（只负责拉起画面脚本）
lib/plate.js        画面脚本（esbuild 打包产物，改 src 后重新 build）
lib/client.js       设置页（dsh.client 客户端模块，注册到 settings.section）
src/client/index.js 画面源码
tools/              构建、预览、验收、性能探针

验收脚本（都要带 base URL，桌面端每次重启端口会变）：

| 脚本 | 验什么 | |---|---| | verify-preview.mjs <base> | 预览页：像素、反色、移动不收、点击收、busy 压制 | | verify-gui.mjs <base> | 真 GUI：出现、z 轴、marker、移动不收、点击收、页面仍可用 | | verify-cycle.mjs <base> | 一轮循环：键盘关→再现→移动/滚轮不关→点击关→hold/release | | verify-compat.mjs <base> | 共存：更高 HUD、模态框、大视频让路、小宠物视频不挡、SUPPRESS | | verify-settings-gui.mjs <base> | 设置页：字段、保存落盘、立刻看一眼 | | diag-perf-gpu.mjs <port> gpu\|sw | 帧率与真实 renderer 名 |

重录 README 里的循环 GIF（画面被逐帧钉在时间轴上，不用屏幕录制，所以没有撕裂）：

node tools/preview-server.mjs 8791        # 另开一个窗口
node tools/record-gif.mjs http://127.0.0.1:8791   # 475 帧 → _frames/
python tools/gif-encode.py 560 64 none 1           # → docs/plate-cycle.gif（8.8 MB，475 帧，12.5 fps）
python tools/gif-encode.py 480 64 none 1 3 8.33    # → docs/plate-cycle-5mb.gif（4.3 MB，317 帧）
python tools/gif-encode.py 320 48 none 1 3 8.33    # → docs/plate-cycle-2mb.gif（1.8 MB，317 帧）
node tools/comment-frames.mjs                 # 取评论配图用的两帧（待机 / 扫掠中）
node tools/poster-shot.mjs                    # 重渲染 docs/poster.png（宣传海报，2160×3240）
python tools/comment-image.py _shots/comment-idle.png _shots/comment-sweep.png

python 需要 Pillow；没有的话用 DSH 自带的 python（dsh-runtimes/dsh-primary-runtime/dependencies/python/python.exe）。 帧图只在本地，_frames/ 已进 .gitignore。

插件页图标读的是包根的 icon.svg（package.json 的 exports["./icon"] 指过去），README 顶部用的是同一个文件—— 所以 GitHub 首页和 DSH 插件列表里看到的是同一枚显像管图标。

宿主路由（除调试路由外都在 /dsh-idle-crt/ 下）：state.json、settings.json（GET/POST）、client.js、bootstrap.js； 调试用的 auth-url.json / debug.json / diag 仅回环可访问。

版本记录

• 0.3.0 — 默认模式下的视差微动：鼠标移动不收起画面，但整帧跟着指针偏 ±1.2%（followMouse）。
• 0.2.7 — 画面顶部那行改成真能执行的安装命令（原来只是装饰文案）。
• 0.2.0 — 逐帧合成全部搬进片元着色器（两张预渲染纹理），4060 上 60 fps。
• 0.1.5 — 文字层缓存 + 隔帧上传，软件渲染下从 90 ms 降到 41 ms。
• 0.1.0 — 首个可用版本：busy 检测、输入语义、共存层、设置页与持久化。

数据与信任

• 不联网：插件没有任何外发请求，画面与设置都在本机。
• 只写一个文件：$DSH_HOME/idle-crt.settings.json（默认 C:\Users\<你>\.dsh\idle-crt.settings.json）。删掉它就回到内置默认。
• 调试路由只在回环：auth-url.json（给无头测试换登录 Cookie）与 debug.json/diag 只在 127.0.0.1 / ::1 可用，非回环一律 403。
• 不动 DSH 本体、不注册全局快捷键、不改别的插件的 DOM。

来源与致谢

上游（本项目的来源）

• justawebsite/dsh-splash-crt —— MIT，CRT 画面、反色扫掠算法、辉光字排版均来自这里，作者 justawebsite 及其贡献者。 上游做的是「DSH 启动时一闪而过的闪屏」；本插件把它改成「闲置十分钟后才出现的待机屏保」， 保留上游的画面语言与着色器思路，重写了触发、输入、共存与渲染路径。

本仓库相对上游的主要改动

1. 触发：从「启动时无条件显示」改为「宿主 busy=false 且页面内闲置超阈值」，并去掉启动时隐藏页面的行为；
2. 输入：默认只有「窗口内点击 / 按键」才收板（上游是任意输入），滚轮改为只锁滚动，新增 dismissOnMove 开关；鼠标移动默认不收起，改为让整个画面跟着指针做 ±1.2% 的视差微动（followMouse，采样层位移，不重绘、不动动画时钟）；
3. 宿主：新增 busy 检测（agent/status + api-session/status + agents.list() 兜底）、设置持久化与 state.json/settings.json；
4. 新增一整页设置界面（settings.section 槽位），改完参数当场生效并落盘；
5. 共存层：z-index 动态爬升、全屏/模态/视频让路（含 20% 视口门槛）、hold/release、data-dsh-idle-crt="active" 合作信号；
6. 渲染：从「每帧重画 2D + 上传纹理」改为「图层一次上传 + 片元着色器逐帧合成」，真机 60 fps；
7. 工程：esbuild 构建、预览页、五套 Playwright 验收脚本与性能探针。

致谢

• justawebsite 与 dsh-splash-crt 的贡献者：没有那块板就没有这个插件。
• DeepSeek Harness 与 Cordis 插件系统：webserver/index-inject、settings.section、dsh.client 这些入口让「不改本体」成为可能。
• 本机实测中与它同场竞技、也顺手暴露了不少坑的插件：dsh-theme-mls-desktop（主题壳与设置面板）、dsh-pet（小尺寸自动播放视频一度让它永不出现）、billion-context / 上下文洞察（大面积深色画布与浮层）、dsh-better-display（高 z-index HUD）。共存逻辑基本都是被它们逼出来的。
• 上游 README 里那份动画时间轴的说明，本项目的默认参数直接沿用了它的节奏。

许可证

MIT。上游同为 MIT；本仓库保留上游版权声明，衍生部分版权归 dsh-idle-crt contributors。