黑客帝国主题 zengrz/dsh-matrix-theme

dsh-matrix-theme

给 dsh web GUI 用的《黑客帝国》电影主题，做成可安装插件：可选主题 matrix（黑底绿字配色，基于 dark 基底）、数字雨氛围背景（忠实移植自 zengrz.github.io 的字形墙）、它在通用设置里的开关行，以及一行雨滴质量选项——在较慢的机器上牺牲背景效果换性能。一个包身兼两职：dsh.bundle 补丁层（cordis.patch.yml 插入 ui-matrix-theme 浏览器名册行）和 dsh.client 插件本体（lib/client.js，已预构建并提交——安装时不跑构建步骤）。

dsh web GUI 中启用的《黑客帝国》主题

安装

dsh plugin --profile <name> add github:zengrz/dsh-matrix-theme

锁定某个 commit，这样之后的 push 就无法悄悄改变实际运行的代码：

dsh plugin --profile <name> add github:zengrz/dsh-matrix-theme#<sha>

不需要构建权限（allowBuilds）：发布的入口点已提交，包内也没有 prepare 脚本。

环境要求与兼容性

- 在声明了 shell.backdrop 槽位的 harness 上（即引入氛围背景槽位的那个 dsh 版本所带的 ui-layout），雨滴渲染在框架的背景层内——位于所有列之下，可点击穿透，由槽位系统管理。
- 在早于 shell.backdrop 槽位的 harness 上（例如 dsh 0.1.0-rc.8），插件在启动时检测到槽位缺失，回退到 app 根节点之后一个固定定位的 DOM canvas，驱动同一个 RainEngine。配色和通用设置开关在两条路径上表现一致，只有背景的挂载位置不同。若之后声明了该槽位（例如会话中途通过 HMR 升级 harness），回退方案会自行退场。
- 补丁只追加，不去重：把本插件加到某个配置档，而该配置档的层里已经注册了 ui-matrix-theme——官方 dsh-web-app bundle 从同一版本起就内置了该主题——加载会失败，报 duplicate loader entry id: ui-matrix-theme。这类配置档本来就有主题；本插件面向的是自定义浏览器界面名册，以及早于该主题的 web-app 版本。
- 浏览器那一半从宿主配置档自己的客户端栈里解析平台对等依赖（react、@deepseek-ai/dsh-client-* 模块表）；本仓库只打包主题自身的代码。

雨滴质量

通用设置区新增一行 Rain effects（位于 Matrix 主题行下方，matrix 主题启用时可见），共三档：

- Full —— 忠实还原参考效果：全密度字形墙、逐字形更替、光标聚光，以及 3D 倾斜。
- Lite — 适合老旧机器或集成显卡：列/行网格按半密度绘制（每帧字形绘制量降到四分之一），去掉字形扰动和光标聚光，淡到几乎看不见的列直接剔除。低成本标志性效果（3D 倾斜和白色单元格行进）保留。
- Off — 完全不使用 canvas：绿色调色板保留，雨滴不产生开销（与 prefers-reduced-motion: reduce 走同一套跳过逻辑）。

该档位是插件自有的浏览器偏好，持久化到 localStorage，键为 dsh-matrix-theme:rain-quality；存储失败只会禁用持久化。雨滴运行期间切换档位会替换引擎（网格按新密度重建）。

模型体验

无：主题只管理浏览器侧偏好（主题选择和雨滴质量），背景是装饰性的（aria-hidden）；不会有任何内容进入模型请求。

重新构建产物

lib/ 已提交。编辑 src/ 后要重新生成，请在 deepseek-harness 检出目录内构建（客户端 bundle 的 loader-handoff id 必须与本包名一致）。创建机器本地的 build.tsdown.config.ts（已 gitignore）：

import { clientBundle } from '<harness>/packages/client/tsdown.client.ts'
export default clientBundle('dsh-matrix-theme', ['src/index.ts'])

然后运行：

cd <this-repo>
ln -sfn <harness>/packages/client/ui-matrix-theme/node_modules node_modules
<harness>/node_modules/.bin/tsdown --config build.tsdown.config.ts

License

MIT，与 dsh 家族一致。主题引擎移植自 MIT 许可的 zengrz.github.io 效果。