> ## 文档索引
> 获取完整文档索引： https://fushouagent.com/docs/llms.txt
> 先阅读此索引，了解所有可用页面。

# testcase generate

> 从本地 Markdown PRD 和引用图片生成测试用例 XLSX。

`fushou-agent testcase generate` 根据本地 PRD Markdown 及其引用图片生成测试用例大纲和 XLSX。默认在本机以交互模式运行，显示工具调用；需求存在关键歧义时，会先提问并等待回答。请安装 Node.js 22.19.0 或更新版本。

## AI 生成的用例，能追溯到需求吗？

生成流程先从 PRD 拆出功能点大纲，再展开为测试用例。`功能点大纲.md` 与 XLSX 一起保存在本地，便于对照需求检查和补充用例；通过编码智能体的 Skill 调用时，还可结合源码和技术方案分析。

生成后可用 [`testcase exec`](/docs/client/testcase/exec)在浏览器、电脑和手机上执行，结果写回 XLSX。产品能力见[测试用例智能体](/product/testcase-agent)。

## 命令格式

```bash title="Terminal"
fushou-agent testcase generate --prd PATH [--rule PATH] [--xlsx PATH]
fushou-agent testcase generate -p --prd PATH
fushou-agent testcase generate --resume SESSION_ID
```

## 参数与选项

| 参数 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `--prd PATH` | 是 | 无 | 已存在的 `.md` 或 `.markdown` PRD 文件，可使用相对或绝对路径。 |
| `--rule PATH` | 否 | 不使用补充规则 | UTF-8 规则指令文件，只支持 `.md` 或 `.txt`，可使用相对或绝对路径。 |
| `--xlsx PATH` | 否 | `<PRD 所在目录>/output/测试用例.xlsx` | 输出目录，或以 `.xlsx` 结尾的完整文件路径。 |

所有相对路径都以运行 `fushou-agent` 时的当前目录为基准。规则文件必须非空且不超过 65,536 个字符。

PRD 引用本地图片时，应让 Markdown 与图片保持原有相对目录结构；移动 PRD 时，需要把引用图片一起移动。

## 示例

仅使用 PRD：

```bash title="Terminal"
fushou-agent login
fushou-agent testcase generate \
  --prd ./需求文档/PRD.md \
  --xlsx ./generated-cases
```

使用补充规则文件并指定完整输出路径：

```bash title="Terminal"
fushou-agent testcase generate \
  --prd /absolute/path/PRD.md \
  --rule ./rules/regression.txt \
  --xlsx /absolute/output/回归测试用例.xlsx
```

`--rule` 后必须是文件路径，不能直接填写规则文本。

## 输出

交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入；任务给出最终结果后停止接收输入，保存输出文件、显示费用并自动退出。新任务需重新运行命令。

当 `--xlsx` 以 `.xlsx` 结尾时，它表示最终工作簿路径；否则表示输出目录，并在其中生成 `测试用例.xlsx`。命令还会在工作簿旁生成 `功能点大纲.md`。

非交互模式（`-p` 或 `--prompt`）仅在 stdout 输出最终结果 JSON，其中包含生成文件的路径，不输出执行过程。完成返回 `0`，失败返回 `1`。非交互模式始终不显示输入框，也不接收输入。需要澄清时，保存问题和会话 ID 并返回 `2`。可在同一电脑的交互终端使用 `--resume SESSION_ID` 回答后继续，恢复时不要加 `-p`，无需重复传入 PRD。

工作簿、大纲、会话和截图附件保存在本机；控制台保留任务状态和费用，不提供新的执行过程下载。


## 常见错误

生成过程中，模型请求遇到临时网络错误或服务繁忙时会自动重试最多 3 次，并保留已完成的分析、澄清回答和工具结果。交互终端显示重试进度；重试仍失败时显示具体错误原因。重试可能增加模型费用。

- `--prd` 文件不存在、不是普通文件，或不是 `.md` / `.markdown`。
- `--rule` 被填写为内联文本，或者文件不存在、不是普通文件、格式不是 `.md` / `.txt`、内容为空或不是 UTF-8。
- `--xlsx` 指向无法创建的目录，或现有目标不是可替换的普通文件。
- PRD 图片被单独移动，导致 Markdown 中的相对图片路径失效。

可以在控制台/测试用例/测试用例生成页面查看生成记录，开始时间按当前浏览器所在时区显示。

## 相关主题

- [testcase exec](/docs/client/testcase/exec.md)