# Python Profiler Visualizer

粘贴一段 Python 代码，一键运行，立刻看到每个函数各花多少时间。桌面应用，不联网，不传你的代码，不配环境。

## 下载

到 [Releases](../../releases) 下载 `Python Profiler Visualizer Setup x.y.z.exe`，双击安装。首次启动会扫描 Python；找不到可点应用里的「打开终端」按钮，按系统预填命令装即可。

## 从源码运行

需 Node 20+ 和 Python 3.9+：`npm install` 后 `npm run dev`。

## 用法

1. 左侧编辑器贴代码（或点工具栏「加载示例」）
2. `Ctrl/Cmd + Enter` 运行
3. 右侧看摘要、热点表、6 种耗时可视化
4. 点热点表任意函数跳到对应行；标准库/第三方包会新开标签页展示源文件
5. 工具栏切换「剖析范围」：仅用户代码 / 含库函数（切换后旧结果会标为陈旧）

按 `← / →` 在柱状图、火焰图、矩形树图、旭日图、累计柱状图、模块热力图之间切换。

### 快捷键

| 按键 | 作用 |
| --- | --- |
| `Ctrl/Cmd + Enter` | 运行 / 取消 |
| `Esc` | 取消运行 / 关设置面板 |
| `← / →` | 切标签页或图表视图 |
| `Home` / `End` | 跳到首/尾 |
| `Delete` / `Ctrl/Cmd + W` | 关闭当前标签页 |

## 耗时数字说明

cProfile 会拖慢代码 1.5~3 倍。引擎启动时跑同一段 tight-loop 测出裸跑与仪器化倍率，把你的 instrumented 时间除回去，摘要数字接近真实耗时，并标「已校准」。

提醒：

- 单次数字有抖动，比较时建议跑多次
- 含 `plt.show()` / `input()` / `cv2.waitKey()` 等阻塞事件循环的等待时，UI 会提示「含交互等待」

## 限制

- 仅单文件自包含脚本，不支持命令行参数或多文件项目
- 无自动超时（取消靠按钮或 `Esc`），长时间任务跑到自然结束
- 不替代 `py-spy` / `scalene`

## 给开发者

Electron 31 + React 18 + Vite 5 + TypeScript 5，Python 引擎用 cProfile + 标准库。

```bash
npm run dev          # 开发
npm run build        # 打包
npm run release      # 出 Windows 安装包
npm test             # 单元测试
npm run test:e2e     # E2E
python -m pytest engine/tests -v   # Python 引擎测试
```

架构：`src/main/` 主进程、`src/renderer/` React 前端、`engine/` Python 引擎。跨语言契约 `AnalysisResult`，Python 侧 `engine/schema.py` 是事实源，TypeScript 侧 `src/shared/analysis.ts` 对齐，契约测试 `engine/tests/test_contract.py` 锁版本。

`npm run release` 产物在 `release/Python Profiler Visualizer Setup x.y.z.exe`。未签名，Windows SmartScreen 点「更多信息 → 仍要运行」即可。

## License

MIT