前言¶
在智能体或业务项目里做回归,常见做法是表格记结果、聊天里贴截图、失败重测后旧结论难找。期望、实际现象、附件和下一轮尝试容易散落在不同地方,开发跟进和复盘都要额外对齐。
DeepSeek Harness(DSH)把能力做成可安装的插件。下面介绍社区维护的客户端插件 dsh-test-workbench:在 DSH 侧边栏里做手工测试执行台,把用例步骤、状态、证据和执行历史放在同一工作区,并可在本地生成 Markdown 报告快照。
这是什么¶
dsh-test-workbench 是开源的 DSH 测试执行工作台,支持手工与 AI 辅助整理的结果记录、逐步证据、执行历史与报告。维护者为 lichufeng123,在插件目录中归类为客户端;当前 README 标明版本 0.1.0,许可 MIT,界面与报告标签为简体中文。
插件运行在 DSH 进程内,不单独起应用服务。它以手工记录为主流程;不内置自主浏览器或业务 API 自动化执行器,也不代替人工判定通过与否。
核心功能¶
一轮回归的执行视图¶
可选择来源版本,填写环境与被测版本,按用例列表推进。六种状态区分通过、失败、阻塞、延期、进行中与未开始;支持依赖感知的初始排序,并可在执行过程中调整顺序。
步骤旁记录证据¶
每个步骤可在「操作 / 期望」旁填写实际观察。支持粘贴或拖入截图、配文,并上传到用例;亦支持视频与 PDF。附件先存为本地草稿,切换页面不会丢掉未上传的编辑;每条附件归属某次具体执行尝试。
重测保留首轮结果¶
修复后可开启新的执行尝试,同时保留此前失败及其证据。用例移出本轮时可记录原因,恢复时保留范围变更历史,便于后续人员查看结果与范围如何变化。
本地 Markdown 报告¶
任意时刻可生成本地 Markdown 报告:失败、未完成、已移除用例及证据缺口会一并体现。每份报告对应冻结快照,后续测试不会静默改写已生成报告;预览与下载不依赖外部发布服务,也不要求一定配置模型。
AI 的边界(可选)¶
在 DSH 已配置模型时,创建或重规划一轮、生成报告等操作可能调用模型做排序或摘要;可能向模型提供方发送用例描述或执行记录,插件本身无独立模型配置。AI 不在这里生成并执行真实测试、不修改期望结果、也不独立裁决真伪;记为 AI 执行的结果须指向当前轮次的真实执行记录。无模型时,手工执行与本地报告预览仍可用。
可选飞书 / Lark 发布默认关闭,需自行配置 lark-cli 与报告目录;0.1.0 对外发布还要求 DSH 模型可用,细节见上游配置文档。
安装与启用¶
环境要求(来自 README):DSH >= 0.2.2-rc.1,Node.js >= 22。
向日常使用的 DSH CLI 配置文件安装已发布的 npm 包:
dsh plugin --profile web add dsh-test-workbench@0.1.0
将 web 换成你实际的 CLI profile 名称。在 Desktop 应用的自定义插件安装处可填写 dsh-test-workbench@0.1.0;名为 desktop 的 CLI profile 并不指向应用托管的配置,需按应用说明操作。
也可从源码引用安装(README 原文):
dsh plugin --profile web add github:lichufeng123/dsh-test-workbench
在活跃 profile 的 Cordis patch 中配置测试工作区根目录:
- id: dsh-test-workbench
config:
workspaceRoot: /absolute/path/to/test-project
插件以当前 DSH 进程权限读写 workspaceRoot 下数据;安装前应查看上游源码与 MIT 许可证,并对照 SECURITY.md 了解数据边界。
典型用法¶
- 在侧边栏打开 测试执行台,导入上游仓库中的
examples/cases.json,或粘贴符合结构的 JSON(单次导入 1–500 条用例;新工作区无需预先用例注册表)。 - 选中导入的来源,创建一轮并填写环境、被测版本与范围。
- 执行测试,保存状态与观察;添加步骤证据后,将草稿显式上传以附着到用例。
- 打开 测试报告,选择 生成本地预览 查看或下载当前快照。
最小用例示例(字段名与 README 一致):
{
"requirement_id": "REQ-DEMO",
"title": "Display preferences",
"cases": [{
"id": "C1",
"title": "Keep a saved preference after reload",
"steps": [
{"action": "Choose comfortable and save", "expected": "Save succeeds"},
{"action": "Reload the page", "expected": "Comfortable remains selected"}
],
"expected_result": "The saved preference remains comfortable"
}]
}
也可导入纯用例数组并在表单中补全来源 ID 与标题。可选 oracle / Oracle、oracles、source 等字段保留项目中的判定依据与引用;插件只存储描述,不执行 oracle 或代为裁决。导入来源保持 provisional / pending review 语义,approved 字段不能把导入变成已批准基线;旧结果导入不计入新轮次已完成测试。执行记录、附件草稿、证据与报告快照位于工作区下的 .ai-test/,输入草稿亦使用浏览器本地存储,敏感内容勿提交到公开仓库。
适用场景与注意¶
适合需要在 DSH 内与开发、智能体协作同事共享手工回归过程的团队:步骤级证据、多轮尝试与范围变更可追溯,报告以快照形式留存。
DSH 社区插件目录为独立站点,与 DeepSeek / 幻方无官方从属关系;星标与版本以目录页与 GitHub 为准(当前资料中 GitHub 星标为 0)。
安装与使用前请核对仓库许可证与 SECURITY 说明;启用 AI 或外部发布时,注意用例与执行记录可能发送到已配置的模型提供方。
结尾¶
dsh-test-workbench 把期望、实际结果、截图与重测历史收拢在 DSH 侧边栏,并支持不依赖外部服务的本地报告预览。进一步了解可从目录页与仓库 README 入手:
- 目录页:https://www.skillhub.cn/plugins/lichufeng123/dsh-test-workbench
- GitHub:https://github.com/lichufeng123/dsh-test-workbench