dsh-reduce-effects
Web UI 开关，可按类别关闭 DSH 前端动画、模糊、阴影、渐变和 JS 动效，以降低浏览器渲染成本
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:azazo1/dsh-reduce-effects#092350577fd8605b14469363c69eebf97eb4f4b9Reduce Effects 以 dsh-reduce-effects 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH Web 前端加一个插件页配置卡片, 用来关闭动画, 毛玻璃, 阴影, 渐变这类特效, 减少浏览器的渲染负担.
前端特效在 DSH 里是分散的: 一部分是 CSS 动画与过渡, 一部分是菜单与浮层的毛玻璃, 还有一部分是 DSH 自带的 JS 动效 (平滑翻页, 跟随滚动), 它们只在系统开启 "减少动态效果" 时才走即时路径. 这个插件把这些分成几个分类, 每个分类一个开关, 默认全部打开 (此时界面与原生 DSH 一致), 关掉哪一项就停哪一项; 另有一个总闸可以一次停掉全部特效.
Web 端装进 web profile:
dsh plugin --profile web add azazo1/dsh-reduce-effects
npm 上的包:
dsh plugin --profile web add dsh-reduce-effects
固定版本:
dsh plugin --profile web add azazo1/dsh-reduce-effects#v0.1.1
GitHub Release 同时挂不带版本号的预构建包, 安装时跳过 allowBuilds:
dsh plugin --profile web add https://github.com/azazo1/dsh-reduce-effects/releases/latest/download/dsh-reduce-effects.tgz
本地 checkout 也可以直接装目录:
dsh plugin --profile web add ./dsh-reduce-effects
装完重启 dsh web, 浏览器里刷新一次页面.
桌面端装进 desktop profile. 它由 Electron 应用独占管理, dsh plugin 会拒绝 --profile desktop, 所以要用应用内的插件管理器: 在插件页的安装入口填上面命令里对应的包名或 tarball 地址. 装上后重启应用, 窗口刷新一次.
引擎版本线要求 @deepseek-ai/dsh-* 不低于 0.1.7-rc.2, 且仍在 0.1.x 上 (peerDependencies 写作 >=0.1.7-rc.2 <0.2.0, devDependencies 同号对齐). 插件配置走 volatile Config, 插件页上的配置卡片经 configForms 读写同一份数据; 浏览器半区只向模块表请求 react 与 @deepseek-ai/dsh-client-ui-primitives. 更早的引擎线装不上这个版本.
web 与 desktop 两个 profile 跑的是同一套 Web 应用 -- 桌面端只是多起一个 Host 子进程, 并给 <html> 打上平台标记 -- 所以同一份包在两边通用, 不需要分别构建.
打开 插件 > dsh-reduce-effects 卡片. 卡片里是一个总闸加一组分类开关, 草稿只留在卡片里, 点 "保存" 才写进当前 profile 的 patch 层并立即生效. 所有开关默认打开, 也就是什么都不改; 下面表格说的是 "把这个开关关掉之后会失去什么".
| 开关 | 关掉之后 | 代价 |
|---|---|---|
| 全部特效 | 一次停掉下面每个分类 | 分项开关保留各自的值, 但重新打开总闸前不可点 |
| 动画与过渡 | 装饰性动画停掉, 过渡压缩到 1 毫秒 | 入场动画直接落到终态 |
| 加载与进度动画 | 进度条与加载指示器的旋转, 脉冲 | 界面看起来像卡住, 看不出还在不在跑 |
| 文字流光 | 运行中节点文字上来回扫动的高光, 以及思考行与技能行整行扫过的那道光 | 运行中节点只剩静止的普通文字, 整行扫光也不再出现. 这两道光的底子都是渐变加动画, 所以关 "渐变背景" 或 "动画与过渡" 也会顺带把它们收掉, 这一项只是更窄的一条收法 |
| 毛玻璃与背景模糊 | 菜单, 浮层的 backdrop blur | 半透明面板后面的内容直接露出 |
| 平滑滚动 | 滚动与跳转的缓动 | 长列表跳转更生硬 |
| 标题 hover 滚动 | 侧栏会话标题悬停时的逐帧横向拖动 | 被省略的标题只能靠悬停卡片或改名看全 |
| 阴影与超椭圆圆角 | 面板阴影, 文字阴影, 超椭圆圆角 | 面板的 0.5px 描边同样由阴影绘制, 边界会变淡 |
| 渐变背景 | 渐变底纹 | 渐变与图片共用 background-image, 以背景图实现的图片装饰也会消失; 以渐变当颜料的文字会退回当前文字色; 会话底部输入区用来遮住滚动消息的那层渐隐底板会退回一层纯主题底色, 顶部 36px 的渐隐随之变成硬边 |
| JS 动效 | DSH 自带 JS 动效的即时路径 | 影响页面内所有读取该偏好的代码 (含其他插件) |
总闸只决定各分类生不生效, 不去改写它们自己的值: 关掉它, 各分类开关变灰并保留原值; 重新打开, 各分类立刻回到原来的状态. 所以想单独保留进度条动画, 只要不关 "加载与进度动画" 那一项即可 -- 只有这一项关掉, 卡住和运行中才会看起来一样.
!important, 注入到一个带 data-plugin-css 标记的 <style> 里, 由插件持有并在卸载时移除.transitionend, 依赖它收尾的界面逻辑不受影响.document.getAnimations() 与 animationstart 逐个筛: 安装时扫一遍已有动画, 之后接住新出现的动画, 该停的循环动画 cancel 掉, 一次性入场动画 finish 到终态. 判据是关键帧名 (spin, progress, busy, pending, blink, dot 等视为加载反馈): 关动画与过渡时停装饰动画放行加载指示器, 关加载动画时反过来; 两者都关才改用全局的 1 毫秒动画规则.data-text-shimmer (只在运行中出现) 收掉 DSH TextShimmer 的渐变颜料与扫动关键帧, 写法与 DSH 自己在减少动态效果下的降级一致.dsh-reasoning-row-sweep 与 dsh-skill-row-sweep), 它不是 TextShimmer, 文字那一档碰不到. 这里按 data-variant="think" 加 data-disclosure-row, 以及 data-tool="skill" 这两个渲染期标记定位行容器, 把它的 ::after 的 content 去掉. 只停动画不行: 关键帧一停, 伪元素会留在起始帧的 left: 0, 那 300px 渐变照样画在行上.window.matchMedia, 让 prefers-reduced-motion 查询回答 reduce, no-preference 回答 false, 其他查询原样转发; 开关打开或卸载插件时恢复原函数.dsh-reduce-effects, 落在 profile 的 patch 层里, 卡片通过 ctx.configForms 读写同一份数据.prefers-reduced-motion 的代码, 包括其他插件; 已经渲染出来的界面可能需要刷新一次.just install
just typecheck
just build
just test
just verify
src/index.ts 是 Host 半区: 声明 volatile 的配置字段.src/settings.ts 是 Host 与浏览器共享的契约: 标识符, 字段名, 默认值与归一化.src/client/ 是浏览器半区: 效果计划, 样式生成, 动画守卫, matchMedia 覆盖, 以及插件页上的配置卡片.lib/ 是构建产物, 随包发布.MIT