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客户端，进入设置 → 扩展 → 开发者模式，开启开关。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
2、点击“加载本地插件”，选择your-plugin-name文件夹的父目录，而非插件文件夹本身。
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、点击“提交审核”，状态变更为“审核中”，此时不可撤回或替换文件。
