Inicio Explorar Axuda
Rexistro Iniciar sesión
ChenJZ
/
City-Lifeline-Cockpit
1
0
Fork 0
Ficheiros Incidencias 0 Pull Requests 0 Wiki
Árbore: a0703c090a
Ramas Etiquetas
City-Lifelin...
/
.scratch
/
cockpit-real-data-wayfinding
/
issues
/
25-25-cesium-ion-data-attribution.md

25-25-cesium-ion-data-attribution.md 8.6 KB
Histórico Raw

25: 前端执行票 —— 去除 Cesium ion 署名与 Data attribution 控件

Type: task Status: resolved Label: ready-for-agent Category: frontend-execution

来源

票 18 真人走查第 5 项（2026-10-10）：画面左下角存在 https://cesium.com/ 水印。

现状

引擎构造（services/cesiumEngine.js 的 viewer 选项）只关闭了 animation、timeline、geocoder、homeButton、sceneModePicker、baseLayerPicker，未关闭 creditContainer，因此 Cesium 默认署名容器保留在左下角。

本部署的事实前提：底图为 Cesium 自带离线 Natural Earth 影像，地形与精细影像均为本机/甲方本地目录（map.terrain.url、map.overlays[]），3D Tiles 为本地 CAD BIM 资产，不使用 Cesium ion 服务与 ion 资产。

范围

  1. 关闭 creditContainer（或在配置层提供显式开关），使界面不再出现 ion 署名与 Data attribution 按钮。
  2. 同步检查 cesium-ion 相关请求：不得在无 ion token 的情况下产生 ion 网络依赖或控制台报错。
  3. 保留必要的数据来源署名（本地影像 credit 等）在业务自有位置展示，不违反来源标注要求。

验收

浏览器实测：左下角无 cesium.com 署名与 Data attribution 按钮；控制台无 ion 相关报错；底图、地形、影像、3D Tiles 仍正常加载。

关联

发现于票 18。

进度

Status: resolved Assignee: codex Type: task Blocked by: Labels: ready-for-agent, frontend-execution, wayfinder:task

进度

  • 2026-10-10 认领。先更正本票的技术前提（见 Answer ①）：creditContainer 不是开关，按原文字面实施会无效。
  • 2026-10-10 按维护者裁定实施：①无条件隐藏 Cesium 署名；②数据来源署名并入右上角可折叠「地图摘要」状态日志；③引擎读数并入该日志并修掉从中间截断。
  • 2026-10-10 授权浏览器验收通过（捕获 db96957e694ba，335 请求、0 错误）。

Comments

Answer

① 先更正：creditContainer 不是开关

本票「现状」与「范围 1」隐含「creditContainer 是个可关闭的 viewer 选项」，核对 Cesium 源码后不成立：

  • Viewer 构造写死 defined(options.creditContainer) ? options.creditContainer : bottomContainer；
  • CesiumWidget 两条路径都会建 CreditDisplay（creditContainer.appendChild(innerCreditContainer)）。

所以传 false / '' 既关不掉，还会让 getElement() 拿到 null 而崩。真正生效的做法是自己给一个不进 DOM 的容器——Cesium 照旧把署名写进去，但它不在文档流里，屏幕上不出现。本票即按此实现（services/cesiumEngine.js）。

② 合法性：隐藏成立，但有前提

已核实全链路零 ion 依赖：地形 CesiumTerrainProvider.fromUrl(本地 URL)、影像为内置 TMS 与 UrlTemplateImageryProvider、3D Tiles 为 Cesium3DTileset.fromUrl(本地 URL)；源码中无 Cesium.Ion / defaultAccessToken / createWorldTerrain / ion 资产。Cesium 的 ion 署名义务只在用到 ion 资产时成立，故本部署隐藏 ion 署名不构成违约。

该前提已写成回归断言（检测到任一 ion 依赖即失败）——日后若有人引入 ion 资产，测试会先红，而不是静默违约。

