🗣️ 人话解读

📌

0.2.2-rc.3 发布线同步进 master多个 release/dsh-0.2.2 与 rc.3 同步合并进入主分支，说明下一版进入发布前收尾；普通用户先等正式版，生产环境别追 rc。

⚠️ 升级注意（5 条）

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

fix(infra): drop --record and treat a new defect on a recorded empty catch as new
refactor(ptc): remove the experimental Python runtime移除了 PTC 中实验性的 Python 运行时。（20字。仅基于提交信息本身；若需结合 diff 核实细节，可提供改动内容。）
Remove keyboard limit from MouseMove移除了 MouseMove 中的键盘限制。
feat(cua)!: give Agents without a preset the cua_run_code tool让未配置预设的 Agent 也能使用 cua_run_code 工具。
refactor(ptc)!: remove all Python PTC support移除项目中所有 Python PTC 支持，属破坏性变更。

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

fix(cua): isolate invalid AX branches during observation修复观察过程中未隔离无效 AX 分支的问题。2026-11-12

ci(cua-macos): run AX recovery regressions and the AppKit fixture on pull requests在 PR 上运行 AX 恢复回归测试和 AppKit fixture 的 CI。2026-11-12

refactor(cua): name the shared tree flag hasUnreadableElements重构 CUA，将共享树标志重命名为 hasUnreadableElements。2026-11-12

docs(cua): put pointer-free actions first in the mouse instructions文档：在鼠标操作说明中优先列出无需指针的操作。2026-11-12

docs(cua): separate mouse permission and targeting paragraphs将鼠标权限与目标定位段落拆分，仅调整文档结构。2026-11-12

ci: remove the dedicated macOS CUA native test workflow移除了 CI 中专用的 macOS CUA 原生测试工作流。2026-11-12

fix(cua): preserve failed AX scope discovery修复 CUA 中 AX 作用域发现失败时结果未保留的问题。2026-11-12

docs(upgrade-guide): record consolidated shell and read_image error codes在升级指南中记录合并后的 shell 和 read_image 错误码。2026-11-12

fix(cua-macos): keep drag guidance in the macOS provider and preserve hover safeguards修复 macOS provider 的拖拽引导保留问题，并维持悬停防护。2026-11-12

test(cua): declare macOS pointer support in the retained script prompt fixture在保留的脚本提示测试夹具中声明支持 macOS 指针。2026-11-12

fix(cua): keep Windows drag validation on the portable interface修复 CUA 在便携接口上未保留 Windows 拖拽校验的问题。2026-11-12

fix(bash,pwsh,fs,ptc): reject unadvertised arguments before pairing and approval修复 bash、pwsh、fs、ptc 在配对与审批前拒绝未声明参数。2026-11-12

feat(cua)!: give Agents without a preset the cua_run_code tool让未配置预设的 Agent 也能使用 cua_run_code 工具。2026-11-12

fix(cua): preserve drag release settling and verify pointer state and deltas修复拖动释放后的稳定处理，并校验指针状态与位移增量。2026-11-12

fix(desktop): supply error peer and inline it in command worker桌面端修复：在命令 worker 中提供并内联错误 peer。2026-11-12

fix(cua-macos): keep native drag events on their owning actor修复 macOS 上原生拖拽事件归属错误，使其保留在所属 actor 上。2026-11-12

fix(cua): align unreadable node markers with child gaps修复CUA中不可读节点标记与子节点间隙的对齐问题。2026-11-12

Reject modifier key in sendKeyEvent在 sendKeyEvent 中拒绝修饰键。2026-11-12

fix(cua-windows): allow input with held modifiers修复 cua-windows 在按住修饰键时无法输入的问题。2026-11-12

docs(feedback): describe reading feedback from exported session logs更新反馈文档，说明如何从导出的会话日志中读取反馈。2026-11-12

fix(cua): unify AX observation failure codes统一了 CUA 中 AX 观察失败的错误码，属于修复类改动。（注：仅依据提交信息，未查看具体 diff。）2026-11-12

