# 文档导航

## English documentation

- [Project overview and quick start](../README.en.md)
- [User guide](user-guide/使用说明.en.md)
- [Installation and deployment](deployment/安装与运维.en.md)

The English guides describe the current implementation. Historical design and acceptance records below are in Chinese; the report UI and some plugin messages also remain primarily Chinese.

## 当前版本

- [CI 公开依赖安装验收](project/CI公开依赖安装验收.md)：0.12.3 的缺包复现、公开依赖补齐与 Linux 干净 CI 验证。
- [DSH 宿主升级适配验收](project/DSH宿主升级适配验收.md)：0.12.2 对 DSH 0.2.1-alpha.3 的 SDK、原生审核、构建与运行兼容验证。
- [RunBridge 远程浏览器与持续预览](user-guide/RunBridge远程浏览器与持续预览.md)：连接设置、虚拟机网络、用例执行、画面与恢复。
- [远程执行与画面架构](architecture/RunBridge远程执行与画面.md) · [接入验收](project/RunBridge远程浏览器接入验收.md)。
- [RunBridge 请求恢复兼容验收](project/RunBridge请求恢复兼容验收.md)：0.12.1 的原请求核对、失败会话恢复、确定未分配证据、旧结果保留及上传边界。

- [CSV 参数文件使用手册](user-guide/CSV参数文件使用手册.md)：完整 GitLab 入门示例、模板占位符、引号和空值、多用例展开、工作区路径、审核运行与错误速查。
- [GitLab 测试要求与本地调试](user-guide/GitLab测试要求与本地调试.md)：被测系统条件、账号权限、私有配置、Markdown/CSV、画面与录像、报告、本地改包调试和本轮项目清理；GitLab 部署引导官方文档。
- [GitLab 测试指导文档验证](project/GitLab测试指导文档验证.md)：前轮样例解析、27 项回归、真实登录页执行/审核/预览/录像截图、隐私与收尾，以及文档职责调整后的检查。

- [Markdown 用户入口验收](project/Markdown用户入口验收.md)：0.11.2 的用户帮助、开发格式边界、GitLab Markdown 网页/接口用例及真实对话验收。

- [手工用例调整验收](project/手工用例调整验收.md)：0.11.1 的五部分模板、真实数据、原始描述、空预期、Markdown 与下载/重建验证。

- [0.11.0 版本发布验收](project/0.11.0版本发布验收.md)：汇总 v0.10.0 之后的功能、修复与优化，记录新版本构建、回归、安装包与本地标签核对；历史真实失败和复测边界继续保留。
- [收尾约束与账本报告优化验收](project/收尾约束与账本报告优化验收.md)：释放准入、检查点提交、流式重建与下载、报告去重；记录大日志量化比较、完整 GitLab 批次及定位失败的单独复测边界。
- [工作区文件路径验收](project/工作区文件路径验收.md)：修复纳入 0.11.0；文件命令按发起对话工作区读取，保留越界限制，公开 SDK 回归及实际 JSON 读取验证。
- [GitLab 用户用例](user-guide/GitLab复杂用例.md)：本机私有配置、2 条网页及 3 条接口 Markdown 场景、固定基线、逐步运行及清理；[场景表](../examples/gitlab/README.md)。
- [GitLab 复杂用例验收](project/GitLab复杂用例验收.md)：公开 SDK 回归、真实 DSH 分轮执行、100 个业务检查点、脱敏、接口无媒体和清理核对；保留失败及规模边界。

- [实际步骤与手工用例验收](project/实际步骤与手工用例验收.md)：公开 SDK 回归、真实网页、接口/CSV、错误/拒绝/取消、导出和媒体核对。
- [实际步骤与手工用例](user-guide/实际步骤与手工用例.md)：运行时操作说明、真实输入、实例编号、状态含义、Markdown 手工用例与运行记录。

- [0.10.0 历史版本发布验收](project/0.10.0版本发布验收.md)：版本与运行记录同步、公开 SDK 重建、安装包和远端标签核对。

