forked from 27hrs/dsh-long-skin
d0b7849c02
Respect host root layout, draw the scrim once, discover appearance controls without build hashes, and recover failed portraits independently. Add unit and real-browser regression coverage. Refs #8, #12, #15, #10, #13. Native Desktop acceptance remains pending; no release.
2.8 KiB
2.8 KiB
未发布的兼容性修复验证
本轮以已发布的 0.1.10 为基线，修复留在独立分支，不发布 npm 或版本标签。
变更
- 保留宿主的根容器定位和层级，背景使用独立层级；兼容社区 Desktop 的标题栏高度。
- 保留官方 Windows 框架透明与 macOS 侧栏、新会话按钮配色修复；半透明背景遮罩统一绘制一次。
- 外观入口按原生三个主题按钮的结构识别，兼容构建类名哈希变化；停用时清理入口和监听。
- 人像逐张加载和解码，单张失败不阻止其他帧使用；失败后分别等待 0.5、1.5、3 秒重试，最多额外三次。
- 未加载的目标帧保留上一张可用人像；全部失败时保留配色背景。停用时取消重试和请求，重新启用后重新加载。
- 保持素材原色、面板透明度及原有推理等级绑定语义。本轮不处理跨刷新外观记忆，也不修改皮肤市场。
本地验证包
验证包是完整的 .tgz，包含客户端构建与 24 张 WebP 人像；只用于本地验证。具体包路径、校验值和对应修复提交由交付消息提供。
官方 Desktop：使用当前宿主支持的本地包安装入口加载该 .tgz，由用户点击安装、启用和重启；不要把 Web profile 的安装结果当成 Desktop 已安装。若当前宿主没有本地包入口，先提供其实际入口信息，再选择安装路径，不直接编辑 profile。
DSH Web：可用 dsh plugin --profile web add /绝对路径/测试包.tgz 安装。安装或重新安装后完全停止并重新启动对应宿主；浏览器刷新不能替代 Desktop 完全退出重开。
用户验收
- 安装测试包并完全退出、重开官方 Desktop，确认加载的是测试包；保留其他皮肤停用的状态。
- 打开「设置 → 通用设置 → 外观皮肤」：应有「滑动变祖」和推理等级绑定开关；切原生后人物及滑块消失，点击滑动变祖后恢复。
- 在浅色档和黑金档分别观察人物、侧栏和输入区；调整窗口大小、切换侧栏，确认无半屏断层、文字可读。
- 拖动滑块：人物应随档位改变；关闭绑定后只改变人物和配色，不修改模型推理等级。
- 打开「完全权限」、模型选择和其他弹窗，确认显示层级正常且可以点击；标题栏仍可拖动，窗口按钮可用。
- 刷新或重启时，外观仍按本次激活默认启用皮肤；跨刷新记住原生选择属于暂缓的 #9。
自动化测试使用浏览器宿主夹具并模拟图片失败；它们不代表官方 Windows Desktop 真机已经验收。
Issue / PR 收尾
已确认可收尾的 #2、#3、#6 关闭。#8、#12、#14、#15 与 PR #10、#13 在用户验证前保持开放；PR #9 留待后续处理。