codebuddy能直接分析系统磁盘i/o瓶颈，无需手动运行iostat或iotop；它通过挂载内核计数器与日志自动诊断高延迟操作、文件系统碎片化及缓存失效，并支持自然语言查询、热力图可视化和wal写放大定位。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy能直接分析当前系统磁盘I/O瓶颈，定位高延迟读写操作、文件系统碎片化、缓存失效等深层问题，无需手动运行iostat或iotop再逐项比对。
启动CodeBuddy并加载本地存储上下文
在终端中执行codebuddy start --mode=storage，该命令会自动挂载/proc/diskstats、/sys/block/*/stat及/var/log/syslog中最近24小时的IO事件日志。
等待约8秒，界面右下角出现绿色“Storage Context Ready”提示后，方可进入下一步。若提示“Permission denied”，需先执行sudo setcap cap_sys_admin+ep $(which codebuddy)授权——【未授权将无法读取内核级IO计数器，所有分析结果为空】。
自然语言触发IO瓶颈诊断
在AI对话框中输入：“找出过去1小时里最慢的3个磁盘操作，按延迟排序，标注触发进程和文件路径”。
CodeBuddy会解析blktrace原始数据流，跳过常规iotop仅显示进程名的粗粒度统计，直接映射到具体open()/read()/fsync()系统调用栈，并关联到源码行号（若项目已启用debug symbols）。
返回结果中，延迟超过200ms的操作会被标为红色，同时附带修复建议：例如“/var/lib/postgresql/data/base/16384/12345_fsm”文件上的随机写入延迟达412ms，建议启用postgresql.conf中的random_page_cost = 1.1并关闭fsync = off（仅限开发环境）。
生成IO热点文件分布热力图
方法一：点击界面上方「Visualize」→「I/O Heatmap」→ 选择时间范围（默认1小时）→ 点击「Render」。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：输入指令“生成/dev/sda上所有文件的IOPS与吞吐量热力图，按目录层级聚合，排除/tmp和/dev/shm”。
热力图以颜色深浅表示每秒I/O请求数（IOPS），鼠标悬停可查看精确数值及对应inode。注意：【热力图默认不包含tmpfs挂载点，避免内存伪IO干扰判断】。
定位数据库WAL写放大根源
第一步：确认PostgreSQL或MySQL服务正在运行，且WAL日志位于/var/lib/postgresql/data/pg_wal或/var/lib/mysql/ib_logfile*路径。
第二步：执行codebuddy analyze:wal --path=/var/lib/postgresql/data/pg_wal。
第三步：查看输出报告中的「Write Amplification Ratio」字段。若该值＞3.2，说明存在严重日志刷盘竞争；此时CodeBuddy会自动检查pg_settings中checkpoint_completion_target是否低于0.7，并提示将该参数调至0.9以拉平WAL写入曲线。
第四步：若检测到pg_wal目录下存在大量.partial临时文件，CodeBuddy会警告“WAL segment切换频率过高”，建议增大max_wal_size至当前值的1.8倍。
