Knowledge RAG

设计知识库

由社区维护、审核后发布，并在 Agent 页面创作前被 RAG 检索为设计约束。

6 条已发布原则 / 全库 192 条

Maki 这类 POI 图标集只解决地图符号，不等于解决地图数据、瓦片、样式、底图 provider、地点标签和交互归因。

地图符号是一层视觉编码。agent 必须把 icon set、sprite、地图样式、地理数据、瓦片 provider、图例和可访问标签分开治理，避免把图标许可误当地图许可。

地图界面必须把运行时库、瓦片、样式、glyph、sprite、地理数据和 provider 归因分别记录，并提供列表/表格替代和键盘可达路径。

地图不是一张背景图。它是复杂数据可视化、交互控件和授权对象的组合；用户必须能理解位置、范围、选中对象、数据来源、更新时间和替代访问方式。

图表需要标题结论、文本摘要、冗余编码和数据表替代；Canvas 或 SVG 本身不能自动等于可访问。

数据可视化是一种非文本内容和交互内容。它必须让看不见图、无法辨色、只用键盘、缩放页面或使用屏幕阅读器的人获得等价结论和数据路径。

图表必须记录 filter、aggregate、bin、timeUnit、join、missing value 和排序逻辑；否则用户无法审计图表为什么这样显示。

数据可视化的可信度不仅来自图形，还来自可解释的数据转换链。每个聚合、过滤和派生字段都应能追溯。

先明确用户要判断的数据关系，再选图表类型和前端库；不要从“我想要一个漂亮图表”开始。

指标卡不是大数字装饰；每张卡都要说明指标定义、时间范围、比较基线、单位、数据状态和下一步行动。

Dashboard 首屏应先回答用户当下该判断什么，而不是把所有数据压成等权图表墙。指标卡是决策入口，需要有语义和证据链。