npm package: @fleetsnowfluff/get-reports-done
Description: Multi-agent deep research system for AI coding assistants - CLI toolchain, session state management, 5 runtime support (Claude Code, OpenCode, Gemini CLI, Codex CLI, Copilot), verification & HTML visualization
Author: getui
Latest version: 1.2.2

# @getui/get-reports-done

🔬 GSD-style multi-agent research system for Claude Code. Deep research with templates & HTML visualization.

**原名称**: Deep Research Plugin for Claude Code

## 特性

- **多 Agent 协作**: 研究 Agent + 分析 Agent + 撰写 Agent + 可视化 Agent
- **并行执行**: 多个研究任务同时进行
- **质量保障**: 交叉验证、信息分级（T1-T4）、来源追溯
- **多种模板**: 标准报告、学术论文、投资分析
- **HTML 可视化**: 响应式布局 + 数据图表（Chart.js）
- **快速模式**: 5-10 分钟完成主题速查
- **GSD 风格**: 熟悉的命令结构和工作流程

## 安装

```bash
npx @getui/get-reports-done@latest
```

## 使用

### 深度研究（research:deep）

#### 基础用法

```bash
/research:deep "electric vehicle market in China"
```

#### 高级选项

```bash
# 自动模式（跳过确认提示）
/research:deep "AI trends 2025" --auto

# 深度研究（4-6轮搜索）
/research:deep "quantum computing" --depth deep

# HTML 可视化报告
/research:deep "competitor analysis" --format html

# 学术论文模板
/research:deep "large language models" --template academic

# 投资分析模板
/research:deep "Tesla stock analysis" --template investment

# 组合使用
/research:deep "blockchain applications" \
  --auto \
  --depth deep \
  --format html \
  --template investment
```

### 快速研究（research:quick）

5-10 分钟完成主题速查，适合：
- 会议前的背景速查
- 快速了解新概念/技术
- 验证假设

```bash
# 标准快速研究
/research:quick "React Server Components"

# 纯摘要格式
/research:quick "WebAssembly" --template summary

# 要点列表格式
/research:quick "Rust vs Go" --template bullet
```

## 输出结构

### 深度研究输出

```
.research/
└── {topic-slug}-{timestamp}/
    ├── step_01_background.md   # 背景研究
    ├── step_02_market.md       # 市场数据
    ├── step_03_players.md      # 主要玩家
    ├── step_04_tech.md         # 技术方案（深度模式）
    ├── step_05_trends.md       # 趋势分析（深度模式）
    ├── 02-ANALYSIS.md          # 综合分析
    ├── 03-REPORT.md            # 最终报告（Markdown）
    └── 03-REPORT.html          # 可视化报告（HTML，如果请求）
```

### 快速研究输出

```
.research/
└── quick-{topic-slug}-{timestamp}.md
```

## 报告模板

### 1. standard（标准报告）

通用研究报告格式，适合大多数场景。

**结构:**
- 执行摘要
- 引言（背景、范围、方法）
- 主体内容（5-8 个章节）
- 结论与建议
- 参考资料

### 2. academic（学术论文）

适合学术研究、文献综述、理论分析。

**结构:**
- 摘要 (Abstract)
- 引言 (Introduction)
- 文献综述 (Literature Review)
- 研究方法 (Methodology)
- 研究结果 (Results)
- 讨论 (Discussion)
- 结论 (Conclusion)
- 参考文献

### 3. investment（投资分析）

适合公司研究、行业投资分析、估值报告。

**结构:**
- 执行摘要（投资建议、目标价）
- 公司/行业概况
- 市场分析（TAM/SAM/SOM）
- 竞争格局
- 财务分析
- 估值分析
- 风险评估
- 投资建议

## HTML 可视化特性

当使用 `--format html` 时，生成的报告包含：

