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 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选项。当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密钥。

调用方法：构造一个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（时间序列）数据，进而渲染生成折线图、桑基图等高级可视化图表。