🗣️ 人话解读

📌

dsh 0.2.2-rc.2 发布并合入 master这是 0.2.2 的候选版本，说明正式版临近；普通用户不必急着升级，测试用户可重点验证自己遇到的问题是否已改善。

⚠️ 升级注意（8 条）

这些提交可能改变或移除现有行为，升级前先看一眼。

refactor(conversation): remove redundant retry source cache重构会话模块，移除冗余的重试来源缓存。
refactor(cua): remove parallel window-only API
refactor(sandbox): remove obsolete unsupported-policy error
refactor(team): order task guidance and remove duplicate advice
refactor(subagent): remove shared directory and scope guidance
refactor(cua): remove pid from app and window results
fix(client): drop the tooltip from row context-menu buttons
fix(stagehand): drop the deprecated extensionId option

📦 本版变更（共 1163 条，其中 298 次分支合并，展示最近 80 条功能变更）

fix(cua): honor per-read traversal limits on Windows修复 Windows 上 CUA 未遵守每次读取遍历限制的问题。2026-11-10

feat(cua-windows): expose element metadata and defer disabled-state rejectionCUA Windows 暴露元素元数据并延迟禁用状态拒绝。2026-11-10

feat(cua-windows): use UIA RuntimeIds as element identifiersWindows CUA 改用 UIA RuntimeId 作为元素标识。2026-11-10

feat(cua-windows): allow selecting unlisted executables by path允许通过路径选择未列出的可执行文件。2026-11-10

feat(cua-windows): launch AUMIDs through Explorer with bounded observation新增通过资源管理器启动 AUMID 并进行有界观察的功能。2026-11-10

fix(cua-windows): separate default invocation from simulated clicks修复 CUA Windows 中默认调用与模拟点击未分离的问题。2026-11-10

feat(cua-windows): show patterns instead of actions in accessibility state在无障碍状态中改为展示模式而非操作。2026-11-10

feat(cua-windows): expose native pattern actionscua-windows 新增暴露原生 pattern actions 的功能。2026-11-10

fix(cua-windows): use native control type names修复 cua-windows，将控件类型名称改为原生名称。2026-11-10

Revert maxDepth/maxElements changes and tests回滚 maxDepth/maxElements 相关改动及测试。2026-11-10

refactor(exports): internalize test helpers and type fixtures重构导出结构，将测试辅助函数和类型夹具改为内部使用。2026-11-10

🐛 Preserve authored text sizes on mobile Safari修复移动端 Safari 自动缩放文字的问题，使作者设定的字号得以保留。2026-11-11

release(dsh): 0.2.2-rc.2发布 dsh 0.2.2-rc.2 版本。2026-11-11

fix(cua-windows): 修正 Windows 辅助功能遍历上限提示2026-11-11

test(cua-windows): 对齐 native traversal 上限边界断言2026-11-11

fix(forge-panel): settle lens runs with their plugins and keep review state through lenses2026-11-11

docs(forge): name what review changes reread, when annotations draw, and brand lens ids2026-11-11

Align the macOS Computer Use provider package and entry names2026-11-11

Refresh provider references in the generated event index2026-11-11

♻️ refactor(session): move Session status into api-session-status2026-11-11

🚚 refactor(session): move Session status into client/ui-session-status2026-11-11

🔖 chore(session): align ui-session-status with 0.2.2-rc.22026-11-11

🐛 fix(session): reload useSessionStatus consumers with the status table2026-11-11

📝 chore(client): regenerate the slot catalog after rebasing2026-11-11

fix(subagent): give SubagentError a closed code union and stop reusing codes2026-11-11

fix(infra): read a body of empty statements as an empty catch2026-11-11

feat(infra): reject silent empty catch clauses2026-11-11

docs(error-handling): explain empty catch rules with examples2026-11-11

docs(infra): record the empty catch gate decision2026-11-11

fix(infra): drop --record and treat a new defect on a recorded empty catch as new2026-11-11

feat(infra): point empty catch rejections at the error-handling guidance2026-11-11

fix(infra): read the empty catch rule the way its authors write it2026-11-11

chore(infra): record the clauses master added before this gate2026-11-11

docs(upgrade-guide): move experimental tool error codes guide to v0.2.2-rc.22026-11-11

refactor(cua): keep the screenshot-target projection off the config entry2026-11-11

feat(cua-mcp): serve the API reference through cua_get_api_reference and give programs a workspace2026-11-11

fix(forge-session): 关联 PTC 程序内 shell 调用操作的 PR2026-11-11

fix(workflow): keep the fatal code that ended a failed run2026-11-11

test(cua-mcp): compare resolved working directories2026-11-11

docs(notes): keep manifestVersion unchanged for seam API members2026-11-11

feat(cua-mcp): mount the Windows provider on native Windows2026-11-11

test(ptc-runtime): cover PtcRuntimeError where the Python runtime is skipped2026-11-11

