mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
66 lines
2.4 KiB
Markdown
66 lines
2.4 KiB
Markdown
---
|
||
id: system-setting.auto-archive.howto
|
||
title: 任务自动归档设置
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 任务自动归档怎么开
|
||
- 完成后自动归档
|
||
- 归档天数怎么改
|
||
- auto_archived
|
||
- archived_day
|
||
- 归档了能恢复吗
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 部署环境变量 SYSTEM_SETTING 不为 disabled
|
||
related_tools: []
|
||
related_pages: []
|
||
negative:
|
||
- 归档天数限制 1-100 天，超出范围保存时报错
|
||
- 子任务不会被独立归档，只看顶层任务（parent_id = 0）
|
||
- 项目自身若设了"自定义归档"（archive_method=custom），系统级开关对该项目不生效
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 任务自动归档设置
|
||
|
||
## 入口
|
||
桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「任务相关」→「自动归档」。
|
||
|
||
涉及字段：
|
||
- `auto_archived` — 开关：`open` / `close`，默认 `close`
|
||
- `archived_day` — 任务完成多少天后归档，默认 7，允许 1-100
|
||
|
||
## 触发条件
|
||
后台 `AutoArchivedTask` 定时跑，每次抓最多 100 条满足条件的任务进行归档。条件如下：
|
||
|
||
1. `auto_archived = 'open'`（系统开关打开）
|
||
2. 任务有 `complete_at`（已完成）
|
||
3. 完成时间距今 ≥ `archived_day` 天
|
||
4. 任务尚未归档（`archived_at` 为空、`archived_userid = 0`）
|
||
5. 任务是顶层任务（`parent_id = 0`，子任务不单独归档）
|
||
6. 所属项目的 `archive_method` 不是 `custom`（自定义归档的项目走自己的规则）
|
||
|
||
## 字段默认值
|
||
|
||
| 字段 | 默认 | 范围 |
|
||
|---|---|---|
|
||
| `auto_archived` | `close` | open / close |
|
||
| `archived_day` | 7 | 1-100，超出报错"自动归档时间不可大于100天" |
|
||
|
||
## 能不能恢复
|
||
能。归档不是删除：归档任务在项目「已归档」列表里仍可查看、撤销归档（恢复到原列）、或彻底删除。归档动作只是设置 `archived_at` 时间戳与 `archived_userid`。
|
||
|
||
## 操作步骤
|
||
1. 进入「系统设置」→「系统设置」→「任务相关」
|
||
2. 「自动归档」选「开启」
|
||
3. 在出现的输入框填天数（默认 7，1-100 之间）
|
||
4. 「提交」保存，下次定时任务执行时按新规则归档
|
||
|
||
## 不支持
|
||
- 不支持按项目 / 任务类型差异化归档天数（除非项目自己开 custom）
|
||
- 不支持"归档后 N 天自动删除"二级规则
|
||
- 关闭开关不会自动撤销已归档任务
|