需先确认插件符合qoder规范(含manifest.json)、注册开发者账户并生成token、用qodercli打包签名后提交pr至github仓库、通过ci与人工审核、最后在skills.sh提交元数据完成收录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已完成一个适用于 Qoder 的功能插件,但不确定如何将其提交至 Qoder 社区供他人使用,则可能是由于缺乏对社区发布流程、元信息规范或验证机制的了解。以下是提交您的第一个开源插件到 Qoder 社区的具体操作路径:
一、确认插件符合 Qoder 插件规范
Qoder 社区仅接受结构清晰、具备完整元数据与可运行验证的插件。插件必须包含 manifest.json 文件,定义名称、版本、入口脚本、权限声明及兼容的 Qoder 版本范围。缺失或格式错误的 manifest 将导致审核被拒。
1、在插件根目录下创建 manifest.json 文件,确保包含 name、version、main、qoderVersion 四个必需字段。
2、检查 main 字段指向的入口文件(如 index.js)是否能被 Node.js 正常加载且无语法错误。
3、运行 qodercli validate-plugin . 命令,验证 manifest 结构与依赖声明是否合规。
二、注册并配置 Qoder 开发者账户
提交插件前需绑定经认证的开发者身份,该身份将作为插件作者标识,并用于接收审核反馈与权限管理。
1、访问 https://qoder.com/developers,使用 GitHub 或 Google 账号登录已有 Qoder 账户,或完成新账号注册。
2、进入个人设置页,点击“Developer Profile”,填写真实姓名、组织(可选)、公开邮箱,并上传头像。
3、在“API Access”区域点击“Generate Token”,复制生成的 Personal Access Token 并安全保存,后续 CLI 提交将使用该凭证。
三、构建插件发布包并上传至社区仓库
Qoder 社区采用 Git 仓库托管源码,要求提交前打包为压缩归档并附带签名,以保障代码完整性与来源可信性。
1、执行 qodercli package --output my-plugin-v1.0.0.tgz,生成符合社区签名标准的 tar.gz 包。
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
2、使用本地 GPG 密钥对归档文件签名:gpg --detach-sign --armor my-plugin-v1.0.0.tgz,生成 my-plugin-v1.0.0.tgz.asc。
3、访问 https://github.com/qoder-community/plugins,点击 “Create pull request” → “Compare across forks”,选择您的 fork 分支,将 my-plugin-v1.0.0.tgz 与对应 .asc 文件一并提交至 submissions/ 目录。
四、通过自动化校验与人工审核流程
提交后,Qoder CI 系统将自动执行静态分析、依赖扫描与沙箱运行测试;通过后进入人工审核阶段,重点检查功能真实性、安全边界与文档完备性。
1、在 PR 页面查看 GitHub Actions 运行状态,确保 ci/validate-plugin 与 ci/sandbox-exec 显示绿色勾选标记。
2、等待社区维护者在 PR 中添加 review/approved 标签,该标签表示已确认插件行为符合描述且无高危风险。
3、若收到修改意见,需在原 PR 中直接提交更新 commit,并重新触发 CI 流程,不可关闭重开。
五、发布成功后同步插件元信息至 skills.sh
Qoder 官方插件市场 skills.sh 会定期同步经审核通过的插件,但需主动提交索引元数据以确保及时收录与分类展示。
1、访问 https://skills.sh/submit,填写插件 GitHub 仓库地址、简短描述(≤120 字)、分类标签(如 “UI”、“DevOps”、“AI Tooling”)。
2、上传一张尺寸为 1200×630px 的封面图,格式为 PNG 或 JPG,文件名须为 banner.png 或 banner.jpg。
3、点击 “Submit for Indexing”,系统将生成唯一 skill-id 并返回确认页面,该 ID 将用于后续 npx skills install 命令调用。










