前言¶
DeepSeek Harness(DSH)采用「一切皆插件」的理念,允许用户通过插件扩展能力。在智能体开发与自动化测试场景中,测试设计往往要经历需求整理、PRD 编写、测试点拆分、用例生成、质检评审等多个阶段。传统方式需要在不同工具间切换,且容易出现信息断层。DSH 的 AI 测试设计插件(dsh-aitestcase)把这一整套流程收拢到 DSH 进程内完成。
是什么¶
dsh-aitestcase 是一个面向工作流分类的 DSH 插件,由维护者 jiangzhengyuan777-tech 维护。它提供六个面向模型的工具,覆盖从原始需求到质检评审的完整闭环,全部在 DSH 进程内完成,不需要 Python、不需要单独的后端服务、不需要第二个 API Key,也不占额外端口。
核心功能¶
插件提供六个工具,构成推荐链路:
aitestcase_testprd:把需求整理成测试 PRD,补全未定义规则、列出待确认问题、明确验收标准,输出 Markdown。aitestcase_testpoints:把 PRD 或需求拆成测试点清单,涵盖功能点、边界条件、异常场景、集成点,输出 Markdown。aitestcase_testcases:用测试点 + PRD 生成测试用例,支持输出为 XMind、表格或 YAML,输出 Markdown 文件。aitestcase_evaluate:AI 辅助评审,给出覆盖率、边界、异常、安全打分,并列出缺口和建议,输出 JSON。aitestcase_history:读取本会话此前生成结果,做增量修改。aitestcase_status:自检模型连通、模板完整、产物目录,输出 Markdown。
安装与启用¶
在 DSH 中安装(桌面版 profile 由 Electron 独占,只能用 plugin_manager):
plugin_manager install_bundle target=<本仓库绝对路径>
安装完成后,在对话中直接使用工具即可:
用 aitestcase_testprd 把下面这段需求整理成测试 PRD,先列出明确规则和待确认问题:
(粘贴需求)
配置¶
插件在设置页提供 12 个配置项,注册为 schemastery 即时字段,修改后保存即可生效,无需重启。常用配置包括:
provider:模型提供方路由,默认deepseek-officialmodel:生成与评估使用的模型,默认deepseek-flashtemperature:采样温度,测试设计建议为 0maxTokens:单次输出上限,默认 20000outputDir:产物目录,相对路径按会话工作目录解析,默认.aitestcasesaveArtifacts:是否落盘,默认truemaxInputChars:整次请求字符预算,默认 60000maxRetries:瞬时故障重试次数,默认 2jsonRepair:评审输出不是合法 JSON 时追加一次修复调用,默认true
典型用法¶
在 DSH 中依次调用工具,即可完成从需求到评审的链路:
- 用
aitestcase_testprd把需求整理成测试 PRD。 - 用
aitestcase_testpoints把 PRD 拆成测试点清单。 - 用
aitestcase_testcases用测试点生成测试用例(表格或 YAML)。 - 用
aitestcase_evaluate做质检评审,获取 JSON 报告。
插件支持标签式输入协议([优化后PRD]、[测试点]、[补充说明]),也支持通过 requirementFile / testcasesFile / prdFile 直接读取工作区文件。
特性¶
- 纯本地编排:直接调用 DSH 已配置的模型,不引入第二个进程或密钥。
- 测试点自动继承:调用
aitestcase_testcases不传测试点时,自动把本会话最近的测试点经模板协议槽位传入,不重复塞进上下文。 - 防复述:历史上下文有明确措辞约束,避免模型续写上一份文档。
- 文件输入:支持通过文件路径读取需求、PRD 或用例。
- 产物落盘:每次生成独立 Markdown 文件,不覆盖历史,可被普通文件工具继续编辑。
- 可取消:工具执行信号贯通到模型调用,打断对话即取消。
- 整体上下文预算:
maxInputChars管的是「模板 + 历史 + 本次输入」的总量,模板永不截断,历史先生效裁剪,输入最后按剩余预算截断并在结果里注明用量。 - 瞬时故障重试:限流 / 超时 / 5xx / 空响应按指数退避自动重试,默认 2 次,致命错误不重试。
- 长任务后台化:四个重型工具支持
background=true,立即返回 job id,用job_output取结果、job_kill取消,环境没有任务注册表时自动降级为同步执行。 - 评审 JSON 可靠:评审结果自动提取/规范化;无法解析时追加一次最小修复调用,仍失败则原样返回并明确标注。
适用场景与注意¶
本插件适合需要在 DSH 内完成测试设计流程的使用者。插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
插件生成与评估的 prompt 模板内联自 AITestCase(MIT,Copyright (c) 2026 LiuYuan0115),本项目把原 HTTP 后端替换为 DSH 进程内模型调用,不包含原后端的向量库历史检索、文档库指针、PDF/图片 OCR、Figma 解析、UI 自动化执行等能力。
短结尾¶
dsh-aitestcase 将测试设计流程收拢到 DSH 进程内,提供从需求到评审的六工具链路。安装后即可在对话中直接使用,配置项即时生效,适合需要快速搭建测试设计流程的开发者与测试人员。
- 插件目录页:https://www.skillhub.cn/plugins/jiangzhengyuan777-tech/dsh-aitestcase
- GitHub:https://github.com/jiangzhengyuan777-tech/dsh-aitestcase