# 城市生命线驾驶舱蓝湖正式素材替换方案（决策地图）

Status: open
Labels: wayfinder:map

## Destination

形成一份可直接交给开发执行的正式素材替换规格：基于蓝湖导出资源，覆盖驾驶舱 2D UI 与监测点/监测设备位置符号，锁定资产清单、语义 manifest、运行时路径与版本规则、字体授权与降级策略、既有业务结构保护，以及真实 `/cockpit` 与 qiankun 宿主的验收和分批交付方案。地图完成时不直接替换业务代码，而是让实现者无需重新发明关键决策。

## Notes

- Domain：城市生命线 Web 驾驶舱 `/cockpit`；词汇以根目录 `CONTEXT.md` 为准。
- Skills：`grilling`、`domain-modeling`、`research`、`prototype`；需要真实浏览器验收时使用 `browser-skill`。
- 用户已确认：Q1=B，Q2=B，Q3=A，Q4=A+C，Q5=D，Q6=C，Q7=D，Q8=B，Q9=B，Q10=B，Q11=A，Q12=C，Q13=A，Q14=A，Q15=A。
- 方案边界：现有模式、panelId、信息架构、地图/设备状态、拾取、定位和聚合契约优先；蓝湖与现有结构冲突时另立决策，不在素材替换中隐式重做。
- 资产边界：本图覆盖 2D UI、监测点和监测设备位置符号；不把设备/城市 3D 模型、地形、DEM、影像和 3D Tiles 当作本图正式素材。
- 运行时约定：正式资源进入驾驶舱自有资产边界，引用必须兼容 `import.meta.env.BASE_URL` 与 qiankun 注入路径；保留现有 `CockpitIcon`、`markerSvg`、`deviceAssets` 等单一接缝。
- 设计交付：原始蓝湖导出包与运行时资源分离；当前分享页要求重新登录，资源获取前需要人工完成一次登录。
- 按 `AGENTS.md`，本图阶段不自动运行 build/dev/浏览器调试；实现阶段需另行遵守该限制，除非用户明确要求验证。

## 任务清单

- [x] [蓝湖访问与正式资源交付包](issues/01-lanhu-access-and-delivery.md)
- [x] [蓝湖页面与运行时资产清单](issues/02-lanhu-asset-inventory.md)
- [x] [正式视觉系统与现有 token 映射](issues/03-visual-system-token-mapping.md)
- [x] [运行时资产 manifest 与版本策略](issues/04-runtime-asset-manifest-and-versioning.md)
- [x] [运行时资产 manifest 与版本策略规格](issues/09-runtime-asset-manifest-spec.md)
- [x] [监测点与监测设备位置符号映射](issues/05-point-device-marker-mapping.md)
- [x] [监测点与监测设备位置符号规格](issues/10-point-device-marker-spec.md)
- [x] [字体授权与缺失资源降级](issues/06-font-and-fallback-policy.md)
- [x] [字体授权与缺失资源降级规格](issues/11-font-and-fallback-spec.md)
- [x] [设计稿差异与现有业务结构保护](issues/07-design-diff-and-structure-boundary.md)
- [x] [设计稿差异与现有业务结构保护规格](issues/12-design-diff-structure-boundary-spec.md)
- [x] [分批替换与终稿验收方案](issues/08-batch-and-final-acceptance.md)
- [x] [分批替换与终稿验收规格](issues/13-batch-acceptance-spec.md)
- [ ] [执行-批次1：品牌/图标替换](issues/14-exec-batch1-brand-icons.md)
- [ ] [执行-批次2：面板视觉 token 替换](issues/15-exec-batch2-panel-tokens.md)
- [ ] [执行-批次3：地图/设备位置符号替换](issues/16-exec-batch3-map-markers.md)
- [ ] [执行-批次4：字体接入](issues/17-exec-batch4-fonts.md)
- [ ] [执行-批次5：装饰/纹理替换](issues/18-exec-batch5-decorations.md)
- [x] [蓝湖 9 画板逐项盘点与正式切图交付](issues/19-lanhu-artboard-inventory.md)

