dsh-boot-suite 0.0.0-stage → 2.13.12

package/CHANGELOG.md

@@ -0,0 +1,751 @@
+## [2.13.12] — 2026-10-29
+
+### 修复：更新时「浏览器下载监听」过早超时、找不到下载文件
+- 症状：用户点「立即更新」后浏览器开始下载，插件等 10 分钟没接到文件就超时；实际网络慢时 24MB 的包可能要十几分钟，下载完成后也没人接住。
+- 2.13.12：等待时间 10 分钟 → **30 分钟**；文件名识别放宽（兼容 `dsh-boot-suite-win-V2.13.12 (1).zip` 等浏览器改名）；超时文案改为引导用户直接找包。
+
+### 新增：更新等待期间的手动出口
+- 等待下载时新增「**打开下载文件夹**」按钮，一键打开系统 Downloads；「选择安装包」在等待期间也可用，下载好的 zip 直接选中即可继续。
+- 手动选包成功后，后台还在跑的下载监听会自动作废，不会弹第二次更新器。
+- 等待期间页面显示明确的「正在等下载（最多 30 分钟）」提示。
+
+### 修复：「生成诊断报告」按钮连点会生成一堆文件
+- 症状：按钮点击后没有“生成中”反馈，用户连点几次，桌面出现多份诊断报告。
+- 2.13.12：按钮生成期间禁用并显示「生成中…」；宿主侧同一时间只允许生成一份，重复请求直接返回“正在生成中”，不再刷屏。
+
+### 构建
+- 版本号 2.13.11 → 2.13.12；client BUILD `cw-35`；全套测试通过。
+
+---
+
+## [2.13.11] — 2026-10-28
+
+### 新增：纱的「镜头模糊」
+- 设置 → 聊天背景 → 纱：新增「镜头模糊」滑块，强度 0–100、默认 0。0 完全不模糊，100 约 24px；滑块拖动实时生效，写在当前外观主题那一份配置里。
+- 实现：只给纱层加 `backdrop-filter: blur()`，模糊的是纱后面的壁纸/视频，纱上面的聊天文字不受影响；强度为 0 时不生成任何模糊规则。
+
+### 修复：一键安装在新版 DSH（0.2.1-rc.3）上误判成功
+- 症状：`安装.cmd` 调用 `dsh plugin add`，新版 DSH 的 `dsh` 命令行不解析任何子命令（`dsh plugin` 和 `dsh --help` 都只打印 `dsh web: http://127.0.0.1:xxxxx/?token=...` 就退出），但退出码是 0；旧逻辑误判安装成功，跳过自带的手动安装兜底，留下「bundles 里加了 dsh-boot-suite，但 dependencies/node_modules 里没有」的危险状态 → DSH 启动时报 `cannot resolve profile bundle "dsh-boot-suite"`。
+- 2.13.11：安装器新增 `Test-InstalledOk()`，以 profile 真实文件为准（`node_modules/dsh-boot-suite` 存在 + `package.json` 的 dependencies 指向它 + 版本号匹配）；命令行退出码 0 但实际没装时自动改「手动安装」兜底；安装后仍校验失败则回滚 profile，并且不会往 bundles 写不存在的插件。
+
+### 构建
+- 版本号 2.13.10 → 2.13.11；client BUILD `cw-34`；13 套测试通过（新增镜头模糊 7 项、安装器兜底 3 项回归断言）。
+
+---
+
+## [2.13.10] — 2026-10-28
+
+### 修复：浅色/深色外观下右上角窗口按钮（最小化/最大化/关闭）看不清
+
+- 根因：这三个按钮是 Windows 原生 `titleBarOverlay` 画的，颜色由 DSH Desktop 的 preload 决定——它在页面里放一个隐藏探针，读探针的 `background-color`（来自 `--dsw-specific-sidebar-fill`）和 `color`（来自 `--dsw-alias-label-primary`），再通过 IPC 设置原生按钮底色/图标色
+- 插件为了透出壁纸，把 `--dsw-specific-sidebar-fill` 改成了半透明色。探针算出的底子是半透明的，原生窗口按自己的方式合成后，遇到浅色外观就变成「白底 + 白图标」，深色外观则可能「黑底 + 黑图标」——按钮其实一直在，只是和底色融了
+- 2.13.10 直接给探针一对固定的高对比色：浅色外观 = 浅底 `#f9fafb` + 深图标 `#0f1115`；深色外观 = 深底 `#1b1b1c` + 浅图标 `#f9fafb`。不依赖 DSH token，也不受半透明影响
+- 片头播放期间维持原来的透明标题栏（`data-dsh-caption` 开关），片头结束/外观切换时主动触发一次 preload 重新测量，让按钮带立刻换色
+- 深色/浅色其它已确认正常的区域不动
+
+### 构建
+
+- 版本号 2.13.9 → 2.13.10；client BUILD `cw-33`；全套测试通过
+
+---
+
+## [2.13.9] — 2026-10-28
+
+### 修复：浅色外观下聊天正文对比度仍不够 + 「纱」滑块失灵
+
+- 根因一：2.13.5 起「纱」被改成跟壁纸亮度走（暗壁纸压深纱、亮壁纸压白纱），但设置页的浓度滑块是按 **DSH 外观主题**存的（浅色主题一个、深色主题一个）。浅色外观 + 暗壁纸时插件实际用了深色纱，用户拖「纱的浓度（浅色主题）」自然看起来没反应
+- 根因二：文字颜色只看壁纸整图平均亮度。壁纸中间的聊天区可能偏亮、四角偏暗，平均下来误判成暗背景 → 白字压亮处，对比度不够；而且没把纱叠上去的实际亮度算进去
+
+### 2.13.9 的做法
+
+- **纱恢复为只跟 DSH 外观主题走**：浅色外观用浅色纱、深色外观用深色纱，设置页滑块直接控制当前主题的浓度，恢复「拖了就生效」
+- **文字颜色改看「壁纸 + 纱」叠完后的实际亮度**：从纱的 computed style 读实际颜色/透明度，跟壁纸亮度做混合后再判断白字还是黑字
+- **亮度采样改取画面中间区域**（聊天文字主要压在这里），不再被四角带偏
+- 聊天正文文字加一层很轻的阴影，背景明暗不均时也能读
+- 深色外观相关逻辑保持不变（已人工确认通过）
+
+### 构建
+
+- 版本号 2.13.8 → 2.13.9；client BUILD `cw-32`；全套测试通过
+
+---
+
+## [2.13.8] — 2026-10-28
+
+### 修复：浅色/深色外观下外框与输入框颜色错乱
+
+- 根因一：判断插件自己写的 `dsh-cw-bg-dark`（暗壁纸）类名时没有剥干净，里面含 "dark"，导致「浅色外观 + 暗壁纸」被误判成深色外观
+- 根因二：判断主题只认 `rgb()/rgba()` 写法，DSH 主题 token 若是 `#0f1115` 这类十六进制就读取失败
+- 根因三：聊天正文的自适应根节点取了「markdown + 输入框」的公共祖先，白字 token 漏进输入框，出现白底白字
+- 根因四：侧边栏 / 标题栏被强行覆盖成白字，DSH 原生组件（新会话按钮、收起侧边栏、完全权限图标、harness 徽标）本来浅色外观是浅底深字，反而被刷成白底白图标
+
+### 2.13.8 的做法
+
+- 主题判断改为剥掉整个 `dsh-cw-*` 命名空间，并支持 `#rgb/#rrggbb/rgb()/rgba()` 两种 token 写法，同时检查 `html` 与 `body`
+- **聊天正文**：跟壁纸亮度走（暗壁纸白字 / 亮壁纸黑字），根节点停在输入框外面，不再包住输入框
+- **侧边栏、顶部标题栏**：只垫一块与 DSH 外观同深浅的半透明面板，不覆盖任何文字/图标 token，按钮、图标、徽标全部保持 DSH 原色
+- **输入框**：完全交回 DSH 原生主题（浅色深字 / 深色浅字），不再刷 token、不再垫面板、不再强制透明底
+
+### 说明
+
+- 不改 DSH 客户端任何文件，全在插件 CSS + DOM class 内完成；桌面回滚按钮可退回上一版
+- 新增主题判定回归测试（`dsh-cw-bg-dark` 不误判、十六进制 token 正确识别）
+
+### 构建
+
+- 版本号 2.13.6 → 2.13.8；client BUILD `cw-31`；全套测试通过
+
+---
+
+## [2.13.7] — 2026-10-28（内部修复尝试，未单独发布）
+
+### 修复：浅色外观下聊天「外框」仍然看不清
+
+- 看过 2.13.6 的用户截图后确认：侧边栏 / 标题栏不应刷白字，改为垫与外观同深浅的面板
+- 内部版本，因主题判定仍有 `dsh-cw-bg-dark` 误判，未发布；最终修复见 2.13.8
+
+---
+
+## [2.13.6] — 2026-10-28
+
+### 修复：浅色外观下侧边栏 / 输入框文字看不见
+
+- 2.13.5 的自适应只覆盖了聊天正文：侧边栏（会话列表、最近文件）和输入框仍用浅色外观的深色文字，压在我们加深的壁纸上，于是看不见
+- 现在自适应范围扩到三块：聊天正文、左侧边栏、输入框面板；各自加对应的文字 token 和半透明面板底色
+- 输入框本体强制透明底并跟自适应文字色（含 placeholder 和光标），行内代码 / 文件名 chip 也补了对比底色
+- 壁纸亮度还没采样到时，先按 DSH 外观主题给一个初值，避免加载瞬间闪黑字
+
+### 说明
+
+- 不修改 DSH 客户端任何文件，全部在插件自己的 CSS + DOM class 里完成；出问题可用桌面回滚按钮退回上一版
+
+### 构建
+
+- 版本号 2.13.5 → 2.13.6；client BUILD `cw-29`；全套测试通过
+
+---
+
+## [2.13.5] — 2026-10-28
+
+### 修复：外观切浅色后聊天文字看不见（黑字压暗底）
+
+- 根因：主题判定把插件自己写到 `<html>` 上的 `dsh-cw-dark` 也当成「深色标记」，于是切成浅色外观后仍一直压深纱 → 黑色文字压在暗背景上，几乎看不见
+- 现在优先读 DSH 主题插件写在 `body` 上的 `--dsw-alias-label-primary` 颜色判断深浅（亮字=深色外观、暗字=浅色外观），判定时忽略插件自己的 class；旧判定逻辑保留为兜底
+
+### 新增：壁纸明暗自适应（聊天区文字自动提亮/压深）
+
+- 采样静态底图 / 循环视频当前帧的平均亮度：暗壁纸 → 聊天区文字提亮（白字）+ 深色半透明卡片；亮壁纸 → 文字压深（黑字）+ 浅色半透明卡片
+- 自适应只作用于聊天区根节点（从 markdown 与输入框的公共祖先往上找），侧边栏、设置页不受影响
+- 「纱」与兜底底色也改成跟壁纸实际亮度走（之前只跟 DSH 外观走）：浅色外观 + 深色壁纸不再被白纱洗亮，暗背景能保留
+- 视频亮度随画面变化：每 1.5 秒复核一次；换图 / 换视频后自动重算
+
+### 构建
+
+- `tools/build-release.mjs` 现在自动生成 `dsh-boot-suite.tgz`（市场安装链接固定指向 latest/download/dsh-boot-suite.tgz，每次发版必须带），并校验 gzip 头与最小体积
+- 打包时忽略源码根目录遗留的 `.tgz` / `.zip`，避免发布包被旧压缩包撑大
+- 版本号 2.13.4 → 2.13.5；全套 13 套测试通过
+
+---
+
+## [2.13.4] — 2026-10-28
+
+- 聊天背景新增「图片适配」开关：**铺满窗口（裁切多余部分，默认）** / **完整显示（不裁切，上下或左右留底色边）**，解决大图被裁切的问题（B 站用户反馈）。
+- `imageFit` 配置值做白名单校验：只接受 `cover` / `contain`，非法值忽略。
+- 版本号 2.13.3 → 2.13.4。
+
+# 更新日志
+
+本文件记录 DSH 开机动画（dsh-boot-suite）的所有版本变化。
+格式参考 Keep a Changelog，版本号遵循语义化版本。
+
+分类：新增 / 修改 / 修复 / 文档 / 性能 / 移除。
+
+---
+
+## [2.13.3] — 2026-10-27
+
+### 新增：更新前自动留一个「紧急回滚」桌面按钮（checkpoint）
+
+- 每次安装/更新前，安装器检查 profile 里当前**实际安装**的版本；如果不是本次包版本，就在桌面生成 `紧急回滚-V<旧版本>（先完全退出 DSH 再双击）.cmd`，同时把回滚脚本放到 `~/.dsh/boot-suite-updates/rollback-version.ps1`
+- 双击按钮：检查目标版本完整 → 等 DSH 完全退出（最多 5 分钟）→ 备份 profile 配置 → 用旧版本自带的 `tools/install.ps1` 切回旧 `pkg` → 校验装回版本 → 重新打开 DSH；中途失败会自动恢复备份，**只换插件版本，不动用户设置**
+- 新版安装成功、无报错后：安装器自动删除桌面旧的 `紧急回滚-*.cmd`（不会越积越多），并提示按钮已更新；用户不用手动删
+- 更新器成功日志末尾提示「回滚按钮已就绪」；设置页「检查更新」下方新增回滚保护说明
+- 回滚日志：桌面 `dsh-boot-suite 回滚日志 yyyyMMdd-HHmmss.txt`（桌面不可写时写 `~/.dsh/boot-suite-updates/`），带目标版本、校验结果与 DSH 退出等待过程
+- 安全：回滚脚本只接受含 `package.json` / `lib/index.js` / `tools/install.ps1` 的完整 pkg，不执行任意路径；`-CheckOnly` 只检查、不改动
+- 升级兼容：不覆盖 `chat-wallpaper.json` / `dsh-startup.json`；更新失败时旧版插件仍可打开（回滚按钮就是为这种情况准备的）
+- 测试：smoke-package 增加回滚脚本存在性与安装器 checkpoint 关键实现断言；全套 13 套仍全过
+
+---
+
+## [2.13.2] — 2026-10-27
+
+### 修复：更新器会先确认安装包完整，坏包不再走到「解压一半才报错」
+
+- 根因：v2.13.1 更新失败那台电脑下载到的是「半包 zip」——文件头仍是 `PK`、大小也超过 1MB，旧逻辑只看头就放行，`Expand-Archive` 才报「找不到中央目录结尾记录」；此时旧版本目录已被清空
+- 宿主侧所有更新入口（自动下载 / 浏览器下载监听 / 手动选择安装包 / 启动更新器）现在都校验完整 zip：文件头 + 尾部中央目录结束记录（EOCD），自动下载还会按 GitHub 正式资产的 `size` 精确比对；坏包当场丢弃并自动换下一个镜像，不再写入更新目录
+- `update-apply` 启动外部更新器前再校验一次；坏包直接删除并提示「安装包不完整或已损坏，已删除，请重新下载」，不会再启动一个注定失败的更新窗口
+- 浏览器下载监听：文件大小稳定但 zip 不完整时，等 20 秒仍未收尾就明确提示「下载的安装包不完整」，不会把半包当成完成
+- 更新器 `tools/update-apply.ps1` 重写：先校验 zip（SHA256 写日志）→ 解压到 `pkg.new` → 校验 `package.json` 版本和必需文件 → 才把旧 `pkg` 备份成 `pkg.old` 并替换；安装器失败会自动恢复旧目录与配置，旧版插件不会被动坏
+- 更新日志多一份兜底：桌面写不进去时写到 `~/.dsh/boot-suite-updates/<版本>/`，日志里带安装包路径、大小、SHA256，方便定位下载问题
+- 测试：smoke-host 新增「截断 zip 被拒、坏包不落盘」2 条断言
+
+### 已知问题与排查（用户反馈）
+
+- 第一幕两个圈不转、其他文字/进度/第二幕都正常：不是缺运行环境，也不需要显卡驱动或组件。系统关闭「动画效果」时会上报 `prefers-reduced-motion: reduce`，插件按无障碍设计主动停掉第一幕两个圈的旋转（`.dsu-ret-rot-a` / `.dsu-ret-rot-b`），「扫描线」转场同样会变成瞬间切换。解决：Windows 设置 → 辅助功能 → 视觉效果 → 打开「动画效果」；或 系统属性 → 高级 → 性能设置 → 选「让 Windows 选择」；完全退出 DSH 重开。远程桌面会话也可能上报「减少动画」，可先在本机直接登录状态下验证
+
+---
+
+## [2.13.1] — 2026-10-26
+
+### 新增：插件自带默认背景图（开箱即有）
+
+- 聊天背景自带一张默认底图：开机动画第二幕「鲸鱼娘扫描睁眼」的静帧（JPEG 1920×1080，约 245 KB），随安装包分发，装在 `lib/assets/default-background.jpg`
+- 新装 / 从未选过背景图的用户，打开聊天就能看到默认背景，不用再先丢图；用户自己丢的图、循环视频仍然优先，不会被默认图盖掉
+- 设置页「聊天背景」→「背景图」第一张就是「默认背景（内置）」，带「内置」角标，随时可点回来
+- 「不用背景图」改为显式关闭（宿主哨兵值 `__none__`），不再用空字符串（空字符串现在表示「自动挑目录里最新一张，没有就用内置图」）
+- 宿主 `/chat-wallpaper/images` 增加 `imageSource`（builtin / your-library / none），`/chat-wallpaper/image?name=__default__` 可直接取内置图
+- 升级兼容：只改默认值与回退逻辑，不覆盖已有 `chat-wallpaper.json`；原有背景图 / 循环视频设置原样保留
+- 修复：`GET /chat-wallpaper/image?name=` 传入目录名（`.` / `..` / 已存在子目录）会让宿主 `createReadStream` 抛未捕获 EISDIR、进程直接退出的问题；现在目录一律 404，并监听读流错误
+- 修复：`POST /chat-wallpaper/set` 不再接受丢图目录之外的任意绝对路径（避免变成本地任意文件读取原语），只允许目录内的图片文件
+- 测试：smoke-wallpaper-host 扩到 127 项（内置图、哨兵切换、目录穿越、目录名防崩、同名用户图优先）；13 套共 998 条通过标记全过
+
+---
+
+## [2.13.0] — 2026-10-26
+
+### 新增：聊天背景「循环视频」
+
+- 设置页「聊天背景」新增「循环视频」组：背景类型（静态底图 / 循环视频）、播放模式（手动选择 / 随机轮换）、轮换间隔（0 = 每次启动随机，可设 1–1440 分钟定时换）
+- 循环视频默认静音、自动循环、铺满窗口；窗口最小化/切后台自动暂停，回来继续；读取失败自动回落静态底图，不会黑屏
+- 视频来源：默认 `~/.dsh/chat-wallpaper/loops/`，可添加任意自定义目录（最多 8 个，避开占满某个分区）；可打开目录/移除目录（文件不会被删）
+- 支持用户自建子文件夹与壁纸引擎项目结构：递归扫描 mp4/webm，识别文件夹内 `project.json` 的 title / file / preview / type / tags，一个项目文件夹 = 一段视频，设置页显示 preview 缩略图
+- 视频列表带「删除」：普通视频删文件；壁纸引擎项目整体删除文件夹（确认框写明）；只允许操作配置目录内的文件
+- 本地删除文件后：下次打开设置 / 重启自动重新扫描，选中的视频不存在会自动清空并回落静态底图（不做实时文件监听）
+- 视频通过宿主 HTTP Range 路由提供（`/chat-wallpaper/video`），只允许配置目录内文件；只存本机、不上传、不进发布包
+- 旧配置自动兼容（无视频字段时默认仍是静态底图）
+
+---
+
+## [2.12.4] — 2026-10-26
+
+### 内置模板也可以「删除」（隐藏，可恢复）
+
+- 「删除该动画」不再只对本地动画生效：内置模板（档案暖白 / 鲸鱼娘等）也可以删除——为不破坏安装包，内置模板的「删除」是写入配置 `hiddenTemplates` 从列表隐藏，可随时恢复
+- 模板组底部在有隐藏项时显示「恢复已隐藏的内置模板（N）」按钮，一键全部恢复
+- 删除/隐藏正在被第一/第二幕引用的模板时，宿主自动把对应配置切回默认
+- 本地模板仍是真删文件（不可恢复）；内置模板不删安装文件（升级也不会丢，恢复后原样回来）
+- 旧配置兼容：没有 `hiddenTemplates` 字段时按空列表处理
+
+---
+
+## [2.12.3] — 2026-10-26
+
+### 删除按钮位置微调（按用户截图反馈）
+
+- 「删除该动画」按钮固定在「第一幕」「第二幕」下拉同一行的最右侧，水平对齐、与下拉留出间距；按钮始终显示，内置模板时置灰不可点（tooltip 说明「内置模板不能删除」）
+- 模板组底部补充说明：删除只对本地动画生效
+- 不改运行逻辑 / 配置字段
+
+---
+
+## [2.12.2] — 2026-10-26
+
+### 设置页布局调整（按用户反馈）
+
+- 「自定义动画」组移到「模板」组之前（先导入/准备动画，再选第几幕）
+- 删除按钮移到「第一幕」「第二幕」下拉旁边，文案统一改为「删除该动画」；仅当选中的是本地模板时显示
+- 移除重复的「本地动画（N）」列表（与下拉旁的删除按钮功能重复）
+- 不改运行逻辑 / 配置字段，旧配置继续兼容
+
+---
+
+## [2.12.1] — 2026-10-26
+
+### 修复：两幕边界转场不再叠加内嵌淡出 + 新增本地动画删除
+
+- 删掉时间线模板结束时的内嵌内容淡出（`dsu-out-content` + 220ms 延迟）：第一幕 / 第二幕现在作为独立片段播放，换场点紧贴时间线结束；三段转场全部由插件转场引擎统一接管，不再出现「闪白过程中还能看到第二幕淡出」
+- 自定义转场时不再有任何额外淡入淡出叠加；默认「交叉叠化」保持原有观感
+- 设置页「模板」组新增「本地动画」列表：列出所有导入 / 安装的本地动画，每条带「删除」按钮；「第一幕」「第二幕」下拉旁也有快捷删除（仅对本地模板显示）
+- 删除正在被引用的本地动画时，自动把对应幕切回默认，避免下次开机找不到模板；安装目录里的内置模板不会被删除
+- 测试：补充删除本地模板与「转场不叠加内嵌淡出」的用例
+
+---
+
+## [2.12.0] — 2026-10-26
+
+### 新增：自定义动画导入 + 三段自定义转场
+
+- 设置页「启动动画」新增「自定义动画」：点「📥 导入动画」选 mp4 / webm / gif / png / jpg / webp（单文件 ≤ 64MB），自动生成一个用户模板（存 `~/.dsh/startup-templates/`，不碰安装目录、不上传），之后「第一幕」「第二幕」下拉都能选它；视频自动读时长、静音、cover 铺满；图片 / GIF 默认按 6 秒播放，按原始比例居中裁切
+- 新增三段自定义转场，各自下拉选择：**第一幕入场 / 第一幕 → 第二幕 / 第二幕 → 桌面**；默认全部「交叉叠化」，与旧版观感一致
+- 转场类型：交叉叠化 / 闪白 / 故障 / 扫描线（方向可选 左右上下）/ 推移 / 虹膜 / 黑场 / 硬切；时长 200–2000ms（默认 600ms）
+- 旧配置兼容：缺少新字段时自动用默认值，不改用户现有设置；转场只读配置数据，失败 / 跳过自动回落，不会黑屏
+- 测试：新增导入动画、转场配置与设置页测试
+- 第一幕 / 第二幕默认播放逻辑保持不变
+
+---
+
+## [2.11.11] — 2026-10-25
+
+### 优化：发布包瘦身 + Release 源码对齐 + 文档口径校正（功能零变化）
+
+- `npm run release` 现在跳过 `docs/code-motion/**`（另一条工作线的动效研究文档与媒体）：发布包不再携带这些内容，体积从 24.7 MB 降到 23.8 MB（约 −0.87 MB），内容更贴近插件本体
+- 发布流程修复：先通过 GitHub API 把远端 main 同步到当前源码树，再在同步提交上打 tag，Release 页自动生成的「Source code」将与真实源码一致（v2.11.4～v2.11.10 的旧 tag 不回改）
+- README / README.en / 分享文案：更正 splash 运行时行数与体积口径——实际 `lib/splash.js` 3288 行 + `lib/splash.css` 1410 行，源码约 196 KB（旧文案 1468/1093 行与「~94 KB」是早期版本数据）
+- 本版不改插件运行逻辑：开机动画、模板、坐标、聊天背景行为与 2.11.10 完全一致
+
+---
+
+## [2.11.10] — 2026-10-25
+
+### 优化：清掉聊天背景的视频死代码（功能零变化）
+
+- 聊天背景的底图 / 纱 / 大字横幅行为完全不变；v2.11.8 起视频播放已移除，这一版把遗留的整条视频管线删干净
+- client.js：删除 preloadVideo / mountLayer / beginIntro / startWhenFree / replayIntro / 一轮一次 sessionStorage / 旧左下角「🖼 背景」浮层面板（含面板 CSS 与「重播开场」按钮）；boot() 不再以「宿主解析到视频」为挂载门，拿到底图/横幅配置就直接挂
+- host-wallpaper.js：删除视频解析（配置 / 用户片库 / 内置回落）、`/chat-wallpaper/video` Range 路由、时间码换算（parseTimecode）、`/status` 视频候选、DEFAULTS 视频字段；`/config`、`/images`、`/status` 只返回底图 / 横幅 / 纱相关字段
+- 用户配置兼容：`~/.dsh/chat-wallpaper.json` 里老版本残留的视频键会在下次保存时自然消失；底图 / 横幅 / 纱的值不受影响
+- 测试：删除只测死代码的 wallpaper 测试，新增 `smoke-wallpaper-apply`（永不创建 `<video>`、applyNow 幂等、teardown 不复活、主题切换不重挂）
+- 删除不再被引用的内置兜底视频 `lib/assets/wallpaper-default.mp4`（约 56 KB）与 3 个视频时代开发脚本
+- 开机动画、模板、坐标、用户配置零改动
+
+---
+
+## [2.11.9] — 2026-10-25
+
+### 文档 + 设置页：清掉「聊天背景开场视频」残留（无新增功能）
+
+- 安装器完成提示、README / README.en / INSTALL 里残留的「开场视频」描述，统一改为「静态底图 + 大字横幅」
+- 设置页「聊天背景」里残留的「开场视频」设置组（v2.11.8 起已失效；选「放到聊天窗口后面」还会让聊天外壳变透明）已移除，保存不再写 mode / placement
+- 设置页「当前状态」无底图时，文案由「视频淡出后回到 DSH 默认底色」改为「使用 DSH 默认底色」
+- INSTALL.md 里写死的旧版本号「2.7.0」改为「当前版本号」，不再随版本过期
+- package.json description 撤掉「左下角背景按钮 / 全屏开场视频 / 循环区间」旧描述，改为设置页「聊天背景」
+- docs 分享文案同步为「底图 + 大字横幅」；README 里「13 套冒烟测试」按实际改为 15 套
+- 开机动画、模板、坐标、用户配置零改动；聊天背景的底图 / 纱 / 大字横幅行为不变
+
+---
+
+## [2.11.8] — 2026-10-25
+
+### 聊天背景：移除开场视频播放（保留底图 / 大字横幅）
+
+- 聊天背景不再预加载、不再播放任何开场视频，避免和启动动画第二幕重复
+- 设置页「聊天背景」当前状态显示「开场视频：已移除」
+- 移除「重播开场」入口的行为（按钮保留为无操作或已去掉）
+- 聊天底图、大字横幅、丢图即换背景全部保留
+- 启动动画两幕与叠化/淡出完全不变
+
+### 说明
+
+- 之前自动从 `~/.dsh/boot-animation/videos` 选视频开场的行为一并移除
+- 用户视频库可继续用于其他用途，不再被聊天背景自动播放
+
+---
+
+## [2.11.7] — 2026-10-25
+
+### 两幕衔接打磨（第一幕 v1 + 第二幕 v2 组合）
+
+- 第一幕（档案暖白）终幕完整播放，停在 WELCOME，不再提前揭幕露出 DSH
+- 第一幕 → 第二幕改为 **交叉叠化**（600ms），第二幕视频随之显现
+- 第二幕结束改为 **淡出**（600ms）到 DSH，去掉视频内部双重淡出
+- 第二幕在独立全屏覆盖层播放，不再与第一幕残留 HUD/WELCOME 叠字
+- 修复第二幕重复播放（单次守卫）
+
+### 默认设置
+
+- 默认两幕：第一幕「档案暖白」（沈宏宏）→ 第二幕「鲸鱼娘扫描睁眼」
+- 第二幕模板随包提供（2560×1440，7 秒，BSD-3-Clause，原作者待上游确认）
+
+### 视频图层
+
+- 引擎支持 video 图层；模板素材接口支持 mp4/webm + HTTP Range
+
+### 发布包文件名带版本号
+
+- v2.11.7 起 Release 同时提供 dsh-boot-suite-win.zip 与 dsh-boot-suite-win-V2.11.7.zip
+
+---
+
+## [2.11.6] — 2026-10-25
+
+### 新增：视频图层 + 鲸鱼娘可选模板
+
+- 引擎新增 `video` 图层类型（自动静音播放、object-fit: cover、参与透明度/时间窗）
+- 宿主模板素材接口支持 mp4/webm，并支持 HTTP Range（视频可拖动/分段加载）
+- 新增可选模板 `whale-girl-scan`「鲸鱼娘扫描睁眼」：
+  - 2560×1440 原片，7.04 秒，全屏播放 + 淡入淡出
+  - 素材来源：NativeDog1/dsh-boot-animation 内置片库（BSD-3-Clause，原作者待上游确认）
+- 设置页鸣谢同步：标注“可选模板随包提供”，指向 NativeDog1/dsh-boot-animation
+
+### 修复
+
+- 修正 README/CREDITS 中把 ChatGPT「龙娘」（@mytjxs）误列为 DeepSeek 鸣谢的问题
+
+---
+
+## [2.11.0] — 2026-10-24
+
+### 自动更新（第一阶段：半自动）
+
+- 检查更新旁新增「立即更新」按钮
+- 点击后由宿主下载最新 Release zip 到 ~/.dsh/boot-suite-updates/<版本>.zip，校验 zip 头
+- 下载完成弹窗确认：「本次更新需要重启 DSH。请确认没有正在进行的对话。是否现在重启？」
+- 点「是」后启动外部更新器：等 DSH 退出 → 解压 → 运行安装器 → 自动重新打开 DSH
+- 失败：恢复配置备份 + 重新打开 DSH + 桌面生成更新日志（提示发给作者）
+- 更新前备份配置到 ~/.dsh/boot-suite-updates/<版本>/backup/，不覆盖用户配置
+- 每日自动检查一次（后续版本接上）；支持链接到 GitHub Release 页手动查看
+
+### 说明
+
+- 本阶段未做「健康检查自动回滚旧版本」，失败时依赖安装器自身的回滚；下一阶段补齐
+- 该流程会关闭 DSH，属于真机验证项，需要用户配合测试
+
+---
+
+## [2.10.2] — 2026-10-24
+
+### 修复
+
+- **空格/回车推进断点失效**：EDIT 原本声明在 runTimeline 内部，模块级的 onGateKey 读到未定义变量会抛
+  ReferenceError。已把 EDIT 提到模块级（onGateKey 与时间线共用）。
+- **标题栏透明探针证据不足**：caption-probe 现在记录右上角 6 层元素堆栈、所有 class 含 frame 的元素、
+  根节点/自举标记/skip 标记，并在 1.5s 与 4.2s 各跑一次，用于定位 DSH 更新后的新结构。
+  在选择器证据齐全前，不盲改透明样式，避免把主界面背景改透明。
+
+---
+
+## [2.10.1] — 2026-10-24
+
+### 设置页新增「生成诊断报告」
+
+- 在「检查更新」旁边新增按钮，点一下由宿主收集环境信息并写到桌面：
+  文件名 = 时间戳 + dsh-boot-suite 诊断报告，请发送给原作者寻求帮助.txt
+- 报告包含：版本、系统、配置、内置模板列表、profile 依赖/bundles/链接、最近的诊断日志
+- 同时修正「检查更新」请求路径（之前多拼了一层 /config）
+- 面向完全不懂命令行/AI 的用户：不用跑 诊断.cmd，点按钮即可
+
+---
+
+## [2.10.0] — 2026-10-24
+
+### 两幕可分别选择
+
+- 设置页「模板」拆成两个下拉：
+  - 启动动画第一幕：默认「档案暖白」
+  - 启动动画第二幕：默认「扫描登录」，可选「不播放」或任意自定义模板
+- 引擎按顺序播放两幕；第二幕播完直接进入 DSH 对话窗口
+- 配置新增 act2 字段；老配置没有 act2 时保持单幕，不会突然多播
+- 设置页新增「聊天背景」引导：聊天背景在另一个窗口（设置 → 聊天背景）
+
+---
+
+## [2.9.1] — 2026-10-24
+
+### 修正默认播放顺序
+
+- 默认模板从 dsh-intro-full（三幕）改为 dsh-intro-two（两幕）：
+  片头 → 扫描登录，去掉第三幕「欢迎回来」
+- 结尾交给引擎的 WELCOME TO DEEPSEEK HARNESS 收束
+- 550C 仍为可选模板，不进入默认播放
+
+---
+
+## [2.9.0] — 2026-10-24
+
+### 默认集成（装完即有）
+
+- 默认模板改为 dsh-intro-full：片头 → 扫描登录 → 欢迎回来，三幕连续，含配音与音效
+- 聊天壁纸自带默认视频 lib/assets/wallpaper-default.mp4（代码生成抽象渐变，约 60 KB）
+- 语音素材随包内置（lib/assets/line-1..6.mp3 + 界面音效），默认直接播
+
+### 鸣谢（设置页新增鸣谢区，README/CREDITS 同步）
+
+- 片头动画参考：沈宏宏（@6shenhonghong9） https://github.com/6shenhonghong9/dsh-startup-screen
+- 扫描动画参考：@mytjxs https://github.com/mytjxs/codex-startup-animation
+- 配音：DeepSeek
+- 550C 复刻模板保留为可选，不进入默认播放
+
+---
+
+## [2.8.3] — 2026-10-21
+
+### 修复
+
+- **新版 DSH 禁止命令行管理 desktop profile**（error: profile "desktop" is managed exclusively by the Electron application）：
+  - CLI 查找优先用 DSH 安装目录里的官方 dsh.cmd，跳过 PATH 里的第三方包装脚本（如 ai-manager 的 dsh.ps1）
+  - 卸载旧插件被拒绝时自动改为手动清理（dependencies / bundles / node_modules）
+  - 安装被拒绝时自动改为手动安装（改 profile 依赖 + 目录联接），不再直接失败
+- 同时兼容旧版允许 CLI 管理 profile 的 DSH
+
+---
+
+## [2.8.2] — 2026-10-21
+
+### 新增
+
+- **`诊断.cmd`**：一键收集 DSH 安装目录/版本、profile 依赖与 bundles、node_modules 链接、
+  插件配置、用户模板目录、残留解压目录，输出到桌面 `dsh诊断-时间.txt`，方便用户反馈。
+
+### 修复
+
+- **卸载不彻底**：卸载脚本现在同时处理 `desktop` 和 `web` 两个 profile，
+  并从 dependencies、bundles、node_modules 三处清理 `dsh-boot-suite` / `dsh-startup-screen` / `dsh-chat-wallpaper`。
+- 卸载脚本在客户端未完全退出时给出明确提示（以前可能一闪而过让人以为卸载成功）。
+---
+
+## [2.8.1] — 2026-10-20
+
+### 修复
+
+- **安装时旧插件卸载失败导致整个安装中断**：`dsh plugin remove` 对未安装的插件返回非零并写 stderr，
+  脚本开了 `$ErrorActionPreference=Stop`，把 stderr 当致命错误直接退出。
+  - 现在先读 profile 的 dependencies，只在确实装过时才卸载
+  - 卸载失败只提示并继续；安装步骤的原生命令也加了作用域，失败由 `$LASTEXITCODE` 判定
+---
+
+## [2.8.0] — 2026-10-19
+
+**三幕完整片头定稿**：第一幕开场 → 第二幕登录自检 → 第三幕欢迎回来，地球贯穿全程，配音与音效全部落位。
+
+### 新增
+
+- **完整版模板 `dsh-intro-full`（26.7s，46 层）**
+  - 第一幕 0–8s：鲸鱼线描 / DS 深度求索 / 英文副标 / 载入进度 / 申请访问许可 / 字符地球
+  - 第二幕 8–19s：左侧码流自检面板 + 中间登录卡 + 右侧地球与计数器（等比例拉长，节奏放慢）
+  - 第三幕 19–26.7s：地球回中 → 炸开 → 粒子聚成 WELCOME BACK → 闪白 → 欢迎回来 → 闪白退场
+  - 地球贯穿三幕：第一幕顶部 → 第二幕右侧（缩小）→ 第三幕回中爆炸成字
+- **身份卡（登录卡）完整字段**
+  - 卡片头 UEG ACCESS PERMIT / 身份许可
+  - 证件编号 / 签发机构 / 授权等级 / 有效期 / 许可范围 / 生物特征 / 核验状态（7 组，两列排布，逐条淡入）
+  - 1:1 假二维码（Pillow 合成的 25×25 模块 PNG，带三个定位角）
+- **配音与音效**
+  - 配音：REQUEST ACCESS PERMISSION（4.96s）、Initializing secure session.（12.0s）、Verifying…standing by.（15.6s）、welcome back（23.0s）、欢迎回来（24.4s）
+  - 前两句套「AI 机械音」预设，第三幕两句保留原声
+  - 新增 6 个合成音效：电子哔 / 数据滋啦 / 低频咚 / 机械咔哒 / 上升扫频 / 下降扫频（槽位 line-9 ~ line-14）
+  - 音频槽位上限 8 → 16；音频按 bus 分轨（amb / voice / sfx / 自定义）
+- **编辑器**
+  - 预览热更新：改参数/拖关键帧不再重建预览页，播放头与暂停状态保持
+  - 「＋ 加一条音效」一键按钮（播放头位置、sfx 总线、自动选槽位）
+  - 音频块高亮（选中黄框 + 底光），重绘后保持
+  - 面板图层（panel）类型：宽高/圆角/边框/填充/辉光/模糊/裁切
+  - 文字外框大小、文字擦除 wipe、字符地球半径倍率与画布自动出血
+- **坐标规范**
+  - 所有图层 `pos` 统一为画布中心 `[640,360]`，位移只写 `offsetX/offsetY`
+  - 新增守护测试 `test/smoke-coords.mjs`（扫全部内置模板，违规即失败）
+  - 编辑器载入老模板时自动把绝对坐标迁移进偏移
+- **宿主**
+  - 保存模板前自动时间戳备份（`backups/`，保留 30 份）
+  - 模板读写/校验上限统一 16MB；模板素材不缓存（改文件立刻生效）
+  - 引擎时长上限 30s → 60s
+- **安装（2.7.1 起）**
+  - 兼容不带 CLI 的桌面端：扩大命令行查找范围（PATH/安装目录/注册表/运行进程/有界递归）
+  - 仍找不到时自动「手动安装」（改 profile 依赖 + 建 node_modules 目录联接）
+
+### 修复
+
+- 点关键帧后播放头跳回 0（点选/改数值两条路径都修）
+- 音频在暂停或拖动时反复播放同一句
+- 音频机械音预设下淡入淡出失效（改作用到 WebAudio 增益）
+- 中文文件名音频被静默忽略（台词改名 voice-main.wav）
+- image 图层 URL 前缀错误（图片层从来没加载成功）
+- 扩展画布时粒子文字落点未平移（WELCOME BACK 偏到左上）
+- 字符地球放大后出现巨大轮廓圆框；画布出血不足导致粒子被裁
+- bgchars 误画大圆环（logoSize 720 的 outline）
+- 素材缓存导致换音频/点云后画面不更新
+- 保存大模板被拒（校验写死 96KB，回落到旧版 → 表现为坐标全部归零）
+- 读取大模板静默回落（>128KB 跳过且无日志）
+
+### 已知问题
+
+- 无头渲染下完整版第二幕段的地球有时只显示部分（真实客户端待确认）
+- 中文粒子文字在无头 Chrome 的 canvas 字体下会变成方块，故中文标题统一用 DOM 文字层
+---
+
+## [2.7.1] — 2026-10-19
+
+### 修复
+
+- **安装时提示「找不到 DeepSeek Harness 的命令行（dsh）」**：桌面端精简安装 / 便携版可能不带 CLI，旧安装脚本直接退出
+  - CLI 查找范围扩大：PATH → 常见安装目录 → 注册表卸载项 InstallLocation → 正在运行的进程路径 → 常见父目录有界递归（深度 4）
+  - 仍然找不到时自动切换「手动安装」：改 profile 的 package.json 依赖 + 建 node_modules 目录联接，效果等同 link 安装
+  - 手动安装失败会回滚 profile 并给出明确原因（多为杀软拦截 mklink）
+---
+
+## [2.7.0] — 2026-10-19
+
+第一幕「DeepSeek FUI 片头」手搓完成，编辑器从「能改」进化到「能剪」。
+本版三件大事：坐标体系统一、音频系统（轨道/总线/剪辑/波形/机械音）、模板体积治理。
+
+### 新增
+
+- 时间线编辑器（tools/editor.html）
+  - 关键帧批量修改：Ctrl/Cmd 点多选（或开「批量选择」开关），选参数 + 填值 → 一次改完所有选中帧，其它参数不动
+  - Delete / Backspace 删除选中关键帧；多选时一次删除（每层至少保留 1 帧）
+  - Ctrl/Cmd + S 保存到本地（时间线、表单、输入框内都可用）
+  - 「全选本层所有帧」「取消多选」快捷按钮
+- 文字擦除 wipe：文字按关键帧从右往左（或反向）逐段露出，配合 line 图层做「竖线扫过、文字浮现」
+  - 教程模板 wipe-tutorial（三步说明 + 合体演示）
+- 文字外框大小：「外框」开关 + 「框大小」0.2～5 倍（0.2 贴着字，5 最大），内边距等比放大、字号不变
+- 字符地球
+  - globeScale 球体半径倍率：粒子铺满全屏后收拢，字形始终清晰（不靠位图缩放）
+  - boxScale 画布扩展倍数 + 自动出血：按图层位移与最大扩散倍率自动扩大画布，挪到哪都不露边
+  - 放大（>1.3 倍）时不再绘制轮廓圈，避免出现巨大圆框
+  - 画布扩展后占位与绘制中心自动对齐；编辑器可手动指定扩展倍数
+  - dotsFile：点云可外置到模板 assets，运行时加载（同 ringsFile 机制）
+- 音频系统
+  - 时间线音频轨：按总线分轨显示（amb 环境 / voice 人声 / sfx 音效 / 自定义轨），可「＋音轨」新增
+  - 音频块剪辑软件式操作：拖中间挪位置 / 左把手掐头 / 右把手去尾
+  - 片段可删除：点选后 Delete、右键、双击、面板 ✕
+  - 静音：点轨道名前的喇叭切换整条总线；每条 cue 也可单独静音
+  - 时间线画真实波形（WebAudio 解码，随偏移/时长窗口重算）
+  - 每条 cue 可调：开始偏移 / 播放时长 / 音量 / 淡入 / 淡出
+  - 音频总线：每条 cue 归属某条总线，总线各自音量与静音
+  - 机械音预设：AI 机械音 / 机器人 / 无线电 / 老电视 / 低沉（WebAudio 滤波 + 失真 + 环形调制）
+  - 导入音频：编辑器选文件 → 自动规范文件名为 ASCII → 上传到模板 assets → 占用空闲槽位
+  - 槽位命名（assetNames）：给 line-1…line-8 起名，下拉 / cue / 轨道块统一显示
+  - 每个音轨「放入轨道」下拉：选一个已导入音频 → 自动在 0 帧生成片段
+  - 合成并预置 4 个机械音效：sfx-click / sfx-switch / sfx-thump / sfx-hum（槽位 line-4～line-7）
+- 模板
+  - dsh-intro 第一幕定稿：鲸鱼线描 + 深度求索标题 + 英文副标 + 载入进度 + 申请访问许可 + 字符地球
+  - 第一幕时长 5s → 8s（所有关键帧、分段、gates、效果时间窗、音频 cue 统一 ×1.6）
+  - 字符点云外置：bgchars-dots.json / sphere-dots.json，模板本体 215KB → 5KB
+- 宿主能力
+  - POST /dsh-startup/template-assets/upload：接收 base64 音频写入用户模板 assets（文件名白名单、20MB 上限）
+  - 模板读 / 写 / 校验上限统一提到 16MB（原读取 2MB、保存校验 96KB 不一致）
+
+### 修改
+
+- 坐标体系统一：位置 = 相对画布中心 (640,360) 的偏移，0,0 即正中心；所有图层统一用 transform 定位
+  - 编辑器「居中」按钮改为把偏移归零；迁移了全部内置模板
+- 编辑器载入模板时显示来源（本地 / 内置），便于确认加载的是哪一份
+- 批量修改面板挪到属性栏内（属性滑块 → 关键帧 → 批量修改），方便对照
+- 层数上限 40→60、单层关键帧 32→64、效果数量 12→24
+
+### 修复
+
+- 保存大模板被拒：保存校验仍写死 96KB，215KB 模板保存失败并回落到旧版（表现为「坐标全部跑回 0」）
+- 读取大模板静默回落：模板 >128KB 被跳过且无日志，编辑器显示内置旧版；已提上限并加诊断日志
+- 暂停/拖动时音频重复播放：主循环在暂停状态下仍每帧触发 cue，且 seek 会清零标记；改为仅播放中触发
+- 从段中开始播放：播放头落在音频段中间时从当前位置起播（跳过已过去部分），不再从头重播
+- 中文文件名音频被静默忽略（引擎只认小写英文/数字/._- 的文件名）→ 台词改名 voice-main.wav 并改引用
+- 批量修改面板插错面板（插进了表单视图，时间线里看不到）
+- 音频块样式写在 splash.css（编辑器不加载）导致块 0 尺寸点不到 → 样式移入编辑器自身 style
+- 背景字符粒子在 assemble=0 时完全不绘制 → 改为低透明度显示
+- 终幕文字糊成一坨：文字采样目标仍按 640×640（画布已 1280×720）+ 采样步长过密 → 修正尺寸与步长
+- 编辑器点击跳变：点关键帧跳回 0、点图层名跳回 0（拖动阈值 / 事件源判定）
+- 一次提交里的语法错误（数组被 join 成逗号导致引擎报错），由提交前测试闸拦下并修复
+
+### 文档
+
+- docs/坐标系约定.md：统一后的坐标模型
+- docs/FUI-五要素.md：闪 / 故障艺术、受限色盘、暗底亮字、缓慢节奏载入、装饰信息
+- docs/分镜规格-DeepSeek片头v1.md、docs/参考研究-550C.md、docs/第一幕坐标-用户手调.md
+- docs/编码方式-几何数据与投影.md：点云 / 海岸线数据的生成与投影方法
+- 示例模板：wipe-tutorial、wipe-demo、550c-homage
+
+---
+
+## [2.5.2] — 2026-10-18
+
+### 修复
+
+- 标题栏透明化真正生效（样式提到解析阶段注入）
+- 标题栏透明化放宽 gate + 加一次性 DOM 探针
+
+### 新增
+
+- 上架申请正文（DSH STORE issue 用）
+
+### 修改
+
+- 补 __ss_link 样式（检查更新里的下载页链接）
+
+---
+
+## [2.5.0] — 2026-10-18
+
+### 新增
+
+- 首帧防露、标题栏收编、两段式揭幕
+- 检查更新
+- 模板商店（列表 + 一键安装，数据源走 GitHub，不建服务器）
+- 模板可自带配音（template-asset），不同模板互不覆盖；商店安装时一并下载配音
+- 深海声呐模板（deep-sonar）：接入用户录制的英文干音、画面英文与配音对齐、古早 AI 播报音色、底噪床全程连续
+
+### 修改
+
+- 作者如实标注为原作者沈宏宏（原动画非 LeeRolling 所作）
+
+### 文档
+
+- 线稿 + 完成图双图方案、赛璐璐出图、禁止清单与提示词
+- 参考动画（龙娘启动）描线实现分析与移植可行性
+- 引擎能力清单（能改的 / 改不了的 / v2 缺什么）
+- 术语表（中英关键词 + 对应模板字段）
+
+---
+
+## [2.2.0] — 2026-10-18
+
+### 新增
+
+- 第一个自定义模板 deep-sonar（深海声呐）+ 设置页模板下拉框
+- 分幕数据化：支持任意幕数（1～24）
+- 一键安装 / 卸载（双击即可）
+- 可移植的急救 / 回滚 / 备份工具
+
+### 修复
+
+- 立即预览要先刷新配置与模板，否则换模板后预览还是老动画
+
+### 文档
+
+- README 重写（中英双语 + 演示图 / GIF + 安全网说明）
+- B 站 1000 字以内分享文案（716 字）
+
+---
+
+## [2.1.2] — 2026-10-18
+
+### 修复
+
+- 运行时脚本改用 script-src 行 —— 修「开机动画整段消失、直接进壁纸」
+
+### 性能
+
+- 缩短开幕黑屏等待
+- 禁止黑屏自愈重复加载运行时
+
+---
+
+## [2.1.0] — 2026-10-18
+
+### 新增
+
+- 聊天背景设置并入 DSH 设置页
+- 壁纸半侧补诊断与启动保险
+
+### 修复
+
+- 冷启动纯黑屏：行表订阅改官方写法 + 客户端 1.5s 黑屏自愈 + 取证
+- 首屏注入改用结构化注入行，修桌面端「先闪一下 DSH 启动界面」
+- 注入订阅互斥 + 行表幂等去重
+
+---
+
+## [2.0.0] — 2026-10-17
+
+### 新增
+
+- 开机动画与聊天壁纸合并为一个插件（dsh-boot-suite）
+- 冷启动六幕开机动画：黑幕 → DeepSeek 标识 → 过曝洗白 → 爆白档案底板 → 五步交互式授权 → 色散故障揭幕
+- 中文主标题 + 英文等宽副标题、真声台词 + 界面音效（13 项设置）
+- 聊天壁纸：左下角「背景」按钮（全屏入场视频 / 聊天底图 / 大字横幅，支持循环区间与时间码）
+
+---
+
+## 维护约定
+
+1. 每个版本发版时，在文件顶部新增一节，标题格式 [x.y.z] — YYYY-MM-DD
+2. 只写用户能感知的变化；重构、测试、内部整理归入「修改」或省略
+3. 修复条目要写现象（用户看到什么），而不是只写代码改动
+4. 提交信息建议用 feat / fix / docs / style / perf / test 前缀，方便日后自动汇总