---
id: report.template.howto
title: 自动生成报告模板
type: howto
feature: report
scope: end-user
locale: zh
aliases:
  - 报告模板
  - 自动填充任务
  - 一键生成日报
  - 周报模板
  - 报告怎么自动带任务
related_tools: []
related_pages: []
prerequisites: []
negative:
  - 模板只汇总当前用户负责（owner）的任务，协作任务不入表
  - 已取消（cancel 状态）的任务即使在周期内完成，也不计入「已完成工作」
  - 模板是一次性生成的快照，提交后任务状态再变化不会反映到已保存的报告里
last_verified: v1.7.90
---

# 自动生成报告模板

## 是什么
新建报告时系统调用 `api/report/template` 自动拉取当前用户在选定周期内的任务数据，渲染成三段表格作为草稿。无需手动填表。

## 触发时机
- 选择「周报」或「日报」时自动触发一次
- 切换 `offset`（如选「上周 / 昨天」）时重新生成

## 模板小节
周报模板包含 3 个小节，日报包含 2 个小节：

| 小节 | 周报 | 日报 | 数据来源 |
|---|---|---|---|
| 已完成工作 | 有 | 有 | 周期内 `complete_at` 落在范围内 + 当前用户为 owner，排除 cancel 状态 |
| 本周/今日未完成工作 | 有 | 有 | 周期内有截止时间且未完成的任务；超期红色标注 |
| 下周拟定计划 | 有 | **无** | 下周时间范围内未完成的任务，含计划起止时间 |

## 表格字段
- 项目 / 任务 / 负责人 / 备注
- 周报「已完成」备注列显示完成是「周X」
- 「未完成」备注列：已超期标红「[超期]」

## 不支持
- 协作任务不出现在表中（只汇总你为负责人的）
- 取消态任务不计入已完成
- 模板内容生成后是静态 HTML，事后不会随任务状态自动更新

## 想让 AI 进一步润色
可让 AI 助手生成更高质量的草稿 → [[report.ai-generate.howto]]