SHOPAGG AI Deployer · CMS 智能部署助手

SHOPAGG AI Deployer：让 AI 通过 MCP 管理企业官网

SHOPAGG AI Deployer 是面向SHOPAGG CMS 的免费扩展插件。它通过 MCP Streamable HTTP 将企业官网的内容管理与独立插件开发能力提供给支持远程 MCP 的可信 AI 客户端，帮助运营人员减少重复录入，也让开发者能够在托管工作区内创建、检查和部署功能扩展。

本资源是 CMS 插件，不是同名的 WordPress 插件。商店标识为 shopagg-cms-ai-deployer，安装后的插件 ID 为 shopagg-ai-deployer。当前版本 0.1.1，价格 ¥0，授权条款见安装包 LICENSE。

功能亮点

1. 一个 MCP 连接，集中管理常用网站内容

• 查询、创建和编辑产品，管理商品状态、分类、摘要、详情及 SEO 字段。
• 支持现有产品价格模式，包括阶梯价格、SKU、价格范围和议价展示；产品及价格、SKU 更新使用事务保护。
• 管理文章、案例和独立页面，支持草稿保存、发布及指定内容删除。
• 创建与修改分类，检查父分类是否存在、类型是否一致，以及是否形成循环。
• 浏览媒体库并上传受支持的图片或视频，单个媒体文件最大 8MB。
• 读取和更新允许清单中的公开网站设置，例如公司资料、联系方式、社交账号及 SEO 信息。

2. 独立工作区开发插件，保留 MCP 直接部署能力

• 创建托管插件，读取文件与 SHA-256，通过整批 changeset 原子提交源码修改。
• 可提供 expected_sha256，减少多个会话覆盖同一文件的风险；变更失败时不提交工作区。
• 静态检查 Manifest、PHP 语法、命名空间和代码策略，校验阶段不自动加载候选 PHP 类。
• 保留 plugin.install、plugin.enable、plugin.disable 和 plugin.rollback_installed 工具，允许通过 MCP 直接安装、启用、停用及恢复已归档版本。
• 安装使用已检查的冻结源码，同一版本不能替换不同内容；工作区保留最近十个修改前快照。
• 版本回滚恢复插件代码，不回退业务数据库，也不逆向执行已经完成的数据库迁移。

3. 后台连接管理与调用记录

• 在后台“扩展 → AI Deployer”查看 MCP 服务地址和客户端配置示例。
• 支持生成、重新生成和撤销访问密钥；完整密钥只显示一次，数据库保存密码哈希。
• 查看 AI 托管插件的名称、版本、工作区状态与快照数量。
• 最近操作展示工具名称、时间、成功或失败状态及耗时，便于排查连接和执行问题。

4. 输入检查、调用额度与审计限制

• 工具执行前校验公开 inputSchema，包括嵌套对象、数组和 JSON 类型。
• 检查 JSON-RPC 请求封套及 MCP 协议版本，使用 Bearer Token 鉴权并检查携带的 Origin。
• 每批最多 20 条消息，超限整批拒绝；每个来源 IP 每分钟最多 60 次请求，每个 Token 每分钟最多 120 条消息。
• 同一站点同时处理一个 MCP 请求；批次超过 10 秒后不再开始剩余调用，已经完成的操作不会撤销。
• 日志按大小轮转，最多保留 10 个文件；最近日志限量读取，避免整月日志一次载入内存。

适用场景

• 工厂与外贸企业：辅助维护产品资料、规格价格、新闻、应用案例和公司介绍。
• 官网运营团队：将整理好的内容交给 AI，通过现有 CMS 数据模型录入、更新和检查。
• 建站开发者：在独立托管工作区制作功能插件，分步执行校验、安装和启用，并保留代码恢复能力。
• 使用支持远程 MCP 的 AI 客户端的团队：通过一个明确的服务地址连接网站，无需另外暴露通用 REST 管理接口。

安装与连接方法

1. 备份站点，确认 PHP 与 CMS 满足要求，并检查下方配套修复说明。
2. 从应用商店下载安装包，在 CMS 后台插件管理中安装并启用 SHOPAGG AI Deployer。
3. 进入“扩展 → AI Deployer”，生成并妥善保存访问密钥。
4. 在支持远程 MCP Streamable HTTP 的客户端中配置网站的 /shopagg-ai/mcp 地址，并添加 Authorization: Bearer YOUR_TOKEN 请求头。
5. 先执行站点状态或产品列表等只读操作验证连接，再按实际需要管理内容或创建托管插件。
6. 如果不再使用某个客户端，在后台撤销或重新生成密钥。

兼容性与配套修复

需要 PHP 8.1 或更高版本，以及 JSON、SQLite3、Fileinfo 扩展；安装 ZIP 需要 CMS 服务器支持 ZipArchive。Manifest 声明的 CMS 基线为 1.3.3，本版本已在包含配套修复的 CMS 1.3.5 中完成隔离安装、启用和设置页渲染验证。

旧版 CMS 不能只复制插件包后直接依赖全部安全保障：0.1.1 的事务与失败处理需要核心 Product、Setting 模型的配套修复；安装包提供 patches/shopagg-cms-1.3.5-compatibility.patch。请由管理员备份后审查、合并，或使用已包含这些修复的兼容 CMS。插件不会自动修改核心文件。

Apache + PHP-FPM/CGI 部署需确保 Authorization 请求头能够传入 PHP；按安装包 README 配置 CGIPassAuth On。反向代理需在服务器层配置可信真实 IP。部分 AI 客户端不支持带自定义鉴权请求头的远程 MCP，连接前请检查客户端能力。

权限与使用边界

MCP 密钥是高权限管理凭据。安装、启用和回滚插件会有意执行 PHP，静态代码策略不等于操作系统沙箱，也不提供同进程 PHP 的绝对隔离。只向可信客户端提供密钥，管理操作前做好站点备份；单个生命周期的执行超时仍由 PHP 和服务器配置控制。

源码工具限定在 AI Deployer 创建的托管插件工作区，不提供任意文件路径或 Shell 工具；内容工具只开放指定业务操作与设置清单。本插件不内置 AI 模型，不提供模型额度；AI 服务由用户选用的客户端及其服务商提供。

后台截图

1. 连接与设置：服务地址、MCP 配置示例、密钥管理和执行边界。
2. 工作区与审计：示例托管插件、静态校验状态和最近操作记录。
3. 移动端界面：窄屏下的连接配置、工作区和操作记录布局。

截图来自隔离演示环境，使用示例域名和 YOUR_TOKEN 占位符，不包含客户资料、真实访问密钥或实际业务运行承诺。

0.1.1 更新说明

• 统一 SHOPAGG 命名，完善 MCP 管理界面和客户端配置示例。
• 修复候选源码在校验阶段被自动加载的问题，收紧动态调用和危险函数检查。
• 增加批量上限、请求限流、并发锁及限量日志读取。
• 完善托管源码归档、直接部署和代码回滚检查。
• 增加工具参数、协议版本、分类关系与事务失败回归检查。