SuperAPI AI 工具集

code-map-visualization

数据与分析

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能是代码库投影并地理哈希成二维地图后的渲染与感知层,负责让地图忠实、快速、可读、可交互、可动画且无障碍。它不包含空间数学,地理哈希编码、代码到平面的投影、包围盒/覆盖集查询、切片与精度↔缩放导航模型由配套技能 geohash-spatial-code-maps 负责。

主要能力按 9 类规则组织:视觉编码与感知通道(encode-,把决策指标放在位置/长度而非色相,大小按面积映射,分类与数值分离,冗余编码关键信号,去除图表垃圾);颜色与感知色标(color-,用 viridis/OKLCH 等感知均匀色阶而非彩虹,色标类型匹配数据,为色觉缺陷设计,分类色相约 8–12 种,控制与底图对比度);GPU 渲染管线(gpu-,Canvas2D 叠加于 WebGL,实例化绘制、批处理、类型化数组打包、图集、按 devicePixelRatio 设置画布);渲染性能与帧预算(perf-,单 raf 循环、仅重绘脏区、防抖视口重算、Worker/OffscreenCanvas 卸载、限制瓦片缓存);标签与文字(text-,贪心防碰撞、按细节层级显示、Canvas2D 原生绘制、加光晕、按区域质心锚点);交互、拾取与相机(interact-,GPU 颜色 ID 或空间索引拾取、一帧内悬停反馈、相机模型、URL 同步视图状态、键盘平移缩放);动画与过渡(anim-,缓动相机、LOD 交叉淡入、按地理哈希保持对象恒常、可中断);无障碍(access-,不只靠颜色、尊重 prefers-reduced-motion、键盘可操作、画布文本替代);仿自然与细胞布局(bio-,Voronoi 区域、权重松弛、圆堆叠、叶序填充、metaball 轮廓、边捆绑、流场)。

使用方式:按需阅读单个参考文件了解详细说明、代码示例与不适用场景;规则间通过 [[other-rule-slug]] 交叉链接,指向配套技能的规则需到那里阅读空间数学。端到端构建的骨架为:决定编码→选颜色→搭建 GPU 管线→守住帧预算→加入标签、交互、动画与无障碍→在合适时采用有机细胞渲染。上游投影与切片来自 geohash-spatial-code-maps。示例面向 TypeScript 配合 Canvas2D + WebGL/deck.gl 与 d3-scale/d3-color,感知推理可推广到任意渲染栈。

适用场景:网页端绘制数万至数百万单元并保持交互帧率;为代码地图放置与排布标签;接线悬停、拾取、选择、相机视图状态、深链与键盘控制;在不令观察者迷失的前提下动画相机、LOD 与数据更新;让画布对色觉缺陷、动效敏感、仅键盘及屏幕阅读器用户可访问。

限制:资料未提供安装命令、版本、收费、价格或平台信息;本技能只覆盖渲染与感知,不外带空间数学,相关规则需跳转配套技能。