# 版本变更记录

记录面向使用者的功能、行为、修复和文档变化，最新内容在前。历史条目根据现存版本标签、提交与验收记录补录；日期取标签目标提交的日期（Asia/Shanghai），不是补打标签的日期。完整验证范围见[开发与验收记录](doc/project/开发进度.md)，版本与提交对应关系见[发布指南](doc/deployment/版本发布与Git标签.md)。

## 未发布

暂无。

## [0.12.3](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.12.3) — 2026-10-15

- 补齐公开 SDK 运行时导入所需的开发 peer 依赖和锁文件，修复干净安装时缺少 `dsh-scope` 等包导致 7 个单元测试套件无法加载的问题。
- CI 在重建后直接导入 `dist/index.js`，同时验证 SDK 依赖可解析及构建入口可加载。
- 取消等待的集成测试改用受控时钟，在宽限期结束前验证仍等待在途工具、结算后才开始清理，消除繁忙环境下的调度竞态；生产超时设置保持原值。

Linux x86_64 的冻结安装、构建一致性、类型、300 项单元和 63 项集成回归及解包检查通过，详见 [CI 公开依赖安装验收](doc/project/CI公开依赖安装验收.md)。

## [0.12.2](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.12.2) — 2026-10-15

- 适配 DSH 0.2.1-alpha.3，升级公开 SDK、Cordis、Cosmokit、Schemastery 开发依赖与锁文件，沿用宿主原生模型、工具、审批和客户端扩展点。
- 修复新宿主关闭计划审核正常返回 `approved: false` 后仍催促模型继续审核的问题；保留草案并等待用户反馈，重新提交并明确批准后才执行。补充关闭审核、要求修改及重新批准的回归。
- 将版本文档同步核对纳入项目约定及发布步骤，统一当前中英文指南、安装标签、宿主要求和运行记录版本；保留历史验收、截图与依赖兼容版本。

验证与交付范围见[宿主升级适配验收](doc/project/DSH宿主升级适配验收.md)。

## [0.12.1](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.12.1) — 2026-10-14

- 适配 RunBridge 持久请求查询：按原 grant、节点和请求核对身份，恢复已分配后失败及创建在途的会话；仅在同请求明确失败、未分配且 NOT_STARTED 时确认资源不存在，未知、无记录和矛盾响应继续保留隔离。
- 普通测试收尾与设置页恢复复用清理证据判定，保存未分配请求的处置证据，不改写初始化失败及旧业务结果；兼容旧 Hub 的唯一会话查询，并识别分配前的请求容量拒绝。
- 补充 4 MiB 单文件、多文件的宿主编码与超限拒绝回归；HTTP 传输限额修复由 Hub 提供。
- 更新当前指南为 Hub 0.5.1 / Node 0.5.0，说明主页面采集、传回后限额与 CDP 初始化失败需重新选页的边界；保留 0.12.0 实机验收原貌。

验证与交付边界见[请求恢复兼容验收](doc/project/RunBridge请求恢复兼容验收.md)。

## [0.12.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.12.0) — 2026-10-14

- 增加 RunBridge 远程浏览器后端，按每次测试冻结节点、许可和会话，复用公开 DSH 原生工具投影、审批、取消、实际步骤及可信断言；配置保存后下次测试生效。
- Hub/Node 0.5.0 补齐正常浏览器测试所需的 26 个 MCP 工具，并从 Hub 已持有的同一 Page 提供持续 PNG；插件在现有浮窗显示，切页、过期、断开和隔离撤下旧图。
- 增加原请求启动核对、原许可恢复和终态 COMPLETE 清理确认；响应未知不盲目重放。补齐 JSON 字符串参数转交，避免嵌套数组在原生管线中失真；截图证据使用规范 MCP 原图。
- 增加远程配置、架构、历史提案与实机验收记录；明确虚拟机网页与宿主接口的网络位置。远程录像和完整 Playwright SDK 方法不在本次范围。

