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

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

id	title	type	feature	scope	locale	aliases	prerequisites	related_tools	related_pages	negative	last_verified
system-setting.task-ai-analyze.howto	AI 任务自动分析设置	howto	system-setting	admin	zh	AI 任务分析怎么开 自动分析任务 task_ai_auto_analyze 关闭 AI 自动分析 AI 自动建议 新建任务自动分析	需要系统管理员权限 应用市场已安装 ai 插件 部署环境变量 SYSTEM_SETTING 不为 disabled			未安装 ai 插件时，分析逻辑直接跳过，不会有任何产出 系统开关 = open 但项目级开关 = close 时，该项目的任务也不会被分析 不会回溯分析历史任务，只对新建后进入待分析队列的任务生效	v1.7.90

AI 任务自动分析设置

入口

桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「任务相关」→「AI任务分析」。

字段名：task_ai_auto_analyze，开关枚举 open / close，默认 open。

触发时机

后台 AiTaskLoopTask 循环任务执行时：

1. 先检查 ai 插件是否安装；未装直接返回
2. 检查系统级开关 task_ai_auto_analyze；为 close 直接返回
3. 拉取待处理新任务
4. 对每个任务再检查项目级开关 ai_auto_analyze；为 close 则跳过
5. 投递异步任务 AiTaskAnalyzeTask 进行分析

也就是说有 三道闸：插件已装 → 系统开关 open → 项目开关 open，三者全满足才会真正调用 AI。

产出

分析完成后，AI 会在任务详情面板给出建议（如优先级、负责人、子任务拆分建议等），不会自动改任务字段，只是"建议"形式的辅助信息。

字段默认值

字段	默认
task_ai_auto_analyze	open

操作步骤

1. 确认应用市场已安装 ai 插件
2. 进入「系统设置」→「系统设置」→「任务相关」
3. 「AI任务分析」选「开启」或「关闭」
4. 「提交」保存，立即生效

不支持

• 不能选用哪个模型做分析（用 AI 插件配置的默认模型）
• 不支持对特定项目"豁免"或单独配额
• 系统开关关闭后历史已分析结果保留，但不会刷新