qoderwake支持三种方式设置ai定时任务输出格式：一是通过管理控制台编辑任务脚本添加--format参数；二是通过cli命令qoder task export指定格式及字段；三是数字分析师角色在指令中明确声明格式要求，确保生成文件结构完整、可交付。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake在执行完自动化任务后，按指定格式（如PDF、Excel、PPT、JSON等）直接生成可交付文件，而不是只保留原始日志或中间产物。手动导出或二次转换不仅耗时，还容易遗漏字段、破坏结构或丢失图表渲染效果。
设置AI定时任务的输出格式
该方式适用于通过【自动化】→【AI定时任务】创建的周期性任务，输出格式由指令参数决定，不依赖后续人工操作。
1、登录QoderWake管理控制台，进入【自动化】→【AI定时任务】模块，找到目标任务并点击编辑。
2、在任务脚本区确认已使用/report或类似指令，并在其后添加--format参数：例如/report weekly --format=pdf、/analyze sales --format=xlsx、/summary --format=json+svg。
3、支持的格式值必须严格匹配系统识别词：【pdf、xlsx、pptx、json、md、svg、zip】，大小写敏感；组合格式如json+svg需用英文加号连接，中间无空格。
4、保存任务后，下次触发将自动按该格式生成文件，输出路径默认为/output/目录，文件名含时间戳与任务标识。
通过CLI命令指定导出格式
当你需要对历史任务做一次性、高精度的格式化导出时，CLI是最可靠的方式，它绕过UI限制，直接调用底层归档引擎。
方法一：导出结构化报告（含元数据+图表）
1、打开终端，执行qoder login --token [your_token]完成认证。
2、运行qoder task list --status completed --limit 5查出最近任务ID，例如TK-20260728-1142。
3、执行导出命令：qoder task export --id TK-20260728-1142 --format json+svg --fields summary,artifacts,performance_chart。
方法二：仅提取原始执行数据（审计/复盘专用）
1、使用jq从runtime.log中筛选关键字段：jq 'select(.event_type == "output_generated") | {timestamp, output_summary, decision_boundary}' /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log > exec_output.json。
2、注意：此命令要求服务器已安装jq，且log路径与agent ID需与实际部署一致，【路径错误将返回空文件，无法回退】。
数字分析师角色的格式绑定配置
该方式专用于“数字分析师”角色生成报表场景，格式选择直接影响Excel公式校验、PPT图表嵌入及Word样式继承能力。
第一步：确认角色已启用并处于就绪状态
1、在QoderWake控制台左侧导航栏选择“数字分析师”角色，右上角状态显示为绿色“Ready”。
第二步：上传数据并输入带格式指令
1、上传CSV或Excel源文件，或填写数据库查询语句。
2、在指令框中明确写出格式要求，例如：“生成含汇总页、明细页与趋势折线图的Excel报表，【保存为xlsx格式，日期列自动识别为datetime类型】”。
3、若需同步生成PPT，必须追加说明：“并调用ppt-gen-skill转为PPT，使用‘数据洞察’模板”。
第三步：验证输出文件结构
1、任务完成后，在/output/目录查找文件名形如report_excel_20260728_1422.xlsx的文件。
2、双击打开，检查所有数值字段是否保留原始小数位数，且工作表中无合并单元格——这是筛选功能可用的前提。
