CodeBuddy支持用自然语言指令驱动Python数据分析全流程：自动完成数据加载、清洗、建模、可视化与报告生成，规避环境配置、依赖冲突与硬编码问题；安装codebuddy-cli==2.4.1后执行init与health检查，再以单句指令触发完整流水线，并支持pause_before、--dry-run及版本约束等定制干预，还可增强现有代码库。

用自然语言指令驱动CodeBuddy自动完成Python数据分析全流程，包括数据加载、清洗、建模、可视化和报告生成，避免手动拼接pandas、scikit-learn、matplotlib等库的繁琐步骤，跳过环境配置冲突、依赖版本错配、临时文件路径硬编码等常见陷阱。

安装并激活Python专属AI引擎

打开终端，执行以下命令安装支持Python 3.11+的CodeBuddy CLI核心包：

pip install codebuddy-cli==2.4.1

运行codebuddy init --python，该命令会自动检测本地conda或venv环境，【若未激活任一Python环境，将默认创建独立虚拟环境并安装pandas 2.2+、scikit-learn 1.5+、plotly 6.0+】。这一步不可跳过，否则后续数据分析指令将因缺少关键依赖而失败。

验证Python引擎就绪：输入codebuddy python --health，看到“✅ All required packages loaded”即表示准备完成。

用一句话启动完整分析流水线

在项目根目录下，直接运行：

codebuddy python "读取data/sales_2024.csv，剔除缺失率＞15%的列，对数值列做Z-score标准化，用随机森林预测是否高价值客户（label列），输出特征重要性条形图和分类报告"

CodeBuddy会自动生成并执行一个临时.py脚本，包含完整错误处理逻辑——比如当CSV中无label列时，它不会报错退出，而是主动提示“未检测到label列，是否将最后一列设为标签？[y/N]”。

执行完成后，自动在./output/analysis_20260807_0101/下生成：

• cleaned_data.parquet（清洗后数据）

• model.joblib（已训练模型）

• report.html（含混淆矩阵热力图与可交互特征图）

定制化干预：插入人工校验点

方法一：在自然语言指令末尾添加→ pause_before:fit

这样会在模型训练前中断，生成待执行代码并保存为pipeline_draft.py，允许你手动修改超参或更换算法。

方法二：用--dry-run参数预览全流程

codebuddy python "分析用户行为日志，按session分组统计页面停留时长中位数" --dry-run

返回的是带注释的完整代码草案，而非直接执行。适合贴入Jupyter Notebook逐步调试。

方法三：强制指定Python模块版本

在指令中嵌入版本约束，例如：

"用seaborn 0.13画箱线图 → [email protected]"

这能防止因系统全局安装了seaborn 0.14导致样式渲染异常。

连接已有代码库进行增量增强

第一步：进入含analyze_user_flow.py的目录

第二步：运行codebuddy python enhance ./analyze_user_flow.py "添加A/B测试分组对比功能，支持t检验与置信区间标注"

第三步：CodeBuddy会解析原文件AST结构，在不破坏原有函数签名的前提下，注入新逻辑并保持PEP8格式。

注意：如果原文件含if __name__ == "__main__":块，增强后的代码会自动将其移至新函数run_ab_test_analysis()中，并更新主入口调用链。【原文件将被备份为 analyze_user_flow.py.bak，不可逆操作，请确认已提交Git】

增强完成后，直接执行python -m analyze_user_flow --ab-test-group=control即可调用新增能力。