dootask/resources/ai-kb/zh/howto/system-setting/ai-model.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.ai-model.howto	AI 模型配置	howto	system-setting	admin	zh	配置 AI 配置模型 接入 OpenAI 接入 Claude 接入豆包 AI 接入 添加 AI 供应商 AI 模型设置 接入大模型			需要系统管理员权限 应用商店（应用市场）已安装并启用 ai 插件	配置入口不在「系统设置」菜单，而在「AI 助手」应用内的设置面板（仅管理员可见） v1.4.35 起旧接口 setting__ai 已废弃，AI 模型配置全部迁移到 AI 助手应用的设置面板 不安装 ai 插件，「AI 助手」应用不出现	v1.7.90

AI 模型配置

现状

DooTask 的 AI 能力由独立的 ai 插件（dootask-ai）提供。系统设置里历史上有过「AI 设置」接口（setting__ai），从 v1.4.35 起已废弃，仅保留路由占位。

实际的模型供应商、API Key、Base URL 等配置在 「AI 助手」应用内的设置面板（仅管理员可见），保存走 api/system/setting/aibot 接口。

入口

桌面端：左侧栏「应用」→「AI 助手」应用 → 点某个 AI 机器人（供应商）卡片上的设置按钮，打开该供应商的设置面板。需安装 ai 插件且当前用户是系统管理员。

操作步骤

1. 管理员在应用商店安装并启用 ai 插件（生成 dootask-ai 容器）
2. 打开「AI 助手」应用，选择要配置的供应商（ChatGPT/OpenAI、Claude、DeepSeek、Gemini、Grok、Ollama、智谱、通义千问、文心一言等）
3. 在设置面板填写：API Key、模型列表（一行一个模型名，可点「使用默认模型列表」一键填入）、默认模型、Base URL（可选）、代理（可选）、Temperature、默认提示词
4. 保存后该供应商的模型立即可在 AI 对话中选用，并可被 system-setting.ai-bot.howto 的「AI 机器人」使用

与其他模块的关系

• 提供模型给 system-setting.ai-bot.howto 的默认模型选择
• 「AI 整理汇报」、AI 助手浮窗等都依赖此处配置
• 客户端调用走 /ai/* 路由，由插件容器处理

不支持

• DooTask 主程序不内置任何模型，必须依赖 ai 插件
• 配置入口不在「系统设置」菜单（v1.4.35 起旧入口废弃），在「AI 助手」应用内
• 普通成员打开设置面板会提示仅管理员可操作
• 不支持自动测试模型是否可用，需要保存后到对话窗口实际试用