v2.13.12 · 更新体验修复

v2.13.12 · 更新体验修复

本版没有新功能，只修 3 个来自真实用户诊断报告的问题。

1. 浏览器下载等待从 10 分钟延长到 30 分钟

点「立即更新」后，插件会等浏览器把安装包下载完。旧版只等 10 分钟，网慢时容易超时。现在最长等 30 分钟，下载完成后仍会自动接住安装。

2. 等待期间不再干等

• 新增「打开下载文件夹」按钮，可确认浏览器是否开始下载。
• 「选择安装包」在等待期间一直可用：如果浏览器已下载完，直接选中 zip 即可继续更新，不用等自动监听。
• 手动选中后会跳过重复触发，不会重复弹更新。

3. 「生成诊断报告」防连点

生成期间按钮会禁用并显示「生成中…」；后台同时只处理一个请求，重复点击会提示「正在生成中」，不会再在桌面生成多份报告。

升级方法

1. 完全退出 DSH（窗口 + 右下角托盘）。
2. 双击桌面 升级到 2.13.12（先完全退出 DSH 再双击）.cmd，装完手动打开 DSH。
3. 设置页确认版本 2.13.12；桌面回滚按钮应为 紧急回滚-V2.13.11。

校验值

• dsh-boot-suite-win.zip / dsh-boot-suite-win-V2.13.12.zip：24,174,331 B
  SHA256 B6BCE662FB9831D7A7CA51171CD0C26E29D99364D48DD10AA7B49D207FD06428
• dsh-boot-suite.tgz（市场/安装用）：21,024,863 B
  SHA256 FBD6697C9BF3554E4227A6F4587799F424943950BA9B4ED4730504A8296E68D8

npm 公共包同步发布：npm i dsh-boot-suite（2.13.12）。

v2.13.11

v2.13.11 — 纱的「镜头模糊」+ 新版 DSH 一键安装修复

新增：镜头模糊

• 设置 → 聊天背景 → 纱：新增「镜头模糊」滑块，强度 0–100，默认 0。
• 0 = 完全不模糊；100 = 约 24px 模糊，越往右背景越糊。
• 只模糊纱后面的壁纸/视频，聊天文字保持清晰；浅色/深色主题各存一份，拖动实时生效。

修复：新版 DSH（0.2.1-rc.3）一键安装误判成功

• 根因：新版 DSH 的 dsh 命令行不解析任何子命令（dsh plugin … 和 dsh --help 都只打印 web 地址就退出），退出码却是 0；旧安装器只看退出码，误判成功并跳过手动安装兜底，留下「bundles 里有 dsh-boot-suite、dependencies/node_modules 里没有」的危险状态 → 启动时报 cannot resolve profile bundle "dsh-boot-suite"。
• 2.13.11 起：安装器以 profile 真实文件为准做安装后校验（node_modules/dsh-boot-suite 存在 + dependencies 指向它 + 版本号匹配）；命令行「退出码 0 但没装」时自动改手动安装；仍失败则回滚 profile，并且不会往 bundles 写不存在的插件。

安装 / 更新

• 已有插件：设置页「检查更新」或等自动更新；更新前桌面自动生成 紧急回滚-V<旧版本>…cmd，装好后自动换成回滚到新版本的按钮、旧按钮自动清理。
• 手动安装：完全退出 DSH（窗口 + 托盘），解压后双击 安装.cmd。
• 插件市场安装：dsh-boot-suite.tgz（本 Release 已附带；以后每次更新都会带）。

校验值

文件	大小	SHA256
dsh-boot-suite-win.zip	24,151,826 B	05D805D385C25FF5B173056B741D282807C3EAA44C1BFA9590F5455BB670001F
dsh-boot-suite-win-V2.13.11.zip	24,151,826 B	同上（内容相同，仅文件名带版本）
dsh-boot-suite.tgz	21,021,042 B	A1DAED3B7DBDDD22237F05222E1819658BE4D05A3415FF922979AF2F9D50D90C

已知问题

• 若 Windows 开了「减少动画」（辅助功能 → 视觉效果 → 动画效果），片头动画会按设计跳过；关掉并重启 DSH 即恢复正常。
• 8K 第二幕仍在等素材，后续单独更新。

v2.13.10

v2.13.10 — 聊天背景文字明暗自适应 + 右上角窗口按钮修复

主要更新

