插件开发与上架指南

​

1. 先选择要提供的能力

​

2. 标准目录结构

acme-research/
  .minimax-plugin/
    plugin.json
  icon.png
  research.mcp.json
  calendar.app.json
  skills/
    literature-review/
      SKILL.md
  # 其他被 Skill 或 MCP 引用的普通文件

• ZIP 根目录必须直接包含 .minimax-plugin/plugin.json，不能在 ZIP 外再套一层目录。
• 文件名和路径只使用 ASCII 字母、数字、点、下划线和连字符；路径统一使用 /。
• 不接受符号链接、硬链接、Git LFS 指针、Git submodule、包安装生命周期脚本、平台专属二进制或依赖可执行位的文件。包安装生命周期脚本指 package.json 中的 preinstall、install、postinstall 等。Skill/MCP 可携带普通可移植脚本，通过明确的解释器调用。
• 文本文件使用 UTF-8、无 BOM；JSON 必须是 object，不能包含重复 key。

​

3. 编写 Plugin Manifest

{
  "schemaVersion": 1,
  "name": "acme-research",
  "displayName": "Acme 研究助手",
  "version": "1.0.0",
  "description": "检索研究资料并生成结构化综述。",
  "author": "Acme",
  "icon": "icon.png",
  "category": "Science & Healthcare",
  "exampleQueries": [
    "检索近期研究并总结主要结论",
    "根据这些资料生成一份文献综述"
  ],
  "apps": [],
  "mcpServers": ["research.mcp.json"],
  "skills": ["skills/literature-review/SKILL.md"]
}

​

4. 添加 Skill

---
name: literature-review
description: 检索、筛选并总结研究资料，生成结构化文献综述。
---

先确认研究主题、时间范围与输出格式。
检索资料后，按研究问题、方法、主要结论与局限进行归纳……

• name 必须与 Skill 目录名完全一致，description 必须非空。
• 正文应是模型可以直接执行的完整指导，不要只写功能宣传。
• Skill 引用的模板、资料或脚本应一并放入包内，并使用相对路径。
• 同一 Plugin 内 Skill 名不能重复；运行时会以 <plugin-name>:<skill-name> 暴露，避免与其他 Plugin 冲突。

​

5. 添加 MCP

{
  "schemaVersion": 1,
  "mcpServers": {
    "acme-search": {
      "type": "streamable-http",
      "url": "https://mcp.acme.example/mcp",
      "description": "检索 Acme 公开知识库",
      "timeout": 30000
    }
  }
}

{
  "schemaVersion": 1,
  "mcpServers": {
    "local-analyzer": {
      "type": "stdio",
      "command": "python3",
      "args": ["./server.py"],
      "description": "分析本地输入文件",
      "timeout": 30000
    }
  }
}

• 支持 stdio、streamable-http、sse；不支持 http alias。
• timeout 表示单次工具调用超时，单位为毫秒；例如 30000 表示 30 秒。未填写时使用运行时默认值。
• stdio.command 只能写 PATH 中的解释器或可执行名，不能包含路径；包内脚本通过相对 args 引用。
• 远程 MCP 必须使用真实 HTTP(S) 地址并可稳定访问；建议在提交前完成 initialize、tools/list、tools/call 验证。
• 不得在 headers、env 或其他文件中写入任何密钥与用户凭据。需要鉴权时请先联系 MiniMax 评估 App/Connector 接入。

​

6. App 接入前置

{
  "schemaVersion": 1,
  "provider": "acme"
}

​

7. 包体与安全限制

​

8. 提交新 Plugin 或更新

