# 更新日志

本文件记录 `dingtalk-dsh-assistant` 每个正式版本的用户可见变化。版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)，日期使用 `YYYY-MM-DD`。

## [未发布]

- 协调请求增加 `superseded` 持久终态，完成与失效请求均可收口；相同恢复故障按稳定身份聚合计数，已失效的结果快照不再污染当前健康状态。
- 普通任务回复与完成通知复用同一引用和接收人规则；引用真实 Topic 消息时可省略 `atOpenDingTalkIds`，由 Runtime 推导被引用发送人。
- 人工介入批准显式绑定精确 requestedAction；处理意见与动作冲突时要求保持停等并重新澄清，看板按钮同步展示准确语义。

## [0.5.15] - 2026-09-19

### 新增

- 一条群消息可拆分为多个独立事项，分别归入 Topic、创建或续接 Task；一个事项完成即可反馈，不等待同消息的其他事项。
- 任务看板可定时全量同步到配置的钉钉电子表格，并在写入后完整回读校验。

### 修复

- 兼容真实 DSH 附件引用的 `attachmentId`，确保 v7→v8 迁移保留消息附件来源。
- 修复常驻任务的决策、完成报告与通知恢复，避免失效审阅、重复执行和永久失败重试。
- 修复已失效人工介入在任务看板中的状态显示；发布流程支持 npm 部分发布后的安全重试。

## [0.5.14] - 2026-09-10

### 新增

- 为常驻会话增加只读状态短答路径；在任务、职责和 Topic 快照保持一致时，直接复用当前模型生成简短答复，减少完整协调回合的等待。
- 持久化叶子报告的接收、处理和通知状态；重启后可恢复尚未通知的结果，失败报告按原提交身份显式重试。

### 变更

- 常驻与叶子统一使用带版本和来源的当前事实、阶段计划与审批快照；任务输入变化只使受影响阶段失效，历史结果保留为历史事实。
- 审阅与流程正文只从当前 Session 可见的结构化工具结果复用；压缩或内容变化后重新读取，避免重复注入和过期上下文继续生效。
- 发布和数据变更流程增加生产只读基线、依赖全集、隔离演练、停止条件及精确批准范围的前置检查。

### 修复

- 修复叶子等待审批期间重复提交报告、报告处理后通知失败导致重复执行，以及并发唤醒遗漏后续报告的问题。
- 修复协调审阅在重启、重试耗尽和通知恢复时重复调用模型或产生孤立请求的问题。
- 修复活动心跳导致状态短答快照无意义失效，以及工具 Schema 与运行时 Zod 契约漂移的问题。

## [0.5.13] - 2026-09-08

### 新增

- 常驻会话将每轮群消息归入持久 Topic，并按 Topic 独立推进、恢复和关联叶子 Task；任务只保留 Topic 引用，话题页同步展示关联任务与最后活动时间。
- 叶子任务支持从插件配置中按目标组合加载多个任务流程提示词，并在上下文压缩后按已记录的任务索引重新注入；内置通用处理规范与用户补充内容分离，任务流程配置默认折叠展示。

### 变更

- 收敛常驻主会话、Topic 与叶子 Task 的职责边界：主会话负责沟通协调，Topic 负责消息归属和进度，叶子会话按任务目标执行且开放完整工具权限。
- 将 Assistant、Observer、resident profile 与开发依赖树整体迁移到 DSH `0.1.2-rc.1` / Cordis `4.0.2`，Codex Connect 升级到 `0.1.0-alpha.4.30`，并改用 Session 的 `snapshotEvents()`、`ownEvents()` 和原生 fork lineage 元数据，避免混装旧 subagent 后在 Web loader 阶段导入已移除的 `snapshotJsonValue`。

### 修复

