vs-testcase-generator

• slug: vs-testcase-generator
• version: 0.1.0
• author: lixinming
• language: zh-CN
• target_audience: tester
• description: 模块选择 → 思维导图 → 用户确认 → 生成/迭代测试用例。支持默认四表 Excel 和自定义 Excel 模板。
• dependencies: python >= 3.7, openpyxl, python-docx, PyMuPDF
• tags: [测试用例生成, 思维导图, 孤儿用例, 直接迭代, 图片提取, 自定义模板]
• license: MIT

硬性门禁

这些规则优先级高于用户给出的文件名、保存路径、"直接生成"、"全部生成"、"不用确认"等表述。

1. 初稿 V1.0 生成前，必须先识别模块并让用户选择；用户已在同轮或上文明确点名模块时，复述锁定范围后继续。
2. 初稿 V1.0 生成前，必须输出并确认思维导图；只有用户明确回复 确认、通过、可以生成用例 或同义清晰确认后，才允许生成 Excel/CSV/MD。
3. 展示模块列表的同一轮不得输出思维导图；展示或修改思维导图的同一轮不得生成用例文件。
4. 初稿 V1.0 只能依据已确认导图生成，不得补充导图外测试点。
5. V1.1+ 迭代按用户明确意见直接修改；仅当用户新增模块、扩大范围或需求不清时，才重新输出并确认导图。
6. 默认模板每次生成、迭代或导出后，必须运行统计/自检脚本；存在自检失败、孤儿用例或孤立场景时暂停并展示问题清单。

思维导图

• 根节点固定为 测试用例思维导图；层级固定为 模块 → 场景 → 测试点。
• 连接线使用 ├─、└─、│ 和三个空格；场景节点使用 场景： 前缀，测试点节点使用 测试点： 前缀。
• 测试方法写在测试点同一行，格式为 测试点：<名称> -> <测试方法>；待确认项标注 【待确认】。
• 映射关系：场景 写入场景总览；测试点 写入用例标题；-> 后内容写入测试方法；场景数必须小于或等于用例数。
• 输出导图后询问：请确认以上思维导图是否符合预期？如无异议请回复“确认”，如需修改请描述调整意见。

标准流程

1. 输入解析与模块选择

提取需求、规则、功能模块和测试点。文档内图片优先自动识别；识别失败时提示用户上传图片、提供文字描述或跳过。输入超过 5000 字符或 150 行时提示拆分。

未明确模块时，展示模块列表并等待用户输入序号、多个序号或 全部：

从您的输入中识别到以下功能模块：
1. 用户登录
2. 待办管理
请选择要生成测试用例的模块（输入序号，多个用逗号分隔；或输入“全部”）。

2. 模板选择

• 无自定义模板：读取 references/default-template.md，使用默认四表模板。
• 有自定义模板：读取 references/custom-template-fill.md，运行 python scripts/parse_template.py <模板> --json。缺少 steps/expected/title、匹配字段不足、出现 ambiguous_candidates 或额外字段超过 5 个时，暂停并让用户确认映射或切换默认模板。

3. 初稿生成

进入本步前必须满足：模块已锁定、最新导图已输出、用户已明确确认。

• 默认模板：生成结构化 scenes/cases JSON，运行 generate_default_template.py 创建 Excel，再运行 apply_default_stats.py <文件> --json 写回统计和自检结果。
• 自定义模板：生成标准 cases JSON，运行 fill_custom_template.py <模板> --cases --output <输出文件> --json。

4. 直接迭代

• 默认模板：按用户意见修改 Excel 后，运行 apply_default_stats.py <文件> --auto-bump-version --change-summary <本次修改要点> --change-remark <影响范围或备注> --json。该命令会自动次版本 +1、同步封面/评审报告版本、追加版本历史、写回统计并自检。需要指定版本时用 --version <新版本号> 替代 --auto-bump-version。
• 自定义模板追加用例：重新运行 parse_template.py，再用 fill_custom_template.py 输出新版本 Excel。
• 自定义模板修改已有用例：只改用户明确指定的行和字段；禁止改表头、列序、公式列、隐藏列、受保护列和其他工作表；交付说明记录旧值摘要和新值摘要。
• 自定义模板删除用例：默认用状态/备注标记为废弃或不适用；物理删除必须先列出用例编号和行号并等待确认。

5. 终版导出

用户确认终版后导出。默认模板导出前运行 apply_default_stats.py <文件> --json 做最终自检；自定义模板导出现有文件。如需 MD，仅提取用例明细区域。

交付反馈

• 默认模板每次生成、导出或迭代后，基于最近一次脚本 JSON 返回值展示统计摘要。
• 摘要至少包含：输出文件路径、总场景数、有效场景数、孤立场景数、总用例数、P0/P1/P2/P3 数量及占比、正向/逆向数量及占比、覆盖模块、孤儿用例数量、孤立场景数量、自检状态。
• 若 self_check.warnings 非空，展示警告摘要；若 success=false、orphan_cases 非空或 isolated_scenes 非空，展示问题清单和下一步处理建议，禁止只说“生成完成”。
• 自定义模板追加或修改后，如无法使用默认统计脚本，至少展示本轮写入/修改行范围、用例新增/修改数量、覆盖模块、未填充字段和人工待确认事项。

资源使用

• 默认模板：读取 references/default-template.md；调用 scripts/generate_default_template.py、scripts/apply_default_stats.py。默认四表公共字段集中在 scripts/default_schema.py。
• 自定义模板：读取 references/custom-template-fill.md；调用 scripts/parse_template.py、scripts/fill_custom_template.py。
• 优先级：读取 references/priority-guide.md；统计结果以 testcase_auto_stats.py --json 为准，Excel 写回以 apply_default_stats.py 为准。
• 只允许删除本轮 AI 生成的临时文件或产物，禁止删除用户提供的需求文档、自定义模板、历史用例或原始截图。

交互前自检

展示文件路径或统计概览前，确认：

1. 初稿 V1.0 已完成模块选择、导图输出和导图确认；V1.1+ 迭代有用户明确修改意见。
2. 默认模板已运行统计/自检脚本，且无未处理的孤儿用例或孤立场景。
3. 默认模板版本号在封面、评审报告基础信息、版本历史中一致；迭代时版本历史记录能概括本轮变更。
4. 自定义模板未改表头、列序、公式列、隐藏列、受保护列和其他工作表。

任一项不满足时，禁止展示交付完成结论，先回到对应步骤处理。