GitCity

GitCity 是什么？

GitCity 将用户的 GitHub 贡献历史转化为交互式等距 3D 城市天际线。核心理念是，每一天的公开贡献变成一座“建筑”，提交活动影响高度，让你以视觉方式探索活动，而非网格形式。

它适用于希望以更吸引人格式呈现贡献数据的 GitHub 用户——如在 README 或开发者作品集中嵌入 SVG——只需输入 GitHub 用户名，无需手动设置。

主要功能

• 基于 GitHub 贡献的交互式等距 3D 城市：根据公开贡献活动构建天际线，让查看者一目了然地理解模式。
• 可驾驶城市模拟：包含模拟模式，可从“街头视角”导航城市，空间考察天际线。
• 主题切换（6 种主题）：提供 Matrix、Noir、Aurora、Ocean、Gold 和 Ice 等主题视觉效果，匹配不同审美偏好。
• 按年、月或周过滤时间：可将可视化限制在特定时间范围内，而非仅显示完整历史。
• 可嵌入 SVG，用于 GitHub README 和作品集：生成 SVG 嵌入，便于在开发者个人资料和项目页面中使用可视化。
• 仅需 GitHub 用户名，即零配置：使用输入的用户名自动获取公开贡献数据，减少设置步骤。

如何使用 GitCity

1. 打开 GitCity，输入你的 GitHub 用户名。
2. GitCity 获取你的 公开贡献数据，渲染城市，其中有提交的日子显示为建筑。
3. 使用 主题控件 更改外观，过滤控件 聚焦于 年、月或周。
4. 若需分享，使用 可嵌入 SVG 选项生成嵌入代码，用于你的 GitHub README 或开发者作品集。
5. （可选）切换至 模拟模式，驾驶穿越城市，从街头视角探索。

使用场景

• 个人 GitHub README 可视化：在 README 中嵌入生成的 SVG，以 3D 天际线展示贡献活动，而非静态图表。
• 作品集展示：在开发者作品集页面包含城市可视化，提供编码活动的概览。
• 时间范围审查（月度或周度）：按月或周过滤，审视贡献量在较短周期内的变化。
• 通过美学讲故事：在项目页面或社交资料中呈现天际线时更改主题（如 Noir 或 Aurora）。
• 贡献“漫游”探索：使用模拟模式导航城市，视觉解读提交密度的模式。

常见问题

• GitCity 使用什么数据？

  GitCity 获取你输入用户名对应的 公开 GitHub 贡献数据。

• GitCity 如何将提交映射到 3D 城市？

  根据页面说明，有提交的每一天变成一座建筑，提交越多，塔楼越高。

• 能否将可视化限制在特定时间范围？

  可以。GitCity 包含 年、月或周 过滤器。

• 能否在其他页面嵌入可视化？

  可以。GitCity 提供 可嵌入 SVG，专为 GitHub README 和 开发者作品集 设计。

• 除了 GitHub 用户名，还需配置什么？

  页面描述为 零配置，仅需输入 GitHub 用户名。

替代方案

• GitHub 贡献可视化（2D 热图/图表）：这些替代方案通常以网格或图表呈现贡献，而非 3D 城市和模拟；更简单但空间感较弱。
• 作品集/静态 GitHub 统计小部件：生成徽章或静态摘要的工具易于嵌入，但通常无驾车城市体验或时间范围 3D 视图。
• 基于 GitHub API 数据自定义可视化：DIY 方法可生成定制视觉（含 3D），但将设置和维护负担转给用户，而非零配置流程。