DSH Test Plugin

在 DeepSeek Harness 对话中，用自然语言完成测试规划、执行和结果交付。

简体中文 · English · 快速开始 · 完整文档 · 更新日志 · 问题反馈

DSH Test Plugin 是 DeepSeek Harness（DSH）的原生测试插件。描述想验证的业务流程，插件会拆解计划，结合真实页面或接口响应执行检查，并在同一对话中展示进度、证据和结果。它复用当前对话的模型、工具、审批和会话记录，支持网页 UI 测试与 GET JSON 接口测试。

从一次探索到重复执行：可以直接输入测试任务，也可以维护 TXT、Markdown 用例和 CSV 参数数据；执行后获得可复查的 HTML 报告，以及供其他执行人复用的 Markdown 手工用例。

浏览器连接仅支持 Playwright MCP 和 RunBridge MCP。 其他 MCP 或浏览器工具（如 Selenium MCP、Chrome DevTools MCP、Playwright CLI）不能直接替代；纯接口 GET JSON 测试由插件采集，无需浏览器 MCP。

功能亮点

能力	可以做什么
自然语言规划与审核	将任务拆成业务步骤和检查点；直接执行，或先审核、修改计划再运行
网页与接口测试	通过本机 Playwright MCP 或远程 RunBridge MCP 操作网页，执行时结合页面情况确定具体操作；采集 GET JSON 响应，检查状态码与响应字段
文件用例与参数化	使用 TXT、Markdown 保存用例，用 CSV 展开多组数据，逐项审核后串行执行
执行进度与耗时	在输入框上方查看当前步骤、已结算数量和耗时；按需展开完整步骤，适应长文字与多实例
实时画面与录像	在同一页面观看无头浏览器画面；可独立开启录像，在报告中回看、拖动和下载 MP4
证据与测试报告	保存实际观察、预期及来源，通过程序比较给出断言结果；生成含步骤、断言和附件的静态 HTML 报告，支持离线保存与重建
实际步骤与手工用例	逐条记录真实操作，按序号整理操作和预期结果，导出包含前置、实际步骤及收尾的 Markdown 手工用例

实际效果

以下截图展示使用 GitLab 作为被测系统时的实际运行效果。

随时知道正在做什么。 进度区显示当前操作、已结算数量、总耗时和本步用时；展开后可以查看完整步骤。

在对话中观看浏览器执行。 实时画面浮窗与对话记录、步骤进度一起展示，可以移动、缩放，也可以显示或隐藏。

用证据核对测试结果。 报告将规划、实际操作与检查组织为统一执行过程，完整预期与本次实际值对照展示；用例头部可直接下载供他人再次执行的手工 MD。浏览器用例可附带录像，接口用例展示相应的请求与检查。

更多计划审核、步骤展开和报告截图见使用说明。

快速开始

1. 准备 DSH 与测试工具

• Node.js 22.19+，已安装并配置可用模型的 DeepSeek Harness 0.2.1-alpha.1～alpha.5、rc.1～rc.5。
• 在 DSH 中使用 native 工具模式；网页测试只支持下表两种连接。
• 仅做接口测试时无需安装浏览器；通过 DSH CLI 安装插件及源码开发需要 pnpm 11.7.0。

连接方式	适用环境	安装与使用
Playwright MCP	浏览器与 DSH 在同一台机器，首次使用推荐	安装 @playwright/mcp@0.0.68 及其匹配的 Chromium，再注册到 DSH，见本机安装与配置
RunBridge MCP	浏览器在远程机器或虚拟机	先按 Hub／Node 指南部署服务，再按远程浏览器指南保存私有连接文件并运行；无需本机 Playwright MCP

宿主安装入口和可复制命令见安装与运维。RunBridge 的既有接入基线为 Hub 0.9.1 / Node 0.8.1，其他组合的验证范围见远程指南。

2. 安装并启用插件

方式一：交给 Agent 安装。 将下面的提示词和Agent 自动安装指南交给具备终端和文件操作能力的 Agent；指南包含环境检查、插件与 Playwright MCP 安装、DSH 配置及首次测试验收。

请按照 https://github.com/Pegasus-Yang/DSH-Test-Plugin/blob/main/doc/deployment/Agent自动安装插件与PlaywrightMCP.md 安装 DSH Test Plugin 和 Playwright MCP，并完成文档中的验收。复用已有 DSH 环境，保留现有模型配置；需要我补充的信息请明确列出。

方式二：手动安装。 按上表准备浏览器连接，再选择下面的一种插件来源。

本地审核时，使用维护者提供的同一个 tgz：

dsh plugin --profile web add /绝对路径/dsh-test-plugin-0.17.0.tgz
dsh web

维护者完成验收并推送标签后，可在 DSH 插件管理页填写下面的仓库地址，安装后启用：

https://github.com/Pegasus-Yang/DSH-Test-Plugin.git#v0.17.0

也可以使用独立 DSH CLI 安装：

