dsh-matrix-rain — 黑客帝国代码雨（思考链驱动）

DSH WebUI 动效美化插件：聊天界面背景加入「黑客帝国代码雨」特效， 雨字内容 = 当前会话 AI 的思考链（流式实时，AI 一边思考、雨一边下它的思路）。

特性

• 思考链即雨字：优先取当前流式输出中的 reasoning 块，其次取最后一条 AI 消息的思考链。三种内容模式：
  • 思考链原文流 — 雨滴按游标顺序取字，竖向可读出思考片段（默认）
  • 思考链乱序投影 — 字符打乱，保留灵感氛围又不直接暴露思考全文（隐私友好）
  • 经典字符 — 纯 Katakana/ASCII 经典矩阵雨（无思考链时自动回退）
• 华丽不挡阅读：雨层 pointer-events:none 全程穿透点击/选择；低透明度 + 可调背景压暗；「两侧留白 / 底部横条」雨区模式给正文让视线
• 设置页完整 DIY（设置 → 矩阵代码雨，Host 持久化）：
  • 总开关（另有会话标题行快捷开关按钮，可隐藏）
  • 雨区范围 / 密度 / 下落速度 / 字号 / 文字切换速度 / 整体透明度 / 背景压暗
  • 调色盘：头部主色、拖尾主体色、辉光色、背景色 四个取色器 + 五套预设主题（经典矩阵 / 幽灵蓝 / 霓虹紫 / 血色红 / 琥珀金）
  • 内容模式、回退字符集、活跃模式（常驻 / 仅思考时）、鼠标扰动、恢复默认
• 设置变更渐进生效：每个雨滴生成时快照「当时」的颜色/字号/速度/字符池——改设置不会清空或改写已生成的雨滴，它们保持原样自然滑落到底部消失，新设置只作用于之后生成的雨滴（新旧雨滴平滑交替；背景压暗/透明度属于环境氛围，即时生效）
• 性能：仅文本变化重建字符池；仅思考时 模式无内容自动停帧省电；页面隐藏自动暂停；dpr 上限 2；密度按雨区收敛

安装（热装配，免重启）

# 方式一：运行时注入
# 使用 DSH 的 dev_inject_plugin，参数 = 本目录
# 方式二：热装配（重启后由 bundles 列表自动装配）
# 使用 DSH 的 dev_install_package，参数 = 本目录

⚠️ 必做：api-proxy settings 白名单补丁

浏览器设置面板读写 matrix-rain 命名空间需要 host 端 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 放行（官方把「哪些插件命名空间暴露给 Web 设置」 硬编码在 api-proxy 里）。dsh 升级覆盖官方包后必须重打：

node patches/apply-runtime-patches.mjs   # 应用（--reverse 回滚）
# 修改目标：@deepseek-ai/dsh-host-apiproxy/lib/index.js
# 效果：WEB_SETTINGS_NAMESPACES 追加 "matrix-rain"
# 注意：需要重启 dsh 进程生效（已打过的环境可跳过）

若未打补丁：设置面板仍可打开、雨效照常，但开关/调色盘的改动不会持久化 （每次刷新回到默认值）。

文件结构

dsh-matrix-rain/
├── package.json          # dsh bundle 声明（exports: . / ./client / ./cordis.patch.yml）
├── cordis.patch.yml      # 组合挂载补丁
├── patches/
│   └── apply-runtime-patches.mjs  # api-proxy allowlist 补丁（dsh 升级后重打）
└── lib/
    ├── index.js          # Node half：注册 matrix-rain settings 命名空间（schemastery schema）
    └── client.js         # 浏览器 half：采集桥 + canvas 引擎 + 设置面板（手写 bundle）

架构（三个 additive slot，零官方 UI 替换）

Slot	职责
conversation.session.header.utilities	思考链采集桥：useSession 订阅快照 → 提取 reasoning 文本 → 共享 store；同时渲染快捷开关按钮
shell.overlay	全屏 canvas 代码雨（pointer-events:none），rAF 直读 store + 最新配置，不经 React 重渲染
settings.section	完整 DIY 设置页（settingsScope Host 持久化，zh/en 双语）

思考链数据源：ConversationSnapshot.partial.blocks（流式）→ 回退 nodes[] 最后一条 assistant 消息的 blocks，取 kind === 'reasoning' 块。

默认配置

全屏雨区 · 密度 50% · 速度 1× · 15px · 透明度 30% · 压暗 18% · 经典绿调色盘 · 思考链原文流 · 常驻 · 快捷按钮开