# 小样本诉求拆解页生成器
## Before / After
| 场景 | Before | After |
|---|---|---|
| 入口 | 临时回到某个项目目录,手写脚本筛 154 条 | 运行统一命令生成子集复核包 |
| 输出 | 一次性 HTML + CSV,路径和字段靠人工约定 | 固定输出 `analysis/<slug>_明细.csv`、`analysis/<slug>_汇总.csv`、`output/review_pages/<slug>.html` |
| 页面 | 原文可能折叠成一整段,复核成本高 | 默认 user/agent 气泡,支持筛选、搜索、分组和 raw_text 兜底 |
| 校验 | 人工口头确认 | 自动校验条数、桶数、JS 语法和字段缺失 |
### Example command
```bash
python /Users/bytedance/Documents/job-bu/data-analysis-workspace/tools/build_case_subset_review_page.py \
--input /path/to/智能AI_v31_明细表.xlsx \
--filter '一级诉求=="商品创建" and 二级诉求=="信息填写" and 三级诉求=="图片素材相关"' \
--slug 图片素材相关154诉求拆解_2026-05-14_v2 \
--user-text-col 用户原文 \
--agent-text-col 客服回复 \
--summary-col 用户摘要 \
--status-col 是否解决 \
--category-col 主要诉求
```
### Expected result
生成器输出一个可直接打开的 HTML 复核页:左侧显示 9 个诉求桶、每桶数量/占比/解决率;右侧展示 154 条 case 的摘要、对话气泡、原文兜底和筛选控件。命令结束时打印校验结果,例如:`rows=154, groups=9, js_ok=true, missing_dialogue_fallback=2`。