需启用右键菜单扩展并注册脚本动作：一、在config.yaml中设context_menu_enabled: true；二、在actions/context-menu/下建JSON文件定义ID、label、command；三、用[+]和[-]实现嵌套菜单；四、在快捷键管理中绑定context-menu:ID触发热键。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在QoderWake中为常用脚本添加右键快捷入口，但当前界面未显示对应操作项，则可能是由于右键菜单扩展机制未启用或自定义条目未正确注册。以下是配置QoderWake自定义右键菜单的具体路径：
一、启用右键菜单扩展支持模块
QoderWake默认禁用第三方右键菜单注入，需手动激活底层事件拦截能力，使系统允许外部动作绑定至文件/节点右键上下文，该步骤是所有自定义菜单生效的前提。
1、关闭正在运行的QoderWake客户端，确保无残留进程。
2、定位用户配置目录：Windows为%APPDATA%\QoderWake\config.yaml，macOS为~/Library/Application Support/QoderWake/config.yaml，Linux为~/.config/QoderWake/config.yaml。
3、用文本编辑器打开config.yaml，在根层级新增字段：context_menu_enabled: true，并确保缩进为两个空格。
4、保存文件后，重新启动QoderWake；启动日志中若出现“Context menu extension activated”提示，即表示模块已就绪。
二、注册脚本执行动作至右键菜单
QoderWake通过JSON格式的动作描述文件将本地脚本与右键触发行为绑定，每个动作需包含唯一ID、可执行路径及菜单显示名称，支持参数化调用。
1、在QoderWake安装目录下创建子文件夹：actions/context-menu/。
2、在该文件夹内新建文件，命名为backup-script.json，内容如下：
{ "id": "backup-exec", "label": "一键备份当前项目", "command": "python3 /opt/scripts/backup.py --target ${current_path}", "icon": "fa:Solid_HardDrive" }
3、确保/opt/scripts/backup.py存在且具备可执行权限（Linux/macOS执行chmod +x，Windows需确认py关联已注册）。
4、重启QoderWake，右键任意项目文件夹时，菜单底部将出现“一键备份当前项目”选项。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、配置多级嵌套菜单结构
当常用脚本数量较多时，可通过二级菜单分组归类，避免主菜单过长；QoderWake支持使用前缀符号定义层级关系，一级菜单以[+]开头，其子项以[-]开头。
1、在同一actions/context-menu/目录下新建dev-tools.json。
2、填入以下内容（注意空格与符号严格匹配）：
{ "id": "dev-group", "label": "[+] 开发辅助工具", "children": [ { "id": "lint-now", "label": "[-] 运行代码检查", "command": "qoderwake lint --path ${current_file}" }, { "id": "test-run", "label": "[-] 执行单元测试", "command": "python3 -m pytest ${current_dir}/tests/" } ] }
3、确保${current_file}与${current_dir}为QoderWake内置变量，无需额外声明，仅在右键目标为文件或目录时自动替换为实际路径。
4、保存后刷新QoderWake，右键任意Python文件将显示带箭头图标的“开发辅助工具”，点击展开后可见两个子项。
四、绑定快捷键与右键菜单联动
为提升操作效率，可将右键菜单中的高频动作映射为全局热键，实现不依赖鼠标、不聚焦窗口的瞬时触发，适用于多任务并行场景。
1、进入QoderWake设置页：点击右上角头像 →「快捷键管理」→「新增绑定」。
2、在「触发动作」栏输入context-menu:backup-exec（冒号后为第一步中定义的action ID）。
3、在「按键组合」栏按下期望组合，例如Ctrl+Shift+B，系统自动识别并写入配置。
4、勾选「跨应用生效」，点击保存；此后无论当前前台为何种程序，按下该组合键均等效于对当前焦点所在目录右键选择“一键备份当前项目”。
