Files
dsh-long-skin/docs/compatibility-validation.md

37 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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