- 增加单条用例执行交互架构，按当前代码梳理插件、DSH、MCP 与 LLM 的职责、模型和工具循环、计划审核、可信采集、确定性断言、停止清理与报告流转；补充总览图、时序图、源码核对入口并更新架构页版本基线。
- 增加 GitLab 测试要求与本地调试指南、无需账号的 TXT 入门用例和分页 CSV/Markdown 模板；说明被测系统条件、普通专用账号的项目权限、DSH/MCP、私有数据准备、完整功能体验、报告及本轮数据清理。GitLab 部署和服务运维引导官方文档，不维护部署教程或 Compose 模板；职责边界同步记录到 AGENTS.md。
- README、中英文使用说明及预览、录像、进度和实际步骤说明统一使用 GitLab 示例；替换真实截图，区分五条用户 Markdown 场景、完整开发回归与既有验收边界。
- 重整中英文 README 的项目首页结构，突出整体用途、功能亮点、真实效果、快速开始和文档入口；移除按版本介绍功能的段落，将详细安装、卸载与排错操作交由对应指南，并在 AGENTS.md 记录首页维护原则。
- 增加 CSV 参数文件使用手册，提供无需账号的 GitLab 完整示例，说明模板替换、引号与空值、全部数据展开、工作区路径、原生审核、报告和常见错误；同步中英文首页、使用说明、文档导航及 GitLab 测试指南入口。

验证、保留失败与支持边界见[远程接入验收](doc/project/RunBridge远程浏览器接入验收.md)。

## [0.11.2](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.11.2) — 2026-10-06

- 用户文件入口以 TXT、Markdown 及 CSV 参数化介绍；内部调试格式和执行约束迁入中英文开发文档，原有开发回归能力保留。
- GitLab 增加用户 Markdown 模板和私有数据绑定：两条 UI、三条接口，覆盖组合筛选、草稿预览取消、检索、分页与缺失项目；生成器默认只打印 .md 命令，完整开发回归资料另存。
- 生成文档复用固定种子、配置归属校验、私有路径与 600 权限；支持完整批次和单例，通过既有文字规划与运行入口执行。同步使用、开发、架构及长期项目约定。
- 修复文字运行中完整 HTTP 响应被直接拿来比较状态码的问题：完整响应声明为对象，错误字段绑定在冻结前拒绝；数组引用提示使用点分隔数字路径。真实正文异常仍保留业务 FAIL，既有预期和历史失败不改写。
- 普通规划轮次只有文字、未提交计划时，插件提醒一次并保留超时预算；再次不提交明确结束为未执行错误。必要信息追问和原生计划审核继续等待用户，补充后恢复普通规划计时，避免进度长期停在 0/0。

验证与真实失败边界见[Markdown 用户入口验收](doc/project/Markdown用户入口验收.md)。

## [0.11.1](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.11.1) — 2026-10-06

- 手工 Markdown 改为供后续执行的模板，只含用例名称、用户原始用例、前置用例、实际步骤和收尾；步骤只列序号、操作及预期，不混入本轮状态、实际结果、证据、耗时或技术来源。
- 手工用例保留真实输入和地址，直接写进操作句子；通过独立的 600 权限原始资料支持只读重建，运行审计继续脱敏。手工正文独立下载，不内嵌到报告 HTML，准确文件使用只读票据。
- 自然语言保留初始原文，文件/CSV 使用原始条目或模板；JSON 没有独立原始描述时留空。没有独立预期时留空，不补造；失败尝试、未知及未派发操作不作为下一次动作，已有业务检查保留冻结预期。
- 移除手工 Markdown 的 HTML 实体编码，用户名下划线、输入及地址保持可读。同步中英文指南、架构、原始资料/旧记录边界及项目长期规则。

验证与使用示例见[手工用例调整验收](doc/project/手工用例调整验收.md)。

## [0.11.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.11.0) — 2026-10-06

### 新增

- 随运行逐条保存实际操作说明、真实输入和关联调用，按用例/数据实例连续编号；报告新增“实际步骤”，可下载 JSON 记录与 Markdown 手工用例。准备和业务收尾独立展示，自动浏览器复位不占业务编号；失败、重试、未派发和未知结果保留，说明完整性独立于业务结果。
- 浏览器业务交互通过当前 Agent 的原生工具转交，复用原生审批、取消和多模态结果；工具 Schema 提供完整 MCP 名称。API 每次真实 GET 保存一次说明，字段检查不会重复计作请求，接口实例无浏览器媒体。
- 增加 GitLab 复杂回归样例：4 条 UI、13 条 GET JSON 接口场景，覆盖编辑、评论、状态流转、筛选、草稿预览取消、创建、分页及 401/404。配置读取、专用数据准备、冻结集合生成和归属清理均有脚本与指南；实际账号和展开用例只保存于忽略的 .local/gitlab/。

