CHANGELOG / 更新日志

DSH Desktop 更新日志

版本号是复合形式 <dsh 内核版本>.shell.<壳修订>：内核随官方 @deepseek-ai/dsh 升级，壳修订只包含桌面壳自身的修复与功能。以下节选近期版本要点，完整说明见各版本 Release 页。

v0.2.0-rc.2.shell.0 （内核 0.2.0-rc.2）

内核升级：从 0.2.0-rc.1 升级到 0.2.0-rc.2；34 个 dsh-* peer pin 与闭包锁文件同步，并按解析版本维护 release-age 豁免。
登录授权适配：每次新授权尝试都会将授权链接自动打开到系统浏览器并保留当前主题；补丁按 rc.2 组件重建，真实打包 E2E 通过。
插件兼容保护：安装继续校验插件 peer 版本，不兼容时说明原因并拒绝安装；兼容的社区市场版本跨过随包 pnpm 年龄门槛后会自动解析。

内核升级 0.1.7-rc.2 → 0.2.0-rc.1：跟随上游 0.2.0 线的首个候选版。壳侧闭包同步 34 个 dsh-* peer 钉、release-age 豁免清单重钉 229 项；登录授权自动打开补丁按新版本语义原样重建（上游 SignInDialog 仍未内置该能力）。
插件安装更安全（内核新行为）：0.2.0 内核在插件安装时强制校验 peer 兼容性——与内核版本不匹配的旧插件会被明确拒绝并给出解释与风险豁免指引，不再静默装上后在运行时崩溃。社区插件市场（dshmarket）需 1.66.4 及以上版本才与本内核声明兼容；配套的 pnpm 11 供应链策略（新包发布满 24 小时才参与解析）意味着市场安装将在 1.66.4 发布满 24 小时后（2026-09-29 晚）自动恢复，此前安装会显示可重试的分类失败说明，无需用户操作。
升级与隔离契约延续：跨版本升级冒烟（设置/数据保留断言）、插件损坏隔离（Safe Mode）在新内核上复验通过。

多网卡多二维码完全支持（#65）：LAN 配对不再只展示主网卡一个地址。桌面端与移动配对代理现在为机器上每一个私有地址（物理网卡 + Tailscale/ZeroTier 等虚拟网卡）各起一套完整监听，扫码窗口为每个地址渲染独立二维码并标注类型（局域网 / VPN 虚拟网卡）——手机接哪个网段都能扫到对应的码。
网卡选择与覆盖：配对面板新增网卡勾选，勾选结果持久化；高级场景可用 DSH_LAN_IP 环境变量覆盖（单地址、逗号分隔多地址、或 0.0.0.0/all 全网卡通配）。
代理稳定性修复：多地址监听重构中遗留的循环嵌套导致升级（WebSocket）处理器与 SSE 长连接超时配置未应用到实际监听的服务，已修复；双地址冒烟 + 双 LAN E2E 全绿。
边界说明：LAN 配对仅限局域网/虚拟局域网内使用，令牌一次性配对、不穿透公网，不上传任何数据。

修复 macOS 无法启动（#79，关键）：v0.1.7-rc.2.shell.0 的 macOS 版本因完整性清单文件在代码签名之后写入而破坏 ad-hoc 封印，macOS 判定应用「已损坏」拒绝启动。本轮起 macOS 不再打包清单文件（它会破坏封印，二者不可兼得）——macOS 的完整性改由代码签名本身校验（codesign --verify --deep --strict，运行体检自动执行），比 SHA-256 清单更强。shell.0 的 macOS 用户请务必升级到本版；Windows/Linux 不受影响，清单校验照旧。
左下角登录流程端到端验证与加固：账号弹层 → 登录 → 授权页自动打开的全链路已有打包 E2E 覆盖并全绿；随 rc.2 重建的登录授权自动打开补丁完成端到端验证（本迭代在真实安装包上复现并修复了该补丁的 effect 顺序问题——插入位置在声明之前会引发渲染期错误，登录对话框无法打开）。
局域网多地址二维码（#65）：配对窗口现在按可达地址渲染多个二维码并标注类别（局域网 / VPN 虚拟网卡），Tailscale/ZeroTier 与物理局域网的设备都能扫到属于自己的入口；同一地址自动去重，最多展示 4 个。
内核与边界不变：内置内核仍为 0.1.7-rc.2；不新增权限、不改变数据目录边界。

内核升级：随官方 @deepseek-ai/dsh 0.1.7-rc.2（上一内置内核 0.1.7-rc.1）。上游变更见官方发布页。
UOS/Deepin 桌面适配（#73）：
登录授权自动打开补丁随 rc.2 重建：账号设置中 DeepSeek 登录授权页自动打开的体验补丁已按 rc.2 重建（此前仅适配 rc.1）。
依赖闭包同步：新 peer dsh-llm-deepseek 入清单；12 个未随 rc.2 发版的子包按解析版本保留；双树 npm 审计零已知漏洞。
内核与边界不变：不新增权限、不改变插件安装与数据目录边界；体检保持只读、不上传、不自动修复。

修复内核 0.1.7 迁移 settings.yaml 后，原生菜单、窗口标题、托盘和通知语言回退的问题；优先从本地 web profile 读取语言与主题，并跟随 profile 更新。
保留对旧 settings.yaml 和 .imported 归档的兼容，读取归档时不会重建旧文件；偏好只保存在本机。
修正跨版本升级门禁：先在旧版首次启动前播种用户设置，再验证旧版迁移和新版安装都保留数据，避免测试夹具制造不真实的混合状态。

修复内核 0.1.7 迁移旧版设置后，原生菜单、窗口标题、托盘等桌面界面语言回退到操作系统语言的问题。壳现在优先读取 web profile 中的语言和主题偏好，并跟随 profile 更新。
保留迁移兼容：仍可读取现存的 settings.yaml 及内核归档的 settings.yaml.imported；读取旧归档时不会重新创建旧设置文件。
偏好留在本机 Harness profile 中，不会上传。

内核升级：随官方 @deepseek-ai/dsh 0.1.7-rc.1（上一内置内核 0.1.6-alpha.2，直接跨到 rc 线）。上游变更内容见官方发布页。
内核行为变化（对用户可见）：0.1.7 起内核对损坏的社区插件改为「隔离并继续启动」，插件不再拖垮整个 Harness；设置文件无损迁移（旧文件逐字节归档为 .imported）；设置入口移至左下角账号弹层。壳的启动冒烟、升级数据保留断言与设置导航 E2E 均已按新契约更新（随 v0.1.6-alpha.2.shell.4 入库，本轮首次随内核发版验证）。
依赖闭包同步：重新生成 lockfile，同步 supply-chain release-age 豁免清单；官方 npm 安全审计零已知漏洞。新内核 peer 缺口 dsh-client-store、dsh-deepseek-account 已加入闭包清单（audit 门指认）；未随 rc.1 发版的 dsh-* 子包按解析版本保留，无版本倾斜。
边界说明：桌面壳无功能变更；社区插件仍不进入安装包。若插件与新内核不兼容，启动失败时错误页提供一键「升级 / 禁用」恢复。
已知行为变化：内核 0.1.7 将 settings.yaml 无损迁移（归档为 .imported）后，壳的原生界面语言（菜单/托盘/通知）改随操作系统语言，应用内语言选择暂不跨重启保留——后续版本将改为读取内核新设置存储（#68）。

更早版本的说明见 GitHub Releases。