功能定位：为什么要在 HelloWorld 里做性能分析
HelloWorld 把「零配置云端 IDE」与「毫秒级 Serverless 运行时」绑在一起，天然适合快速验证算法、刷题、演示原型。当代码从 50 行膨胀到 5 000 行，内存泄漏往往最先在容器里爆发：边缘节点 512 MB 限额触发 OOM，临时域名直接返回 502。官方在 2026.1 把性能分析做成「开箱即用」面板，目的就是让开发者不装插件、不拉镜像、不 ssh，也能拿到可与本地 Valgrind 对比的定量数据。
与本地工具链相比，HelloWorld 的方案牺牲了一点底层灵活度，换来的是跨语言一致化 UI：Rust、Go、Python 都走同一套「快照-对比-火焰图」三步，降低团队沟通成本；同时平台把CPU、内存、网络、碳排放放在同一张时序图，方便 ESG 审计直接截图。
版本演进：2025 → 2026.1 的迁移要点
2025 版仅提供「Console Memory」一行数字，需要用户自己 curl 外部探针；2026.1 起内置hw-profile守护进程，默认在容器启动时注入 LD_PRELOAD，因此旧项目首次打开会提示 schema-2025 incompatible。官方给出一条一次性迁移命令：
npx hello migrate --profile
执行后 workspace.json 会增加profile: { "version": 2, "backend": "hw-profile" }，旧探针脚本会被重命名为*.legacy.sh，方便回退。若项目根目录已存在自定义的.helloworld/pipeline.yml，迁移脚本会自动追加- run: hw-profile --validate步骤，保证 CI 阶段也能捕获泄漏。
三步开启：桌面端最短路径
- 打开工作区 → 右上角「Run」按钮左侧的下拉箭头 → 选择「Profile & Run」。
- 首次使用会弹出「性能分析授权」抽屉，勾选「Inject hw-profile」→ Confirm；平台将自动重启容器（耗时约 3 秒）。
- 重启后底部出现「Performance」标签，点击「Start Recording」即开始采集；复现泄漏场景后点「Stop」生成快照。
若找不到「Profile & Run」，请检查：
- 版本号 ≥ 2026.1（Settings → About）。
- 模板商城导入的项目需在「Settings → Language → Enable Profiling」手动打开，因为部分最小模板为节省启动时间默认关闭注入。
移动端路径：iOS/Android 远程附加
移动端 App 目前不提供完整的火焰图面板，但支持「远程触发快照」。步骤如下：
- 在手机浏览器打开同一工作区 → 点击右上角「⋮」→「Remote Dev」→ 扫码配对。
- 配对成功后，桌面端「Performance」面板会出现「Mobile Snapshot」按钮；在真机上操作触发泄漏，然后点按钮即可把快照拉回桌面端分析。
经验性观察：Flutter 3.24 项目通过远程附加比本地 flutter run --profile 节省约 30% 的重复编译时间，因为云端容器已经缓存了引擎.so。
快照对比：定位内存泄漏的实操技巧
生成两份快照后，在「Performance → Heap Diff」选择「Baseline」与「Leak」→ 平台会按「Retained Size」倒序列出对象。判断泄漏的三条经验阈值：
1. 单次请求后 retained heap 增长 ≥ 10 % 且 GC 后未回落；
2. 同类对象实例数随请求线性递增，斜率 ≥ 1.2；
3. 快照对比中出现「循环引用」红色图标，点击可查看引用链。
以 Python 3.14 为例，若在 diff 中看到 _json.Scanner 对象持续增加，大概率是全局 lru_cache 未设置 maxsize；修复后重新「Profile & Run」，diff 视图会显示「Fixed」绿色标签，方便教学场景直接截图交实验报告。
火焰图与调用树：CPU 热点交叉验证
内存快照只能告诉你「哪里没释放」，却不说「谁申请得最多」。在「CPU/Time」子面板打开「On-CPU Flame Graph」，若 malloc 相关帧占比超过 25 %，即可确认高并发＋小对象频繁申请是泄漏诱因。此时可启用「AI Pair-Programmer」→ 输入「/refactor hotspot reduce malloc」，AI 会给出对象池或切片复用重构建议，并自动在侧边 Diff 预览，接受后重新运行即可在 10 秒内看到内存下降曲线。
常见失败分支与回退方案
| 现象 | 根因 | 处置 |
|---|---|---|
| 容器重启后「Profile」按钮消失 | 模板默认关闭注入 | Settings → Language → Enable Profiling → Restart |
| 快照文件 0 B | LD_PRELOAD 与自定义 so 冲突 | 在 .helloworld/preload.conf 排除冲突库，或临时用「Standard Run」 |
| 打开 diff 视图白屏 | 快照 >200 MB 导致前端 OOM | 改用「Export → Raw Heap」下载后本地用 hw-cli diff |
与 CI/CD 的协同：把泄漏检查变成红线
在.helloworld/pipeline.yml追加以下步骤，可在 PR 阶段自动拒绝引入泄漏：
- run: hw-profile --baseline=main --head=$HW_COMMIT - run: hw-profile --assert-leak=5%
平台会把「main 分支最后一次成功快照」作为 baseline，若 HEAD 的 retained heap 增长超过 5 %，Pipeline 标记为失败，并自动在 PR 评论中贴出 diff 火焰图。经验性观察：对高校实验课而言，把阈值设在 3 % 能有效遏制学生「全局缓存一切」的坏习惯，同时避免误杀正常缓存策略。
边界与误区：什么时候不该用内置分析
- 低延迟竞赛场景：注入探针会带来约 3 % CPU 开销、5 % 内存基线，若题目时限 100 ms 以内，建议本地用静态检查替代。
- 需要内核级跟踪：hw-profile 基于用户态采样，无法捕获 page fault 细节；此时应导出原始 perf.data 到本地做 Kernel Flame Graph。
- 商业加密库：某些 so 检测到 LD_PRELOAD 会拒绝运行，需改用「Standard Run」+ 手动触发 jemalloc heap profiler。
碳排放指标：把内存泄漏与能耗挂钩
2026.1 仪表盘新增「Carbon → Memory Leak」子项，会把泄漏对象总量按「每 1 MB·h = 0.42 g CO₂」折算。经验性观察：一次 50 MB 的泄漏在边缘节点跑 24 h，约等于多排放 0.5 g，若你的函数每天被调用 10 k 次，一年就多出 1.8 kg，足够在 ESG 报告里被审计圈红。修复后可在「Impact」面板直接生成 SPDX 3.0 附带碳减排声明，方便金融客户入库。
最佳实践 10 秒检查表
☑ 每次新增全局缓存前先问自己：maxsize 与 ttl 设了吗？
☑ 生成快照后立刻看「Retained Size」TOP10，有无熟悉类名意外上榜？
☑ PR 阶段把 --assert-leak 阈值写入 pipeline，别等合并后才发现 502。
☑ 移动端调试完顺手点「Mobile Snapshot」，省得事后复现不出场景。
☑ 修复后把 diff 图贴到 Issue，方便 reviewer 一键确认。
FAQ（Schema 标记）
旧项目提示 schema-2025 incompatible 必须迁移吗？
不强制，但旧探针脚本无法识别 2026.1 的堆追踪格式；建议运行 npx hello migrate --profile，45 秒完成，可回退。
快照文件过大导致浏览器卡死怎么办？
Performance → Export → Raw Heap，下载后用 hw-cli diff 本地分析，不走前端渲染。
CI 阈值设多少才合理？
API 服务建议 5 %，算法竞赛 1 %；高校实验可设 3 %，配合自动批注防止误杀缓存。
收尾：下一步行动清单
你现在已知道 HelloWorld 性能分析如何一键开启、如何快照对比、如何写进 CI。立刻打开你的工作区，按「Profile & Run」跑一遍 baseline，再把最近一次疑似泄漏的 commit 拉进来对比，如果 diff TOP1 对象出乎你意料，恭喜你——第一个 0.1 g 碳减排已经到手。记得把修复后的火焰图贴到 PR，让 reviewer 无门槛秒批；下一次 OOM 报警时，你会感谢今天提前设下的 5 % 红线。
