调试QoderWake插件需先启用Qoder开发者模式并暴露CDP端口9229，再配置VSCode launch.json连接主进程，或使用Qoder内置DevTools、Chrome远程调试，最后验证Source Map是否映射TS源码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试为QoderWake插件添加新功能或修复行为异常，但无法在运行时观察变量状态、单步执行逻辑或定位断点触发位置，则很可能是调试环境未正确关联到Qoder主编辑器进程。以下是配置插件调试环境的步骤：
一、确认Qoder主程序支持插件调试协议
QoderWake作为基于Qoder平台构建的扩展插件，其调试依赖主程序暴露的调试代理端口与插件生命周期钩子。必须确保当前运行的Qoder版本不低于2026.1，并已启用开发者模式。该模式会启动内置的WebSocket调试服务，默认监听端口为9229，且允许外部调试器通过Chrome DevTools Protocol（CDP）建立连接。
1、打开Qoder主程序，在地址栏输入 qoder://settings/developer 并回车。
2、勾选“启用插件调试支持”与“暴露CDP调试端口”两项开关。
3、点击“重启Qoder以应用设置”按钮，等待主进程完全退出后重新启动。
二、配置VSCode Launch.json启动项
VSCode需通过Node.js调试器连接QoderWake插件运行时上下文，这要求Launch.json中明确指定调试目标为Qoder主进程而非独立Node进程。配置核心在于复用Qoder启动参数并注入--inspect-brk标志，使插件加载前即挂起等待调试器接入。
1、在QoderWake插件项目根目录下创建 .vscode/launch.json 文件。
2、写入以下JSON内容，其中 /path/to/qoder/executable 需替换为本地Qoder可执行文件绝对路径：
3、将 "runtimeExecutable" 字段值设为 /path/to/qoder/executable。
4、在 "runtimeArgs" 数组中追加 "--inspect-brk=9229" 与 "--load-plugin=/path/to/qoderwake/dist" 两项参数。
5、设置 "port" 为 9229，"timeout" 不低于 30000 毫秒以应对插件初始化延迟。
三、使用Qoder内置DevTools启动调试会话
Qoder主程序集成了一套轻量级调试前端，可绕过VSCode直接连接插件运行时。该方式适用于快速验证插件入口函数执行流程与模块加载顺序，无需额外配置调试器实例。
1、确保Qoder已启用开发者模式且插件已安装至 ~/.qoder/plugins/qoderwake 目录。
2、在Qoder主界面按下快捷键 Ctrl+Shift+I（Windows/Linux）或 Cmd+Option+I（macOS）。
QoderWake Linux版是阿里推出的生产级数字员工系统，支持Linux环境部署。它作为7×24小时在线的AI员工，具备长期记忆与专业技能（如编程、运维），可自主响应代码审查、告警处理等事件。其核心采用“员工与工位分离”架构，并设置了严格的权限红线，确保持续进化的同时实现安全可控。
3、在弹出的开发者工具窗口中切换至“Sources”面板。
4、展开左侧文件树中的 qoderwake:entry.js 节点。
5、在首行代码左侧灰色区域单击设置断点，刷新Qoder窗口触发插件重载，执行将在断点处暂停。
四、通过Chrome浏览器远程调试QoderWake
当VSCode调试器因权限或端口占用问题无法连接时，可利用Chrome浏览器作为替代调试前端。Chrome原生支持CDP协议，能完整呈现插件上下文堆栈、作用域变量及事件监听器列表。
1、确保Qoder主程序正在运行且调试端口9229处于监听状态。
2、打开Chrome浏览器，访问地址 chrome://inspect/#devices。
3、点击页面右上角“Configure”链接，在弹出对话框中添加 localhost:9229 并确认。
4、等待数秒后，“Remote Target”区域应出现名为 QoderWake Plugin Context 的条目。
5、点击该条目右侧的“inspect”链接，即可打开独立调试窗口，查看插件全局对象、执行线程与内存快照。
五、验证插件调试符号映射是否生效
源码映射（Source Map）是调试TypeScript编写的QoderWake插件的关键环节。若未正确配置，断点将仅能在编译后的JavaScript文件中设置，无法回溯至原始TS源码行。验证重点在于检查Qoder加载插件时是否识别并应用了.map文件。
1、确认插件构建输出目录中存在 qoderwake.js.map 文件，且其内容包含有效的sources字段指向src/下的TS路径。
2、在Qoder开发者工具的“Sources”面板中，展开“webpack://”节点，查找是否存在 ./src/ 子目录结构。
3、若该目录为空或缺失，检查插件项目tsconfig.json中是否启用 "sourceMap": true 与 "inlineSources": true 选项。
4、重新执行构建命令 npm run build 后，重启Qoder并刷新开发者工具Sources视图。
