[graydovee]

概述 / Summary

把工作区依赖与文档从 dsh 0.2.1-rc.2 升级到 0.2.1-rc.3；插件本身不需要任何代码改动。按 fork 流程：产品侧改动先进承载分支 omdsh-dev/dsh-browser，本 PR 再从 main 切出并 --no-ff 合并该承载分支，同一 PR 内补中英 changelog。

动机 / Motivation

dsh 0.2.1-rc.3 已发布（npm next 标签；DSH Desktop 的 nightly 通道已自动升级）。dsh-v0.2.1-rc.2...dsh-v0.2.1-rc.3 只有 6 个提交、300 个文件，改动集中在客户端 UI（新增侧栏/会话视图/右栏的「更多」菜单）、新会话空白复用修复、以及 DeepSeek API Key 的模型列表来源。

插件依赖的宿主包（dsh-tools、dsh-agent、dsh-attachment、dsh-llm、dsh-host-webserver、dsh-home-paths、dsh-api-gateway、dsh-client-connection、dsh-client-ui-slots、dsh-client-locale、dsh-session-persistence 等 24 个包）在 rc.2 与 rc.3 之间逐字节相同（仅 package.json 的 version 字段不同），所以只需同步版本声明、文档与锁文件。

改动内容 / Changes

承载分支合并（omdsh-dev/dsh-browser @ 0115cf75，合并提交 990caf3c，--no-ff）：

• 根 package.json：35 个 @deepseek-ai/dsh-* 依赖 0.2.1-rc.2 → 0.2.1-rc.3，pnpm-lock.yaml 重算
• 桥插件 package.json：20 个 devDependencies 升到 rc.3；engines.dsh 与 12 个 peerDependencies 保持 ^0.2.1-rc.2（rc.2/rc.3 插件接口一致，两个宿主都受支持）
• 桥插件 README（中英）、README.i18n.yaml 哈希、cordis.patch.yml 与 manifest.spec.ts 注释同步到 rc.3

本 PR 追加的 fork 侧文档（fb168745）：

• CHANGELOG.md / CHANGELOG.zh-CN.md 各一条 ## latest 条目
• 根 README（中英）与扩展 README（中英）的运行时兼容说明、npx 示例同步到 rc.3
• scripts/install.sh / install.ps1 的固定版本示例同步到 rc.3（PowerShell 脚本保留 UTF-8 BOM）
• 根与扩展 README.i18n.yaml 哈希回写；.agents/notes/upstream-pr-flow.md 运行时版本号更新

上游 PR omdsh-dev#121 已按流程只 edit 描述新增对应 changelog 条目，未新增评论。

测试 / Testing

承载分支（/tmp 独立 worktree，dsh 0.2.1-rc.3）：

• pnpm run build / typecheck / check:runtime → 通过
• pnpm run test → 77 文件 / 686 用例通过
• node scripts/smoke-runtime.mjs → 通过

本 PR 合并后的最终树：

• pnpm install --frozen-lockfile → 通过（与 CI 一致）
• pnpm run build / typecheck / check:runtime → 通过
• pnpm run test → 78 文件 / 700 用例通过
• node scripts/smoke-runtime.mjs → 通过（发现信标与 CORS、token 认证、create/list/history、模型选择、权限预设、Host 命令与 skill、V2→V4 迁移、V4 快照、重启后投影）
• bash -n scripts/install.sh → 通过

额外对照验证：

• rc.2 与 rc.3 各自构建出的桥 lib/ 逐字节相同（75 个文件哈希全等）
• 用「rc.2 构建产物 + 原 rc.2 清单（engines.dsh: ^0.2.1-rc.2）」在 rc.3 宿主上跑冒烟同样通过

影响范围 / Impact

• 仅影响本仓库的开发与 CI 基线版本；插件运行时仍声明兼容 ^0.2.1-rc.2，rc.2 与 rc.3 宿主都可安装
• 无平台 / 浏览器行为变化；扩展与安装脚本行为不变（只有示例里的版本号变化）
• 承载分支已推送（PR [功能汇总] fork 仓库的新增功能，后续持续追加，可随时合回主线（已兼容0.2.1-rc.3） omdsh-dev/dsh-browser#121 head），上游 PR [功能汇总] fork 仓库的新增功能，后续持续追加，可随时合回主线（已兼容0.2.1-rc.3） omdsh-dev/dsh-browser#121 描述已更新

Checklist

• 已在相关平台实测通过 / Tested on the relevant platforms
• 已通过 pnpm run build / bash -n scripts/install.sh 等基础检查 / Passed basic checks
• 文档已同步更新（如需要）/ Docs updated if needed
• 不包含无关改动 / No unrelated changes included