test(desktop): reuse runtime closure validation for packaged peers桌面端测试复用运行时闭包校验，以验证打包后的对等依赖。2026-11-12

Fix system prompt test修复了系统提示词相关的测试。2026-11-12

docs(feedback): keep only feedback-specific rules for exported logs文档更新：导出的日志中仅保留反馈专用规则。2026-11-12

fix(forge): retain expanded diff lines across review metadata refreshes修复评审元数据刷新后已展开差异行丢失的问题。2026-11-12

test(forge): discard pending context for changed PR revisions测试(forge)：当 PR 修订变更时丢弃待处理上下文。2026-11-12

test(forge): resolve the deferred file read in the revision cases在 forge 的 revision 测试用例中解决延迟文件读取问题。2026-11-12

fix(compaction): summarize on the model that last answered修复压缩逻辑：改用最后回答的模型来生成总结。2026-11-12

fix(desktop): read Actions EdgeOne zone from publisher config修复桌面端从发布者配置读取 Actions EdgeOne zone 的问题。2026-11-12

feat(desktop): split macOS installer artifacts for independent downloads将 macOS 安装包拆分为可独立下载的多个构件。2026-11-12

test(desktop): parse publication settings through config reader新增桌面端测试，验证通过配置读取器解析发布设置。2026-11-12

fix(desktop): isolate split artifact uploads and address review修复桌面端，隔离拆分产物上传并处理评审意见。2026-11-12

fix(cua): read the preset registry when the provider starts修复 CUA：在 provider 启动时读取预设注册表。2026-11-12

fix(desktop): approve website upload and refresh together修复桌面端批准网站上传与刷新未同时执行的问题。2026-11-12

fix(cua-macos): use AX child recovery when resolving input targets修复 macOS 输入目标解析，改用 AX 子元素恢复机制。2026-11-12

test(cua-macos): exercise recovered input targets and undispatched failures新增 cua-macos 测试，覆盖恢复的输入目标与未派发失败。2026-11-12

refactor(ptc)!: remove all Python PTC support移除项目中所有 Python PTC 支持，属破坏性变更。2026-11-12

fix(cua): isolate invalid AX roots during scope discovery修复作用域发现中未隔离无效AX根节点的问题。2026-11-12

fix(cua-macos): preserve optional geometry and reuse the selected click window修复 macOS CUA，保留可选几何信息并复用已选点击窗口。2026-11-12

fix(cua-macos): keep the geometry lookup in synchronous AX access修复 macOS 端几何查询问题，确保其仍在同步 AX 访问中执行。2026-11-12

test(cua-macos): verify Paste dispatch against partial AppKit menus新增测试验证 Paste 在部分 AppKit 菜单下的分发。2026-11-12

test(cua-macos): exercise unreadable menus through the owning AppKit process为 cua-macos 增加测试：通过所属 AppKit 进程覆盖不可读菜单场景。2026-11-12

test(cua-macos): dispatch the unique command recovered from AppKit menu rangescua-macos 测试分发从 AppKit 菜单范围恢复出的唯一命令。2026-11-12

refactor(cua): keep AX root recovery local to observation将 AX 根节点恢复逻辑收敛到观察环节内本地处理。2026-11-12

refactor(compaction): record the answered route in a private projection重构合并逻辑，将已应答的路由记录到私有投影中。2026-11-12

fix(ptc): reject unsupported providers without native fallback修复 PTC：拒绝无原生回退的不支持提供商。2026-11-12

fix(desktop): align rollout approval with parsed percentage修复桌面端，使发布审批与解析后的百分比保持一致。2026-11-12

docs: regenerate the module graph for the compaction-basic projection dependency为 compaction-basic 投影依赖重新生成模块图。2026-11-12

fix(ptc): reject reserved scoped REPL binding names修复 ptc：拒绝保留的作用域 REPL 绑定名称。2026-11-12