- 收紧群聊消息的话题归属判定；当消息只是向他人询问分支、草稿或自行调整等协作事项时，不再误归到当前 Task，同时保留引用链和明确任务指令的关联能力。
- Topic 路由、回复审阅和检查点工具改为先构造参数对象再序列化，并对 `undefined` 等非无损值做结构化投影；版本过期、未知请求和无损 JSON 校验失败时返回可恢复的纠错上下文。
- 修复 Resident 任务状态、按需上下文读取、检查点纠错和 UAT 重构建判定，避免错误完成、跨 Topic 污染、旧构建误判通过以及恢复流程重复消费消息。

## [0.5.12] - 2026-09-07

### 修复

- 群消息只要包含 Task 创建、续接、重开、提议或取消动作就强制要求非空确认；缺失时返回无副作用的 `reply-required` 并保留待处理请求。非取消类动作改为在确认可靠写入 Outbox 后执行，避免叶子已经开始处理但群里没有任何确认。
- Resident 启动恢复失败时不再自动创建替代 Session 或改写群绑定；原 Session 保持不变，Runtime 通过恢复问题进入降级状态，等待显式修复后重启。
- 历史回复审阅候选不再完整注入每条群消息和 Task 通知信封，改由 Resident 仅在准备回复时按请求 ID 读取 Runtime 绑定的 8 条/16 KB 快照；本群 Task 系统索引也改为摘要，完整目标、消息时间线和上下文按 Task ID 读取，避免重复历史持续挤占上下文。Resident 恢复时仍会清理依赖旧内存请求表的待处理协议信封，旧版退出产生的可证明无副作用失败自动迁移到顺序恢复。
- 判断在业务副作用前因重启、无效工具参数、Schema 或暂时上下文故障中断时，改为持久化指数退避自动恢复；同群后续消息在前一条恢复完成前只入 Inbox、不越序 Steer。已开始 Task/Outbox 提交后的异常单独展示为“处理提交失败”，禁止自动重放。
- Agent 活动异常结束但原生 Inbox 仍有群判断请求时，先按群执行一次恢复 Turn；短引用回复按精确引用 ID 识别钉钉补充的前导 @，避免自身代回被再次送入判断。
- 常驻与叶子会话在当前上下文缺失引用正文时，使用同一 DWS profile 按消息 ID 递归恢复完整引用链；内部查询异常不再要求群成员补发原问题或截图。
- 关联复核改为插入当前 Turn 的下一 step，避免后续 Turn 尚未开始就被当前 `whenIdle()` 错误标记为判断未提交。
- 群消息明确撤销误建或不再需要的 Task 时新增 `task-cancel` 动作；Runtime 在 Task 串行队列和叶子 dispose 前先发送原生取消信号，并拒绝取消后的迟到结果。
- 常驻会话回复前强制审阅带真实来源正文的历史 Outbox；同一事项的等价确认保持静默，需要补全时先撤回并读回验证旧确认，再发送一条合并后的最新确认。

## [0.5.11] - 2026-09-02

### 新增

- Task 持久化完整来源消息与参与人历史；后续通知按当前目标、消息上下文和参与人语义选择接收者，不再只依赖最初提出人。

### 变更

- 叶子会话在第一现场自主闭环适用 Skill，移除专用学习信号转发；常驻主会话不再承担重复判断或沉淀。
- 任务卡移除执行轮次耗时区块，诊断数据继续由 `/state/task-timings` 提供。
- 完成验收与检查点评审统一作为主会话内部上下文，并缩短 Task 串行锁持有时间，避免模型评审阻塞其他任务。

### 修复

- 检查点只允许逐项推进，任务仍有剩余项时禁止完成；终结工具结果晚到时可按调用 ID 正确闭合，真实缺失结果仍会报警。
- 群消息 Decision 改为按 DSH step 结构化提交；实时 Steer 打断收口时基于最新上下文重新判断，常驻回复提交前也会再次处理新 Steer。
- 恢复 DWS 入站 bridge 的断线重连、全量回补、慢回补调度和恢复水位，避免长时间运行后漏收消息或重复扫描。
- 修复群消息回复提交与引用消息回读链路；非空引用回复可实时处理人工授权，等待人工介入的任务保持阻塞语义一致。

## [0.5.10] - 2026-08-31

### 变更

