> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 上架与分享

> 企业开发者走官方合作流程上架插件市场，个人开发者通过开源社区分享。

## 企业开发者

推荐通过官方合作流程，把 Mini App 提交到 MiniMax Code 插件市场。插件包的通用规范、目录结构、安全限制和常见驳回原因，见[《MiniMax Plugin 开发与上架指南》](/docs/code/agents/plugin-submission)。

* 如果你的 Mini App 用到了公司官方提供的 MCP 服务，请提前联系我们。
* 不要把 OAuth、access token、refresh token、client secret 或 API key 写进插件。需要用户身份的能力，先走 App / Connector 接入。
* 包里任何内容有变化，都要提升 `version`。

## 个人开发者：开源社区

[MiniMax-Code-MiniApps](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps) 是 MiniMax Code Mini App 的官方社区仓库，任何人都可以通过 Pull Request 贡献。工具、游戏、可视化、小实验都欢迎，团队会定期甄选优质 Mini App 上架。

**1. 从示例开始**

Fork 仓库，把 `examples/hello-miniapp/` 复制到 `plugins/<你的 GitHub 用户名>/<plugin-id>/`，在这里开发。包规则在仓库的 `docs/` 里，AI 编程 Agent 会自动读取 `AGENTS.md`。

**2. 写清楚说明**

附上 README 和许可证，写明安装步骤、访问了哪些数据和服务、测试过哪些版本。

**3. 提交 PR**

在两个根 README 的表格里加上你的 Mini App，运行 `npm run check`，然后提交 Pull Request。

> [!NOTE]
>
> 作者目录用小写的 GitHub 用户名。插件目录名必须和 `plugin.json` 的 `name` 一致，并且在整个仓库里唯一，因为安装后的路径里没有作者目录这一层。

想要 Mini App 还没有的运行时能力，比如新的 `context` API 或窗口行为，到置顶的[能力许愿单](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/issues/9)留言。

## 安装社区 Mini App

社区包目前需要手动安装，桌面端的 GitHub 插件导入不支持这些包。

**1. 下载**

下载或克隆仓库，在 `plugins/<作者>/` 下找到要用的 Mini App。先读它的 README，了解它会访问哪些本地文件和网络服务。

**2. 复制**

把整个插件目录（包括隐藏的 `.minimax-plugin`）复制到 `<dataDir>/plugins/<plugin-id>/`，默认是 `~/.minimax/plugins/`。不要带上作者目录这一层。

**3. 打开**

重启 MiniMax Code，确认插件已识别并启用，再按 README 打开。

也可以把目录或 ZIP 直接交给 Agent，让它按[成品包流程](/docs/miniapp/authors/quickstart#finished)发布。

> [!WARNING]
>
> Mini App 的代码以你的身份在本机运行，只安装来源可信的包。见[安全模型](/docs/miniapp/host/security)。

## 官方案例

首期，Mini App 创作团队用 Vibe Coding 做了两款产品供大家参考。

### 股市

* 完整的股票 K 线图和自选股。
* 把散落在知识星球、进门财经、腾讯文档等平台的股票信息，集中整理到看板里。
* Agent 能看到看板里的所有内容，随时接手，继续协助你推进工作。

![股市 Mini App：K 线图、自选股和资讯看板](https://mintcdn.com/agent-cn/cVBevhAJXWhxEBzo/images/miniapp/case-stock.png?fit=max\&auto=format\&n=cVBevhAJXWhxEBzo\&q=85\&s=8d4eedc9b2217a993a63101beae66c44)

### CadQuery Viewer

* 在 MiniMax Code 里查看本地 STL、STEP 模型，实时显示 CadQuery 脚本推送的模型。
* 在模型上标出位置，一键发到对话，让 Agent 准确知道你说的是哪个面、哪个孔、哪条边。
* Agent 可以通过 MCP 工具在查看器里打开模型，包里还内置了 CadQuery 参数化建模 Skill。

![CadQuery Viewer 实拍：Agent 生成 MiniMax 小章鱼 3D 模型，并按模型上的标注把嘴巴改成红色](https://mintcdn.com/agent-cn/JSC7FJNGF6jZWNks/images/miniapp/case-cq-viewer.gif?s=bbf3f86f08a17f5525774b4d8743d101)

[源码在开源社区](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/hanzijie/cq-viewer)

## 社区作品

| Mini App | 做什么 | 作者 |
| - | - | - |
| [Token Usage Board](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/amszuidas/mcode-token-usage-board) | 按日期、模型、会话查看本机 Token 用量，包括输入、输出和缓存 | amszuidas |
| [Token Usage Monitor](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/yanhy2000/mcode-usage-monitor) | 近实时监看 Token 用量、输出速度和缓存命中率 | yanhy2000 |
| [Model Manager](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/ocoomber/openrouter-model-manager) | 浏览、搜索、启停 `~/.minimax/config.yaml` 里的模型，支持批量操作和一键撤销 | ocoomber |
| [Self-drive Route Planner](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/hanzijie/self-drive-route-planner) | 官方插件：地点搜索、备选路线和小红书 3:4 行程卡片 | HanZijie |
| [Git Commit Tree](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/microbiosis/git-tree) | 用泳道图查看本地 Git 仓库的提交历史、分支和每个文件的改动 | Microbiosis |
| [灵签易占](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/weekbin/chinese-divination) | 梅花易数起卦、体用解读，浏览六十四卦和干支历 | weekbin |
| [Session Trajectory](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/avatasia/mmc-trajectory) | 回看一次对话的模型轨迹：消息、推理、工具调用、Token 和每轮耗时 | avatasia |