refactor(ptc): reuse the existing scoped REPL prefix export重构 ptc，复用已有的 scoped REPL 前缀导出。2026-11-12

docs(compaction): address review comments on summary-route wording and the snapshot fixture根据评审意见修改压缩摘要路由措辞并更新快照测试夹具。2026-11-12

docs(desktop): clarify cache recovery requirements更新桌面端文档，明确缓存恢复需求。2026-11-12

feat(ptc): define scoped REPL top-level scopes and import base in guidance (#8275)为 REPL 定义带作用域的顶层作用域，并在 guidance 中导入 base。2026-11-12

Sync partial AX observation recovery with its stack base同步部分 AX 观测恢复与其栈基址。2026-11-12

Sync AX execution recovery with its stack base同步 AX 执行恢复逻辑，使其与栈基址保持一致。2026-11-12

fix(cua): read the optional preset registry from the service store修复 cua：将可选 preset registry 的读取来源改为 service store。2026-11-12

docs(cua): relate creation failures to the host-plane note更新 CUA 文档，将创建失败关联到 host-plane 说明。2026-11-12

test(cua): record cua_run_code under the PTC executor without presets新增测试：在无预设的PTC执行器下记录cua_run_code。2026-11-12

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

fix(session): load the migration worker in single-file runtimes (#8376)修复单文件运行时会话迁移 worker 的加载问题。2026-11-12

refactor(connection): add connection auth provider for remote connection (#8266)重构连接模块，为远程连接新增认证提供者。2026-11-12

Reset Files backoff in completion order and count the first uncached image按完成顺序重置文件退避，并统计首个未缓存镜像。2026-11-13

Preserve normalized upload-index failures on cache reads缓存读取时保留上传索引规范化的失败状态。2026-11-13

Hold cancelled transport open across the next lookup in the recovery test在恢复测试中，让已取消的传输在下次查找期间保持打开。2026-11-13

fix(client): key stylesheets by the real package path修复客户端样式表，改为按真实包路径作为键进行索引。2026-11-13

feat(timeline): integrate Timeline as an experimental plugin (#7973)将 Timeline 集成为实验性插件。2026-11-13

fix(client): judge stylesheet containment with pathBelow改用 pathBelow 判断样式表包含关系，修复客户端样式表判定问题。2026-11-13

docs(client): require multilingual fuzzy matching in user-facing search更新客户端文档，要求用户可见搜索支持多语言模糊匹配。2026-11-13

refactor(client): converge search lists on shared multilingual fuzzy filter重构客户端搜索列表，统一改用共享的多语言模糊过滤器。2026-11-13

feat(experimental): 导入 DeepSeek 官网对话导出为会话 (#8342)新增实验性功能，支持把 DeepSeek 官网导出的对话导入为会话。2026-11-13

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

feat(home-paths): add dshPath category helper and home path proposal新增 dshPath 分类辅助函数及 home 路径提案。2026-11-13

fix(experimental): mint imported chat ids with brandString修复实验功能：导入聊天 ID 时改用 brandString 生成。2026-11-13

chore(client): regenerate the cordis client slot catalog重新生成 Cordis 客户端插槽目录。2026-11-13

ci: fetch the pre-merge history by depth instead of by dateCI 改为按深度而非日期拉取合并前历史。2026-11-13

fix(ui-primitives): keep the clipboard try to one statement将剪贴板相关的 try 块限制为单条语句。2026-11-13

fix(ci): stabilize browser interactions and narrow clipboard try修复CI，稳定浏览器交互并收窄剪贴板尝试范围。2026-11-13

docs(module-graph): regenerate after the chat import brand change重新生成模块图文档，以反映聊天导入品牌变更。2026-11-13

feat(web): mark the inherited-history divider with the fork glyphWeb端用分叉图标标记继承历史分隔线。2026-11-13

docs(web): state the divider glyph contract without rationale prose更新 Web 文档，明确分隔符字形约定，并去除理由性说明。2026-11-13