SuperAPI AI 工具集

wcygan-graphic-demos

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:构建和维护文章原生(article-native)图形演示,通过可检查状态、清晰动效和响应式呈现,讲解一个具体的软件或数据系统概念。目标是让演示只教一个在正文中被点名的概念或不变式,并让演示源码、文章嵌入、样式与验证证据彼此一致。

主要能力:

  • 提供参考文档:动效打磨(ui-motion-polish)、界面设计(ui-design)、Canvas 渲染生命周期、Web 动画技术、Playwright 视觉验证等,需在对应工作前阅读。
  • 演示类型分类:连续相位循环、离散自动播放/分步、场景选择、参数化模型、实时动作或异步探测、空间参考、静态参考或画廊、环境循环;建议选用能暴露不变式的最简选项。
  • 本地架构:模型(model)、引擎(engine)、渲染器(render-canvas)、视口(viewport)、测试(model.test.ts)与 React 组件分工;简单演示可保留为组件内模型。
  • 表示形式选择:Canvas 2D 用于动画包流、时间线、环形与密集状态图;SVG 用于固定标签与路径的小型矢量图;DOM/CSS 用于控件、条形、表格等;Leaflet 用于真实地图瓦片;ASCII 翻页用于由 src/data/.json 生成的帧数据;静态 Mermaid SVG 由 src/diagrams/<slug>/.mmd 编译到 public/<slug>/*.svg。

必要用法:先追踪文章,打开导入组件的 MDX 文件,读嵌入前后的段落,用一句话说明概念,并在改代码前命名不变式(如实体路由、复制延迟、乐观锁、一致性哈希)。动效需映射到具名相位,只在挂载后运行,尊重 reduced motion,页面隐藏时暂停,并在 effect 或引擎的 destroy() 中清理动画帧、观察器、监听器与地图实例。无障碍方面应放在 <figure> 中,补充 figcaption、图例、时间线或状态文本,并写明描述真实状态转换的 aria-label、<title> 或 <desc>。

验证命令:模型或相位改动运行 deno task test src/demos/<name>/model.test.ts;类型或组件改动运行 deno task typecheck;大范围演示或文章改动运行 deno task pre-commit。视觉变化需检查桌面与手机宽度视口,确认 canvas 或 SVG 非空白、标签不溢出、控件可用、无横向溢出,并检查 reduced motion 下仍能传达同一不变式。

适用场景:wcygan.net 文章中讲解分布式系统或数据系统概念的交互式或静态图形演示。

限制:本资料未提供安装命令、收费、价格、平台要求或效果保证等信息。