用途:为单个 GitHub 仓库生成单屏分析仪表盘,采用 FlowAI / Soft Paper 视觉风格(暖白画布、白色圆角面板、固定左侧栏、紧凑 KPI 卡片、柔和标签、密集表格、低对比细线)。适用场景包括仓库增长看板、开源项目健康报告、stars/forks/贡献者分析、issue 与 PR 活动页、维护者/贡献者看板。
主要能力:解析 owner/repo 范围;通过 GitHub CLI/API 采集公开数据,如 GET /repos/{owner}/{repo} 获取 stars、forks、watchers、open issues;分页获取 contributors 并取前 N;用 Search API(repo:{owner}/{repo} is:issue / is:pr)统计 issue 与 PR 总数;合并最新 issue 与 PR 生成近期活动行(预览限 5–10 条)。数据规范化为仓库信息、指标、头部贡献者(5–8 位)、近期活动等字段。
使用方式:若需可刷新、可审计或定时更新,产出 live-artifact 源文件集(template.html、data.json、artifact.json、provenance.json);若仅需视觉产物,产出单文件 index.html(内联 CSS,无外部 JS 库)。布局为 256px 侧栏加主面板、顶栏、仓库头部、5 张 KPI 卡、2fr/1fr 主网格与页脚。
限制:v1 仅限单个仓库,多仓库需用户指定主仓库或分别建看板;GitHub REST 不提供完整历史 star/fork 增量,需用 GraphQL、stargazer 快照或 Events API,否则须在 provenance 中标注为估算/合成;不得存储令牌、原始 HTTP 信封、cookie、速率限制头或私有元数据;仅浅色模式;不要做成 GitHub 界面克隆。