- 📱 **响应式布局**: Bootstrap 5，支持桌面/平板/手机
- 📊 **数据图表**: Chart.js 自动将表格转为交互式图表
- 🎨 **现代设计**: 渐变 Hero、卡片式布局、侧边导航
- 🖨️ **打印优化**: 专业的打印样式
- ⚡ **CDN 加速**: 使用 CDN 引入依赖，无需本地安装

## 架构

```
/research:deep (Command)
    ↓
Orchestrator (主控制器)
    ↓
├─→ dr-local-researcher (扫描本地工作区，生成 T0 资料)
    ↓
├─→ dr-researcher (并行执行多个，优先使用本地 T0)
    ↓
dr-analyst (分析综合)
    ↓
dr-writer (生成 Markdown 报告)
    ↓
dr-visualizer (生成 HTML 可视化) [if --format html]

/research:quick (Command)
    ↓
├─→ dr-local-researcher (快速扫描本地)
    ↓
Single dr-researcher (2-3 searches，优先本地 T0)
    ↓
Inline analysis & output
```

## 项目结构

```
deep-research-cc/
├── bin/
│   └── install.js                   # 安装脚本
├── commands/
│   └── research/
│       ├── deep.md                  # /research:deep 命令
│       └── quick.md                 # /research:quick 命令
├── agents/
│   ├── dr-researcher.md             # 研究 Agent
│   ├── dr-local-researcher.md       # 本地文件研究 Agent
│   ├── dr-analyst.md                # 分析 Agent
│   ├── dr-writer.md                 # 撰写 Agent
│   └── dr-visualizer.md             # 可视化 Agent
├── deep-research/
│   ├── workflows/
│   │   ├── deep-research.md         # 深度研究工作流
│   │   └── quick-research.md        # 快速研究工作流
│   ├── templates/
│   │   ├── report.md                # 标准报告模板
│   │   ├── analysis.md              # 分析模板
│   │   ├── academic-paper.md        # 学术论文模板
│   │   └── investment-analysis.md   # 投资分析模板
│   └── references/
│       └── research-methods.md      # 研究方法参考
└── package.json
```

## 信息质量分级

| 等级 | 来源类型 | 可信度 | 示例 |
|------|---------|--------|------|
| **T0** | 当前 workspace 本地文件 | ⭐⭐⭐⭐⭐ | 项目文档、数据文件、Markdown 笔记 |
| **T1** | 官方文档、政府数据、上市公司财报 | ⭐⭐⭐⭐⭐ | SEC filings, 政府统计局 |
| **T2** | 权威媒体、研究机构 | ⭐⭐⭐⭐⭐ | Reuters, Gartner, McKinsey |
| **T3** | 知名博客、行业媒体 | ⭐⭐⭐⭐ | TechCrunch, Wired |
| **T4** | 论坛、社交媒体 | ⭐⭐⭐ | Reddit, Twitter |

**规则:** 关键决策必须基于 T0-T2 来源。优先使用本地 T0 资料。

## 与 GSD 的关系

| 特性 | GSD | Deep Research |
|------|-----|---------------|
| 目标 | 软件开发 | 信息研究 |
| 产物 | PLAN.md → 代码 | RESEARCH.md → 报告 |
| 周期 | 多阶段长期 | 单任务短期 |
| 目录 | `.planning/` | `.research/` |
| Agent 数量 | 10+ | 5 |

## 触发关键词

以下关键词会自动触发此技能：

- 深度调研
- 市场分析
- 行业研究
- 技术报告
- 竞品分析
- 投资研究
- 趋势分析
- 可行性研究
- 尽职调查
- landscape analysis

## 对比：Deep vs Quick

| 特性 | research:deep | research:quick |
|------|---------------|----------------|
| 时间 | 30-60 分钟 | 5-10 分钟 |
| 深度 | 4-6 轮搜索 | 2-3 轮搜索 |
| 验证 | 交叉验证 | 快速确认 |
| 分析 | 专门分析阶段 | 内联合成 |
| 模板 | 支持 | 基础格式 |
| HTML | 支持 | 不支持 |
| 适用 | 重要决策 | 快速了解 |

## License

MIT