dsh-perf-boost

DeepSeek Harness 桌面端的客户端渲染优化插件，全部改动只发生在渲染进程。

Client-side rendering optimizations for DSH Desktop.

设置入口：设置 → 性能优化

更新详情

0.2.2

• 优化了长对话省渲染的实现，改成一处分样式接管子项，新消息进来自动生效的效果
• 修复了流式输出时每来一条消息就扫一遍页面的问题，改成一分钟几十次的空闲巡检的问题

0.2.1

• 新增了「大会话预热」的开关，设置页里点一下就能关的功能
• 新增了浅色模式下的配色，开关和分隔线跟着文字颜色走的效果
• 优化了开关说明的文字，统一改成「可能会导致……」的效果
• 新增了百分比改成最近 1 分钟窗口，长时间使用不会越用越低的功能
• 优化了开关列表的顺序，默认开启的排在前面、默认关闭的放在后面的效果

0.2.0

• 新增了设置页「更新详情」，能直接看到每个版本改了什么的功能
• 新增了滚动时让路，滚动过程中不再扫列表、停手后再补的效果
• 新增了长任务让路，超过 50 毫秒的卡顿之后等主线程缓过来再扫的效果
• 新增了视口外图片低优先级解码，把带宽留给看得见的图的效果
• 新增了窗口不可见时暂停 CSS 动画，合成器不再空转的效果
• 修复了大会话预热会去读正在写入的会话文件的问题
• 优化了列表观察范围，从盯整页收窄到只盯消息列表的效果
• 优化了每个开关的说明，把可能会导致写清楚的效果

开关

按默认状态排序，前六项默认开启，对观感没有可见影响。

开关	默认	影响视觉	作用
长对话省渲染	开	无	给滚动列表容器挂一个 class，子项的 content-visibility: auto 由一条 CSS 规则接管（新消息自动生效，不用逐个打 inline style），占位高度取该列表实测平均子项高度；末尾 4 项与标了 aria-busy 的消息保持正常渲染，代码块单独按 300px 跳过
窗口隐藏不排帧	开	无	页面不可见时 schedule() 直接返回；切回时有 visibilitychange 钩子恢复，每秒看门狗兜底
空闲降帧	开	无	20 秒无输入将 rAF 驱动的动画降到 30fps，有输入立即恢复
媒体懒加载	开	无	图片加 loading=lazy、decoding=async，视频加 preload=metadata
后台暂停定时器	开	无	页面不可见时跳过 setInterval 回调，不销毁也不重置周期；回到前台各补跳一次
视口外暂停视频	开	无	仅处理静音视频：滚出视口暂停解码，滚回续播
会话列表节流	开	无	流式输出时把「只有 token 计数变了」的列表发布攒到每秒一次；可见字段变了立刻放行
大会话预热	开（宿主侧）	无	启动 15 秒后把最近 10 个 8MB 以上会话分段读进系统文件缓存，只读，跳过 10 分钟内改过的会话
关闭背景模糊	关	有	全局 backdrop-filter: none，浮层由磨砂改为纯色底
减少动画	关	有	动画与过渡时长置 0.001ms，弹窗不再逐帧动
帧率角标	关	有	右下角显示 NN fps

每个开关的说明里都标了可能会导致，这里汇总一次：

开关	可能会导致
长对话省渲染	快速滚动时，被跳过的行可能空白一瞬，紧接着补上
窗口隐藏不排帧	后台标签页里的动画会停，切回前台补一帧
空闲降帧	长时间不动，动画看起来变慢；动一下鼠标立刻恢复
媒体懒加载	快速拖到很远处的图片可能先白一下再出来
后台暂停定时器	隐藏期间攒下的轮询只补一次，个别插件会看到一次跳变
视口外暂停视频	滚回来时可能黑一下或重新缓冲
会话列表节流	侧栏 token 数字最多晚 1 秒才跳
大会话预热	读盘那几十秒里机械盘/低配机器打开会话可能反而慢一点，磁盘占用升高

不提供预设档位。

验证

• 「长对话省渲染」行下方显示 已生效：N 个列表，跳过 M 项渲染（共 K 项）
• 打开「帧率角标」，右下角出现 fps 小方块
• 控制台 window.__dpbRaf、window.__dpbTimers 为 true，表示 rAF 与定时器接管成功

角标读数为浏览器实际送帧数，上限等于显示器刷新率。帧时、DOM 节点等细分数据请用 DevTools 的 Performance 面板录制，插件不做常驻采样。

实测

Windows 桌面端，200Hz 显示器，缩放 100%：

场景	帧率	p50 帧时（DevTools）
空白页（同机 Edge）	187–200	5.0 ms
DSH 页面（新会话，DOM 1218）	200	5.0 ms
DSH 桌面端（2.3 万事件会话）	约 156	≈6.4 ms

页面代码本身可以跑满刷新率，差距来自长会话的 DOM 体量与 Electron 窗口合成。

安装

pnpm add dsh-perf-boost
pnpm add github:AlLHHH/dsh-perf-boost
pnpm add file:./dsh-perf-boost

将 dsh-perf-boost 加入 profile 的 dsh.profile.bundles，重启应用生效；卸载时从 bundles 移除并重启。

实现说明

• 只修改当前渲染进程：不改宿主代码，不落盘配置，不发送遥测。配置存于 localStorage['dsh-perf-boost:cfg']。
• 唯一的网络请求是「检查更新」：页面 POST 到 /api/dsh-perf-boost/update-check，由宿主查询 npm 的 latest（CSP 限制页面不能直接跨域）。查询失败显示「未查到」，不影响功能。
• requestAnimationFrame 仅在启用「窗口隐藏不排帧」或「空闲降帧」时接管，否则保持原生实现。

大会话预热可以在设置页里关掉，也可以在插件配置里写 warmup: false 一次性关掉。

已知限制

• 窗口的 transparent / vibrancy 由应用自身（app.asar 的 lib/main.js）决定，Windows 分支不透明，插件无法修改。
• 省渲染只减少布局与绘制，消息节点仍在内存中，超长会话的滚动开销依然存在。
• 媒体懒加载只修改属性，不改动 DOM 结构，已加载的图片不会被回收。

兼容

• engines.dsh >= 0.2.0-0，实测 0.2.1-rc.3（桌面版 0.2.1.0）
• peer @deepseek-ai/cordis ^4.0.1，实测 4.0.5
• 依赖客户端插件 API：window.__ModuleLoader__.load、slots（settings.section）、require('react')

许可

MIT