## 进度

已完成全部目标、范围与偏好澄清；**决策阶段收口**。当前地图含 **19 张**子票：**8 张决策票全部 resolved**（01–08）；**5 张规格子票已发布 `ready-for-agent`**（[09 manifest](issues/09-runtime-asset-manifest-spec.md)、[10 位置符号](issues/10-point-device-marker-spec.md)、[11 字体](issues/11-font-and-fallback-spec.md)、[12 差异判断表](issues/12-design-diff-structure-boundary-spec.md)、[13 批次与终稿验收](issues/13-batch-acceptance-spec.md)）；**5 张执行票已发布 `ready-for-agent`**（[14 品牌/图标](issues/14-exec-batch1-brand-icons.md)、[15 面板 token](issues/15-exec-batch2-panel-tokens.md)、[16 位置符号](issues/16-exec-batch3-map-markers.md)、[17 字体](issues/17-exec-batch4-fonts.md)、[18 装饰](issues/18-exec-batch5-decorations.md)），是实施阶段的可认领入口；**1 张盘点任务票已 resolved**（[19 蓝湖 9 画板逐项盘点](issues/19-lanhu-artboard-inventory.md)，由 fog 毕业，已产出 9 画板全量事实与 63 个归档资产）。批次依赖：16 Blocked by 15；18 Blocked by 14–17；14/15/17/19 可并行。地图达到 Destination——决策清空、规格集可交实施；按票 08 裁定，地图保留为实施索引，不关闭删除。

进展备注（批次 1）：票 14 已完成解析层最小子集与六图标临时迁移（manifest 登记 `temporary`）。票 19 盘点结论改变了批次 1 的走向：**蓝湖侧无正式切图，品牌位无 logo 图形、四个功能图标在稿中为纯文字 chip** → 六个图标按规格 12 记「设计稿未覆盖、维持现状」，不再等待"正式素材"；票 14 剩余为维护者走查与结构回归。

## Decisions so far

<!-- 只索引已关闭的决策票；细节只存在于对应子票。 -->

