01. 项目概述
这是本站旗舰「可安装的质量工程」产品：把真实需求产物变成可评审的 QA 交付物。生成后固定走人工评审闭环（测试经理 · 开发经理 · 产品经理），按覆盖率 / 逻辑 / 可执行性 / 清晰度 / 安全性打分（满分 100，默认阈值 90，最多 5 轮）。官方文档：https://innonestx.github.io/testcase-generator/
- Word
- TXT
- Image
- Video
- 多模态解析
- AI 用例生成
- 三角色评审闭环
- Excel / Markdown / XMind 导出
02. 问题
为什么做？
真实需求常以 PDF、Word、截图甚至短视频出现。手工整理场景与边界用例成本高；裸 LLM 倾倒缺少覆盖、可执行性与安全视角，难以被 QA 团队直接采用。
03. 方案
怎么解决？
做成可安装的多模态生成器：解析 PDF / Word / TXT / 图片 / 视频 → AI 生成结构化用例 → 结构化人工评审闭环（测试 / 开发 / 产品经理；可配置多模型）→ 按评分算法迭代，直至达阈值或轮次上限 → 导出 Excel / Markdown / XMind。同一产品支持 Docker、本地源码、npm 全局安装与 OpenClaw 插件四种运行方式。
04. 架构
系统架构
产品流水线
- 多模态输入（PDF · Word · TXT · Image · Video）
- AI 生成（可配置 generator / reviewer / both）
- 结构化测试场景与用例
- 人工评审：测试经理 · 开发经理 · 产品经理
- 评分算法（阈值默认 90 · 最多 5 轮）→ 导出
支持的运行方式
- Docker / Docker Compose（端口 3456 Web UI）
- 本地源码运行（npm run build && npm run start）
- npm 全局安装（testcase-generator --standalone）
- OpenClaw 插件（/testgen 与 generate_test_cases 工具）
05. 关键特性
核心功能
- 多模态接入：PDF、Word、TXT、图片与视频（视频可选 ffmpeg 抽帧）
- 人工评审闭环：测试经理（覆盖/可执行）· 开发经理（可行性/安全）· 产品经理（业务/旅程）
- 评分维度：覆盖 30 · 逻辑 20 · 可执行 20 · 清晰 15 · 安全 15
- 多厂商模型槽位：Anthropic、OpenAI、DeepSeek、Qwen、Gemini 等，或自定义 OpenAI 兼容端点
- 导出 Excel、Markdown、XMind；中英文生成
- 四种安装面：Docker、本地源码、npm、OpenClaw 插件
06. 我的角色
我具体做了什么？
- 主导产品方向：可安装的质量工具，而不是一次性演示笔记本。
- 设计「多模态解析 → AI 生成 → 评分人工评审 → 导出」流水线。
- 完成 Docker、npm、本地源码与 OpenClaw 插件四条运行路径。
- 把评审阈值、轮次上限与 QA 日常导出格式写进默认可运行配置。
07. 技术栈
使用什么技术？
- TypeScript
- Express（Standalone Web）
- Anthropic / OpenAI-compatible LLMs
- Docker
- npm
- OpenClaw Plugin
- Excel / Markdown / XMind 导出
08. 成果指标
Docker 拉取经 Docker Hub API Gateway 实时采集；npm 与 OpenClaw / ClawHub 同步刷新。
09. 部署
如何运行？
分发面以 Docker、npm 与 OpenClaw 为主（另支持本地源码运行）。Docker 拉取量由 Docker Hub API Gateway 实时采集。
- Docker：docker pull xuxuclassmate/testcase-generator:latest，配置 AI_PROVIDER 与 API Key，映射 3456，打开 http://localhost:3456。
- npm：npm install -g @classmatexuxu/testcase-generator，然后 testcase-generator --standalone。
- OpenClaw：openclaw plugins install -l /path/to/testcase-generator，在 config.yaml 配置 models[] 后使用 /testgen。
- 本地源码（无下载计数）：clone 仓库 → npm install → 配置 .env → npm run build && npm run start。
10. GitHub
11. 在线体验
12. 取舍
- 用结构化人工评审闭环（测试 / 开发 / 产品经理）+ 评分阈值代替裸 LLM 倾倒——覆盖、可执行性与安全视角写进默认配置。
- Docker + 源码 + npm + OpenClaw 四条路径一起交付，人和 Agent 共用同一产品（Installable > Demoable）。
- 接受多轮评审带来的首答时延，换取 Excel / Markdown / XMind 等 QA 日常可落地产物。
13. 交付物
- 本站旗舰可安装 AI 测试产品
- 官方四种运行方式：Docker · 源码 · npm · OpenClaw
- 人工评审 + 评分阈值写入默认可运行配置
- Docker 拉取、npm 下载与 ClawHub 安装量可实时验证
14. 可检查的证据
交互 Demo
浏览器走通：示例 PRD → 用例 → 人工评审——无需实时 LLM。
打开 Demo官方文档
模型配置、人工评审闭环、评分算法与四种安装方式。
打开文档Docker 镜像
本地 Web UI：上传 PDF / Word / 图片 / 视频并生成用例。
Docker Hub工程笔记
如何把多模态 AI 用例生成做成可安装产品。
阅读笔记15. 链接
安装入口、证据与延伸阅读。
立即体验
探索 → 试用 → 验证：先走交互 Demo（示例 PRD → 结构化用例 → 人工评审），再按官方文档安装做真实多模态上传。
浏览器 Demo 使用精选示例输出——不是实时 LLM。本机上传 PDF / Word / 图片 / 视频请按官方文档用 Docker、npm 或本地源码运行。
docker pull xuxuclassmate/testcase-generator:latest
# 配置 .env（AI_PROVIDER + API Key），然后：
docker run -d --name testcase-generator -p 3456:3456 \
-e AI_PROVIDER=anthropic -e ANTHROPIC_API_KEY=sk-ant-... \
-e LANGUAGE=zh -e ENABLE_REVIEW=true -e REVIEW_THRESHOLD=90 \
xuxuclassmate/testcase-generator:latest
# 打开 http://localhost:3456
# 或 npm：
# npm install -g @classmatexuxu/testcase-generator
# testcase-generator --standalone