> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 发布项目插件
> 将 superun 项目导出为 Qoder Plugin，上传图标和插件 ZIP，填写发布信息并提交审核。
把自己的 superun 项目导出为 Qoder 插件，让使用者在 Qoder 中通过对话查询项目数据、使用已有业务功能。
## 先在 superun 下载插件包
1. 打开要发布的项目，进入 **运营 → Agent 友好**。
2. 如果还没有完成接入，先点击 **开始接入**，等待项目接入能力准备完成。
3. 在 **发布到 AI 平台 → Qoder 插件** 中，点击 **导出插件包**。
4. 填写插件 **唯一标识**，确认 **版本**，点击 **生成并下载**。
5. 保存以 `-qoder-版本号.zip` 结尾的文件。下载后，可点击成功提示中的 **查看上传教程** 继续操作。
插件包绑定的是导出时的当前项目。发布其他项目时，请进入对应项目重新导出。
## 上传到 Qoder
打开 [Qoder 我的发布](https://qoder.com/account/apphub-publications?tab=plugin\&page=1)，登录后进入 **Plugins** 页签。
点击右上角 **发布 → 发布 Plugin**。
在 **发布 Plugin** 表单中填写自己的插件信息。截图中的名称、联系方式和署名仅为示例。
| 字段 | 怎么填写 |
| - | - |
| 图标 | 在 Qoder 发布页面手动上传。更换时点击「更换图标」，图片要求以页面提示为准。 |
| 显示名 | 填写面向使用者展示的项目或插件名称，例如「客户管理助手」。 |
| 描述 | 说明插件能帮助用户做什么，例如「查询客户管理项目中的数据，整理业务分析结果」。 |
| 分类 | 按插件实际用途选择，例如截图中的「办公效率」。 |
| 联系方式 | 填写自己的邮箱或 GitHub 联系方式。 |
| 开发者署名 | 填写你希望公开展示的作者名称，发布后以「by 署名」展示。 |
| 适配产品 | 勾选已经确认适配的 Qoder 产品端，并阅读、确认下方的产品展示说明。 |
带星号的字段必须填写。适配产品列表在截图中包括 Qoder APP、Qoder IDE、Qoder CLI 和 QoderWake；按实际验证情况选择，不要直接照抄截图中的勾选。
Qoder 的上架图标需要在此页面手动上传。仅下载或上传 superun 导出的 ZIP，不代表市场图标已经配置完成。
向下滚动到 **Plugin 文件**，上传刚从 superun 下载的 Qoder ZIP 包，无需解压或重新压缩。
等待文件上传和校验完成，核对图标、显示名、描述、作者信息和适配产品，确认无误后提交。
如果平台提示包内唯一标识或版本有问题，返回 superun 修改导出信息，重新生成 ZIP 后再上传。只修改 ZIP 文件名不会改变包内配置。
提交后回到 **我的发布 → Plugins**，查看插件对应的 **上架状态** 和 **审核状态**。
截图中的状态是 **未上架 / 待审核**，表示正在等待审核，尚未公开上架。审核结果和后续操作以 Qoder 页面及通知为准。
## 插件首次使用
使用者安装插件后，首次接入时按插件指引检查本地运行环境、安装 superun CLI，并在浏览器中登录自己的项目账号完成授权。目标应用需要支持本地命令和 Node.js 20 或更高版本。
插件使用该账号的权限访问绑定项目；发布插件不会把作者的登录授权交给安装者。完成一次真实的只读数据查询后，才能确认接入成功。修改数据或执行业务功能前，按插件提示确认具体操作和参数。
## 常见问题
插件 ZIP 和市场展示图标是在发布页面分别配置的。请在「图标」区域手动上传图片，再查看发布预览。
唯一标识写入插件包，用于区分插件；显示名是在 Qoder 发布表单中面向使用者展示的名称。修改 ZIP 文件名或显示名，不会修改包内唯一标识。
按实际适配和验证情况选择。页面提示：勾选表示主要适配的产品端，未勾选的 Qoder 产品端仍可能展示并使用该扩展；具体行为以 Qoder 当前说明为准。