Qoder自定义代码片段插件需创建qoder-timestamp-plugin目录，编写含activate函数的extension.js、实现时间戳插入的command，注册命令并绑定ctrl+alt+t快捷键，构建后放入extensions目录启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想为Qoder编辑器添加一个自定义代码片段插入功能，但找不到清晰的插件开发入口，也不清楚如何注册命令、绑定快捷键、与编辑器API交互。本教程带你从创建空目录开始，完成一个可立即启用的“插入时间戳”扩展模块。
初始化插件项目结构
在Qoder安装目录外新建文件夹，命名为 【qoder-timestamp-plugin】，进入该文件夹后执行命令创建基础文件。
运行 mkdir -p src/commands → 创建 src/commands 目录存放命令逻辑。
用任意文本编辑器新建 package.json，写入必需字段：name 必须以 qoder- 开头，version 不能为 0.0.0，main 字段指向入口 JS 文件（如 dist/extension.js）。
编写核心扩展逻辑
在 src/extension.js 中写入最简有效代码：
export function activate(context) { console.log('Timestamp plugin activated'); }
这行代码虽短，但缺一不可——Qoder 只识别导出名为 activate 的函数作为启动入口，否则插件加载失败且无报错提示。
接着在 src/commands/timestamp.js 中实现功能主体：调用 qoder.window.activeTextEditor.insert('[' + new Date().toISOString().slice(0,19) + ']') 插入 ISO 格式时间戳。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
注册命令并绑定到编辑器
第一步：在 src/extension.js 的 activate 函数内，调用 qoder.commands.registerCommand('timestamp.insert', () => { /* 执行插入逻辑 */ })。
第二步：将命令注册结果传给 context.subscriptions.push()，否则插件禁用时命令不会自动注销，可能引发后续冲突。
第三步：打开 Qoder 用户设置（Ctrl+,），搜索 keybindings，点击右侧“打开键盘快捷方式（JSON）”，在数组中新增对象：{"key": "ctrl+alt+t", "command": "timestamp.insert", "when": "editorTextFocus"}。
构建与启用插件
方法一：使用官方构建脚本（推荐）
确保已全局安装 qoder-cli → 运行 qoder-cli build → 自动生成 dist/extension.js。
方法二：手动构建（仅限调试）
执行 npx tsc --build tsconfig.json → 要求项目根目录存在 tsconfig.json 且 compilerOptions.outDir 设为 dist。
最后一步：将整个 qoder-timestamp-plugin 文件夹复制到 Qoder 的 extensions 目录下（Windows 默认路径为 %USERPROFILE%\.qoder\extensions\），重启编辑器。
