为什么需要安装 GitHub App？解锁 GitHubCard 的完全体

在使用 GitHubCard 的过程中，你可能注意到了我们推荐安装我们的 GitHub App。你可能会问：“我已经用 GitHub 账号登录了，为什么还需要再安装一个 App？”

这篇文章将为你详细解答这个疑问，带你了解 GitHub App 背后的机制、它带来的巨大优势，以及我们如何确保你的数据安全。

核心原因：突破 API 速率限制

这是最直接、最重要的原因。

GitHub 对 API 调用有着严格的限制（Rate Limiting）。

• 未验证请求：每小时仅 60 次。
• OAuth 登录用户：每小时 5,000 次。

听起来 5,000 次很多？对于个人浏览确实够用。但请记住，GitHubCard 是一个高并发的展示平台。当你的卡片被放在热门项目的 README 中，或者你的博客文章被大量阅读时，每一次页面加载都可能触发一次 API 调用（在缓存未命中的情况下）。

GitHub App 的优势在于： 它拥有独立的、更高的 API 配额。更重要的是，通过 GitHub App 获取的数据可以更高效地利用我们服务端的缓存策略，确保在高流量下你的卡片依然能秒级加载，而不会显示尴尬的 "API Rate Limit Exceeded"。

更多好处：解锁高级功能

除了解决限流问题，安装 GitHub App 还能解锁一系列增强功能：

1. 自动 Webhook 更新

这是 GitHub App 最强大的特性之一。

• 现状：当你更新了 GitHub 简介或 Star 了一个新仓库，GitHubCard 的缓存通常需要等待 1 小时甚至更久才会过期刷新。
• 安装 App 后：GitHub 会在数据变更时主动向我们发送 Webhook 通知。我们会即时清除旧缓存，让你的卡片数据实时更新，无需人工干预。

2. 访问组织仓库 (Organization Repos)

如果你是某个 GitHub 组织的成员，想要为组织项目制作展示卡片，OAuth 令牌往往权限不足或需要繁琐的额外授权。GitHub App 可以在安装时精细控制权限，让你轻松选择并授权特定的组织仓库，既方便又安全。

3. 更精细的权限控制

OAuth 往往要求较为宽泛的权限范围（Scopes）。而 GitHub App 采用更现代的权限模型，我们只申请生成卡片所必须的最小权限集（通常只是读取公开数据）。你可以随时在 GitHub 设置中查看或撤销这些权限。

何时需要安装？

• 高频展示场景：如果你的卡片用于热门开源项目的 README，或者你的个人网站流量较大。
• 组织用户：需要为 GitHub Organization 下的仓库创建卡片时。
• 追求极致体验：如果你希望数据更新更及时，服务更稳定。

如何安装？

过程非常简单，只需不到 1 分钟：

1. 登录 GitHubCard 控制台。
2. 点击 "Install GitHub App" 按钮。
3. 跳转到 GitHub 官方授权页面。
4. 选择你要授权的账户（个人或组织）。
5. 选择授权范围（推荐 "All repositories" 以便未来无缝使用，或者 "Only select repositories" 以手动指定）。
6. 点击 "Install & Authorize"。

完成后，你将自动跳转回 GitHubCard，系统会自动识别并升级你的配额。

安全承诺：我们如何保护你的数据

我们深知信任是服务的基石。关于 GitHub App 的安全性，请你放心：

• 只读权限 (Read-Only)：我们的 App 核心权限是只读的。我们绝不会（也无法）修改你的代码、删除你的仓库或进行任何破坏性操作。
• 最小权限原则：我们只申请渲染卡片所必须的元数据（Metadata）、内容（Contents，仅用于读取配置文件）等权限。
• 数据隔离：你的 Token 和授权信息均加密存储，且仅用于为你提供服务。
• 随时撤销：你拥有完全的控制权。随时可以在 GitHub 的 Settings -> Applications -> Installed GitHub Apps 中卸载我们的 App，我们将立即失去所有访问权限。

总结

安装 GitHub App 是从“试用”到“生产环境”的关键一步。它不仅消除了 API 限制的焦虑，更为未来的实时更新和高级功能打下了基础。

如果你正在认真经营你的 GitHub 形象，我们强烈推荐你完成这一步简单的集成。

立即安装 GitHub App →

还没有卡片？可以先从 GitHub 个人名片生成器 或 GitHub 仓库卡片生成器 开始。

---

GitHubCard Team