QoderWake自定义右键菜单：一键运行脚本高效配置指南

不少用户会遇到这样的问题：在QoderWake中为常用脚本添加右键快捷入口时，菜单却一片空白。别急，并非软件缺陷，而是有个模块默认未启用。下面详细拆解如何完整配置QoderWake的自定义右键菜单。

整体分为四个环节：首先在配置中启用功能开关，然后注册脚本动作，接着构建多级嵌套菜单，最后绑定快捷键。效果如何？继续往下看。

一、启用右键菜单扩展支持模块

QoderWake默认禁用第三方右键菜单，需要手动激活底层事件拦截能力，使系统允许外部动作绑定到右键上下文。这一步是所有自定义菜单生效的前提，不可跳过。

1、关闭正在运行的QoderWake客户端，建议检查进程彻底退出，避免残留。

2、定位用户配置目录：Windows 是 %APPDATA%QoderWakeconfig.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。右键任意项目文件夹，菜单底部应出现“一键备份当前项目”选项。

三、配置多级嵌套菜单结构

若常用脚本较多，直接罗列在主菜单上显得杂乱，可使用二级菜单分组归类。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、勾选「跨应用生效」，点击保存。此后无论前台运行哪个程序，按下该组合键，相当于对当前焦点所在目录右键选择“一键备份当前项目”。