这个项目能做什么

Smokey 是一个静态的单文件开发者仪表盘,用于监控 GitHub 仓库的健康状况。在浏览器中打开 index.html,输入 GitHub 用户名或组织名称,以 owner/repo 格式列出仓库,页面会在一个可排序的表格中显示它们的当前状态。其目标是无需在 GitHub 上点击来回切换即可查看仓库健康状况。 表格显示的内容 - 每个仓库的最后一次推送,默认按最旧的推送先列出;任何列标题(仓库、最后推送、PR、问题)均可点击以重新排序。 - 最新发布的版本号和发布日期,显示在仓库名称下方。 - 开放的拉取请求和问题的数量;点击数量会打开该仓库的过滤后的 GitHub 页面。 - 注意徽章:一个用于开放 PR 的行和一个用于开放问题的行,仅在存在外部贡献者活动的仓库中出现,每个徽章均链接到过滤后的 GitHub 视图。机器人作者的 PR(例如来自 github-actions[bot])会被自动过滤掉。 身份验证 公开仓库无需登录即可加载。可在设置面板中可选添加 GitHub 个人访问令牌(PAT),以解锁私有仓库和 CI 状态列;对于受 SAML SSO 保护的组织仓库,如果令牌已获得该组织的授权,则需要令牌。由于未经身份验证的 API 访问每小时限制为 60 次请求,而每个仓库消耗四次请求,因此监控大约十五个公开仓库时需要令牌;经过身份验证的令牌可将限制提升至每小时 5,000 次请求。README 说明令牌仅存储在浏览器的 localStorage 中,并且仅发送到 api.github.com。经典令牌(repo 范围)和细粒度令牌(Contents: Read, Metadata: Read, Actions: Read 用于 CI 状态)均有描述。 流量图表 仪表盘不使用 GitHub 的实时流量 API,而是通过保存在 traffic-log 分支中的每日快照绘制完整历史流量面积图,该快照由单独的每周 GitHub Actions 工作流(log-traffic.yml)累积生成。图表使用对数时间轴,以扩展最近几天的显示,并采用平方根值刻度。此视图不需要令牌。如果该分支或记录的行尚不存在,图表将报告无流量历史。 托管与设置 无需构建步骤、依赖安装或服务器。GitHub Pages 提供的托管副本可直接使用,无需安装任何内容;否则可下载 index.html 并在本地打开。要运行自己的实例, fork 该仓库并在主分支根目录启用 GitHub Pages。布局被描述为移动友好且紧凑,无侧边栏。 README 还记录了故障排除情况:缓存过时的页面会持续显示“添加 PAT”消息(通过硬刷新解决,注意在私密窗口中会清除 localStorage),由未经身份验证的速率限制或缺少 SAML 授权导致的 403 错误,以及在添加仓库后流量图表保持为空,直到日志工作流至少运行一次。 许可证与联系:MIT 许可证,版权所有 2025 Scott Kirvan。欢迎通过问题、分叉和拉取请求贡献;列出的联系渠道包括 LinkedIn 和 Discord 服务器,仓库的 notes 文件夹中还包含 CHANGELOG 和 TODO。