dsh plugin --profile web add github:Pegasus-Yang/DSH-Test-Plugin#v0.17.0
dsh web

命令行安装前先正常停止正在运行的 DSH，安装与后续启动使用同一 profile 和 DSH_HOME，启动后刷新页面。从 DSH 源码目录运行时，将 dsh 替换为 pnpm dsh。仓库发行版本包含构建产物，可以直接安装。

这 10 个宿主使用同一个插件包，无需版本豁免。当前开发 SDK 固定 alpha.3；后续插件升级继续保留已支持宿主。状态与已验证范围详见记录，支持集合以 dsh-compatibility.json 为准。

升级、卸载和本地安装包的操作见安装与运维。

3. 在对话中运行第一条测试

准备一个可访问的 GitLab 登录页，在 DSH 对话框中输入：

/test 访问 http://127.0.0.1:8929/users/sign_in，断言页面存在用户名输入框、密码输入框和 Sign in 登录按钮

将地址替换成自己的 GitLab 地址。这条用例不需要账号；GitLab 部署请查阅官方 Docker 文档，系统条件与测试账号要求见GitLab 测试指南。

插件会展示计划、逐步执行并更新进度，结束后提供结果和报告链接。希望先确认计划时，使用 /test-plan。执行文件用例前，将文件所在目录设为当前对话工作区，路径按该工作区读取。

4. 按需开启画面与录像

安装本机 Browscreen 命令，在 设置 → 测试插件 → 浏览器预览与录像 中开启所需的预览或录像、检测安装、选择专用 Playwright MCP，并保存设置。之后使用正常测试命令即可，采集服务由插件按需启动。

实时画面只在当前浏览器的 CDP 连接和有效首帧就绪后显示。录像有独立开关，默认关闭；隐藏浮窗不会停止已启用的录像。接口实例不显示浏览器画面或视频区域。

安装要求和操作步骤见实时预览配置与浏览器录像与报告。

命令与用例

以下命令都在 DSH 对话框中使用：

命令	用途
/test <任务>	展示计划后直接执行
/test-plan <任务>	先审核、修改计划，再执行
/test-run <文件>	从当前工作区读取 TXT 或 Markdown 用例并执行
/test-data <CSV> --file <用例文件>	按 CSV 展开参数，审核后执行

需要中途停止时，使用 DSH 原生停止按钮；运行完成后可从进度区或设置页重建报告。完整输入规则和界面操作见使用说明。

想体验更完整的流程，可以使用GitLab 样例：两条 UI 用例覆盖组合筛选和草稿预览取消，三条接口用例覆盖搜索、分页和错误响应，另有 CSV 参数化模板。按测试指南准备专用账号和本轮数据，账号保存在不提交的本机配置中。

支持范围

• 浏览器执行只适配 Playwright MCP / RunBridge MCP；在其他 Agent 中装好浏览器工具，或将其他 MCP 改名为 playwright，都不能替代 DSH 中的对应连接。
• 运行于 DSH native 工具模式，共享测试环境按串行方式执行；多对话独立浏览器并行运行属于后续优化。
• 接口测试支持 GET JSON 采集；自动预览使用本机 Chromium Playwright MCP，当前支持单活动页面。
• 自然语言和文件用例执行都使用当前对话的模型；报告重建从已保存记录生成，不重新执行用例。
• 测试结果保留失败、取消和清理状态；证据缺失、工具错误或必要清理失败不会算作通过。报告界面及部分提示以中文为主。

文档与帮助

从这里开始	内容
完整文档导航	使用、部署、架构、设计和验收记录
使用说明	命令、文件、参数、计划审核与报告
CSV 参数文件使用手册	可复制示例、占位符、数据展开、审核与常见错误
GitLab 测试要求与本地调试	系统与账号要求、复杂用例、数据准备及插件调试
执行步骤与进度	步骤展开、运行阶段和耗时
实际步骤与手工用例	操作记录及可复用的手工用例导出
预览配置 · 录像与报告	实时画面、视频依赖、回看和下载
安装与运维 · 故障速查	安装、升级、卸载、环境恢复和常见问题
Agent 自动安装指南	交给 Agent 安装插件、Playwright MCP 和浏览器，并验证第一条测试
当前架构	模块职责与执行链路

开发与贡献

欢迎通过 Issues 反馈问题或提交改进。反馈时请附上插件、DSH、Node.js 和 MCP 版本，复现步骤及已脱敏的错误信息。

源码开发：

git clone https://github.com/Pegasus-Yang/DSH-Test-Plugin.git
cd DSH-Test-Plugin
pnpm install --frozen-lockfile
pnpm typecheck
pnpm build
pnpm test:unit
pnpm test:integration

本地打包与隔离调试见安装与运维，真实测试范围见开发与验收记录。提交改动前完成相关检查并同步文档；凭据、日志和原始运行资料保存在不提交的本机目录中。

许可证

本项目采用 MIT 许可证。第三方依赖及图标许可见 THIRD_PARTY_NOTICES.md。