# 宝锐本机数据分析与可视化环境清单

> 核对时间：2026-11-12
> 范围：本机 macOS，不是 WorkBuddy 沙箱。
> 结论：原清单中的“✅ 已预装”不能直接作为本机依据；本机已单独建立分析虚拟环境。

## 一、解释器与用途

| 解释器 | 版本 | 用途 |
|---|---:|---|
| `/usr/bin/python3` | 3.9.6 | 宝锐工作台现有脚本默认解释器；已装 pandas 2.3.3、openpyxl、xlsxwriter、PDF 相关 |
| `/opt/homebrew/bin/python3` | 3.14.3 | Homebrew Python；已装 pandas 3.0.2、numpy 2.4.3，缺绘图/统计库 |
| `/Users/liuxinyuan/.venvs/baorui-analysis/bin/python` | 3.13.12 | **独立分析环境**；已装 pandas、numpy、scipy、matplotlib、seaborn、statsmodels、plotly |

> 工作台脚本继续使用 `/usr/bin/python3`，不要整体切到分析 venv。分析 venv 仅用于临时分析、建模、出图和验证。

## 二、核心包实际版本

| 包 | 系统 Python 3.9 | Homebrew 3.14 | 分析 venv 3.13 |
|---|---:|---:|---:|
| numpy | 2.0.2 | 2.4.3 | **2.5.4** |
| pandas | 2.3.3 | 3.0.2 | **3.1.1** |
| scipy | 未装 | 未装 | **1.18.1** |
| statsmodels | 未装 | 未装 | **0.15.0** |
| matplotlib | 未装 | 未装 | **3.11.2** |
| seaborn | 未装 | 未装 | **0.13.2** |
| plotly | 未装 | 未装 | **7.1.0** |
| openpyxl | 3.1.5 | 3.1.5 | **3.1.5** |
| xlsxwriter | 3.2.9 | 未装 | **3.3.1** |
| pillow | 11.3.0 | 未装 | **13.0.0** |
| reportlab | 4.4.10 | 未装 | 未装 |
| WeasyPrint | 66.0 | 未装 | 未装 |
| pdf2image | 1.17.0 | 未装 | 未装 |
| requests | 2.32.5 | 未装 | 未装 |
| beautifulsoup4 | 未装 | 未装 | 未装 |
| scikit-learn | 未装 | 未装 | 未装 |
| geopandas | 未装 | 未装 | 未装 |
| bokeh | 未装 | 未装 | 未装 |
| pyecharts | 未装 | 未装 | 未装 |
| networkx | 未装 | 未装 | 未装 |

## 三、环境验证

验证目录：`资料/分析环境验证_20261112/`

| 项目 | 结果 |
|---|---|
| pandas 分组汇总 | 华东 280、华南 250、华北 120 |
| Excel 写入/读回 | 5 行，内容完全一致 |
| SciPy 独立样本 t 检验 | t=3.1429，p=0.018155 |
| statsmodels OLS | 斜率 2.0143，R²=0.9991 |
| 中文字体 | PingFang SC、Arial Unicode MS、Heiti SC、Songti SC 可用 |
| Matplotlib 中文图 | `matplotlib_chinese.png`，中文标题/坐标轴正常 |
| Seaborn 图 | `seaborn_test.png` |
| Plotly 交互图 | `plotly_test.html`（CDN）与 `plotly_test_selfcontained.html`（内嵌 plotly.js，4.8MB） |
| 依赖完整性 | `pip check` 无冲突 |

## 四、推荐用法

```bash
# 分析、建模、出图
~/.venvs/baorui-analysis/bin/python your_analysis.py

# 工作台现有脚本
/usr/bin/python3 脚本/xxx.py
```

### 推荐组合

| 需求 | 方案 |
|---|---|
| Excel/CSV 清洗、透视、合并 | pandas 3.1.1 + openpyxl 3.1.5 |
| 统计检验、回归、时间序列 | scipy 1.18.1 + statsmodels 0.15.0 |
| 静态报告图 | matplotlib 3.11.2 + seaborn 0.13.2 |
| 可分享的交互图 | plotly 7.1.0 |
| 中文图表 | 设置 `PingFang SC`，并关闭 unicode_minus |
| PDF 输出 | 系统 Python 的 WeasyPrint 66.0 / reportlab 4.4.10；或后续在 venv 补装 |
| 前端看板 | 现有自包含 HTML + 内联 SVG / ECharts |

## 五、注意事项

1. **pandas 3.x 与现有脚本的 pandas 2.3.3 存在 API/默认行为差异**。分析 venv 里跑通的代码，回填工作台脚本前要用 `/usr/bin/python3` 再验一次。
2. **Node.js 实际为 v24.14.0，不是 v22.13.1**（npm 11.9.0）。CloudBase CLI 在 Node 24 下有已知静默失效问题，部署时继续使用 node 直调 `cli.js`，不要裸跑 `tcb`。
3. 原清单里 scikit-learn、geopandas、beautifulsoup4、bokeh、pyecharts、networkx 均未安装；需要时再装，不要写进“已预装”。
4. 分析 venv 的包版本见：`资料/分析环境验证_20261112/requirements-analysis.txt`。