SuperAPI AI 工具集

animated-github-profile

编程与开发

查看项目

更新于 11-15 03:20

技能介绍

用途

该技能用于设计、改造或生成 GitHub 个人主页 README(仓库名与用户名一致的 username/username),在 GitHub 对 Markdown 的 HTML 清理限制下,用纯 SVG、CSS @keyframes 和 SMIL 实现动效元素,并支持暗色/亮色主题自适应的图片资源。它主要作为指南与代理指令集,而非可直接使用的成品素材。

主要能力

  • 首屏横幅:banner.svg 与 banner-light.svg,viewBox 为 0 0 1200 480,包含 macOS 窗口控制点、带脉冲状态指示的状态胶囊、终端问候语、逐字显现的渐变名字、CSS 循环切换的职位标题、模拟 IDE 代码打字与闪烁光标、全宽激光扫描条、背景光晕呼吸动画,并提供亮色配色变体。
  • 摆动挂绳工牌:lanyard.svg,viewBox 为 0 0 460 380,含织带、金属扣、玻璃拟态卡体、芯片、头像圈、开发者信息、矢量条码,使用阻尼摆动关键帧与无限轻微漂移、全息眩光扫过。
  • 技术轨道系统:stack.svg,viewBox 为 0 0 680 380,含发光核心、三层虚线椭圆轨道、不同速度公转的技术卫星,以及右侧能力矩阵。
  • 动态贡献可视化:通过 GitHub Actions 定时生成贡献蛇(Platane/snk)或 3D 等距城市天际线(yoshi389111/github-profile-3d-contrib),并推送到输出分支。
  • README 组装:用 <picture> 元素实现暗/亮模式切换,配合带版本参数的图片链接与项目、联系方式区块模板。

使用方式

  1. 用任意 AI 图像生成器按给定提示词生成角色插画,要求纯白或透明背景,生成 3–4 个版本择优。
  2. 将各 SVG 的设计规格提示词交给 AI 编码助手,产出独立 SVG 文件。
  3. 按示例创建 .github/workflows/snake.yml 或 profile-3d.yml 工作流,定时重新生成贡献动画并推送到 output 分支。
  4. 在 README.md 中按示例用 <picture>、<img> 与 <div> 组装各模块,并为本地图片链接加版本查询参数。

适用场景

希望在不使用 JavaScript 的前提下为 GitHub 主页加入动效、主题自适应视觉与自动更新贡献图的开发者。

限制与注意事项

  • GitHub 会移除 <script>、事件监听和内联 JavaScript,无法实现交互游戏或动态 DOM 操作;SVG 动画在不同浏览器和图片上下文中支持程度不一。
  • GitHub 通过 Camo 代理缓存外部图片,更新 SVG 后需提升 ?v= 参数,并先推送 SVG 再推送 README。
  • 在 SVG 中嵌入 Base64 图片时应使用 PNG,Safari 无法解码独立 SVG 内的 Base64 WebP。
  • 独立 SVG 按 XML 解析,需转义 &、<,注释不能包含 --,<style> 建议放入 CDATA。
  • 打字显现的裁剪区域需留足上下内边距(约 8–12px),避免字形被裁切。
  • 需为禁用动画的环境提供完整静态状态,并用 prefers-reduced-motion 关闭 CSS 动画;SMIL 需单独的静态回退。
  • 多文件 SVG 的渐变等 ID 需按文件加前缀,避免内联时冲突。
  • 大量复杂滤镜或深层 SMIL 循环会增加移动端 CPU 与耗电。
  • 使用 Actions 推送资源应授予最小权限(如 contents: write),核对第三方 action 的 SHA 与输出路径;固定 SHA 本身不等于安全审计。3D 城市示例写入当前分支,可能被分支保护阻止,应改用经批准的分支/PR 流程,而非削弱保护。
  • 不得虚构安全许可、任职或贡献数据;保留描述性 alt 文本与可读的静态回退;应通过托管后的 README 图片路径测试,而非仅本地打开 SVG。
  • 文中 SVG 提示词为设计规格,不是随附的可用素材。