- Task 创建统一校验简短标题、明确目标、可核验验收标准、来源消息和提出人；验收门禁保持任务类型无关。
- 任务卡片按当前执行轮次拆分展示总墙钟、排队、运行、等待、可配对工具时间和其他运行时间；历史数据不足时明确标记为估算。
- 群消息取消静默聚合窗口，改为持久化后逐条、零延迟 `steer`：上一条尚未处理完成时，新消息直接插入当前 Turn 的下一 step 共同处理，不排队到下一 Turn。每条输入只携带事实，稳定协议仅保留在 Resident 系统提示词；单次结构化 JSON 通过 `actions` 支持多个 Task。结构化判断按 coordinator 消息 ID 读取对应回合结果，避免把普通插话回复误判为 JSON 后重复判断。
- 常驻群聊主会话不再暴露 Goal 工具及其提示；叶子任务仍使用 DSH Goal 管理执行、阻塞、恢复和完成。

### 修复

- 区分插话前投递失败与已插话后的结构化判断失败；DWS 重复事件不再把同一群消息再次送入 Agent。
- 结构化判断纠错明确使用 `actions` 顶层契约，避免模型重复输出旧的 `kind` 结构。
- 本地 profile 安装强制刷新当前源码的 `file:` 依赖，并隔离根 workspace，避免部署继续使用旧 pnpm 缓存副本。

## [0.5.9] - 2026-08-31

### 修复

- 任务达到最大执行轮数后不再保持假运行状态；恢复耗尽任务时会补充轮数预算，使后续处理能够继续推进。

### 文档

- 更新 README 的数字员工项目介绍与展示图片。

## [0.5.8] - 2026-08-28

### 修复

- 更新提示改为使用 `plugin add` 显式重写 Assistant 与 Observer 的 npm 来源；即使当前本地 tgz 与 npm 版本相同，也不会因“Already up to date”继续绑定临时文件。

## [0.5.7] - 2026-08-28

### 修复

- 设置页复制的升级命令改为同时更新 Assistant 与 Observer 的完整 scoped 包名，并使用 `--latest` 跳过 profile 中固定版本或本地 tgz 的限制。
- README 与安装手册同步使用同一条可执行升级命令，避免文档提示与 Web 设置页不一致。

## [0.5.6] - 2026-08-28

### 修复

- 群聊新消息写入 Inbox 后会立即插话当前主会话；主会话向叶会话补充上下文也使用同一插话通道，避免长步骤期间持续排队。
- 任务依赖的图片或附件缺少可读取引用时会阻止启动任务，并明确反馈缺失信息；同时加强消息与活动任务的语义关联判断。
- 检查点后续更新改写事项文案时，运行看板按剩余数量和顺序计算进度，避免把未完成事项误判为全部完成。

### 变更

- 运行看板统一收发信箱、授权审批和告警列表的字号、表头、无边框状态标签、分页信息与筛选框宽度。
- 任务卡片精简目标、检查点和状态桶布局，移除冗余 ID 操作及装饰容器，并收紧卡片纵向间距。
- 群聊会话区移除重复标题和 Session 信息，单群场景仍显示紧凑的群聊选择器；页内 Tab 与顶部导航统一使用蓝色选中样式。

## [0.5.5] - 2026-08-28

### 变更

- 活动任务收到新的执行线索、补充信息或处理要求时，主会话改为发送一句简短确认；确认不复述对方信息，也不虚构进度、结果或完成时间。

## [0.5.4] - 2026-08-28

### 修复

- 修复 Windows CRLF 源文件导致 Web client 构建后产生空行尾随空格、发布工作流误判 bundle 未提交的问题。
- 修复根发行包仍固定依赖 0.5.0 内部 Runtime/Observer、安装新版本时可能带入旧实现的问题；根包现与两个内部包保持同版本。

### 变更

