# 图表 UI/UX 与发布归属检查

2026-09-14 · v0.10.0

## 组件调研与选择

- [AntV G2 Tooltip](https://g2.antv.antgroup.com/en/manual/component/tooltip) 与[交互机制](https://g2.antv.antgroup.com/en/manual/core/interaction/overview)：提供可配置提示和图表交互，适合后续复杂交互图表。
- [Apache ECharts 无障碍能力](https://echarts.apache.org/handbook/en/best-practices/aria/)：支持自动描述和图案等非颜色编码。
- 本版保留本地 SVG 数据渲染，新增统一交互模块。现有模块已覆盖历史快照、缺失断线、真实零值和多平台分组；替换渲染库仍需要迁移这些业务语义。统一模块使用本地静态资源，不依赖 CDN。

## 检查发现与修复

| 优先级 | 发现 | 本版处理 |
| --- | --- | --- |
| P1 | 数据点只有原生 title，无法可靠即时查看数值与时间 | HTML 浮层，悬停、聚焦、点击均可查看；显示原始数值、日期、平台及采集来源 |
| P1 | 数据点小，鼠标难以命中 | 鼠标接近节点即可触发；键盘聚焦、Enter/Space 触发，Escape 关闭 |
| P1 | 窄窗口提示易被裁切 | 浮层附着当前页面并按可视区域定位；滚动、缩放和节点移除后清理 |
| P2 | 坐标缩放后过小、颜色对比不足 | 调整坐标字号、时间刻度、网格线与系列色；系列色对白底对比均超过 3:1 |
| P2 | 指针移动反复创建提示内容 | 同一节点复用内容，缓存节点范围 |
| P1 | 发布链接归属可为空 | 官方链接强制选题；达人链接强制 KOL 和 Campaign；界面、Agent 工具说明和数据层共同约束 |
| P1 | 历史无归属数据与新校验不兼容 | 历史记录仍可读取，列表提供“待绑定”筛选；编辑链接时补齐，禁止猜测归属 |

保持原有多图表配置、筛选、缺失断线、真实零值和数据明细。归档被发布链接引用的选题、达人或 Campaign 会被阻止，需先处理引用。

### 内容对比分组（v0.10.2）

内容对比以选题为横轴分类，同一选题的各平台发布并排显示，图例区分平台。平台数据保持独立，不累加成一个总值。同选题同平台有多条发布时分别保留；缺少发布或指标不补零。未关联选题的达人发布按 KOL 与 Campaign 分组，历史无归属记录独立展示，不根据标题猜测归属。默认选择保留完整分组，已有用户手动选择保持不变。

v0.10.4：横轴名称不再重复“选题：”。有发布记录但当前指标缺失时显示非数值占位，并区分尚无采集与已有采集但未包含该指标；没有该平台发布记录的槽位保持空白。观看量缺失不能用点赞代替，也不能补零。

## 验证范围与边界

### 北极星发布标注（v0.11.0）

每张北极星图表在编辑区提供“发布标注”多选下拉框，独立保存选题选择，默认不显示标注。通过发布记录的实际发布日期对齐每日指标时间轴，带时区时间戳按本地日期对齐；不使用计划排期代替实际发布。相同日期的发布合并为一个淡色标记，悬停或键盘聚焦展示选题、平台和日期。标注只在实际绘图日期范围内显示，不遮挡数值节点，不改变指标值或数据范围；同期变化不代表内容归因。

隔离数据目录中验证官号/达人保存、必填校验、后端拒绝无归属链接、浮层鼠标/键盘交互及 1100px/400px 视口边界。测试数据不写入用户正式数据目录。自动化测试覆盖快照与数据模型、归属规则及交互。

本版未重启用户实际 DSH Desktop；需要重启加载后确认宿主内表现。历史链接的业务归属必须由用户确认，不自动批量分配。