dootask/resources/ai-kb/zh/faq/common-faq/ai-no-models.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
common-faq.ai-no-models.faq	AI 助手没有可用模型	faq	common-faq	end-user	zh	没有模型 模型为空 AI 用不了 找不到 AI AI 不响应 模型下拉空		ai_assistant_panel		DooTask 主程序不内置任何 AI 模型，必须靠 ai 插件接外部供应商 配好模型不代表立即能用——还需在「AI 机器人」选定默认模型 普通用户看不到模型管理页面，只能等管理员配置	v1.7.90

AI 助手没有可用模型

问题

点开 AI 助手浮窗或在任务详情用「智能拆解」「AI 报告」时，模型选择下拉为空、或者直接提示「未配置 AI 模型」「AI 服务不可用」。

原因

DooTask 的 AI 能力由独立的 ai 插件（dootask-ai）提供。下面任一未到位都会无可用模型：

1. 应用市场没装 ai 插件：主程序没自带 AI 容器，必须从插件市场安装
2. 插件装了但没配模型：插件需要在「系统设置 → AI 设置」里加供应商（OpenAI / Anthropic / 通义 / 豆包 / 智谱 / DeepSeek 等）+ API Key
3. 配了供应商但没勾默认模型：系统设置 → AI 机器人 → 默认模型为空时全员无法用
4. API Key 过期 / 余额不足：供应商侧失效会让请求 401/402，前端表现为「模型不可用」
5. dootask-ai 容器异常：插件容器 crash 或网络问题，/ai/* 路由 502

解决

1. 让管理员到 appstore.install.howto 装 ai 插件
2. 让管理员到 system-setting.ai-model.howto 配供应商和模型
3. 让管理员到 system-setting.ai-bot.howto 勾选默认模型
4. 自己试一下不行 → 管理员到对应供应商后台看 API Key 是否有效、余额够
5. 管理员排查容器：docker ps | grep dootask-ai；docker logs dootask-ai

不支持

• 普通用户不能自己加 API Key（只能管理员）
• 主程序不能跳过 ai 插件直连模型
• 一次只能选一个默认模型作为系统主模型

更多 AI 助手能力见 ai-assistant.entry.howto / ai-assistant.tools-list.concept