调研可视化报告生成器 · Info Research Visualizer
> 调研靠 Ctrl+C/V 太散、结论难读、分享靠截图？
> 一句话把任何主题变成咨询级可视化报告——搜索 → 结构化 → SVG 架构图 → 单文件 HTML，浏览器直接打开分享。
它能帮你做什么
| 场景 | 输入 | 产出 |
|---|---|---|
| 行业/竞品调研 | "调研一下 XX 行业" | 带架构图+对比表的可视化报告 |
| 技术选型 | "对比 A 和 B 方案" | 多维对比矩阵 SVG |
| 概念科普 | "讲讲 XX 是什么" | 定义→原理→演进的结构化长文 |
| 知识梳理 | "整理 XX 的资料" | 单文件 HTML，可浏览器直开 |
核心差异化：不是只给你一段提示词，而是跑完「搜→理→画→生成」整条流水线，直接交付一个能打开、能分享、能归档的 HTML 文件（SVG 全部内嵌，零外部依赖）。
触发条件
用户输入包含以下意图时激活（中英文均可）：
- "帮我调研一下 XXX" / "做个 XXX 的调研"
- "整理一下 XXX 的信息" / "整理 XXX 的资料"
- "出个 XXX 的可视化报告" / "做个 XXX 的研究报告"
- "深度调研 XXX" / "详细分析 XXX"
- "分析 XXX 并画个架构图" / "XXX 竞品对比"
- "XXX 行业分析" / "XXX 市场调研"
- "research XXX" / "visualize XXX" / "make a report on XXX"
工作流程
Phase 1 — 信息搜集
- 解析用户输入：提取调研主题、深度要求、输出路径偏好。
- 判断搜索深度：
- 标准模式（默认）：2-3 轮 WebSearch，抓取 3-5 个关键页面。
- 深度模式（用户说"深度/详细/全面"等）：4-6 轮 WebSearch，用query_keyword_groups做多角度搜索，抓取 6-10 个页面。 - 执行搜索：
- 用WebSearch做关键词搜索，覆盖中英文。
- 从搜索结果中筛选最相关的 3-10 个 URL。
- 用WebFetch逐个抓取，提取核心内容。 - 可选补充：如果用户提供了本地文件路径，用 Read 工具读取补充。
- 空结果处理（鲁棒性）：若 WebSearch 返回为空或极少量结果，明确告知用户「未检索到足够信息」，并建议更换关键词或缩小范围；绝不编造数据或来源。
Phase 2 — 信息整理与结构化
- 提炼一句话结论：用 2-4 行浓缩核心观点，回答"这东西到底是什么 / 为什么重要"。
- 梳理章节大纲：根据搜集到的信息动态决定章节结构（不套固定模板）。
- 技术类 → 可能是"架构 / 核心能力 / 代码示例 / 对比 / 生态"
- 产品类 → 可能是"定位 / 功能矩阵 / 竞品对比 / 适用场景"
- 概念类 → 可能是"定义 / 原理 / 类比 / 演进 / 争议" - 填充各章节内容：每章节用最合适的展示形式（表格 / 列表 / 代码块 / 提示框）。
- 标注信息来源：记录所有引用的 URL 和出处。
Phase 3 — 可视化输出
3.1 生成 SVG 架构图
根据调研内容自动选择最合适的图表类型，不限于固定类型：
| 内容特征 | 推荐图表类型 | 说明 |
|---|---|---|
| 分层结构、系统组成 | 架构图（分层方块） | 展示组件层次和包含关系 |
| 步骤链路、数据流 | 流程图（有向箭头） | 展示流程走向和依赖 |
| 多方案、多维度对比 | 对比矩阵（表格化） | 横纵交叉对比 |
| 时间线、版本演进 | 时序图 / 时间轴 | 按时间排列事件 |
| 实体关联、依赖关系 | 关系图（节点 + 连线） | 展示网状关系 |
| 层级包含 | 结构图（嵌套容器） | 外层包含内层 |
一个报告可以有多张 SVG，按内容需要生成，不强制只画一张。
SVG 绘制规范详见 references/svg_guide.md。
3.2 组装 HTML 报告
关键原则：SVG 必须内嵌（inline <svg>），不使用外部文件引用。
这样输出的单文件 HTML 即可完整展示，无需依赖额外文件。
HTML 报告的固定骨架（内容灵活，骨架固定）：
┌─ 标题区 ──────────────────────────────┐
│ 报告标题 + 元数据（日期 · 来源说明） │
├─ 结论卡片 ────────────────────────────┤
│ 一句话结论（2-4 行核心观点） │
├─ SVG 区 ──────────────────────────────┤
│ inline <svg> 架构图（可多张） │
├─ 正文章节 ────────────────────────────┤
│ 章节一...（表格/列表/代码/提示框） │
│ 章节二... │
│ ...（章节数量和标题由内容决定） │
├─ 资料来源 ────────────────────────────┤
│ 引用的 URL 和出处列表 │
└───────────────────────────────────────┘
HTML 模板和样式规范详见 references/html_template.md。
3.3 输出位置（纯通用模式）
为兼容所有用户环境，本技能不依赖 Obsidian 或任何特定资料库结构。
- 若用户指定了输出目录 → 写入该目录。
- 否则 → 写入当前工作目录（cwd），文件名
{YYYY-MM-DD}_{主题名}.html。 - 落位后输出一行提示：「📁 报告已生成：{路径}」。
- 如用户希望接入自己的资料库自动归位，可参考原版
info-research-visualizer的域路由能力自行扩展。
3.4 输出质检（鲁棒性，强制）
生成完毕后，自检报告必须满足以下最低标准，缺一项则补全后再交付：
- ✅ 包含 ≥1 张 inline SVG 架构图（非装饰，有信息量）
- ✅ 包含结论卡片（一句话核心观点）
- ✅ 底部列出资料来源（URL + 出处）
- ✅ 单文件、CSS 内联、SVG 内嵌，浏览器可直接打开
输出后用 present_files 工具展示给用户。
执行要点
- 搜索质量优先：不要只搜一轮就动手。至少 2 轮搜索，交叉验证信息准确性。
- 内容驱动结构：章节结构由搜集到的信息决定，不要硬套模板。
- SVG 要有信息量：架构图不是装饰，要传递正文难以表达的系统全貌。
- 配色一致：HTML 和 SVG 共用蓝色系主色（
#2563eb），保证视觉统一。 - 单文件原则：所有 CSS 内联、SVG 内嵌，一个
.html文件即可打开分享。 - 标注来源：每个关键信息点尽量标注出处，底部统一列出资料来源。
- 不编造：搜索无果时如实告知，绝不用虚构数据填充报告。
参考文件
references/html_template.md— HTML 报告完整模板、CSS 样式规范、组件用法references/svg_guide.md— SVG 图表类型选择指南、绘制规范、配色方案
更新日志
v1.0.0（2026-08-06）
- 首发上架版本
- 品牌化：中文展示名「调研可视化报告生成器」+ 痛点定位句
- 触发词扩写：覆盖口语化中英文表达
- 改为纯通用输出模式（去除 Obsidian/资料库硬依赖），适配所有用户
- 新增鲁棒性：空搜索结果处理、输出质检清单
- 补全元信息：version / author / license / tags / pricing / homepage