### 修复与可靠性

- 修复 /test-run、/test-plan --file 和 /test-data 的路径判断，按发起对话工作区读取目录内相对及绝对路径；无 cwd 的历史会话回退配置 workspace，保留符号链接和越界限制，缺失文件提示实际查找位置。
- 浏览器初始化和纯释放阶段统一限制工具准入，拒绝收尾中继续点击、输入、快照、脚本或封装业务操作；正常失败和停止收尾复用约束，明确释放失败立即隔离并停止后续业务。
- 收紧正文/文本非空检查的预期绑定，防止以字符串 0 或可见性替代原检查；冻结预期和程序断言继续暴露失败。GitLab 样例补充业务标题及渲染预览的精确定位说明，不修改原预期或事后覆盖 FAIL。

### 账本与报告

- 新事件格式为 2，计划和 SuiteRun 保持格式 1；账本改为简短快照提交引用，保留两份已提交检查点和最新状态。新旧格式逐行、可取消重建，继续核验哈希、序号、修订和未结算调用；只读重建不覆盖原报告或重执业务。
- 调用和下载数据去重、详情按需展开；移除 HTML 中重复内嵌的压缩账本，改用独立 events.jsonl 流式下载及文件专用只读票据。离线日志和 MP4 回看需保留完整运行目录；单 HTML 仍能展示结论、步骤、断言及内嵌截图。
- 同一旧运行的报告从 323.79 MB 降至 14.75 MB，减少 95.45%；同样事件的账本从 1.54 GB 降至 8.7 MB，减少 99.43%，重建状态一致。测量条件、完整状态文件大小及真实批次失败边界见[优化验收](doc/project/收尾约束与账本报告优化验收.md)，不代表所有环境的统一性能保证。

### 文档与交付

- 同步中英文 README、安装与使用说明、离线保存及故障速查；补充实际步骤、GitLab 样例、工作区路径和优化验收文档。
- 根目录 AGENTS.md 明确重要版本必须更新版本号和创建附注标签，并持续记录用户确认的长期项目决定。提交与标签默认仅保存在本地，审核后由用户推送。

完整验证与发布范围见[0.11.0 版本发布验收](doc/project/0.11.0版本发布验收.md)。

## [0.10.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.10.0) — 2026-10-05

- 新增独立的浏览器录像开关，默认关闭；使用本机 `browscreen[video]`，支持稳定版本 `>=0.3.0,<0.4.0`。实际浏览器/CDP 就绪后后台启动，预览与录像共用采集进程，不依赖浮窗或页面轮询。
- 录像按运行及实例归档为 MP4，记录完整/部分/失败状态、时长和 SHA-256；正常报告等待收尾，超时或紧急封存后不将迟到视频标作完整。
- 报告新增条件“操作录像”选项卡、播放、拖动和下载，支持在线 Range 及完整目录离线回看；接口实例不显示界面媒体区域。
- 缺少命令、版本不兼容或视频依赖不可用时按需提供安装提示；识别到录像准备失败时仅允许一次预览回退。补充录像使用与排错指南。

- 精简斜杠命令，仅保留 `/test`、`/test-plan`、`/test-run`、`/test-data`；状态查看使用进度区，停止使用 DSH 原生按钮。报告重建迁至进度区和设置页，环境恢复及实际处置证据提交统一放在设置页，保留原生工具审批、隔离互斥与当前记录校验。
- 修正进度面板折叠箭头：展开时向下，收起时向上。
- 实时画面按钮切换显示与隐藏，按会话复用并去重浮窗；用户隐藏后轮询不反复弹出，结束或采集终止时自动关闭。
- 同步中英文入门、使用说明、进度预览指南和故障处理文档。

## [0.9.2](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.9.2) — 2026-10-05

- 为中英文 README 和使用说明补充真实使用截图，展示计划审核、步骤进度与耗时、完整步骤列表、浏览器实时画面、预览设置及报告中的实际值和预期；同步进度与预览指南的图示。
- 首页介绍侧重功能与能力，移除面板颜色描述；实时画面截图改为完整 DSH 页面，展示浮窗与对话、步骤列表的位置关系。
- 项目协作约定改为默认仅创建本地提交与版本标签，交由用户审核后手动推送。

