research-report

1# Research Report - 汇总报告
2 
3## 触发方式
4`/research-report`
5 
6## 执行流程
7 
8### Step 1: 定位结果目录
9在当前工作目录查找 `*/outline.yaml`，读取topic和output_dir配置。
10 
11### Step 2: 扫描可选摘要字段
12读取所有JSON结果，提取适合在目录中显示的字段（数值型、简短指标），例如：
13- github_stars
14- google_scholar_cites
15- swe_bench_score
16- user_scale
17- valuation
18- release_date
19 
20使用AskUserQuestion询问用户：
21- 目录中除了item名称外，还需要显示哪些字段？
22- 提供动态选项列表（基于实际JSON中存在的字段）
23 
24### Step 3: 生成Python转换脚本
25在 `{topic}/` 目录下生成 `generate_report.py`，脚本要求：
26- 读取output_dir下所有JSON
27- 读取fields.yaml获取字段结构
28- 覆盖每个JSON的所有字段值
29- 跳过值包含[不确定]的字段
30- 跳过uncertain数组中列出的字段
31- 生成markdown报告格式：目录（带锚点跳转+用户选择的摘要字段）+ 详细内容（按字段分类）
32- 保存到 `{topic}/report.md`
33 
34**目录格式要求**：
35- 必须包含每一个item
36- 每个item显示：序号、名称（锚点链接）、用户选择的摘要字段
37- 示例：`1. [GitHub Copilot](#github-copilot) - Stars: 10k | Score: 85%`
38 
39#### 脚本技术要点（必须遵循）
40 
41**1. JSON结构兼容**
42支持两种JSON结构：
43- 扁平结构：字段直接在顶层 `{"name": "xxx", "release_date": "xxx"}`
44- 嵌套结构：字段在category子dict中 `{"basic_info": {"name": "xxx"}, "technical_features": {...}}`
45 
46字段查找顺序：顶层 -> category映射key -> 遍历所有嵌套dict
47 
48**2. Category多语言映射**
49fields.yaml的category名与JSON的key可能是任意组合（中中、中英、英中、英英）。必须建立双向映射：
50```python
51CATEGORY_MAPPING = {
52    "基本信息": ["basic_info", "基本信息"],
53    "技术特性": ["technical_features", "technical_characteristics", "技术特性"],
54    "性能指标": ["performance_metrics", "performance", "性能指标"],
55    "里程碑意义": ["milestone_significance", "milestones", "里程碑意义"],
56    "商业信息": ["business_info", "commercial_info", "商业信息"],
57    "竞争与生态": ["competition_ecosystem", "competition", "竞争与生态"],
58    "历史沿革": ["history", "历史沿革"],
59…