• 聊天正文自动反色：按「壁纸 + 纱」叠完后的实际亮度自动选白字/黑字，深色壁纸不再黑字压黑底、浅色壁纸不再白字压白底。
• 浅色外观全面修复：DSH 外观切「浅色」时，侧边栏、最近文件、输入框、harness 徽标、新会话按钮、完全权限图标、收起侧边栏按钮都保持 DSH 原生浅色样式，不再出现白底白字/一坨白。
• 纱的浓度滑块恢复生效：浅色/深色主题各记一份浓度，拖动实时生效（之前被壁纸亮度逻辑覆盖）。
• 右上角窗口按钮（最小化/最大化/关闭）：直接给 Windows 原生标题栏探针固定一对高对比色，片头动画期间仍保持标题栏透明，片头结束自动恢复。
• 合并了 v2.13.5～v2.13.9 的内部修复迭代（GitHub 上不单独发布这些版本）。

安装 / 更新

• 已有插件：设置页「检查更新」或等自动更新；安装前桌面会自动生成 紧急回滚-V<旧版本>…cmd，装好后自动换成回滚到新版本的按钮、旧按钮自动清理。
• 手动安装：完全退出 DSH（窗口 + 托盘），解压后双击 安装.cmd。
• 插件市场安装链接：dsh-boot-suite.tgz（本 Release 已附带，以后每次更新都会带）。

校验值

文件	大小	SHA256
dsh-boot-suite-win.zip	24,148,129 B	516A5A2C09E8DA998AC66C0DC12F0AF947DB1A9E6ADB6B02C9E881046F4845F8
dsh-boot-suite-win-V2.13.10.zip	24,148,129 B	同上（内容相同，仅文件名带版本）
dsh-boot-suite.tgz	21,019,401 B	CFAF4F2222D5690D9576C9DA58F67BAF3B8D224F7BF27501D33937D22FE8B8A4

已知问题

• 若 Windows 开了「减少动画」（辅助功能 → 视觉效果 → 动画效果），片头动画会按设计跳过；关掉并重启 DSH 即恢复正常。
• 8K 第二幕暂未提供，后续单独更新。

v2.13.4 — 聊天背景图片自适应（不裁切）

dsh-boot-suite v2.13.4 — 聊天背景图片自适应（不裁切）

一句话：聊天背景图可以「不裁切」了。

新增

1. 聊天背景 → 背景图 → 新增「图片适配」下拉：
   • 铺满窗口（裁切多余部分）：默认，与以前一致；
   • 完整显示（不裁切）：整张图完整放进窗口，上下或左右留底色边，适合大图/宽图。
2. 适配方式只接受 cover / contain，坏值自动忽略，不会写坏配置。

不变

• 开机动画、两幕、三段转场、循环视频、默认背景图、紧急回滚按钮全部不变。
• 旧配置没有 imageFit 字段时，自动按「铺满窗口」处理。

适合谁

• 之前反馈「静态大图加进聊天背景被裁切」的用户：选「完整显示」即可。

验证

• 本机 13 个测试套件全部通过；桌面端冷启动两幕正常；两种图片适配均生效。
• 安装包 dsh-boot-suite-win.zip / dsh-boot-suite-win-V2.13.4.zip：24,131,659 字节，SHA256 1E44083131AFBEDBA4A28478D1A3153066B08385BF00EC0AA57FF47DDC74B3BF。
• 市场用 dsh-boot-suite.tgz：21,011,042 字节，SHA256 3D55555C17205DFAA090C3B1F63A811DD4209A451A263F5C284EE86088DDE08B。

v2.13.3 — 更新前自动紧急回滚（checkpoint）

v2.13.3 — 更新前自动留一个「紧急回滚」按钮（checkpoint）

这次只有一个目的：以后每次更新出问题，用户都能一键回到更新前能打开的状态。

新增

• 更新前自动生成桌面回滚按钮：安装器在替换版本前，读取 profile 里当前实际安装的版本，在桌面生成 紧急回滚-V<旧版本>（先完全退出 DSH 再双击）.cmd。
• 新版成功后自动换新：安装成功会清理旧的 紧急回滚-*.cmd，不会越积越多，用户不用手动删。
• 回滚只换插件版本，不动设置：双击按钮 → 校验旧版本完整 → 等 DSH 完全退出（最多 5 分钟）→ 备份 profile 配置 → 切回旧版本 → 校验版本 → 重新打开 DSH；中途失败自动恢复备份。用户配置、模板、聊天背景全部保留。
• 回滚日志：桌面 dsh-boot-suite 回滚日志 yyyyMMdd-HHmmss.txt（桌面不可写时写 ~/.dsh/boot-suite-updates/）。
• 设置页「检查更新」下方增加回滚保护说明；更新器成功日志末尾也会提示「回滚按钮已就绪」。

