AI 统一配置

📅 2026-11-21 👁️ 0

AI 统一配置

AI 统一配置用于集中管理 AI 写作/翻译接口、AI 助手接口,以及 MCP 开放接口的权限与安全策略。

入口路径

后台顶部菜单 →「设置」→「AI统一配置」。实际地址:/system/setting/ai,需要管理员权限(canAdmin)。

功能说明

页面分为「AI接口配置(写作/翻译)」「AI接口配置(AI助手)」「MCP 开放接口」三个标签页。MCP 开放后,第三方 AI 客户端(Claude Desktop、Cursor、Cherry Studio 等)可通过 MCP 协议调用本站的意图工具。

界面截图

MCP 开放接口配置(含开放范围、调用身份、工具清单):

AI 统一配置 - 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 时拒绝复制并提示 [源码]。

操作步骤

  1. 进入「设置 → AI统一配置」。
  2. 配置写作/翻译与 AI 助手所需的接口(如需要)。
  3. 如需开放 MCP:先生成 Token,再设置调用身份和开放范围。
  4. 用白名单/黑名单与工具列表收紧权限。
  5. 点击「一键复制配置」,将配置粘贴到第三方 AI 客户端。

适用场景与建议

  • 只让 AI 读数据:开放范围选「只读」,工具列表按域名限制。
  • 需要 AI 写文章:开放范围选「读+写」,并用白名单收窄到内容模块。
  • 生产环境:不要勾选备份、升级、删除、shell_exec、fs_* 等工具,也不要选「全部」。

注意事项

  • MCP 开放后,持有 Token 的第三方可调用本站接口,Token 泄露等同于权限泄露。
  • 「全部」开放范围包含删除类操作,误配可能造成数据丢失。
  • 速率限制为 0 时不设上限,可能带来服务压力,建议按实际需求设置。
  • MCP 配置结构位于 pkg/ai/eino/config.go,与写作配置 config/aiGenerate.go 不同 [COMPUTED]。
  • 修改权限后,已连接的客户端需要重新建立连接才会生效。

相关文档

相关文章

网站导航设置使用帮助

网站导航设置网站的导航链接,并用于网站前台的展示。除了设置默认的顶部导航内,还可以根据自身需要,添加其他的位置导航,比如页脚导航、侧边栏导航等形式的自定义导航内容。导航列表中,可以支持最多2级的导航链接,也就是只支持一级下拉导航链接。导航类别管理默认设置中,系统内容了默认导航这一个类别,如果你有需求

2022-06-20

首页TDK设置使用帮助

首页TDK设置可以设置网站首页的title、keywords、description 三个标签的内容。首页TDK设置中可以设置的有:首页标题首页标题将在首页中的 标签中显示,为首页优化带来更好的体验。首页关键词首页关键词将在首页中的 标签中显示,用于设置需要优化整站的核心关键词。适当设置关键词可以

2022-06-20

联系方式设置使用帮助

联系方式设置默认可设置联系人、联系电话、联系地址、联系邮箱、微信号、微信二维码信息,如果觉得默认的设置项不能满足需要,还可以自定义新的设置项。默认的设置项可以设置的有:联系人一般上用于设置显示在前端联系方式上,用于给客户称呼使用的联系人,比如:王先生联系电话联系电话一般填写为用户可以联系上你的电话,

2022-06-20

内容设置使用帮助

内容设置提供了对内容图片的处理方式设置。内容设置中可以设置的有:是否下载远程图片可以设置为下载和不下载,如果设置为下载远程图片,则会将引用的外部链接的图片下载到本地。如果你使用的是自己的图床,则不需要选择下载远程图片。是否自动过滤外链当你不希望你发布的内容中,有外部站点的链接,可以选择过滤外链。这样

2022-06-20

首页幻灯片

首页幻灯片用于维护首页 Banner 图片及其链接、ALT 和简介,按分组管理,供模板调用展示。

2026-11-21

联系方式设置

联系方式设置用于维护联系人、电话、地址、邮箱、微信、社交媒体和店铺信息,供模板在前台调用展示。

2026-11-21

内容设置

内容设置用于控制文档的编辑器、URL 生成规则、列表分页、图片处理与缩略图策略,影响全站内容的录入方式和前台展示效果。

2026-11-21

货币设置

货币设置用于定义商城展示和订单接口返回的货币名称、国际代码与符号。

2026-11-21