答案是启用性能采样器、perf捕获调用栈、生成多维火焰图、py-spy观测线程、回溯memory log策略开销。需依次激活内置采样器，用perf record采集主进程与浏览器沙盒栈，分别生成on-cpu和off-cpu火焰图，以py-spy补充python线程分析，并审计notion sync批处理配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake执行自动化任务时发现响应延迟、脚本卡顿或CPU占用异常升高，则可能是由于数字员工在解析工作流、调用插件或处理DOM操作时存在隐性性能瓶颈。以下是定位该问题的具体步骤：
一、启用QoderWake内置性能采样器
QoderWake AI增强版（TencentOS Server 4 镜像预装）内置轻量级采样模块，可在不中断业务的前提下捕获脚本执行栈。该模块默认关闭，需显式激活以避免日志污染。
1、登录QoderWake控制台，进入【Settings → Diagnostics → Profiling】页面。
2、将“Execution Stack Sampling”开关设为Enabled，采样频率设为99Hz。
3、在“Target Scope”中勾选需监控的模块：Browser Use Agent、GitHub Connector、Slack Bridge。
4、点击“Apply & Restart Agent”，等待状态栏显示Profiler Active (PID:XXXX)。
二、使用perf record捕获底层调用栈
当QoderWake运行于Linux宿主环境（如TencentOS Server 4 AI增强版）时，可直接调用内核级perf工具采集全栈数据，覆盖Python解释器、Chrome沙盒进程及系统调用层。
1、在终端中执行ps aux | grep qoderwake，确认主进程PID（如12345）与Browser Use Agent子进程PID（如12348）。
2、对主进程执行采样：sudo perf record -F 99 -p 12345 -g -- sleep 60。
3、对Chrome沙盒进程单独采样：sudo perf record -F 99 -p 12348 -g -- sleep 60。
4、生成原始符号文件：sudo perf script > qoderwake-main.perf && sudo perf script -p 12348 > qoderwake-browser.perf。
三、生成多维度火焰图并分离关键路径
QoderWake脚本执行涉及Python逻辑层、浏览器DOM交互层、跨进程通信层三重上下文，需分别生成On-CPU与Off-CPU火焰图以区分计算密集型与阻塞型瓶颈。
1、安装FlameGraph工具集：git clone --depth 1 https://github.com/brendangregg/FlameGraph.git ~/flamegraph。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、为Python主进程生成On-CPU火焰图：~/flamegraph/stackcollapse-perf.pl qoderwake-main.perf | ~/flamegraph/flamegraph.pl --title "QoderWake Python On-CPU" > qoderwake-python-oncpu.svg。
3、为Browser Use Agent生成Off-CPU火焰图：~/flamegraph/stackcollapse-perf.pl qoderwake-browser.perf | ~/flamegraph/flamegraph.pl --title "QoderWake Browser Off-CPU" --type=offcpu > qoderwake-browser-offcpu.svg。
4、提取关键函数路径：在生成的SVG中搜索qoder_bridge_notify、chrome_sandbox_eval、github_api_rate_limit_wait等高亮函数名，定位其父调用栈宽度。
四、注入py-spy实时观测Python线程状态
当perf无法获取完整Python符号（如使用PyPy或混淆后的字节码）时，py-spy作为无侵入式采样器可绕过C扩展限制，直接读取CPython解释器内存中的帧对象。
1、确保QoderWake运行于标准CPython 3.11+环境：qoderwake --version输出应含CPython 3.11.x字样。
2、执行实时采样：sudo py-spy record -p 12345 -o qoderwake-pyspy.svg --duration 60。
3、若提示权限错误，运行echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope临时放开ptrace限制。
4、检查输出SVG中_execute_workflow_step与_wait_for_dom_ready函数的横向占比，任一超过35%即判定为瓶颈函数。
五、启用QoderWake Memory Log回溯策略变更开销
QoderWake通过Notion Sync插件将每次策略更新写入Memory Log数据库，若同步过程未做批处理或字段冗余，会导致高频I/O拖慢主线程。该路径无法被perf或py-spy直接捕获，需结合审计日志交叉验证。
1、进入Notion中已配置的“QoderWake Memory Log”数据库，筛选最近1小时内记录。
2、按“时间戳”倒序排列，检查每条记录的原始执行摘要字段是否包含重复的validate_rule_update调用。
3、在QoderWake控制台【Audit → Event Log】中，搜索关键词notion_sync_batch_size，确认当前值是否为默认的1。
4、若确认为1，执行命令qoderwake config set notion_sync_batch_size 16，重启Agent后观察CPU波动是否收敛。