安装

1. 完全退出 DeepSeek Harness（窗口 + 右下角托盘）；
2. 下载 dsh-boot-suite-win-V2.13.3.zip，完整解压；
3. 双击包内 安装.cmd（不自动启动 DSH）；
4. 手动打开 DeepSeek Harness，设置页确认版本 2.13.3。

已经能正常打开 2.13.x 的电脑，也可以在设置页「启动动画」底部点「检查更新」，走自动更新（会先校验安装包完整）。

校验值

• dsh-boot-suite-win-V2.13.3.zip：1AC2466BB5A1625AD770974C9894071957A5A34F1D6AF26481ECDDB8AE868066
• dsh-boot-suite-win.zip：同上
• dsh-boot-suite.tgz（市场用）：2B73EBD1EC36F785FBC4429E2B55700AB11DE78E9040C1C9943DE5AC24C4C789

如果新版出问题

桌面会有一个 紧急回滚-V2.13.2（先完全退出 DSH 再双击）.cmd：完全退出 DSH 后双击它，即可回到 2.13.2；把同目录下生成的 dsh-boot-suite 回滚日志 …txt 发给作者即可定位。

v2.13.2 — 更新器加固：坏包先拦住，旧版本不再被装坏

修复：更新器先校验安装包，坏包不再把旧版本装坏

问题：v2.13.1 的更新失败不是安装包本身坏了，而是那台电脑下载到的是「半包 zip」——文件头仍是 PK、大小也超过 1MB，旧逻辑只看文件头就放行；等更新器把旧版本目录处理后，Expand-Archive 才报「找不到中央目录结尾记录」。此时旧版本插件已经不可用，只能靠更新器自动恢复。

v2.13.2 的改动

• 宿主侧所有更新入口（自动下载 / 浏览器下载监听 / 手动选择安装包 / 启动更新器）都校验完整 zip：文件头 + 尾部中央目录结束记录（EOCD）；自动下载还会按 GitHub 正式资产的 size 精确比对，坏包当场丢弃并自动换下一个镜像
• 浏览器下载监听：文件大小不再变化但 zip 不完整时，等 20 秒仍未收尾就明确提示「下载的安装包不完整」，不会把半包当成完成
• update-apply 启动外部更新器前再校验一次；坏包直接删除并提示「安装包不完整或已损坏，已删除，请重新下载」，不会再启动一个注定失败的更新窗口
• 更新器 tools/update-apply.ps1 重写：先校验 zip（SHA256 写日志）→ 解压到 pkg.new → 校验 package.json 版本和必需文件 → 才把旧 pkg 备份成 pkg.old 并替换；安装器失败会自动恢复旧目录与配置，旧版插件不会被动坏
• 更新日志多一份兜底：桌面写不进去时写到 ~/.dsh/boot-suite-updates/<版本>/，日志里带安装包路径、大小、SHA256
• 测试：smoke-host 新增「截断 zip 被拒、坏包不落盘」2 条断言

升级建议

• 已经能正常打开 2.13.x 的电脑：设置 → 启动动画 → 检查更新，或等自动更新提示
• 之前更新失败、旧版本打不开的电脑：下载本页 dsh-boot-suite-win-V2.13.2.zip → 完整解压 → 双击包里的 安装.cmd，装完手动打开 DSH；不需要先修复旧版本
• 本版不新增功能、不改用户配置/模板/背景图，只加固更新流程

资产

文件	大小	SHA256
dsh-boot-suite-win.zip	24,121,602 B	19F282ED59F5F6E9BADAE2B6B07447FF495382805E3950C8C21228C89DEC4D1A
dsh-boot-suite-win-V2.13.2.zip	24,121,602 B	19F282ED59F5F6E9BADAE2B6B07447FF495382805E3950C8C21228C89DEC4D1A
dsh-boot-suite.tgz（插件市场用）	21,001,842 B	6E403B55299D05AC0CCE0B5C6D94CB3E53D645450F92C5B77C4999BB8DC7D553

---

常见问题：第一幕那两个圈不转

现象：第一幕两个带缺口的圆环不旋转，但文字、进度、第二幕视频都正常。

