2
0
Files
dsh-long-skin/docs/compatibility-validation.md
2026-10-20 12:37:36 +08:00

43 lines
3.8 KiB
Markdown
Raw Permalink 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.11 兼容性修复验证
本轮以 0.1.10 为基线。修复经过本地包验证和 Grok Build 4.7 最高可用推理等级(xhigh)只读 review 后,随 0.1.11 发布;Windows Desktop 仍需报告者更新后验证。
## 变更
- 保留宿主的根容器定位和层级,背景使用独立层级;兼容社区 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 留待后续处理。
## 后续:DSH 0.2.1-rc.2 账号页面
已核对[官方固定发布源码](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/client/ui-settings-account/src/client/PlatformOverlay.module.css)及对应 npm 产物:账号用量/充值页覆盖层仍继承背景 token,48px 返回栏没有独立底色。皮肤新增局部规则,仅为 body 直属、带原生拖拽返回栏和 viewport 的模态覆盖层恢复配色背景。
验收:分别在浅色和黑金档打开用量/充值页,确认返回栏与加载状态背景不透明、返回按钮清晰可用;普通弹窗、菜单和聊天背景保持原行为。停用皮肤后恢复宿主背景。自动化只使用宿主结构夹具,不登录账号,也不替代原生 Desktop 验收。