QoderWake任务报告导出教程 执行结果结构化与可视化指南

完成QoderWake任务后，若在界面未找到完整的报告文件，通常是由于执行结果未被主动触发结构化归档。系统默认会将所有产出物组织为“产物链路”，但获取标准化的报告文档，确实需要手动操作。以下为您详细介绍几种导出任务报告的方法，实现执行结果的结构化输出与数据可视化，便于后续分析与存档。

一、通过Quest独立视窗触发报告导出

Quest视窗是任务运行的核心管理界面，所有任务产出物均汇集于此，并支持一键导出完整报告。此方法适用于Windows、macOS及Linux客户端，操作流程统一。

操作步骤简明：首先，在主界面右上角点击「Quest」按钮，打开独立任务视窗。接着，在左侧任务列表中定位目标任务，并确认其状态为Completed（已完成）或Verified（已验证）。随后，点击该任务右侧的「⋯」更多操作菜单，选择Export Report（导出报告）。在弹出的配置窗口中，可勾选需要包含的报告模块，例如任务摘要、产物链路、验证日志、执行耗时分布图等；若任务包含失败步骤，还可额外勾选失败步骤快照。最后，点击「Generate & Download」，系统将自动打包生成一个ZIP压缩文件，内含JSON格式的元数据、Markdown格式的正文报告以及SVG格式的可视化图表。

二、使用Qoder CLI命令行导出结构化报告

对于偏好命令行操作的开发者，或需要集成至CI/CD流水线的自动化场景，Qoder CLI提供了更精细的控制能力，支持按需筛选输出内容与格式。

具体执行命令如下：打开终端，首先使用qoder login --token [your_token]确保已登录Qoder账户。随后，通过qoder task list --limit 1查询最近一次任务的ID。获取任务ID后，执行核心导出命令：qoder task export --id [task_id] --format json+svg --fields summary,artifacts,validator_log,performance_chart。命令执行成功后，导出文件将保存于当前工作目录，文件夹命名格式为qoder-report-[task_id]，内部包含report.json、report.md以及存放图表的charts/子目录。

三、在QoderWork中联动生成可视化分析报告

若您的QoderWake任务涉及文件处理、数据清洗或表格生成，通过QoderWork接管产出物可实现跨工具的可视化增强分析。此方法需预先在本地完成权限授权与Connector接入配置。

联动操作流程：首先，确保QoderWork已启用「QoderWake Connector」功能，并在设置中勾选Auto-import Wake artifacts（自动导入Wake产物）。当QoderWake任务执行完毕后，启动QoderWork桌面端，进入「Import」标签页。系统将自动识别最新的Wake任务产物，点击对应条目右侧的Visualize as Dashboard按钮。接下来，选择一个预设的分析模板，例如「Code Fix Audit」（代码修复审计）、「Log Analysis Heatmap」（日志分析热图）或「Test Coverage Timeline」（测试覆盖时间线）。最后，点击「Render & Export」，即可生成一份交互式HTML分析报告，该报告支持导出为PDF或静态网页格式，便于长期存档与分享。

四、通过API接口批量获取任务报告数据

针对企业级用户，如需构建内部审计看板或满足合规性存证要求，可直接调用Qoder REST API批量拉取结构化的任务报告数据。使用API需具备团队管理员权限及有效的API Key。

调用方法：构造一个GET请求，地址为GET https://api.qoder.com/v1/tasks/{task_id}/report?include=full&format=structured。请在请求头（Header）中添加必要的认证信息，包括Authorization: Bearer [api_key]和X-Qoder-Workspace-ID: [workspace_id]。API响应体遵循标准JSON Schema，主要包含五大根节点：task_metadata（任务元数据）、execution_trace（执行轨迹）、artifact_list（产物列表）、validation_summary（验证摘要）和performance_metrics（性能指标）。获取数据后，您可使用Chart.js、ECharts等主流图表库，解析performance_metrics中的time_series（时间序列）等字段，进而渲染生成折线图、桑基图等高级可视化图表。