bot_dev1
5da367dfd8
纯标准库实现，对齐 PRD 5.5「⑤ 配置化驾驶舱」性能口径： - perf_budget.py：PerformanceBudget（首屏 2000ms + 6 类资源预算）、 ResourceMeasurement（block_render 区分关键路径）、BudgetVerifier （阻塞串行+非阻塞取最大口径，逐类型比对预算，PASS/FAIL/EMPTY + 类型化优化建议，reason 可解释）。 - lazy_load.py：LazyLoadStrategy（immediate/visible/idle/never）、 LazyLoadPolicy（视口行数+预加载+分页阈值+虚拟滚动）、LazyLoadPlanner （widget 坐标+滚动位置 → 决策+分页计划+虚拟滚动窗口）。 - tests：32 用例覆盖预算构造/查询、关键路径口径、达标/超预算场景、 always_load 强制加载、视口边界、分页/虚拟滚动、输入校验。 - _sanity_check.py：冒烟验证达标/超预算/懒加载分流。
54 lines
2.5 KiB
Markdown
54 lines
2.5 KiB
Markdown
# 性能预算与懒加载策略引擎（Issue #54 / PRD 5.5）
|
||
|
||
> 父 Issue「⑤ 性能优化（首屏 ≤ 2s，图表懒加载）· 0.5d」
|
||
|
||
把驾驶舱性能口径落为**可校验、可测试的纯标准库引擎**（无 node/前端构建环境，
|
||
与 iAOP 零运行时依赖原则一致）。产出两类资产：
|
||
|
||
## 1. 性能预算与校验（`perf_budget.py`）
|
||
|
||
- `PerformanceBudget` —— 首屏预算（默认 ≤ 2000ms，PRD 5.5）+ 分资源类型预算
|
||
（HTML/CSS/JS/字体/接口/图片）。`PerformanceBudget.default_cockpit()` 给驾驶舱默认预算。
|
||
- `ResourceMeasurement` —— 单资源实测耗时（含 `block_render` 标记，区分关键路径）。
|
||
- `BudgetVerifier` —— 校验器：按**关键路径口径**（阻塞渲染资源串行累加、非阻塞并行取最大）
|
||
计算首屏总耗时，逐类型比对预算，产出 `BudgetReport`（状态 PASS/FAIL/EMPTY + 超预算
|
||
明细 + 类型化优化建议，每条 `reason` 可解释）。
|
||
|
||
```python
|
||
from perf_budget import PerformanceBudget, BudgetVerifier, ResourceMeasurement, ResourceType
|
||
|
||
budget = PerformanceBudget.default_cockpit() # 首屏 ≤ 2s
|
||
report = BudgetVerifier(budget).verify([
|
||
ResourceMeasurement("app.js", ResourceType.JS, 700, block_render=True),
|
||
ResourceMeasurement("app.css", ResourceType.CSS, 250, block_render=True),
|
||
])
|
||
assert report.passed # PASS + 裕量 reason
|
||
```
|
||
|
||
## 2. 图表懒加载策略（`lazy_load.py`）
|
||
|
||
- `LazyLoadStrategy` —— 4 种加载时机：`immediate`（首屏立即）/`visible`（进视口）/
|
||
`idle`（空闲时）/`never`（不加载）。
|
||
- `LazyLoadPolicy` —— 策略规则（首屏视口行数、rootMargin 预加载、分页阈值、虚拟滚动）。
|
||
- `LazyLoadPlanner` —— 决策器：widget 布局坐标 + 视口/滚动位置 → `LazyLoadPlan`
|
||
（每个 widget 的加载决策 + 分页计划 + 虚拟滚动窗口，`reason` 可解释）。
|
||
|
||
```python
|
||
from perf_budget import LazyLoadPlanner, WidgetLayout
|
||
|
||
plan = LazyLoadPlanner().plan([
|
||
WidgetLayout("proc", "process_view", y=0, h=4, always_load=True),
|
||
WidgetLayout("trend", "trend", y=10, h=2), # 视口外 → idle
|
||
], scroll_y_rows=0)
|
||
print(plan.immediate_ids, plan.idle_ids, plan.pages)
|
||
```
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
python -m unittest discover -s templates/ti-cl4/perf-budget/tests -p "test_*.py" -v
|
||
```
|
||
|
||
覆盖正常 + 边界 + 错误（32 用例）：预算构造/查询、关键路径串行/并行口径、达标/超预算
|
||
场景、always_load 强制加载、视口边界、分页/虚拟滚动、输入校验。
|