本版更新图文说明和版本信息，测试执行、预览配置及卸载行为沿用 0.9.1。截图保留实际拍摄版本 0.9.1。

## [0.9.1](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.9.1) — 2026-10-05

- 修复 GitHub 仓库安装成功却无法启用：Git 版本直接包含 `dist`，安装无需执行构建脚本、宿主源码链接或本机调试文件。
- 补齐公开 npm 的 DSH SDK 开发依赖及锁文件；增加发行入口检查和 CI 干净重建比较，避免缺少入口或发布陈旧产物。
- 自动预览只接入选中 MCP 的运行配置，保留原始 profile；停用、卸载、切换或关闭后恢复最新浏览器参数，整体退出不重新启动 MCP。
- CDP 初始化文件复制到运行目录，避免删除包时影响正在退出的 MCP。
- 增加卸载和运行配置生命周期回归，更新 GitHub 安装、开发、停用和卸载说明；保留旧版预览残留的速查恢复步骤。

## [0.9.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.9.0) — 2026-10-05

- 浏览器预览直接调用已安装的本机 `browscreen`，删除源码项目目录、项目环境检查、uv 启动及外部服务隐式复用；不保留旧接法兼容或迁移。
- 设置页新增“检测安装”和高级命令路径，展示实际命令位置、版本及错误引导；默认使用宿主 PATH，支持稳定版本 `>=0.2.1,<0.3.0`，Python 要求 ≥3.14。
- 版本查询限 5 秒，仅当前有效 CDP 后启动采集；启动至首帧共用 60 秒预算，版本、端口、进程或采集失败不随轮询反复启动。
- 保留 CDP、运行归属和有效首帧校验；预览失败仅在设置或当前浏览器测试按需提示，终止失败撤销浮窗，业务断言和环境隔离规则保持原义。
- 同步命令安装、逐步配置、故障速查、中英文说明及开发验证脚本。

- 补齐 `v0.1.0` 至 `v0.8.3` 的10个历史附注标签，明确后续版本发布与标签核对规则。
- 按 GitHub 项目首页结构重写中英文 README，集中展示功能、快速开始、命令、支持范围及文档入口。
- 整理公开文档中的个人电脑路径、说明截图及失效的本机验收链接；原始资料保留本地，增加凭据文件、安装包和本机视觉记录的忽略规则。
- 新增本文件，并纳入安装包；发布流程要求同步维护版本更新说明。

多对话独立浏览器并行执行仍为后续优化，当前保持串行及共享浏览器限制。

## [0.8.3](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.8.3) — 2026-10-04

- 将底部步骤区改为天蓝色当前步骤面板，突出运行阶段、任务名称、结算数量、总耗时和本步用时。
- 完整步骤按需展开，在限定高度内滚动并定位当前步骤；支持多实例连续编号、检查点和原因查看。
- 优化长标题、长操作文字、窄窗口、窗口缩放及键盘折叠交互。
- 区分规划、审核、准备、清理、取消和异常；准备及清理不占业务编号，已结算数量不代表通过比例。
- 补充进度显示指南与界面验收记录，验证100步模拟列表及真实历史会话页面。

## [0.8.2](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.8.2) — 2026-10-04

- 将环境状态与确认释放入口移到“设置 → 测试插件 → 测试环境”。
- 本插件命令失败时只向发起会话提示；没有使用测试功能的普通对话不显示全局隔离提醒。
- 保留用户确认、原生工具审批、失败时继续隔离及旧结果不改写的恢复规则。
- 新增异常残留清理和常见问题速查文档，说明预览、配置、构建、安装与报告问题的处理步骤。

## [0.8.1](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.8.1) — 2026-10-04

- 修复共享环境被异常残留隔离后，新测试无法启动却缺少明显提示的问题。
- 展示隔离原因、持续时间和清理超时阈值，超过阈值时提示可能卡住。
- 增加确认释放流程：核实旧外部操作停止后，通过原生浏览器关闭工具尝试恢复。
- 恢复失败或超时时保留隔离；成功后提示重新提交测试，不自动重放用例或修改旧报告。
- 此版本的常驻隔离提示在0.8.2改为按需提示，并迁入设置页。

## [0.8.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.8.0) — 2026-10-04