原因：不是缺少运行环境，也不需要装显卡驱动或组件。系统关闭「动画效果」后，浏览器会收到 prefers-reduced-motion: reduce，插件按无障碍设计主动停掉第一幕圆环的旋转（「扫描线」转场同样会变成瞬间切换）。

解决：Windows「设置」→「辅助功能」→「视觉效果」→ 打开「动画效果」；或 右键「此电脑」→ 属性 → 高级系统设置 → 性能「设置」→ 选「让 Windows 选择」。完全退出 DSH（窗口 + 托盘）再重新打开即可。

如果那台电脑是通过远程桌面 / 远程控制软件在用，请先在本机直接登录状态下试一次：远程会话有时会把系统上报成「减少动画」。

v2.13.1 默认背景图（新装即有）+ 背景图选择/清空/恢复

新增：新装默认自带聊天背景图（v2.13.1）

• 安装包内置一张默认聊天背景图（1920×1080，约 245 KB）：新安装、或本机从没设置过背景图的用户，打开聊天默认就能看到，不用再手动拖图
• 设置页「聊天背景 → 背景图」列表第一张为「默认背景（内置）」；点它即可应用。之前已经选过别的图或循环视频的配置不会被强制覆盖
• 「不用背景图」现在会真正清空背景；想恢复时点「默认背景（内置）」即可
• 内置图随插件包分发（源码位置 lib/assets/default-background.jpg），不写入用户 ~/.dsh 目录，不影响用户已有图片、视频和配置
• 旧配置自动兼容：没有背景图字段、背景图文件被删除、或把背景图清空时，自动回落到内置默认图

修复（发布前独立验收发现）

• GET /chat-wallpaper/image?name= 传入目录名（. / .. / 已存在子目录）时，宿主读取目录会抛未捕获 EISDIR 并导致整个 DSH 进程退出；现在目录名一律 404，并给读流挂了错误处理，宿主不会再被打崩
• POST /chat-wallpaper/set 不再接受丢图目录之外的任意绝对路径（避免变成本地任意文件读取原语），只允许目录内的图片文件；读取旧配置仍向后兼容
• 用户自己丢的图和内置图同名（default-background.jpg）时，指定该名字返回用户图而不是内置图

验证

• npm test 13 套全过、0 失败（998 条通过标记：ok 766 + ✓ 232；坐标 196 层；wallpaper-host 127；package.json version=2.13.1，无 BOM，关键文件齐全）
• 发布包构建校验：244 个文件 + 2 个目录记录；lib/assets/default-background.jpg 250,819 B 随包分发；安装后默认背景可显示、可切换、可清空/恢复
• 发布包 SHA256：E47C4AF2A6DD0AAE86E91F9B0F7F9A239294CD60CE0A8E6A7EB12AF3DCC4BA9A（dsh-boot-suite-win.zip 与 dsh-boot-suite-win-V2.13.1.zip 为同一文件，24,117,749 B）
• dsh-boot-suite.tgz（插件市场安装包）SHA256：60C746EA38B5D9F38C33619DBA6118DD3A3D11885E5DBBA4625773C970DF8B76（20,996,750 B）

v2.13.0 聊天背景循环视频（壁纸引擎项目/Custom 目录/随机轮换）

新增：聊天背景「循环视频」（v2.13.0）

• 设置页「聊天背景」新增「循环视频」组：背景类型（静态底图 / 循环视频）、播放模式（手动选择 / 随机轮换）、轮换间隔（0 = 每次启动随机，可设 1–1440 分钟定时换）
• 循环视频默认静音、自动循环、铺满窗口；窗口最小化 / 切后台自动暂停，回来继续；读取失败自动回落静态底图，不会黑屏
• 视频来源：默认 ~/.dsh/chat-wallpaper/loops/，可添加任意自定义目录（最多 8 个，避开占满某个分区）；可打开目录 / 移除目录（文件不会被删）
• 支持用户自建子文件夹与壁纸引擎项目结构：递归扫描 mp4/webm，自动读取文件夹内 project.json 的 title / file / preview / type / tags；一个项目文件夹 = 一段视频，设置页显示 preview 缩略图
• 视频列表带「删除」：普通视频删文件；壁纸引擎项目整体删除文件夹（确认框写明）；只允许操作配置目录内的文件
• 本地删除文件后：下次打开设置 / 重启自动重新扫描，选中的视频不存在会自动清空并回落静态底图（不做实时文件监听）
• 视频通过宿主 HTTP Range 路由提供（/chat-wallpaper/video），只允许配置目录内文件；只存本机、不上传、不进发布包
• 旧配置自动兼容：没有视频字段时默认仍是静态底图