- 运行看板各页面移除重复的页面标题和子标题，任务状态桶使用剩余视口高度并消除底部补白与页面级纵向滚动。
- 收信箱、发信箱和授权审批统一表头、行高、内边距与交替底色；状态列固定在最左侧，长内容最多显示两行。
- 活动任务卡片中的检查点区域以“任务”面板展示并默认收起，只保留完成数/总数和进度，展开后显示阶段任务、状态和耗时。
- 安装手册补充收敛式上下文压缩插件的独立下载、SHA-256 校验、官方 provider 替换、运行态验证、回滚和历史 Session 修复边界。

## [0.5.3] - 2026-08-27

### 修复

- Resident、叶会话和故障替换 Session 统一使用配置的 Agent 预设，修复自定义预设下叶会话无法启动的问题。
- 切换预设时沿用既有 Resident Session，保留原 Session 的事件上下文。

### 变更

- 运行看板 Header 的高度、内边距和字体规格与 Session 页面保持一致。
- 移除四个任务状态桶的容器阴影；检查点改为默认收起的带边框浅灰面板，完成态使用圆圈对勾图标。

## [0.5.2] - 2026-08-27

### 新增

- 叶会话支持提交结构化任务检查点，运行看板展示检查点进度、执行状态和耗时。
- 群决策支持 `task-proposal`；未明确指名但可能需要处理的事项会先询问是否需要处理。
- 主会话可根据持久化检查点确认或纠偏叶会话，并负责消息撤回决策和回读确认。

### 变更

- Resident Inbox 与主会话向叶会话补充上下文改为及时插话，减少长步骤中的排队等待。
- 运行看板统一群聊、审批、归档和告警页面布局，任务卡片支持展开或折叠检查点。

## [0.5.1] - 2026-08-27

### 修复

- 修复运行看板在侧栏折叠动画期间短暂露出底层 Session 页面的问题。
- 优化授权审批状态标签，并为刷新按钮补充图标提示。

### 变更

- 正式版本发布支持对已存在且指向 `main` 历史的 Tag 进行手工重试。

## [0.5.0] - 2026-08-27

### 新增

- 运行看板嵌入 DSH 右侧内容区，保留左侧 Session 菜单，并提供群聊会话、任务看板、授权审批、归档任务和告警视图。
- 已完成或已归档任务可复用原叶子 Session 开启新的执行轮次，记录每轮目标、验收标准、阶段任务、来源和结果历史。
- 群聊消息分类交由模型结合任务状态判断，支持回答、新任务、任务补充、任务重开与忽略等处置。

### 修复

- 阻塞中的任务只补充上下文，不再错误重开；重开时同步更新当前目标、发送人、来源消息、验收标准和阶段任务。
- 修复恢复数据写入伪来源、完成通知遗漏引用、主会话过度压缩叶子结果和已回复结论被重复发送的问题。
- 修复新增常驻群失败时无反馈、跨源请求报错，以及收起 DSH 侧边栏后运行看板遮挡 Session 标题的问题。

### 变更

- 运行看板按 DSH 官方布局与基础组件重构，统一菜单、表格、筛选、状态标签、抽屉和内容区高度。
- 任务名称、当前目标和来源证据独立存储，名称变更不再改写任务授权范围或来源。

## [0.4.0] - 2026-08-26

### 新增

- 增加单一发行包，可通过 DSH 插件命令一次安装 resident Runtime、设置页和任务看板。
- 设置页展示当前版本，并基于 GitHub Release 检查新版本。
- 增加 CHANGELOG 和插件市场发现所需的仓库元数据。

### 变更

- assistant、observer 与发行包统一使用同一个产品版本号。
- Node.js 最低版本与实际 zstd Runtime 要求一致，调整为 24。

[0.5.15]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.15
[0.5.14]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.14
[0.5.13]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.13
[0.5.12]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.12
[0.5.11]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.11
[0.5.10]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.10
[0.5.9]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.9
[0.5.8]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.8
[0.5.7]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.7
[0.5.6]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.6
[0.5.5]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.5
[0.5.4]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.4
[0.5.3]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.3
[0.5.2]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.2
[0.5.1]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.1
[0.5.0]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.0
[0.4.0]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.4.0