AI 统一配置
AI 统一配置
AI 统一配置用于集中管理 AI 写作/翻译接口、AI 助手接口,以及 MCP 开放接口的权限与安全策略。
入口路径
后台顶部菜单 →「设置」→「AI统一配置」。实际地址:/system/setting/ai,需要管理员权限(canAdmin)。
功能说明
页面分为「AI接口配置(写作/翻译)」「AI接口配置(AI助手)」「MCP 开放接口」三个标签页。MCP 开放后,第三方 AI 客户端(Claude Desktop、Cursor、Cherry Studio 等)可通过 MCP 协议调用本站的意图工具。
界面截图
MCP 开放接口配置(含开放范围、调用身份、工具清单):

设置项说明
AI接口配置(写作/翻译)
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| AI写作来源 | 写作/翻译使用的接口 | radio:官网 / openai / deepseek / spark(星火) |
默认用官网;自有密钥选 OpenAI/DeepSeek;国内可选星火 | 非官网接口为 VIP 功能;需服务器能访问对应 API |
| 自定义API地址 | 自定义 OpenAI 兼容端点 | 文本;OpenAI 默认 https://api.openai.com/v1、DeepSeek https://api.deepseek.com [i18n] |
按引擎默认值填写 | 仅写作来源为 openai/deepseek 时显示 |
| 自定义模型 | 调用的模型名 | 文本;OpenAI 默认 gpt-3.5-turbo、DeepSeek deepseek-chat [i18n] |
按账户可用模型填写 | 同上联动 |
| API Keys | 接口密钥 | 标签式可添加多个,sk- 开头 [源码+i18n] |
每次随机选一个 key | 敏感信息,注意保管 |
| 星火大模型版本 | 讯飞星火版本 | radio:1.5 / 3.0 / 3.5 / 4.0 [源码] | 按开通的版本选 | 仅写作来源为 spark 时显示 |
| APPID / APISecret / APIKey | 星火认证参数 | 文本,无默认 [源码] | 从讯飞开放平台获取 | 同上联动 |
AI接口配置(AI助手)
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 接口名称 | 自定义接口标识 | 文本,必填 [源码] | 如「DeepSeek 生产」 | — |
| API 地址 | 接口 base URL | 文本,必填,如 https://api.openai.com/v1 [源码] |
填兼容 OpenAI 协议的地址 | — |
| API Key | 接口密钥 | 文本,必填,sk- 开头 [源码] |
— | 敏感信息 |
| 模型 | 模型名 | 文本,必填,如 deepseek-v4-flash [源码] |
— | — |
| 思考模式 | 是否开启推理 | radio:开启 / 关闭;新增默认开启 [源码] | 需要深度推理时开启 | — |
| **回复长度 | max_tokens | 数字,默认 8192 [源码] | 按模型上限设置 | — |
| 请求超时时间 | 超时秒数 | 数字,默认 120 [源码] | 网络慢可增大 | — |
MCP 开放接口
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 启用 MCP 开放接口 | 总开关 | switch,默认关闭 [源码] | 需要第三方 AI 调用时开启 | 空 Token 时可用但鉴权失效,见下方 |
| 鉴权 Token | Bearer 凭证 | 文本,点「生成随机 Token」生成 32 位;空则禁用鉴权 [源码] | 点击生成,不要手工写 | 第三方需在 Header 带 Authorization: Bearer {token} |
| 速率限制(次/分钟) | 每分钟调用上限 | 数字,默认 0(不限)[源码+实测] | 按服务器能力设置 | 0 不限,警惕滥用 |
| 接口调用身份 | AI 以哪个管理员身份调用接口 | select,必填,0=不开放;首次默认选**位管理员 [源码+实测] | 务必选权限受控的专用管理员,不要依赖默认超管 | 选 0 则 AI 无法调用任何后台接口 |
| 接口开放范围 | AI 可访问的数据范围 | select:关闭 / 只读 / 读+写(默认推荐)/ 全部;前端默认 read_write [源码+实测] |
起步用「只读」,需要写入再升「读+写」 | 「全部」含删除,谨慎开启;Go 零值为关闭 |
| 接口白名单 | 只允许访问的模块 | 文本,多个用英文逗号分隔,留空不限 [源码] | 如 archive, category |
前缀匹配;仍受开放范围约束 |
| 接口黑名单 | 禁止访问的模块 | 文本,多个用英文逗号分隔 [源码] | — | 优先级高于白名单 |
| 禁止访问的接口 | 硬禁止的具体接口 | 文本,格式 METHOD /path,可省略 /system/api 前缀 [源码] |
如 POST /archive/detail |
优先级** |
| 允许使用的工具 | 意图级工具白名单 | 文本,留空开放全部默认工具;* 开放含高危工具;可填域名如 content/seo [源码] |
起步留空,需要时按域名或具体意图授权 | 备份/升级/删除等默认不开放,需手动加入 |
配置项详解
接口调用身份(安全关键)
出现条件:MCP 标签页始终显示 [实测]。
源码默认在 !token && !invoke_admin_id 时自动选中**位管理员(通常是超级管理员)[源码]。Go 注释明确警告:隐式回落到超级管理员等于发放**钥匙,应显式指定权限受控的专用管理员 [源码]。
推荐值:专门创建一个低权限管理员账号用于 AI 调用,不选超管。
填错后果:用超管身份开放写权限,AI 可能误删或误改全站数据。
接口开放范围(四档)
出现条件:始终显示 [实测]。
| 取值 | 含义 |
|---|---|
off |
关闭,AI 不能访问数据 |
read |
只读,仅查看 |
read_write |
读+写,可新增/修改,但仍拒绝破坏性操作(前端默认,推荐起步) |
all |
全部,含删除,仅明确需要时开启 |
Go 零值为关闭(fail closed),前端默认 read_write [COMPUTED]。
填错后果:误选「全部」会让 AI 拥有删除权限,风险极高。
三个名单的优先级
出现条件:始终显示 [实测]。
Go 判定顺序(pkg/ai/eino/config.go):①内置硬规则(凭证类端点、管理员变更等)不可配置;②黑名单 deny_ns/deny_endpoints;③白名单 allow_ns;④开放范围与端点风险等级匹配 [源码]。全部 fail closed,任一不通过即拒绝;白名单留空表示不按命名空间限制,但仍受开放范围约束。
推荐值:先用开放范围控制大致权限,再用白名单收窄到必要模块。
填错后果:黑名单写错可能放过本应禁止的模块;白名单写错会导致 AI 无法访问需要的数据。
允许使用的工具
出现条件:始终显示;下方有可点选的「本站点可用工具」清单(按域名分组,按风险等级着色)[实测]。
源码语义:留空开放全部默认可见工具(含 shell_exec、fs_*、web 等主机级能力);填 * 连默认关闭的高危工具一起开放;填具体意图或域名则只开放对应工具,未知意图默认拒绝 [源码]。
推荐值:生产环境建议按域名授权(如 content,seo),不要填 *。
填错后果:填 * 会开放主机级高危能力,存在被滥用的风险。
一键复制配置
出现条件:配置了 Token 后可用 [实测]。
生成 mcpServers.{name}.url 与 Authorization: Bearer ${token} 配置片段;未生成 Token 时拒绝复制并提示 [源码]。
操作步骤
- 进入「设置 → AI统一配置」。
- 配置写作/翻译与 AI 助手所需的接口(如需要)。
- 如需开放 MCP:先生成 Token,再设置调用身份和开放范围。
- 用白名单/黑名单与工具列表收紧权限。
- 点击「一键复制配置」,将配置粘贴到第三方 AI 客户端。
适用场景与建议
- 只让 AI 读数据:开放范围选「只读」,工具列表按域名限制。
- 需要 AI 写文章:开放范围选「读+写」,并用白名单收窄到内容模块。
- 生产环境:不要勾选备份、升级、删除、
shell_exec、fs_*等工具,也不要选「全部」。
注意事项
- MCP 开放后,持有 Token 的第三方可调用本站接口,Token 泄露等同于权限泄露。
- 「全部」开放范围包含删除类操作,误配可能造成数据丢失。
- 速率限制为 0 时不设上限,可能带来服务压力,建议按实际需求设置。
- MCP 配置结构位于
pkg/ai/eino/config.go,与写作配置config/aiGenerate.go不同 [COMPUTED]。 - 修改权限后,已连接的客户端需要重新建立连接才会生效。