Qoder扩展API开发：编写你自己的专属插件并发布到社区

Qoder自定义插件开发需完成创建项目结构、实现功能逻辑、本地调试、签名打包、社区上传五步：含manifest.json与main.js；init中注册命令并监听事件；开发者模式加载验证；用signer-cli生成.qext文件；上传至社区审核。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望为Qoder扩展API开发自定义插件并将其发布至社区，需完成插件编写、本地调试、签名打包及社区上传四个核心环节。以下是具体执行步骤：

一、创建插件项目结构

Qoder扩展插件基于标准JSON配置与JavaScript逻辑组合，必须包含manifest.json描述文件和至少一个入口脚本。该结构是插件被识别和加载的基础前提。

1、在本地新建文件夹，命名为your-plugin-name。

2、在该文件夹内创建manifest.json文件，写入必需字段：name、version、description、main、permissions。

3、创建main.js文件作为插件主逻辑入口，确保其中导出一个默认对象，含init和destroy两个方法。

4、在manifest.json中将main字段值设为"main.js"，确保路径准确且无拼写错误。

二、实现核心功能逻辑

插件行为由main.js中的init函数驱动，该函数在Qoder启动时被调用，所有交互逻辑、事件监听和API调用均在此处注册。

1、在main.js中声明const plugin = { init, destroy }；并导出该对象。

2、在init函数内调用qoder.api.registerCommand注册自定义命令，命令名需为全小写字母加短横线格式（如"toggle-dark-mode"）。

3、使用qoder.api.on("document:loaded", callback)监听文档加载事件，确保DOM就绪后再操作界面元素。

4、所有对qoder.api的调用必须在init执行后进行，禁止在模块顶层直接调用API方法。

三、本地调试与验证

Qoder提供内置插件加载机制，支持未签名插件的临时加载，用于功能验证与错误排查。

1、启动Qoder客户端，进入设置 → 扩展 → 开发者模式，开启开关。

2、点击“加载本地插件”，选择your-plugin-name文件夹的父目录，而非插件文件夹本身。

Qoder

阿里巴巴推出的AI编程工具

下载

3、观察控制台输出：若出现"Plugin loaded: your-plugin-name"，表示加载成功。

4、在命令面板（Ctrl+Shift+P）中输入插件注册的命令名，确认可触发对应逻辑且无报错。

四、签名与打包发布包

社区仅接受经过Qoder官方密钥签名的.zip包，未签名包无法提交。签名过程生成唯一指纹并绑定开发者身份。

1、访问Qoder开发者门户，登录后下载专用签名工具signer-cli。

2、在终端进入your-plugin-name目录，执行signer-cli pack --key=your_private_key.pem。

3、命令成功后生成your-plugin-name-v1.0.0.qext文件，该文件为加密ZIP格式，含签名证书与校验信息。

4、严禁手动修改.qext文件内容或重命名其扩展名，否则校验失败导致上传拒绝。

五、提交至Qoder插件社区

插件需通过社区审核流程方可公开显示，提交时系统自动校验签名有效性、元数据完整性及基础安全策略。

1、登录Qoder社区开发者后台，进入“我的插件”页面，点击“新建提交”。

2、上传步骤四生成的.qext文件，系统即时验证签名并解析manifest.json字段。

3、填写展示信息：标题（不超过32字符）、图标（48×48 PNG）、截图（最多3张，1280×720 JPG/PNG）。

4、点击“提交审核”，状态变更为“审核中”，此时不可撤回或替换文件。