v0.0.23 — 列表交互、任务恢复与官方 DSH 兼容

A²D² DSH Plugin v0.0.23，从整合后的 main 发布，包名保持 @a2d2/dsh-a2d2。本版接续 v0.0.22，集中交付这段时间已经合入主干的功能与修复。

主要变化

• 列表更好查、更好用：Project、Issue、PR 提供逐列菜单和搜索，支持排序、真实值过滤、适用列分组／切片、隐藏恢复和列移动。首批最多 100 行，滚动继续追加；加载失败保留已有内容并可重试。搜索／过滤后仍保留 Project 父子层级、折叠和子项会话入口。
• 原任务可以继续恢复：已受管会话切换 provider、模型或推理强度后，恢复保留当前选择与原执行身份；接续详情不再被轮询反复取消。失败、等待、暂停时显示原执行重试／恢复入口，完成任务解释不能继续接续的原因。
• Issue 详情立即打开：点击后先显示所选 Issue 与加载状态，再异步读取原文和已有进展；支持失败重试，旧响应不会覆盖新详情。修复 GitHub 无筛选 Project 视图返回 null 导致刷新失败。
• 工作状态读取与保存改进：共享 DAO 避免反复解析大历史，历史／命令回执／来源大字段按需读取；修复文件元数据碰撞时误用旧缓存、覆盖外部更新的问题，保留完整历史和幂等结果。
• 官方 DSH API 适配：支持公开的会话本地模型选择、固定身份恢复和 UUID jobs 观察／持久交付回执，保留已验证的旧宿主路径；新增可重复使用的升级检查工具。
• 接续与会话修复：停止重放误存的旧 Goal 输入；修复接续材料准备与投递；会话名称保留任务编号和接续序列，失败后仍可进入当前会话；PR 会话入口正确区分跨仓库同编号 Issue。

完整条目、关联 Issue／PR 和限制见 CHANGELOG。既有 v0.0.22 标签与附件保持不变。

安装与升级

1. 先备份完整工作目录，包括控制 JSON、来源 sidecar 和 archive；切换时停止旧写者。

2. 下载附件 a2d2-dsh-a2d2-0.0.23.tgz，不要解压，也不要使用 GitHub 自动生成的 Source code 压缩包。

3. 在实际使用的 DSH profile 插件管理器输入下载文件的绝对路径，也可使用应用提供的 CLI，例如桌面 profile：

   dsh plugin --profile desktop add /absolute/path/a2d2-dsh-a2d2-0.0.23.tgz

4. 完整退出并重新打开 DSH。发布本身不会切换当前运行实例。

旧数据在来源初始化或首次写入时迁移为带 storage.version: 1 的归档格式。旧插件不能直接读取新格式；降级需停止所有写者，使用完整备份或新版本的离线全量导出，不能只恢复控制 JSON、删除 storage 标记或清理 archive。详见迁移与离线降级。

安装包已包含构建后的服务端、浏览器 bundle、类型声明和配置，无需自行编译。不要同时启用旧无 scope 包 dsh-a2d2 与本包的两套实例。本版通过 GitHub Release 分发。

验证与兼容范围

• 插件最低 Node.js 22。已有官方集成证据使用未经修改的源码构建 22ddee3792402c3e70ec5f86a63c3e3e895a2f60，CLI 0.2.1-rc.3，该宿主要求 Node 24.9 起。同版 npm 宿主包缺少所需公开模型 API，不能仅按版本号判断可用。
• 列表、层级、恢复、详情等修复的既有 GUI 验收与官方 Session/model、jobs 集成分别记录。本次发布未将这些记录扩展为所有桌面发行版的端到端安装承诺。
• 官方 jobs 的空输出、消费后失败／取消及缺回执的 inline/PTC 结果继续保守待处理；空重复读取不能证明交付。
• 最终提交的 Node 22／24 CI、凭据扫描、打包校验与附件来源记录在下方发布证据中。

发布证据

• 源码：e34993f96ea07e0a0153b7ec8ce68dde422847a5，发布准备 PR #261 已合并。v0.0.23 标签与包／插件版本一致，源码可由 main 到达。
• 主干 CI、标签 CI 全部通过，包含 Node 22／24 检查、标签来源校验和历史凭据扫描。
• 发布候选构建 通过：118 个测试文件、1343 项测试通过；Node 测试 28 通过、2 项按合同跳过、0 失败；类型检查与干净源码打包验证通过。
• 直接验证本次附件：191 个包内条目、32 个导出目标完整，CHANGELOG.md、双语说明、许可证及插件 sidecar 齐全；在空项目安装该实际 tarball 并导入 15 个服务端入口通过，源码提交与校验和一致。
• 安装包 SHA-256：fe05245fdae9c10f917c75106ddbf9c78fb993e2bd3417d6cf8eb83af82c7a1e。附件 SHA256SUMS 同时覆盖 tarball 和 SOURCE_COMMIT。

v0.0.22 — 修复会话消息被吞