1. 在提交表单中选择“上架新 Plugin”或“更新已有 Plugin”，并分别选择目标区域（CN/US）与启用端（桌面端/云端，可多选）。
2. 选择来源并只填写对应内容：ZIP 根目录必须直接包含 .minimax-plugin/plugin.json；GitHub 填写公开仓库根地址，可选填写 Ref 与 Plugin 子目录。系统会冻结本次来源，确保后续审核与发布使用同一份内容。
3. 更新已有 Plugin 时，name 必须保持不变，并提供维护权证明。包内内容变化时必须提升 version；仅调整已有区域的启用端等 Catalog 元数据且包内容完全不变时，可保持版本。首次向另一区域发布同名 Plugin 仍须选择“新插件”。具体变更由系统生成的 MR diff 展示，无需另填“变更摘要”。
4. 提交成功后保存 submission_id。系统会完成来源规范化与脚本校验；失败原因会写回记录并主动发送飞书消息。AI 预审为可选能力，当前未启用，不影响流程继续。
5. 脚本校验通过后，系统按所选区域自动创建指向 CN/US Marketplace main 的 Release MR，并在人工审核群卡片中提供 MR 链接。审核人员直接检查 MR diff、Markdown 校验报告、图标与 CI；确认无误后由仓库 owner 合入。
6. MR 合入后，Marketplace main Pipeline 自动打包并分发。Intake 会跟踪发布任务，将状态更新为“发布中”“已发布”或“发布失败”，并主动发送飞书消息。查询时需使用原提交飞书账号，并提供 submission_id 与提交邮箱。 跨区域提交：一份提交的操作类型适用于所有目标区域。如果插件已在 CN 存在、但首次提交到 US，请拆成两份提交：CN 选择“更新插件”，US 选择“新插件”。 发布与上架：“已发布”是本次提交的包分发状态，不代表插件当前一定在市场中可见。市场展示顺序及上下架由 MiniMax 运营独立管理；首次发布的新插件默认上架，但不因此自动安装。更新已有插件会保留原有顺序及上下架状态，更新已下架插件不会自动恢复上架。 下架不会改写用户已有的安装、卸载、启用或停用选择，恢复上架后保留这些选择。客户端通过已有刷新流程同步最新运营状态，变更可能不会立即生效。查询表单返回提交与发布状态，不查询当前运营上架状态；如显示“已发布”但在预期区域和端仍不可见，请携带 submission_id 联系 MiniMax 核查。

​

9. 提交前自查

• ZIP 根目录或 GitHub 指定子目录直接包含 .minimax-plugin/plugin.json
• name、包目录与 manifest 一致；如包内内容变化，已提升版本号
• 图标、名称、描述、分类和不超过 3 条示例 query 均为正式内容
• 至少包含一种能力，所有 App/MCP/Skill 文件都被 manifest 引用
• Skill frontmatter 完整，MCP endpoint/命令已验证
• 包内不含 Token、Secret、个人数据、包安装生命周期脚本、软链接或平台专属二进制；普通 Skill/MCP 脚本通过明确的解释器调用
• 拥有代码、文案、图标和引用资料的提交与分发权利
• 如包含 App，已经提前联系 MiniMax 并完成 Connector provider 确认

​

10. 常见驳回原因

• ZIP 多套一层目录、GitHub 子目录定位错误，或目标根目录缺少 .minimax-plugin/plugin.json。
• Plugin 名称、版本、路径、JSON Schema 或 Skill frontmatter 不符合规范。
• 能力文件未被 manifest 引用，或 manifest 引用了不存在的文件。
• MCP 使用了不支持的 transport、绝对路径、平台专属依赖，或包含 OAuth/密钥。
• App provider 尚未完成 Connector 接入，或目标环境尚未验证。
• 示例 query、描述或图标仍是测试内容；版权、隐私或数据合规说明不完整。
• 更新已有 Plugin 时修改了包内内容却未提升版本、无法证明维护权，或 MR diff 暴露不兼容变更。

​

11. 数据与沟通说明

• GitLab 中冻结的提交包、脚本校验报告和可选 AI 预审报告保留 180 天。飞书 Base 中的运营记录与附件不自动清理，将按平台现状保留，并在确有运营需要时由 owner 人工处理。
• 请勿在提交包或表单中填写生产密钥、用户 token 或不必要的个人敏感信息。
• AI 预审是可选的提效能力，当前暂未启用；无论是否启用，最终上架决定均由 MiniMax 人工审核人员作出。
• 规范与校验规则可能随平台演进更新，请按本指南当前投稿范围准备材料。自动预检通过不等于最终接收或上架，仍需通过人工审核与生产发布校验；市场当前可见性还受区域、启用端和运营上下架状态影响。