③ 交付（方案已按维护者反馈二次修正）

  1. 隐藏署名：createViewer 自建离屏 creditContainer 并传给 Viewer。
  2. 并入外壳既有状态面板（MapInfoPanel.vue，纯内容块）：除顶部中央的状态筛选图例（决策 02 的全局入口，必须常驻）外，地图上其余信息全部并入外壳那个已有的状态面板（CockpitShell.vue 的 cockpit-shell__status-details，与「数据分区」「状态推送」「更新」同框），展开/收起也复用外壳那一个开关。
    • 这一版是改过的：第一版另起了一个右上角可折叠面板，维护者指出它与顶部图例、外壳面板互相占用容器（图一 vs 图二）。现已取消该容器，只剩一个。
  3. 修掉截断：引擎读数原本带 nowrap + overflow:hidden + ellipsis，长句被从中间切断（正是「左右显示不完整」）。mapService.js 已改为布局中性 + 换行，内容块内再 !important 兜底。
  4. 自有署名不丢：mapService 从同一批图层计划（底图/叠加影像/3D Tiles）收集 credit，由内容块展示。
  5. 修掉「容器异常占用」与编码被裁（图三）：
    • 嵌入态解除浮块遗留的 max-height: 30%、加 align-self: start，只占内容该占的高度；
    • 清单列表自带 max-height + 自身滚动，不再把外层撑高；
    • 「名称 / 编码」由并排两列改为上下两行：并排时编码列是 auto 轨道会撑到 max-content，把整行顶出 560px 宽的面板，长编码被从右侧切掉（0500…、PS00…）。
  6. 顺带修掉两处自查/走查发现的真缺陷：.map-blocked.is-compact 优先级压过嵌入样式导致「无地图位置」被挤成竖排；STATUS_STYLE 重复声明。

④ 验收（浏览器实测）

方案二次修正后重跑（合并进外壳状态面板的版本）：

验收项 实测 判定
无 cesium.com 署名 / Data attribution 可访问性树中已无 link "Cesium ion" 与 button "Data attribution" 通过
控制台无 ion 报错 捕获期 0 errors 通过
无 ion 网络依赖 335 条请求中匹配 ion 的 0 条 通过
底图/地形/影像/3D Tiles 仍加载 读数「底图：内置离线影像 Natural Earth II · 地形：dem · 叠加影像 1 层 · 3D Tiles 1 个」，画面管线与标记正常 通过
引擎读数完整不截断 整句换行显示 通过
只有一个容器 地图信息已落在外壳状态面板内，与「数据分区/状态推送/更新」同框，顶部图例无遮挡 通过（截图确认）
图层清单渲染 「管线图层 监测点 事件定位 应急资源」出现在面板内 通过（截图确认）
清单容器不异常占空 嵌入态解除 max-height:30%、清单自身滚动 通过（截图确认）
长编码不再被裁 名称/编码上下两行，长编码（41010500001320000001/…）完整显示 通过（截图确认）
展开后清单宽度撑满容器 展开「查看原因」后清单占满状态面板整宽，「查看原因」按钮贴到容器右边缘 通过（截图确认）

补充修复（维护者第三次走查：展开后清单宽度与容器严重不符）

根因：.map-info 是 display: grid，而我在它上面写了 justify-items: start。 justify-items 会作用到所有子项，让它们按 fit-content 收缩而不是撑满容器 —— 展开的坐标准入清单因此比容器窄一大截。

修法：删掉该 justify-items（恢复默认 stretch），并显式加 .map-info > * { justify-self: stretch; min-width: 0; max-width: 100% } 作为防御， 避免日后有人再给父级加对齐规则把它收窄；图层小标签那一行用自身的 justify-self: start 保持按内容排。该约束已写进回归断言（justify-items 不得再出现）。

前两次走查提出的「容器异常占空」与「长编码被裁」两项，本轮一并取到了截图证据，均已通过。

⑤ 回归

  • 新增 [t25-credit-info-panel.mjs](../verify/t25-credit-info-panel.mjs)：署名离屏、无 ion 依赖、署名归面板、地图只留图例、并入外壳那一个容器、内容块自身不定位/不自带开关、不得截断、嵌入态不占空、清单单列、图层清单必须渲染、子项必须撑满容器宽度 —— 全部通过。
  • 布局闸门：9 失败，与「把本票改动（MapInfoPanel.vue/MapCoordinateBlocked.vue）git stash 后重跑」得到的失败集合完全一致（零回归）。
    • t37/t38：HEAD 的 CockpitShell.vue 本身就没有 data-area-state/data-fog-chip（提交 777f061 起），与本票无关。
    • t05-adapter（D1-stores/overviewStore.js-no-raw-fields）：来自票 16 对 overviewStore.js 的改动，不在本票改动集内。
    • 其余为既有环境类失败（缺 puppeteer-core 模块等）。
  • 按 AGENTS.md 未运行生产构建；浏览器验收在明确授权后进行，开发服务与浏览器会话已关闭。