验证

• npm test 13 套全过、0 失败（972 条通过行；坐标 196 层；wallpaper-host 106 / wallpaper-client 81 / wallpaper-panel 43 / merge 35）
• 本机手动安装验证：版本 2.13.0、壁纸引擎项目被识别为一段视频、静音循环播放、随机轮换/自定义目录/删除可用、原静态底图与横幅不受影响
• 独立复核通过；发布包 SHA256：27386CEDD3689C54BCA72C17A17826E79141CE52053AD05D1304CAAC271FB5C4（dsh-boot-suite-win.zip 与 dsh-boot-suite-win-V2.13.0.zip 同一文件）

v2.12.4 自定义动画导入 + 三段转场 + 模板删除/隐藏

新增 / 修复 / 界面调整（汇总 v2.12.0 → v2.12.4）

v2.12.0：自定义动画导入 + 三段自定义转场

• 设置页「启动动画」新增「自定义动画」→「📥 导入动画」：mp4 / webm / gif / png / jpg / webp（≤64MB）自动生成用户模板，存 ~/.dsh/startup-templates/，第一幕 / 第二幕下拉都能选；视频自动读时长、静音、cover；图片 / GIF 默认 6 秒
• 新增三段自定义转场（各自下拉，默认全部交叉叠化）：第一幕入场 / 第一幕 → 第二幕 / 第二幕 → 桌面；类型：交叉叠化、闪白、故障、扫描线（方向可选）、推移、虹膜、黑场、硬切；时长 200–2000ms
• 旧配置自动兼容，缺字段用默认

v2.12.1：两幕成为完全独立片段

• 修复「第二幕 → 闪白」时闪白过程中还能看到第二幕透出：删除时间线片尾的内嵌淡出与 220ms 尾巴（换场点紧贴片尾），闪白覆盖改为 36ms 拉满且不再回落
• 默认「交叉叠化」观感保持；自定义转场不再与任何内嵌 fade 叠加

v2.12.2 / v2.12.3：设置页布局

• 「自定义动画」组移到「模板」组之前；移除重复的「本地动画（N）」列表
• 「删除该动画」按钮固定在「第一幕」「第二幕」下拉同一行最右侧，水平对齐、与下拉留间距

v2.12.4：内置模板也可以删除（隐藏 / 可恢复）

• 内置模板的「删除」= 从列表隐藏（写入你的配置，不删除安装文件，升级也不会丢），随时可在模板组底部点「恢复已隐藏的内置模板（N）」找回
• 删除/隐藏正在被第一/第二幕引用的模板时，自动切回默认
• 本地动画仍为真删文件（不可恢复）；两种确认提示文案已区分

验证

• npm test 13 套全过、0 失败（837 条通过行；坐标 196 层不变；含时间线转场测试）
• 本机手动安装复验：版本 2.12.4、两幕正常、第二幕结束闪白不再透出第二幕、删除/隐藏/恢复流程正确
• 独立复核通过；发布包 SHA256：D0B11AF6669FFADF4711FCDDC340984BA70354079B17369659A87ADAD2758101（dsh-boot-suite-win.zip 与 dsh-boot-suite-win-V2.12.4.zip 同一文件）

v2.11.11 发布包瘦身 + Release 源码对齐 + 文档口径校正

优化：发布包瘦身 + Release 源码对齐 + 文档口径校正（功能零变化）

• npm run release 现在跳过 docs/code-motion/**（另一条工作线的动效研究文档与媒体）：发布包不再携带这些内容，体积从 24.7 MB 降到 23.8 MB（约 −0.87 MB），包内文件 279 → 241
• 发布流程修复：先通过 GitHub API 把远端 main 快进同步到当前源码树（新 commit 1fb54c6，tree 与本地 HEAD 完全一致），再在该提交上打 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 完全一致

验证

• npm test 11 套全过、0 失败（约 492 条通过行；坐标 196 层不变）
• 本机冷启动确认：设置页版本 2.11.11、两幕动画正常、聊天背景只有 背景图 / 纱 / 大字横幅
• 发布包 SHA256：AEE800A263AFA352A83EA4F6B72E880E48EB0C77F224258A3692479187728213（dsh-boot-suite-win.zip 与 dsh-boot-suite-win-V2.11.11.zip 同一文件）