map.md 11 KB
城市生命线驾驶舱蓝湖正式素材替换方案（决策地图）
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/浏览器调试；实现阶段需另行遵守该限制，除非用户明确要求验证。
任务清单
- 蓝湖访问与正式资源交付包
- 蓝湖页面与运行时资产清单
- 正式视觉系统与现有 token 映射
- 运行时资产 manifest 与版本策略
- 运行时资产 manifest 与版本策略规格
- 监测点与监测设备位置符号映射
- 监测点与监测设备位置符号规格
- 字体授权与缺失资源降级
- 字体授权与缺失资源降级规格
- 设计稿差异与现有业务结构保护
- 设计稿差异与现有业务结构保护规格
- 分批替换与终稿验收方案
- 分批替换与终稿验收规格
- 执行-批次1：品牌/图标替换
- 执行-批次2：面板视觉 token 替换
- 执行-批次3：地图/设备位置符号替换
- 执行-批次4：字体接入
- 执行-批次5：装饰/纹理替换
- 蓝湖 9 画板逐项盘点与正式切图交付
进度
已完成全部目标、范围与偏好澄清；决策阶段收口。当前地图含 19 张子票：8 张决策票全部 resolved（01–08）；5 张规格子票已发布 ready-for-agent（09 manifest、10 位置符号、11 字体、12 差异判断表、13 批次与终稿验收）；5 张执行票已发布 ready-for-agent（14 品牌/图标、15 面板 token、16 位置符号、17 字体、18 装饰），是实施阶段的可认领入口；1 张盘点任务票已 resolved（19 蓝湖 9 画板逐项盘点，由 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
- 蓝湖访问与正式资源交付包 — 已确认登录完成，项目包含 9 个未分组画板；人工可打开画板并正常读取、导出、下载资源，后续可进入逐项资产盘点。
- 蓝湖页面与运行时资产清单 — 已锁定蓝湖可确认事实与仓库侧全部语义接缝；当前无已确认可直接运行时资源，具体画板/切图/字体/状态图/标注需逐项人工补采，报告见 研究报告。
- 正式视觉系统与现有 token 映射 — 已锁定 token 保持稳定、按需新增语义 token、复杂效果才资源化、主画板优先、1280px 纵向滚动和状态推导规则；规格见 正式视觉系统与现有 token 映射规格。
- 运行时资产 manifest 与版本策略 — 已锁定 manifest 唯一入口、
public/cockpit+BASE_URL、人工版本+内容 hash、原子发布、核心资源回滚、显式 fallback、远程资源登记和分环境诊断；规格见 运行时资产 manifest 与版本策略规格。 - 运行时资产 manifest 与版本策略规格 — 已发布
ready-for-agent实现规格，统一资产解析层承载 manifest 校验、版本/hash、原子发布、回滚、fallback、远程白名单和诊断；前置依赖为已关闭的运行时资产策略讨论票。 - 监测点与监测设备位置符号映射 — 已锁定「双层水滴徽标」体系：唯二纯白母版（实心/镂空）承载状态色、内层行业/设备图标降饱和降亮度、尖端锚定、宽度基准 18/14、无设备点位不用内层图标、监测点仅报警态加扩散环；并就地修订三处既有已锁口径；规格见 监测点与监测设备位置符号规格。
- 监测点与监测设备位置符号规格 — 已发布
ready-for-agent实现规格，唯一新接缝为位置符号合成计划层，复用既有状态词表、资产接缝与色值来源；前置依赖为已关闭的位置符号讨论票。 - 字体授权与缺失资源降级 — 已锁定严格开源白名单（思源黑体/思源宋体/Crimson Text）+ 系统回退栈、不引入商用字体、系统字体不得打包、中文字体须子集化且保留回退链；缺口分级仅三类阻断发布；补全了「核心资源组」成员定义；规格见 字体授权与缺失资源降级规格。
- 字体授权与缺失资源降级规格 — 已发布
ready-for-agent实现规格，复用既有资产解析层只新增授权门禁与缺口分级；明确代码只能校验许可证据齐全性、不声称判定授权合法性；前置依赖为已关闭的字体授权讨论票。 - 设计稿差异与现有业务结构保护 — 已锁定七类差异判断表（默认归视觉、现状优先、升级必须立票），并列出已有裁决（不得重新打开）区；规格见 设计稿差异与现有业务结构保护规格。
- 设计稿差异与现有业务结构保护规格 — 已发布
ready-for-agent实现规格，判断表为人工审查契约、不转自动化断言，结构保护由既有断言面承担；前置依赖为已关闭的设计稿差异讨论票。 - 分批替换与终稿验收方案 — 已锁定 5 批次路线（品牌/图标 → token → 位置符号 → 字体 → 装饰；token 为位置符号前提、装饰最后）、每批进入条件与双轨验收、P0–P3 缺陷分级、双环境分开签收、1280px 视口检查、临时素材逐项关闭清单；并裁定把路线拆成 5 张执行票挂本图；规格见 分批替换与终稿验收规格。
- 分批替换与终稿验收规格 — 已发布
ready-for-agent实施规格，定义执行票格式（进入自查 + 验收清单 + 证据区）与终稿验收六项报告；配套 5 张执行票（14–18）已同步发布，为实施阶段入口。 - 蓝湖 9 画板逐项盘点与正式切图交付 — 已盘点 9 个画板（全部 1440 宽，命名无语义）；蓝湖侧无正式切图：设计方只导出 25 个「光」图层，品牌位是渐变文字无 logo、四个功能图标在稿中为纯文字 chip；归档 59 个资产（sha256 索引，含去重留痕）并提取全稿色板、8 族字体与位置符号双层母版矢量；报告见 盘点报告。
Not yet specified
（当前无：原「蓝湖 9 画板逐项盘点」fog 已毕业为票 19。）
Out of scope
- 改变四个一级模式、现有二级面板、
mode/panelId、数据契约、地图图层语义、设备状态语义、拾取、定位、聚合或面板联动。 - 设备级或城市级真三维模型生产/采购，DEM、正式影像、倾斜摄影和 3D Tiles 的选型与生产。
- 移动端、竖屏、多屏拼接适配。
- 本图内直接实施代码改造、运行时部署或发布上线；这些是规格收口后的执行工作。