mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
---
|
||
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]]
|