- [蓝湖访问与正式资源交付包](issues/01-lanhu-access-and-delivery.md) — 已确认登录完成，项目包含 9 个未分组画板；人工可打开画板并正常读取、导出、下载资源，后续可进入逐项资产盘点。
- [蓝湖页面与运行时资产清单](issues/02-lanhu-asset-inventory.md) — 已锁定蓝湖可确认事实与仓库侧全部语义接缝；当前无已确认可直接运行时资源，具体画板/切图/字体/状态图/标注需逐项人工补采，报告见 [研究报告](research/02-lanhu-asset-inventory.md)。
- [正式视觉系统与现有 token 映射](issues/03-visual-system-token-mapping.md) — 已锁定 token 保持稳定、按需新增语义 token、复杂效果才资源化、主画板优先、1280px 纵向滚动和状态推导规则；规格见 [正式视觉系统与现有 token 映射规格](specs/03-visual-token-mapping.md)。
- [运行时资产 manifest 与版本策略](issues/04-runtime-asset-manifest-and-versioning.md) — 已锁定 manifest 唯一入口、`public/cockpit`+BASE_URL、人工版本+内容 hash、原子发布、核心资源回滚、显式 fallback、远程资源登记和分环境诊断；规格见 [运行时资产 manifest 与版本策略规格](specs/04-runtime-asset-manifest-and-versioning.md)。
- [运行时资产 manifest 与版本策略规格](issues/09-runtime-asset-manifest-spec.md) — 已发布 `ready-for-agent` 实现规格，统一资产解析层承载 manifest 校验、版本/hash、原子发布、回滚、fallback、远程白名单和诊断；前置依赖为已关闭的运行时资产策略讨论票。
- [监测点与监测设备位置符号映射](issues/05-point-device-marker-mapping.md) — 已锁定「双层水滴徽标」体系：唯二纯白母版（实心/镂空）承载状态色、内层行业/设备图标降饱和降亮度、尖端锚定、宽度基准 18/14、无设备点位不用内层图标、监测点仅报警态加扩散环；并就地修订三处既有已锁口径；规格见 [监测点与监测设备位置符号规格](issues/10-point-device-marker-spec.md)。
- [监测点与监测设备位置符号规格](issues/10-point-device-marker-spec.md) — 已发布 `ready-for-agent` 实现规格，唯一新接缝为位置符号合成计划层，复用既有状态词表、资产接缝与色值来源；前置依赖为已关闭的位置符号讨论票。
- [字体授权与缺失资源降级](issues/06-font-and-fallback-policy.md) — 已锁定严格开源白名单（思源黑体/思源宋体/Crimson Text）+ 系统回退栈、不引入商用字体、系统字体不得打包、中文字体须子集化且保留回退链；缺口分级仅三类阻断发布；补全了「核心资源组」成员定义；规格见 [字体授权与缺失资源降级规格](issues/11-font-and-fallback-spec.md)。
- [字体授权与缺失资源降级规格](issues/11-font-and-fallback-spec.md) — 已发布 `ready-for-agent` 实现规格，复用既有资产解析层只新增授权门禁与缺口分级；明确代码只能校验许可证据齐全性、不声称判定授权合法性；前置依赖为已关闭的字体授权讨论票。
- [设计稿差异与现有业务结构保护](issues/07-design-diff-and-structure-boundary.md) — 已锁定七类差异判断表（默认归视觉、现状优先、升级必须立票），并列出已有裁决（不得重新打开）区；规格见 [设计稿差异与现有业务结构保护规格](issues/12-design-diff-structure-boundary-spec.md)。
- [设计稿差异与现有业务结构保护规格](issues/12-design-diff-structure-boundary-spec.md) — 已发布 `ready-for-agent` 实现规格，判断表为人工审查契约、不转自动化断言，结构保护由既有断言面承担；前置依赖为已关闭的设计稿差异讨论票。
- [分批替换与终稿验收方案](issues/08-batch-and-final-acceptance.md) — 已锁定 5 批次路线（品牌/图标 → token → 位置符号 → 字体 → 装饰；token 为位置符号前提、装饰最后）、每批进入条件与双轨验收、P0–P3 缺陷分级、双环境分开签收、1280px 视口检查、临时素材逐项关闭清单；并裁定把路线拆成 5 张执行票挂本图；规格见 [分批替换与终稿验收规格](issues/13-batch-acceptance-spec.md)。
- [分批替换与终稿验收规格](issues/13-batch-acceptance-spec.md) — 已发布 `ready-for-agent` 实施规格，定义执行票格式（进入自查 + 验收清单 + 证据区）与终稿验收六项报告；配套 5 张执行票（14–18）已同步发布，为实施阶段入口。
- [蓝湖 9 画板逐项盘点与正式切图交付](issues/19-lanhu-artboard-inventory.md) — 已盘点 9 个画板（全部 1440 宽，命名无语义）；**蓝湖侧无正式切图**：设计方只导出 25 个「光」图层，品牌位是渐变文字无 logo、四个功能图标在稿中为纯文字 chip；归档 59 个资产（sha256 索引，含去重留痕）并提取全稿色板、8 族字体与位置符号双层母版矢量；报告见 [盘点报告](research/19-lanhu-artboard-inventory.md)。

## Not yet specified

（当前无：原「蓝湖 9 画板逐项盘点」fog 已毕业为[票 19](issues/19-lanhu-artboard-inventory.md)。）

## Out of scope

- 改变四个一级模式、现有二级面板、`mode`/`panelId`、数据契约、地图图层语义、设备状态语义、拾取、定位、聚合或面板联动。
- 设备级或城市级真三维模型生产/采购，DEM、正式影像、倾斜摄影和 3D Tiles 的选型与生产。
- 移动端、竖屏、多屏拼接适配。
- 本图内直接实施代码改造、运行时部署或发布上线；这些是规格收口后的执行工作。