mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
---
|
||
id: system-setting.priority.howto
|
||
title: 任务优先级配置
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 任务优先级
|
||
- 优先级颜色
|
||
- 自定义优先级
|
||
- 改优先级
|
||
- 设置优先级
|
||
- 加一个优先级
|
||
- 优先级天数
|
||
- 紧急程度
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限（普通用户只能 get 读取）
|
||
negative:
|
||
- 不能给单个项目自定义独立优先级，全局共享一套
|
||
- 不支持按优先级自动指派负责人 / 自动通知
|
||
- 普通用户调用保存接口会被拒绝（仅 admin）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 任务优先级配置
|
||
|
||
## 入口
|
||
桌面端：左上角头像 →「系统设置」→「任务优先级」。
|
||
对应后端：`POST api/system/priority`，`type=get` 读取，`type=save` 写入（限 admin）。
|
||
|
||
## 是什么
|
||
全系统共享的优先级清单。每条优先级有名称、颜色、自动截止天数、排序权重。任务创建时下拉里出现的就是这套清单。
|
||
|
||
## 字段结构
|
||
保存时上传 `list` 数组，每条形如：
|
||
|
||
```json
|
||
{
|
||
"name": "紧急",
|
||
"color": "#FF4D4F",
|
||
"days": 1,
|
||
"priority": 100
|
||
}
|
||
```
|
||
|
||
- **name** — 显示名（必填）
|
||
- **color** — Hex 颜色码（用于卡片左边色条 / 标签）
|
||
- **days** — 自动建议截止天数（创建任务时按"今天 + days"预填截止）
|
||
- **priority** — 排序权重，数字越大越靠前
|
||
|
||
服务端使用 `Setting::normalizeTaskPriorityList()` 校验并归一化（去重 / 截断 / 字段裁剪），空数组会拒绝。
|
||
|
||
## 操作步骤
|
||
1. 进入「任务优先级」页
|
||
2. 「新增」追加一行 → 填写名称 / 颜色 / 天数 / 权重
|
||
3. 拖拽或修改 `priority` 字段调整顺序
|
||
4. 点击「保存」即时生效，所有项目共享
|
||
|
||
## 默认数据
|
||
首次访问会返回系统默认的优先级（紧急 / 高 / 普通 / 低）。修改后保存即覆盖默认。
|
||
|
||
## 不支持
|
||
- 不能按项目维度独立配置
|
||
- 不支持「按优先级触发自动化规则」
|
||
- 删除某个优先级时已经使用它的旧任务仍保留旧名称（不会自动迁移）
|