先说核心步骤：首先进入Grok控制台，激活调度模块，执行enable-scheduler命令后，系统将自动启动CRON引擎并创建/var/grok/schedule/目录。接着，创建名为sales_api.conf的数据源连接文件，其中必须包含三个关键配置项：url、auth_token和timeout。最后，编写一份daily_sales_report.yaml调度规则，明确指定cron、datasource、output_format及template_id这四项参数。

整个流程的目标非常清晰：让Grok自动替您完成销售数据分析、核心指标计算、趋势图表生成，并在最终输出一份包含封面和页脚的PDF报告——无需再手动导出CSV、拼接图表、逐页制作PDF。

配置Grok定时任务与数据源

第一步：在Grok控制台中开启调度模块。执行enable-scheduler命令，系统将自动加载CRON引擎并初始化/var/grok/schedule/目录。

第二步，创建数据源连接文件sales_api.conf，存放至/var/grok/datasource/目录下。文件内容必须包含url = https://api.sales-corp.com/v2/reports?since={last_run}、auth_token = sk_...以及timeout = 30这三项，缺一不可——尤其是timeout字段，若忘记配置，请求一旦挂起，后续所有任务都会陷入等待。

第三步，编写调度指令文件daily_sales_report.yaml，保存到/var/grok/schedule/。设置cron: "0 8 * * *"（每天早上8点执行一次），datasource: sales_api.conf，output_format: pdf，template_id: sales_summary_v3。模板ID必须与已注册的PDF模板严格对应，否则任务会静默失败——连错误提示都不会给出。

定义PDF报表结构与样式

方法一：使用内置模板编辑器快速定制。

访问https://grok.local:8080/template/editor?tid=sales_summary_v3，直接在浏览器中操作。封面区域可拖入公司Logo的SVG文件，标题字体设置为思源黑体 Bold、字号28pt，副标题通过{{today}}变量自动插入，格式为“YYYY年MM月DD日”。图表区需特别注意：只能插入plotly-html类型的占位符，直接粘贴PNG图片会导致最终PDF导出时该区域变为空白。数据表区建议启用“冻结首行+自动列宽适配”，金额列务必勾选“千分位显示+小数点后两位”，保存后立即生效。

方法二：手动上传LaTeX模板（高级用法）。

将report.tex放入/var/grok/templates/目录。导言区必须包含usepackage{graphicx,geometry,fontspec}和setmainfont{Noto Sans CJK SC}，否则中文会全部显示为方块字符。

触发分析流程并验证PDF输出

先手动执行一次全流程验证：运行grok run --task daily_sales_report。终端输出如果显示[✓] Fetched 142 rows → [✓] Computed YoY/MoM → [✓] Rendered 3 plots → [✓] Sa ved to /output/sales_summary_20260612.pdf，说明所有环节均已通过。然后检查/output/目录下的PDF文件大小，至少应在1.2MB以上——低于此值说明图表未嵌入或字体未打包，需返回模板编辑器重新发布。最后使用pdfinfo /output/sales_summary_20260612.pdf确认元数据中的Producer字段为Grok v4.3.1-pdf-engine，若不是此值，说明调用了降级渲染路径，矢量图表的精度将受到影响。