dootask/resources/ai-kb/zh/howto/system-setting/priority.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
system-setting.priority.howto	任务优先级配置	howto	system-setting	admin	zh	任务优先级 优先级颜色 自定义优先级 改优先级 设置优先级 加一个优先级 优先级天数 紧急程度			需要系统管理员权限（普通用户只能 get 读取）	不能给单个项目自定义独立优先级，全局共享一套 不支持按优先级自动指派负责人 / 自动通知 普通用户调用保存接口会被拒绝（仅 admin）	v1.7.90

任务优先级配置

入口

桌面端：左上角头像 →「系统设置」→「任务优先级」。 对应后端：POST api/system/priority，type=get 读取，type=save 写入（限 admin）。

是什么

全系统共享的优先级清单。每条优先级有名称、颜色、自动截止天数、排序权重。任务创建时下拉里出现的就是这套清单。

字段结构

保存时上传 list 数组，每条形如：

{
  "name": "紧急",
  "color": "#FF4D4F",
  "days": 1,
  "priority": 100
}

• name — 显示名（必填）
• color — Hex 颜色码（用于卡片左边色条 / 标签）
• days — 自动建议截止天数（创建任务时按"今天 + days"预填截止）
• priority — 排序权重，数字越大越靠前

服务端使用 Setting::normalizeTaskPriorityList() 校验并归一化（去重 / 截断 / 字段裁剪），空数组会拒绝。

操作步骤

1. 进入「任务优先级」页
2. 「新增」追加一行 → 填写名称 / 颜色 / 天数 / 权重
3. 拖拽或修改 priority 字段调整顺序
4. 点击「保存」即时生效，所有项目共享

默认数据

首次访问会返回系统默认的优先级（紧急 / 高 / 普通 / 低）。修改后保存即覆盖默认。

不支持

• 不能按项目维度独立配置
• 不支持「按优先级触发自动化规则」
• 删除某个优先级时已经使用它的旧任务仍保留旧名称（不会自动迁移）