96 lines
3.3 KiB
Markdown
96 lines
3.3 KiB
Markdown
# blog-5m：热力图定稿萤火（4 只）落地正式开源页 - 完成总结
|
||
|
||
## 交付结论
|
||
- 结果：完成
|
||
- 完成时间：2026-11-05 11:21
|
||
|
||
## 假设回顾
|
||
### 已验证假设
|
||
- 月柱在无「点亮联动」后仍有信息价值（静态高度=哪个月最忙），保留不删
|
||
- 萤火引擎的 offsetLeft/offsetTop 定位对官方组件的 11px/10px 双档网格同样成立（布局实测，零手算节距）
|
||
|
||
### 仍未完全验证的假设
|
||
- 无
|
||
|
||
## 交付范围
|
||
### 已交付
|
||
- task_0001 萤火落地与预览退役
|
||
- task_0002 生产核验（manual: 部署后人工核验）
|
||
|
||
### 未交付
|
||
- 无
|
||
|
||
### 偏差说明
|
||
- 无
|
||
|
||
## 简化决策
|
||
### 保持简单的关键选择
|
||
- 最简可行：Heatmap.astro 三处手术（浮层标记换 4 只 hm-fly、script 换萤火引擎、style 换 hm-fly/hm-lit+月柱静态）+ 删三类一次性资产 + E2E 一条断言
|
||
- 暂不引入: 虫数可配置化
|
||
- 不做的抽象: 「动效引擎注册表」（只有一种引擎，抽象无收益）
|
||
- 范围级别：package
|
||
- 变更对象：开源页热力图组件与一次性预览资产
|
||
- 快速检查：`pnpm astro build` + `python3 scripts/build-perf/config-check.py .`
|
||
- 集成检查：E2E（含萤火新断言）+ content-lint 0/0/0 + grep 断言产物（无 heatmap-preview、无 hm-head、4 只 hm-fly）
|
||
- 全项目检查：生产部署后人工核验 /opensource/ 萤火在跑、/heatmap-preview/ 404；**升级条件**——仅当改动触及 BaseLayout 或构建链时才升级全站回归，本包不涉及
|
||
- 升级触发：开源页独立区块，升级为「该区块人工核验」即可
|
||
|
||
### 本轮明确不做的内容
|
||
- 萤火参数再调（数量/速度/半径——用户未提，不为未发生的需求加工）
|
||
|
||
## 变更边界
|
||
### 本轮主要改动模块
|
||
- 见 tasks.md 的 boundary 记录
|
||
|
||
### 明确未触碰的区域
|
||
- 萤火参数再调（数量/速度/半径——用户未提，不为未发生的需求加工）
|
||
|
||
## 验证证据
|
||
### 备注
|
||
- 机器证据：runs.jsonl（见验证范围的机器验证率）
|
||
|
||
## 验证范围
|
||
- 级别：package
|
||
- 机器验证率：1/1；manual 任务 1 项不计入分母
|
||
- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
|
||
|
||
## 哲学生效证据
|
||
### 行为成效回填
|
||
- Development Record 行为门禁通过
|
||
|
||
### 一致性门禁回顾
|
||
- 验收面（checklist 或成功标准）已通过
|
||
|
||
## Git 记录
|
||
- 日期时间：2026-11-05 11:21
|
||
- 范围：blog-5m：热力图定稿萤火（4 只）落地正式开源页
|
||
- 功能：task_0001 萤火落地与预览退役；task_0002 生产核验（manual: 部署后人工核验）
|
||
- 操作：提交 / 推送
|
||
- 成效：Development Record 行为门禁通过
|
||
- 提交：pending local commit
|
||
- 提交区间：44cd62e9a2a5fc0f400de2862a3a07c5686bf25e..44cd62e9a2a5fc0f400de2862a3a07c5686bf25e
|
||
- 推送：not-run (push stage follows commit)
|
||
|
||
## AGENTS.md 增量提议
|
||
```diff
|
||
热力图 v5 选型闭环：用户在五案预览页选定萤火并指定虫数 4——引擎落进正式开源页（贪吃蛇与月柱点亮联动退役，月柱转静态），预览路由/五候选组件/lint 白名单全部退役，E2E 补萤火断言（61/61）。
|
||
```
|
||
|
||
## 被拒绝的扩展提议
|
||
- 无
|
||
|
||
## 门禁证据
|
||
- check_spec_package.py exit 0
|
||
|
||
## 遗留事项
|
||
- 无；问题处置见下方结构化区块
|
||
|
||
## 问题处置
|
||
|
||
```json
|
||
{
|
||
"issues": [],
|
||
"version": 1
|
||
}
|
||
```
|