A²D² DSH 插件修复版，基于当前已经部署并验证的工作面板版本构建。版本号接续内部 0.0.21，本版保留包名 @a2d2/dsh-a2d2。

本次修复

• 修复任务等待、暂停、完成或交接后，人工消息被静默拦截、界面只出现空白 Completed 的问题。
• 等待、暂停及完成工具返回后，当前轮次可以正常给用户交代结果。
• 旧会话提示任务已转到哪个会话，并提供“进入当前处理会话”入口，同时保留对话和输入能力。
• 旧版暂存的未消费人工消息在原会话下一次人工输入时恢复，保留原 ID、内容和附件，并排除重复消息。
• Task 协调记录按具体操作校验当前负责者；普通对话和宿主工具不再被 Task 状态统一禁用。聊天不会自动重开已完成任务或恢复自动调度。

本包也保留已部署的接续材料重试、不可达旧作业提醒、紧凑模型工具回包及显式分页读取修复。

安装与升级

1. 下载附件 a2d2-dsh-a2d2-0.0.22.tgz，不要解压，不要选择 GitHub 自动生成的 Source code。

2. 在 DSH 桌面端插件管理器输入下载文件的绝对路径。也可使用对应应用提供的 CLI：

   dsh plugin --profile desktop add /absolute/path/a2d2-dsh-a2d2-0.0.22.tgz

3. 完整退出并重新打开 DSH。仅刷新网页不足以清除旧会话实例中残留的拦截器。

GitHub 上的旧版 v0.0.1 使用包名 dsh-a2d2；本版沿用当前已部署的 @a2d2/dsh-a2d2。请避免同时启用两个不同包名的 A²D² 实例。包内已经包含编译模块、共享分块、浏览器 bundle、类型声明、插件配置与许可证，无需自行编译。

验证与兼容范围

• 发布源码业务代码与线上修复提交 92a81be 一致；另接入打包前构建、导出完整性检查，并修正客户端类型声明入口。
• TypeScript 检查通过；8 个相关测试文件共 79 项测试全部通过。
• 从不含 lib/ 的干净源码导出构建并打包，检查全部 30 个导出目标及插件配置；空项目安装并加载 14 个服务端入口通过。
• 当前 DSH 实例的两个真实故障会话已恢复实际回复；旧会话交接提示和进入当前处理会话按钮已验证。

Node.js 22 或以上。本预发布在当前匹配的 DSH 0.2.1-rc.2 开发宿主验证；没有宣称所有官方桌面版本均已完成兼容验收。模型、GitHub 认证及可选通知服务仍由使用者配置。

此版通过 GitHub Release 分发。附件 SHA256SUMS 可校验安装包。

v0.0.1

A²D² DSH 插件首个预发布版本，提供已编译的安装包。

桌面端安装

1. 下载本页附件 dsh-a2d2-0.0.1.tgz。不要下载下方自动生成的 Source code，也不要解压安装包。
2. 打开官方桌面端的插件管理器，在安装入口输入下载文件的绝对路径，例如 /Users/你的用户名/Downloads/dsh-a2d2-0.0.1.tgz。
3. 安装后按界面提示重启或重新加载，进入 设置 → A2D2 配置，选择宿主中已配置、可用的模型。

包内已包含服务端模块、浏览器 bundle、类型声明和插件配置。用户不需要自行编译插件，也不需要为这个包添加 Git prepare 的 allowBuilds 授权。

可选命令行安装：先通过桌面应用菜单 Manage dsh Command… → Install 注册桌面端提供的 dsh 命令，完全退出桌面应用，再执行：

dsh plugin --profile desktop add /absolute/path/dsh-a2d2-0.0.1.tgz

完成后重新打开应用。单独通过 npm 安装的 dsh 不能管理桌面端 profile。

包含的功能

• 任务与会话聚合、会话交接、上下文与费用指示球。
• A²D² 配置页、阶段 Agent 与模型候选配置。
• 子代理派发、GitHub PR 关注及可选通知集成。

这些是包内提供的功能，实际可用性取决于宿主能力与用户配置。

已知限制

这是预发布版本，尚未完成官方桌面端的全部功能验收。会话 Agent 初始化要求宿主公开提供 sessionController.selectLocalModel；官方 0.2.1-rc.2 的公开接口未定义该方法，相关会话创建与交接路径不能宣称已兼容。安装成功不代表上述功能全部可用。

模型账号、gh 认证、可选工作流技能和通知服务需按需自行配置。此版本通过 GitHub Release 分发，未发布至 npm registry。

验证

• 本地 TypeScript 检查及 621 项测试通过；GitHub CI 的 Node 24 检查通过。
• GitHub CI 的 Node 22 检查有两项 github_watch 测试等待超时；本地单独复跑这组 21 项测试通过。此预发布不代表全部 CI 检查已通过，详情见 PR #208。
• Git 安装复现了缺少构建授权的错误；精确授权后安装成功。
• 预编译包的导出文件、插件配置及服务端模块导入检查通过。

附件 SHA256SUMS 可用于校验下载文件。安装问题与说明见 #205 和 中文安装文档。