研究报告生成器

分析技术项目/论文，并生成包含 PDF 导出功能的综合报告。

运行模式

精简模式（默认）

• 文献检索 + 论文分析
• 代码阅读（本地或远程）
• 多轮迭代式报告撰写
• 通过 md2pdf 技能生成 PDF
• 不进行环境搭建或实验运行

完整模式

• 包含精简模式全部功能 +
• Conda/virtualenv 环境搭建
• 依赖项安装
• 实验执行
• 结果分析

使用方法

bash {baseDir}/scripts/research-report.sh 
  --topic "Spatial Forcing" 
  --mode lite 
  --iterations 3 
  --output both

参数说明

工作流程

第一阶段：发现

1. 检索 arXiv 及项目主页
2. 获取相关论文（引用文献 + 参考文献）
3. 识别关键技术与依赖项

第二阶段：分析

1. 读取源代码（若提供了 --project-path）
2. 基于文档/代码分析系统架构
3. 梳理技术栈构成

第三阶段：报告撰写（× 迭代次数）

1. 拟定报告大纲
2. 分章节迭代撰写内容
3. 插入图表（Mermaid / ASCII 图）
4. 优化技术解释表述

第四阶段：导出（仅完整模式）

1. 搭建 conda 环境
2. 安装依赖项
3. 运行实验
4. 将实验结果追加至报告中

第五阶段：PDF 生成

1. 调用 md2pdf 技能
2. 通过 Telegram 发送给用户

输出目录结构

/
├── reports/
│   ├── _report_v1.md
│   ├── _report_v2.md
│   ├── _report_final.md
│   └── _report_final.pdf
├── memory/YYYY-MM-DD.md （追加写入）
└── logs/_research.log

报告模板

生成的报告遵循以下结构：

1. 执行摘要 —— 100 字概览
2. 动机 —— 问题陈述 + 其重要性说明
3. 背景 —— 直观易懂地讲解前置知识
4. 核心方法 —— 结合类比讲解技术细节
5. 代码分析 —— 关键文件逐行解读
6. 实验 —— 实验配置 + 结果（仅完整模式）
7. 故障排查 —— 常见问题及解决方案
8. 参考文献 —— 论文 + 代码仓库 + 文档链接

依赖项

必需依赖：

• pandoc（用于 PDF 导出）
• texlive-xetex（支持 CJK 字体及数学公式）

仅完整模式所需：

• conda / miniconda
• CUDA toolkit（如需 GPU 实验）

集成能力

本技能自动完成以下操作：

• 调用 md2pdf 技能实现 PDF 转换
• 向 memory/YYYY-MM-DD.md 追加记录
• 创建结构化的报告目录

使用示例

精简模式，5 次迭代：

research-report --topic "VGGT" --iterations 5 --mode lite

完整模式，指定本地代码路径：

research-report --topic "Spatial Forcing" 
  --project-path ~/Spatial-Forcing/openvla-SF 
  --mode full 
  --iterations 3

仅输出 PDF：

research-report --topic "OpenVLA" --output pdf

故障排查