dsh-conversation-aurora

给 DSH 对话区加一层整屏动效背景：把整块画布当背景，用 Canvas 画星空、代码雨、电路、小猫、小女生、赛车、飘雪、肥皂泡；正文列用一层按列宽计算的纱罩住，保证可读。

• 包名：dsh-conversation-aurora
• 插件目录：conversation-aurora/
• patch 行 id：dsh-conversation-aurora
• Client 工厂 id：dsh-conversation-aurora（必须与包名一致）
• 宿主半区：index.js，空的（只需要一行可加载）

安装

从 npm 安装（推荐）

插件页 → 添加插件 → 输入包名 dsh-conversation-aurora → 安装源选 npm 官方 → 安装 → 立即启用。

国内镜像（registry.npmmirror.com）同步有延迟；刚发布时请先用官方源。

从本地目录安装（开发用）

插件页 → 添加插件 → 填本目录的绝对路径 → 安装 → 立即启用。

卸载：插件页 → 卸载。效果随插件 context 一起回收，页面恢复原样。

用它

| 快捷键 | 作用 | | --- | --- | | Alt+T | 换到下一个背景，并固定住（8 个循环，选择会记住） | | Alt+R | 回到随机，并立刻换一个（清掉固定值） | | Alt+D | 浅色 / 深色主题互换（走宿主 theme.setTheme，与「设置 → 外观」同步） |

它只在"你干活"的时候出现：任何工具在跑、或回合进行中，背景才播放；空闲、切会话、窗口隐藏时立刻停掉 requestAnimationFrame 并淡出，两侧恢复普通白纸。

每个回合随机一个主题：你发一条消息、我把这一轮做完 = 一个回合；回合内背景不变（中间停顿多久都不换），下一个回合重新随机，且不会和上一个重复。Alt+T 固定某个主题，Alt+R 回到随机并换一个。固定值存在 localStorage 的 dsh.conversation-aurora.theme。

9 个背景

| 主题 | 内容 | | --- | --- | | 星空跃迁 | 星点从中心向外飞出，长条纹 | | 代码雨 | 竖列字符下落，带拖尾 | | 电路脉冲 | 直角走线 + 沿线跑的光点 | | 华山论剑 | 三层远山视差 + 冷月 + 云岚 + 偶尔一道剑气 + 落叶（没有人物、没有招式名，只有山水与光） | | 小猫散步 | 矢量剪影小猫走路、尾巴摆动、留下爪印 | | 小女生 | 连衣裙剪影 + 马尾 + 牵着气球，一路小跑掉小心心 | | 飞机大战 | 我方战机从画面下方飞入、左右巡航连续开火，敌机从上方成批压下来，击中炸成火星 | | 赛车 | 横向速度线 + 小车剪影 | | 飘雪 | 雪花慢落 + 摇摆 | | 肥皂泡 | 径向渐变薄膜 + 高光，缓缓升起 |

加一种新背景：在 client.js 里写一个 themeXxx(g)，返回 { resize(), step(dt) }，再往 STAGE_THEMES 数组加一行 { id, name, create }。g 提供 { ctx, w, h, pal }。

可读性怎么保证

• .dsh-stage__veil 是一条按 --dsh-chat-content-width 计算的横向纱：正文列内 84% 遮盖，列外 110px 内快速放开，两侧完全透明。
• 浅色主题用 multiply（正片叠底）+ 墨色（靛蓝 / 紫 / 青），像印在白纸上；深色主题用 lighter（加色）+ 亮色，才有发光感。见 stagePalette()。
• 背景层是 z-index:-1，永远在正文之下，pointer-events:none，不挡任何交互。

调参

视觉参数集中在 client.js 顶部：

| 位置 | 含义 | | --- | --- | | TUNE.holdIdleMs | 工具停下后多久淡出（默认 420ms，防抖） | | TUNE.switchQuietMs | 切会话后的静默期（默认 600ms） | | stagePalette() | 浅色/深色两套墨色 + 混合模式 | | THEMES 里各主题的常量 | 数量、速度、尺寸 | | .dsh-stage__veil 的 .84 | 文字列遮盖强度，调高更护眼、调低更炫 |

改完 client.js 后刷新页面即可（Ctrl+R）。

已知限制

1. 依赖宿主的 DOM 语义属性：[data-conversation-content] / [data-tool][data-state] / [data-chat-running] / [data-streaming]。DSH 大版本升级后如果这些改名，插件会安静地什么都不做（不会报错、不会挡交互）。
2. 没有"背景层"插槽：DSH 目前没有这个扩展点，所以背景层是挂在对话画布元素内部的（z-index:-1）。这是刻意偏离「只能注册进 slot」的地方，随插件停用一起消失。
3. 切会话会静默 600ms：避免把上一轮残留的工具行当成"正在工作"，看到几秒特效。
4. 减少动态效果：系统开启后只画一帧静止画面，不跑 requestAnimationFrame。
5. 性能：只有一张 canvas；每帧只做绘制，无 filter/backdrop-filter；空闲时 rAF 归零。
6. 不做设置项：没有「设置」里的面板，调参靠改常量。

官网

现在有三套独立官网，互不覆盖：

• 纸感版：site/index.html
  纸、墨、朱砂、宋体。3×3 作品目录、按住偷看、明暗主题、放大镜。
  文案从「等待太枯燥」出发，不把特效说成关键词彩蛋。

• 中场休息版：site-intermission/index.html
  黑、奶白、放映机琥珀。16:9 放映厅、九格胶片带、片单、票根、暂停与时间码。
  标题是「中场休息，不放广告。」九段循环短片，等待时自己开演。

• 候场室版：site-waiting-room/index.html
  银、钴蓝、安全橙。整屏 5×3 bento 墙面，九块实时屏幕同时亮着。
  中央蓝色标题卡 + 橙色「不是关键词彩蛋」说明卡；点任意屏幕看详情，可全局静止。

三套都直接双击打开即可，不需要构建。也可以：

# 纸感版
python -m http.server 8801 --bind 127.0.0.1 --directory conversation-aurora/site

# 中场休息版
python -m http.server 8803 --bind 127.0.0.1 --directory conversation-aurora/site-intermission

# 候场室版
python -m http.server 8805 --bind 127.0.0.1 --directory conversation-aurora/site-waiting-room

详见 site/README.md、site-intermission/README.md 与 site-waiting-room/README.md。

开发

node --check client.js                 # 语法
node tools/rename.mjs <新包名>          # 三处 id 一起改（发布前用）
npm pack --dry-run                     # 看会发出去哪些文件

发布：npm version patch → npm publish（需要 2FA 验证码）。

文件

conversation-aurora/
├─ package.json        dsh.bundle.patch + dsh.client
├─ cordis.patch.yml    插入一行
├─ index.js            Host 半区（空）
├─ client.js           Client 半区：状态机 + 9 个背景主题
├─ locale/zh.json      插件页标题与描述
├─ locale/en.json
├─ icon.svg
├─ preview.html        离线预览（直接加载 client.js）
├─ site/               官网 A：纸感版（另有 README）
├─ site-intermission/  官网 B：中场休息版（另有 README）
├─ site-waiting-room/  官网 C：候场室版（另有 README）
├─ tools/rename.mjs    发布前改名脚本
├─ LICENSE
└─ README.md