fix(cua): name the failing field when no request form matches2026-11-11

fix(cua): label a top-level request issue as arguments2026-11-11

Clarify macOS CUA migration and provider diagnostics2026-11-11

Quote the entry ID as printed by the CLI2026-11-11

fix(cua-windows): align modifier names and support Win key2026-11-11

test(workflow-ptc): use the output field in the fatal-code fixture2026-11-11

Sync master after the API policy notes merged合并 API 策略说明后同步 master 分支。2026-11-11

fix(stagehand): read non-object arguments as the MCP bridge does修复 Stagehand 非对象参数读取，与 MCP bridge 对齐。2026-11-11

refactor(ptc): remove the experimental Python runtime移除了 PTC 中实验性的 Python 运行时。（20字。仅基于提交信息本身；若需结合 diff 核实细节，可提供改动内容。）2026-11-11

fix(tool-schedule): keep the reason for an invalid delegation depth修复工具调度：委派深度无效时保留原因。2026-11-11

Name helper artifacts and packaging workflows by platform将辅助产物和打包工作流按平台命名。2026-11-11

Keep the existing Desktop packaging workflow names保留现有 Desktop 打包工作流名称不变。2026-11-11

merge: sync master into Python PTC removal将 master 分支同步合并到移除 Python PTC 的分支中。2026-11-11

fix(ci): prune retired Python PTC catch entries修复 CI：清理已退役的 Python PTC catch 条目。2026-11-11

Explain missing macOS helper jobs and verify artifact name selection说明 macOS helper 任务缺失原因，并验证制品名称选择。2026-11-11

Sync master into the CUA helper packaging workflows将 master 分支同步到 CUA helper 打包工作流中。2026-11-11

docs(ptc): clarify remaining extension support and migration更新文档，澄清剩余扩展的支持情况与迁移方式。2026-11-11

test: brand ToolCallId with brandString after merging master合并 master 后，用 brandString 对 ToolCallId 进行品牌化并更新相关测试。2026-11-11

refactor(forge-session): 处理 #8297 评审意见根据#8297评审意见重构forge-session代码。2026-11-11

docs(cua): describe supported modifiers in platform guidance在平台指南文档中补充说明支持的修饰键。2026-11-11

fix(extensions): name the discarded error in the plugin tool code read修复插件工具代码读取中未命名被丢弃错误的问题。2026-11-11

fix(ui-conversation): move to the line boundary on Home and End on macOS修复 macOS 上 Home 和 End 键未移动到行首/行尾的问题。2026-11-11

fix(plugin-market): convert market Remote failures before HarnessError passthrough修复插件市场，在透传 HarnessError 前先转换市场 Remote 错误。2026-11-11

refactor(exports): retire obsolete subpaths with compatible brand APIs (#8215)重构导出，停用废弃子路径并提供兼容的品牌 API。2026-11-11

docs(forge-session): 更新模块图中的 dsh-llm 依赖更新 forge-session 文档模块图中的 dsh-llm 依赖关系。2026-11-11

docs(cua-mcp): document the Codex entry as exercised, with required startup and unattended approval文档补充 Codex 入口实测说明，含必需启动步骤与无人值守审批配置。2026-11-11

refactor(cua-mcp): reset by releasing the program environment through the runtime's owner release重构 CUA-MCP 的重置逻辑，改为通过 runtime 的 owner release 释放程序环境。2026-11-11

test(cua-mcp): stop the looping program of the reset test when the reset does not当重置未生效时，停止重置测试中的循环程序。2026-11-11

test(cua-mcp): release held promises at teardown in the reset unit tests在重置单元测试的清理阶段释放被挂起的 Promise。2026-11-11

fix(ci): cache the verified bubblewrap archive and bound its download修复 CI：缓存已校验的 bubblewrap 归档并限制其下载。2026-11-11

Back off timed-out Files uploads across image requests在多个图片请求中，对超时的文件上传进行退避处理。2026-11-11

Wait for both late upload responses in the backoff regression在退避回归测试中等待两个延迟上传响应都返回。2026-11-11

Count a timed-out upload waiter while shared transport continues在共享传输继续时，将已超时的上传等待者计入统计。2026-11-11

docs(upgrade-guide): move cordis rc.12 guide to v0.2.2-rc.2将 Cordis rc.12 升级指南移至 v0.2.2-rc.2。2026-11-11

fix(ci): scope the verified archive cache to ephemeral runners修复 CI，将已验证归档缓存的作用域限定为临时运行器。2026-11-11

test(inspector): budget the Client Runtime deadline for a real round trip为 inspector 测试的 Client Runtime 截止时间预留真实往返预算。2026-11-11

fix(ci): keep the verified-download spec within the line budget修复CI，让verified-download测试规范符合行数限制。2026-11-11

test(inspector): state the deadline bounds in the timeout case comment为 inspector 超时用例的注释补充 deadline 边界说明。2026-11-11