- [浏览器录像与报告](user-guide/浏览器录像与报告.md)：0.12.3 的依赖安装、独立开关、视频回看、下载、离线保存和接口无媒体规则。
- [浏览器录像与报告验收](project/浏览器录像与报告验收.md)：正式 PyPI 0.3.0、公开 npm DSH、缺依赖、混合实例及播放验收。

- [命令精简与单预览浮窗验收](project/命令精简与单预览浮窗验收.md)：在 0.9.2 基线上验收、随 0.10.0 发布的四个命令、界面报告与处置、折叠箭头和单浮窗切换。

- [带截图的功能与使用说明](user-guide/使用说明.md#用截图认识功能)：真实计划审核、当前步骤与耗时、完整列表、浏览器浮窗、设置和报告；[项目首页预览](../README.md#实际效果)提供快速展示。
- [版本变更记录](../changelog.md)：各版本功能、修复和文档变化，以及尚未打新标签的主分支更新。
- [GitHub安装与卸载验收](project/GitHub安装与卸载验收.md)：0.9.1 公开 SDK 构建、独立 npm 宿主、Git 安装及真实页面执行、停用和卸载验证。
- [Browscreen命令接入验收](project/Browscreen命令接入验收.md)：0.9.0 PyPI 包、174 项回归、真实设置、接口与浏览器浮窗验证，以及部署边界。
- [执行步骤与进度显示](user-guide/执行步骤与进度显示.md)：0.12.3 的当前步骤焦点、完整列表、折叠、长文字及多实例编号。
- [步骤进度界面验收](project/步骤进度界面验收.md)：0.8.3 所选稿对照、100步模拟列表、长文字、窄窗口与真实安装的验证范围。
- [常见问题速查与处理](deployment/常见问题速查与处理.md)：按现象定位环境残留、释放失败、预览、配置、构建、安装和报告问题，附处理步骤与恢复标准。
- [测试环境卡住怎么办](user-guide/测试环境卡住怎么办.md)：0.12.3 的按需提示、设置页释放、超时提醒和失败处置。
- [设置释放与按需提示验收](project/设置释放与按需提示验收.md)：0.8.2 普通对话不显示隔离、命令错误按会话提示、设置页确认及真实浏览器释放。
- [隔离提示与确认释放验收](project/隔离提示与确认释放验收.md)：0.8.1 历史验收，常驻提示已在 0.8.2 改为按需提示；保留原生恢复与失败保留行为。
- [浏览器实时预览一步一步配置](user-guide/浏览器实时预览一步一步配置.md)：当前 Browscreen 0.3.x 本机命令安装、预览与录像开关、版本检测、逐项填写、运行命令、关闭与排错。
- [预览设置与自动接入验收](project/预览设置与自动接入验收.md)：0.8.0 设置持久化、MCP 接入、直接 /test、API 无浮窗及安装包验证。

- [执行进度与实时预览验收](project/执行进度与实时预览验收.md)：0.7.0 步骤图、实际耗时、CDP/首帧门禁、原生浮窗和独立安装包验证。
- [文本用例与参数化验收](project/文本用例与参数化验收.md)：0.6.0 TXT、Markdown、CSV、原生审核及多实例报告的实际结果。
- [文字规划与中文对话验收](project/文字规划与中文对话验收.md)：0.5.0 文字步骤、运行时定义、原文与拆分思路、中文通报及验证边界。
- [计划审核与接口测试验收](project/计划审核与接口测试验收.md)：0.4.0 原生 plan 审核、修改及真实 HTTP 报告核验。
- [开发与验收记录](project/开发进度.md)：分步提交、真实运行证据与未完成范围。
- [当前实现](architecture/当前实现.md)：模块及数据流、支持边界。
- [单条用例执行与参与者交互](architecture/单条用例执行与参与者交互.md)：插件、DSH、MCP 与 LLM 的职责、命令启动、计划审核、模型与工具循环、可信采集、断言、停止收尾和报告流转，附总览与时序图、源码入口。
- [安装与运维](deployment/安装与运维.md)：构建、插件安装、MCP、预算及隔离处置。
- [版本发布与Git标签](deployment/版本发布与Git标签.md)：发布步骤、版本与提交的对应表、历史标签补全及查找方法。
- [GitHub公开内容检查](project/GitHub公开内容检查.md)：凭据与历史内容检查、本机资料整理及README公开阅读结构。
- [使用说明](user-guide/使用说明.md)：命令、输入、断言及报告。

## 设计与实施

- [RunBridge MCP 远程浏览器对接](design/runbridge-mcp/README.md)：以原 12 工具基线编写的历史提案，完整接入已在 0.12.0 实施；当前能力与修复结果以上方架构和验收记录为准。
- [收尾约束与账本报告优化实施方案](design/收尾约束与账本报告优化实施方案.md)：已获批准，核心实现及优化指标验证完成；保留原方案及完整回归标准，实际结果和分轮复测边界见验收记录。
- [运行实际步骤与手工用例导出实施方案](design/运行实际步骤与手工用例导出实施方案.md)：已获批准，纳入 0.11.0；运行时逐条保存操作说明及真实调用，编号展示、失败重试记录和 Markdown／JSON 手工用例导出。
- [Browscreen视频录制与报告接入实施方案](design/Browscreen视频录制与报告接入实施方案.md)：正式 0.3.0 参数、独立录像开关、服务端采集、按实例归档、MP4 报告与 API 无媒体显示；方案已获用户批准，实施结果见当前架构和录像验收记录；原调研范围按历史保留。
- [Browscreen命令启动改造实施方案](design/Browscreen命令启动改造实施方案.md)：0.9.0 改造依据；直接切换为已安装的本机命令，删除旧接法兼容，包含版本检测、按需启动和验收计划。
- [多对话并行测试优化方案](design/多对话并行测试优化方案.md)：后续优化，尚未实施；记录当前共享资源问题、CLI/独立 MCP 候选、运行与预览隔离、分阶段实施和验收标准。
- [执行进度与浏览器实时预览方案](design/执行进度与浏览器实时预览方案.md)及[实施方案](design/执行进度与实时预览实施方案.md)：步骤图、实际耗时、DSH 原生浮窗和仅在 CDP 与首帧就绪时启用的 Browscreen 接入。
- [文本用例与 CSV 参数化方案](design/文本用例与CSV参数化方案.md)及[实施方案](design/文本用例与CSV参数化实施方案.md)：0.6.0 文件用例、参数预览和原生审核的改造依据。

[原生对话增强改造](design/原生对话增强改造.md) 是 0.2.0 的当前接入决策；下列独立执行/清理 Agent 的早期方案作为历史保留。

| 文档 | 用途 |
| --- | --- |
| [插件设计方案](design/插件设计方案.md) | 理解目标、模块职责和完整运行链路 |
| [数据契约与状态规则](design/数据契约与状态规则.md) | 实现计划校验、记录、断言和报告统计时的共同合同 |
| [详细实施方案](design/详细实施方案.md) | 按 M0–M6 推进开发，明确每阶段做什么、交付什么 |
| [阶段校验清单](design/阶段校验清单.md) | 按编号验证并填写证据，不以口头完成代替实测 |
| [方案审核与修复记录](design/方案审核与修复记录.md) | 本轮七项问题、用户确认决策、修订映射与静态复审边界 |

## 参考

- [开发者 JSON 用例与调试](reference/开发者JSON用例与调试.md)：内部执行格式、校验约束、样例、完整 GitLab 开发回归及文字计划边界；[English](reference/开发者JSON用例与调试.en.md)。

- [上游接口与验证记录](reference/上游接口与验证记录.md)：调研来源、接口风险和本次文档交付检查。
- [前期纯插件调研](reference/前期纯插件调研.md)：可行性依据，当前实施以设计与实施文档为准。
- [DSH证据数据](reference/data/deepseek-harness-evidence.json)：22条固定版本来源与文件摘要。
- [项目首页](../README.md)：首版约定和当前状态。

使用插件先读当前版本文档；继续开发先读设计和数据合同，再按清单验证。设计文档保留编写时的拟议结构与历史结论，当前代码事实和验收状态以上面的实现及开发记录为准。

- [测试报告视觉验收](design/测试报告视觉验收.md)：选定设计、视觉复核与交互证据。