前言¶

用 DeepSeek Harness（DSH）跑 Web 端智能体对话时，界面往往是「内容区 + 侧栏 + 输入框」的固定布局。长时间盯代码和流式输出，背景缺少变化，也缺少和 agent 忙闲状态联动的视觉反馈。给整窗加一层不影响点击的透明画布、把流式 token 混进雨里、让雨势随会话活跃度起伏——这是 @weibaohui/dsh-matrix 要解决的问题。它属于 DSH 社区目录里的「趣味换装」类插件，由 weibaohui 维护；与官方无从属关系，安装与运行仍在你本机的 dsh 进程权限之内。

下面介绍插件定位、核心能力、安装步骤和典型调参方式。事实以 GitHub README 与 npm 包 @weibaohui/dsh-matrix（当前 0.7.0）为准。

这是什么¶

一句话：在 DSH Web 对话窗口上方盖一层 position: fixed、pointer-events: none 的 Canvas 字符雨；英文数字矩阵、篆体「道法修仙」、甲骨「卜辞」三种显示模式可切，透明度、速度、密度、字号、深浅配色、金边发光等可调；宿主把 agent 流式 token 与活跃度经 SSE 推给客户端，雨势和雨里字符会跟着变。

维护与来源：

• 目录页：https://www.skillhub.cn/plugins/weibaohui/dsh-matrix
• 源码：https://github.com/weibaohui/dsh-matrix
• 许可证：MIT（package.json）
• 适配：dsh >= 0.1.7-rc.2，Node >= 22.5

核心功能¶

三模式与三轴组合¶

README 把显示拆成三个正交维度：

1. 模式：显示内容——黑客帝国（英文大写 + 数字 + 符号）、道法修仙（纯汉字篆体，v0.2+）、甲骨卜辞（152 字折线甲骨字形，v0.3+，数据来自 aylqs2025/oracle-bone-jgw-1203，CC-BY 4.0）。
2. 配色：经典绿、琥珀、赛博青、品红、鎏金、七彩轮转、七彩随机；暗色 / 亮色各一套下拉，客户端约每 3s 采样页面亮度并跟随深浅主题。
3. 金边发光：描边 + 外发光，与模式、配色独立叠加。

v0.7.0 起默认显示内容为甲骨卜辞、深浅配色默认七彩轮转、金边发光默认开启；从旧版升级时，仅当配置仍为 v0.6 旧默认（matrix / classic / amber）才会一次性迁到新默认，用户改过的值会保留。

token 进雨、雨随 agent 起伏¶

• 掺对话原文（feed）：宿主捕获 assistant/chunk 流式 token，经 SSE 推到雨布。矩阵模式约 1/3 雨头字符来自正在生成的原文（大写化后进池）；非拉丁字符丢弃。修仙 / 甲骨模式只放行汉字且在字符池内的字。设置页可关。
• 跟随 agent 活动（reactive）：宿主统计 token 吞吐（40%）、工具调用（30%）、活跃会话数（30%），合成 0..1 的 level，经 GET /dsh-matrix/api/stream 推送；事件越密，雨速最高约 ×1.9、亮度越高，空闲回落。设置页可关。

交互与显示范围¶

• 透明雨布：画布本身透明，拖尾用 destination-out 擦除；canvas.style.opacity 为总透明度旋钮（默认 30%，滑杆 5%–100%）。
• 显示范围：默认「除左侧栏」（动态探测对话区左缘）；可切「全屏」。
• 持续下雨：关闭后，对话未开始或已收尾时进入排空模式（只擦不落），拖尾淡尽停画；agent 开始输出时雨再起。
• 双击清屏：窗口内双击在清屏与下雨之间切换（输入框内双击选词不触发）。

性能与无障碍¶

渲染分辨率封顶（DPR ≤ 1.5、长边 ≤ 2400）、30fps 节流、字形离屏图集 + drawImage；帧率不足时先关拖尾闪烁再降 24fps。页面隐藏暂停；prefers-reduced-motion 可自动停放（配置项 ignoreReducedMotion）。设置页展示雨柱数、fps、帧耗、画质、倍率、连接状态等引擎状态。

修仙模式嵌入 LXGW 霞鹜篆书（OFL-1.1）；甲骨模式用嵌入的 glyphs.json + Path2D 描线，不依赖字体文件。两模式可选「注音标注」（老式 ㄅㄆㄇㄈ 注音）。

安装与启用¶

在已安装 DSH 且使用 Web profile 的环境中，执行 README 给出的命令：

dsh plugin --profile web add @weibaohui/dsh-matrix -w

装完后重启 dsh web 生效。管理入口：设置 → 黑客帝国。

插件以当前 dsh 进程权限运行；安装前建议浏览仓库源码与 MIT 许可证，确认符合你的安全与合规要求。

典型用法¶

经过上面的安装，默认即开始下雨（除左侧会话栏外覆盖对话区）。可按 README 逐步调整：

1. 抢戏 vs 氛围：设置里调透明度——约 0.15 偏幽灵感，0.6+ 更接近「满屏矩阵」。
2. 全屏雨：设置 → 黑客帝国 → 显示范围 选「全屏」。
3. 终端观感：暗色 / 亮色分别选配色；v0.7 默认七彩轮转，可改经典绿、琥珀、赛博青等。
4. 静水：关掉「跟随 agent 活动」；需要专注阅读时双击窗口清屏，再双击恢复。
5. 不聊天也要停雨：关掉「持续下雨」。
6. 模式切换：设置页「模式」在黑客帝国 / 道法修仙 / 甲骨卜辞之间切换；修仙、甲骨可单独开关「注音标注」「金边发光」。

开发者可在浏览器控制台试 README 中的彩蛋（仅当前页会话）：

__dshMatrix.boost(3)
__dshMatrix.applyConfig({ opacity: 0.8, themeDark: 'cyan' })

不装插件也可本地预览引擎：打开仓库内 demo/demo.html；URL 参数示例 ?region=no-left&continuous=0&opacity=0.6，修仙加 &mode=xian，甲骨加 &mode=oracle。

配置持久化走宿主 GET/POST /dsh-matrix/api/config；字段包括 enabled、opacity、speed、density、fontSize、mode（matrix | xian | oracle）、zhuyin、glow、themeDark / themeLight、region（no-left | fullscreen）、reactive、feed、continuous 等，具体范围见 README 配置 schema。

适用场景与注意¶

适合谁：长期在 DSH Web 里写代码、看流式回复，希望背景有矩阵 / 篆体 / 甲骨氛围，且不想挡点击和选中文本的用户。

需要注意：

• 插件分类为趣味换装，不改变 agent 逻辑；CPU 占用已有节流与自适应画质，低配机器仍可通过降透明度、关跟随活动、双击清屏减轻负担。
• 甲骨字形、篆体字体分别有 CC-BY 4.0 与 OFL 署名文件（client/oracle/ATTRIBUTION.txt、client/fonts/lxgw-seal-OFL.txt），二次分发时需遵守对应许可。
• 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属；版本以 npm 0.7.0 及 README 兼容性表为准（当前插件行对应 dsh 0.1.7-rc.2）。

结尾¶

@weibaohui/dsh-matrix 把经典字符雨做成 DSH Web 上的透明浮层：三模式、七配色与金边发光可组合，流式 token 与活跃度 SSE 驱动雨势，设置页集中调参。若要在 Harness 里试装，可从目录页了解简介，按官方命令安装后于 设置 → 黑客帝国 微调即可。

• 目录：https://www.skillhub.cn/plugins/weibaohui/dsh-matrix
• GitHub：https://github.com/weibaohui/dsh-matrix