想要高效利用 CodeBuddy 的性能报告导出功能？核心原则是根据实际使用场景选择正确的输出格式。四种导出方式各有所长——SVG 适合团队协同分析，JSON 便于自动化系统接入，PDF/HTML 面向非技术人员阅读，CLI 则直连 CI/CD 流水线。操作本身无需任何额外插件，唯一需要注意的是权限检查和格式匹配，避免导出后无法正常打开。

接下来，我们逐项解析每种导出方式的具体操作与最佳应用场景。

导出标准 SVG 火焰图实现团队协同分析

这是最常见、兼容性最强的导出方式，直接分享给同事或嵌入文档用于技术评审再合适不过：

• 在 IDE 中完成性能分析后，火焰图自动渲染生成，右上角会出现「导出」按钮（图标为 ⬇️ 箭头）
• 点击后默认创建带时间戳的文件（如 profile-20260630-1756.svg），保存路径为 .codebuddy/perf/
• 该 SVG 可直接用浏览器打开，支持缩放、搜索函数名、悬停查看采样占比，无需安装额外工具
• 如需批量处理，可在终端执行：codebuddy --print "导出最近一次火焰图为SVG" -p

导出 JSON 原始采样数据用于自动化处理

当你想把性能数据接入内部监控平台、进行趋势对比或编写自定义分析脚本时，JSON 格式是最佳选择：

• 火焰图加载完成后，在右侧「数据面板」点击「Raw Data」标签页
• 点击「Copy as JSON」一键复制结构化采样数据（包含调用栈、耗时、线程 ID 等字段）
• 或使用 CLI 命令导出到指定路径：codebuddy export-perf --format json --output ./reports/cpu-20260630.json
• 注意：JSON 不含可视化信息，但字段完整，便于 Python / Pandas 二次分析

生成 PDF/HTML 格式的可读性报告

面向产品经理、测试同学等非技术角色，或者归档交付时，PDF 和 HTML 更加友好：

• 在火焰图界面下方，点击「生成摘要报告」按钮（文字链接，非图标）
• 系统自动提取 Top 5 热点函数、调用链深度、采样总时长、对比基线（如有）等关键指标
• 点击「导出为 PDF」或「导出为 HTML」，文件默认保存至项目根目录的 /reports/ 子目录
• HTML 报告支持内联 CSS，离线打开即可看到图表与文字说明，无需服务器支撑

通过 CLI 一键导出并上传到内部存储

最适合集成进构建流水线的场景——例如每次发布前自动归档性能快照，省去手动操作的繁琐：

• 确保已配置 MCP 服务（如内部 MinIO 或 NAS 地址），并在 .codebuddy/config.yaml 中声明 perf_export_target
• 运行命令：codebuddy export-perf --target internal-s3 --tag v2.3.1 --auto-commit
• 该命令会打包 SVG + JSON + HTML 三份报告，打上版本标签，并上传至预设存储位置
• 上传成功后返回唯一 URL，可直接粘贴进 Confluence 或飞书文档