- 新增输入框上方的执行步骤图、当前步骤高亮和包含等待时间的实际耗时。
- 接入 DSH 原生 Browscreen 画面浮窗；仅在当前页面 CDP 可达、运行归属匹配且有效首帧到达后显示。
- 新增“设置 → 测试插件”预览配置，保存 Browscreen 项目目录、采集端口和 Playwright MCP；下一次测试自动按需接入。
- 支持关闭后手动重开预览、连接失败状态和结束清理；纯接口及无 CDP 任务不显示空浮窗。
- 补充首次配置、构建依赖恢复及真实预览验收说明；记录多对话并行的后续优化方案。

历史文档中的0.7.0是步骤进度与预览的开发验收阶段，没有独立的包版本提交或Git标签，相关实现合并在0.8.0记录。

## [0.6.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.6.0) — 2026-10-04

- 完善 TXT、Markdown 用例和 CSV 参数化的示例及中英文指南；支持任务模板或用例文件，审核时展示来源、参数快照和展开实例。
- 修复文件用例通报被无意义空参数阻塞的问题；审核前取消时保留全部未执行实例及正确统计。
- 明确同路径安装包升级的正式 remove/add 流程，解决安装成功却复用旧内容的问题。
- 完成文件用例、参数化、多实例报告与浏览器用例的实际验收记录。

## [0.5.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.5.0) — 2026-10-04

- 自然语言规划改为业务动作短句和文字检查点；工具、选择器、采集定义与比较方式在执行当前步骤时确定。
- 展示并保存原始任务、简短拆分思路和步骤清单；直接执行前核对完整通报，原始任务不被后续修改意见覆盖。
- 依据宿主语言偏好或任务语言生成过程说明，保留数字与字符串检查的类型语义。
- 修复固定采集和清理拒绝空采集参数的问题，完善运行时断言绑定与必需检查校验。
- 新增英文 README、使用与部署文档，完善本地安装包路径迁移说明。
- 在该标签区间接入 TXT/Markdown 解析、CSV 展开、多实例原生审核和报告的基础实现；完整指南、边界修复及验收在0.6.0完成。

## [0.4.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.4.0) — 2026-10-04

- 新增 `/test-plan`，通过 DSH 官方命令进入原生 plan 模式，支持要求修改、批准草案及审核前取消。
- 修复原生计划服务的作用域获取问题；批准当前草案后才派发测试动作。
- 统一 HTTP GET JSON 可信采集入口，支持状态码及嵌套响应字段断言，并防止绕过采集链路直接调用内部接口工具。
- 增加接口示例、计划审核修改和真实 HTTP 报告验收记录。

## [0.3.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.3.0) — 2026-10-03

- 重构静态报告为左侧导航、用例列表和详情视图，提供概览、运行信息及步骤、断言、附件页。
- 增加名称、数据集和状态筛选，以及证据展开、截图放大和下载交互。
- 修复宿主页面隔离及认证限制导致附件预览和下载失败的问题，保留静态报告离线查看能力。
- 补充真实报告的视觉、交互和缩放验收说明。

## [0.2.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.2.0) — 2026-10-03

- 测试增强改为附着在当前原生会话的 Agent 上，复用宿主的模型循环、工具调用、审批和会话保存。
- 在同一会话完成规划、执行、可信采集、停止及预授权清理。
- 分离分析规划与运行时采集调整，完善必需断言和预期的冻结校验。
- 修复原生工具结果中非 JSON 可选字段造成的序列化问题，完善取消、隔离和恢复生命周期。

## [0.1.0](https://github.com/Pegasus-Yang/DSH-Test-Plugin/tree/v0.1.0) — 2026-10-03

- 建立原生 TypeScript 测试插件，提供自然语言及 JSON 计划、串行用例和数据实例执行。
- 实现计划合同校验、可信观察、确定性断言、持久事件账本与离线 HTML 报告。
- 接入原生工具审批、停止、预授权清理、共享环境隔离及动态必需断言。
- 支持网页内报告入口；修复带参数测试命令未进入插件及浏览器清理等待问题。
- 完成本地插件打包安装和首批真实网页验收，形成后续按原生对话增强的改造依据。

## 维护规则

- 新功能、行为变更、修复和用户相关文档调整先记入“未发布”，只记录已经实现或完成的内容。
- 发布时将本版条目整理到新版本标题下，填写交付提交日期和版本标签链接，并与 `package.json` 保持一致。
- 后续改动继续加入“未发布”；旧标签和历史条目保留，纠错时明确说明，不把未实施方案写成已发布功能。