update

README.md

@@ -0,0 +1,67 @@
+# 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