diff --git a/.github/workflows/collect.yml b/.github/workflows/collect.yml index 4a08ab009..65bbdf07c 100644 --- a/.github/workflows/collect.yml +++ b/.github/workflows/collect.yml @@ -1,8 +1,10 @@ name: Collect dashboard data run-name: Collect dashboard (${{ inputs.request_id || github.event_name }}) on: + # The bot dispatches collection when an Issue or PR is opened, reopened or closed, and every + # eight hours otherwise. This daily run only covers a bot that has stopped dispatching. schedule: - - cron: '17,47 * * * *' + - cron: '17 2 * * *' workflow_dispatch: inputs: source_repository: diff --git a/README.md b/README.md index 24f0e7450..f023e8698 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ ## 使用 -在目标仓 Actions 手动运行 **Collect dashboard data**，或由 Bot 触发；每小时第 17、47 分钟自动续跑。`main` 上包含 `site/`、`.sync/` 以外文件改动的推送，也会自动派发一次采集；仅改这两个目录的采集提交不会再次派发。采集提交 `site/` 后，**Deploy dashboard Pages** 发布站点。首次配置见 [Actions 采集](docs/actions-collection.md)。 +在目标仓 Actions 手动运行 **Collect dashboard data**，或由 Bot 触发：Issue、PR 新建、重新打开或关闭时立即触发，其余变化每 8 小时随定时刷新一次；看板仓自己每天 UTC 02:17 定时运行一次，作为 Bot 停止触发时的兜底。`main` 上包含 `site/`、`.sync/` 以外文件改动的推送，也会自动派发一次采集；仅改这两个目录的采集提交不会再次派发。采集提交 `site/` 后，**Deploy dashboard Pages** 发布站点。首次配置见 [Actions 采集](docs/actions-collection.md)。 本地快速预览（Python 3.10+，凭据来自环境或已登录的 gh）： diff --git a/docs/actions-collection.md b/docs/actions-collection.md index 15a7b6a13..0e63ac93e 100644 --- a/docs/actions-collection.md +++ b/docs/actions-collection.md @@ -18,7 +18,7 @@ Worker 校验 GitHub OIDC 签名、issuer、audience、不可变仓库与组织 App 的 Actions 写权限在 App 注册页 **Permissions & events → Repository permissions → Actions → Read and write** 设置，并由目标组织在安装页批准更新；仅修改注册页不等于既有 installation 已获授权。即使两个看板仓同属一个组织，也要分别批准正式与测试 App 各自的 installation；测试 App 的安装范围须覆盖实验源仓及测试看板仓，也可以包含其他仓库。两套 App 的安装范围可以重叠；各 Bot 通过源仓过滤、看板目标映射和 OIDC 信任配置隔离业务，范围外 Webhook 仍归档，不触发业务。临时令牌只授予当前配置中的源仓读取或目标看板写入权限，不随 App 安装范围扩大。仓库 Settings → Actions 的默认 `GITHUB_TOKEN` 权限继续保持只读；触发所需的 App Actions 写权限与此设置不同。 -工作流接受 `workflow_dispatch`，并在每小时第 17、47 分钟定时续跑；固定 checkout main，禁止 checkout 输入指定的任意分支。输入 `source_repository` 可省略，填写时必须匹配本站源仓；`request_id` 为诊断用刷新编号，不包含原始 Webhook、私钥或安装令牌。可在 Actions 的 **Collect dashboard data** 手动执行，也可以由 Bot 调用 GitHub workflow dispatch API。 +工作流接受 `workflow_dispatch`。Bot 只在 Issue、PR 新建、重新打开或关闭时立即触发，其余变化（CI 运行、评审、发布等）由 Bot 每 8 小时一次的空闲刷新带上；看板仓自己每天 UTC 02:17 定时运行一次，只作 Bot 停止触发时的兜底；固定 checkout main，禁止 checkout 输入指定的任意分支。输入 `source_repository` 可省略，填写时必须匹配本站源仓；`request_id` 为诊断用刷新编号，不包含原始 Webhook、私钥或安装令牌。可在 Actions 的 **Collect dashboard data** 手动执行，也可以由 Bot 调用 GitHub workflow dispatch API。 `collect-on-push.yml` 在 `main` 收到包含 `site/`、`.sync/` 以外文件改动的推送时，自动派发 `collect.yml` 的 `workflow_dispatch`，固定 `ref=main`，`request_id=push-<完整提交 SHA>`，不传 `source_repository`。它使用本仓 `GITHUB_TOKEN`，仅声明 `contents: read` 和 `actions: write`；不在 PR 上运行，也不取消正在执行的采集。`paths-ignore` 排除 `site/**` 与 `.sync/**`，因此只修改这两个目录的采集提交不会再次派发；源码与数据混合的推送仍会触发。定时、手动及 Bot 触发保持不变，Pages 仍由 `site/` 的提交触发。 diff --git a/docs/dashboard-pages.md b/docs/dashboard-pages.md index b803d510b..0ecb4f4dc 100644 --- a/docs/dashboard-pages.md +++ b/docs/dashboard-pages.md @@ -2,6 +2,8 @@ 看板只展示已采集的稳定状态，不运行测试。页面依次为：总览、Issue、PR、CI、测试、Coverage、版本验证、运维、GitCode 同步（见 [GitCode 同步记录](gitcode-sync.md)）。配置了[分支线](branch-lines.md)时，CI、测试、Coverage 页首可在 main、legacy 与 release 分支之间切换，每次只显示一条分支线。旧的“看板”“构建报告”“历史数据”页已移除；看板形式并入 Issue 与 PR 页，历史分片仍作为采集器的存储保留。 +页首显示快照时间。没有数据变化的采集不改快照时间，新的 UTC 日期会重建一次，Bot 至少每 8 小时采集一次；所以快照超过 36 小时未更新时，页面提示采集可能已停止。 + ## 总览 总览面向“今天要处理什么”，从上到下依次展示以下内容。 diff --git a/static/app.js b/static/app.js index 89a6759aa..dc4330d51 100644 --- a/static/app.js +++ b/static/app.js @@ -1426,8 +1426,10 @@ $('#meta').title='按浏览器时区显示'; $('#repo-link').title=snap.repo; } - const stale=snap && Date.now()-new Date(snap.generated_at)>7200000; - const message=STATE.clientError || [...(snap?.notices||[]).map(n=>n.message).filter(message=>message !== '部分补充信息不可读取，请以 GitHub 原页面为准。'), ...(stale?['快照超过两小时未更新；当前显示最后一次发布的数据。']:[])].join(' '); + // A quiet collection keeps the snapshot's time, a new UTC day rebuilds it, and the bot collects at + // least every eight hours: an older snapshot means collection has stopped. + const stale=snap && Date.now()-new Date(snap.generated_at)>36*3600000; + const message=STATE.clientError || [...(snap?.notices||[]).map(n=>n.message).filter(message=>message !== '部分补充信息不可读取，请以 GitHub 原页面为准。'), ...(stale?['快照超过 36 小时未更新，采集可能已停止；当前显示最后一次发布的数据。']:[])].join(' '); banner.className='banner '+(message?'warn':'hidden');banner.textContent=message; document.querySelectorAll('#tabs a').forEach(a=>{ const active=a.dataset.tab===STATE.tab;a.classList.toggle('active',active); diff --git a/static/index.html b/static/index.html index 81d5646a6..e36593e12 100644 --- a/static/index.html +++ b/static/index.html @@ -5,7 +5,7 @@ GitHub 状态看板 - +
@@ -48,8 +48,8 @@ - - - + + + diff --git a/test/journey-board.spec.cjs b/test/journey-board.spec.cjs index bfc5d1e00..3f959661b 100644 --- a/test/journey-board.spec.cjs +++ b/test/journey-board.spec.cjs @@ -20,7 +20,7 @@ test('all existing pages render; only static requests and no promotional copy', await expect(page.locator('#tab-overview .ci-lane-row[data-lane="pr"] .ci-lane-day')).toHaveCount(14); await expect(page.locator('#tab-overview')).toContainText('v1.0'); await expect(page.locator('#meta')).toContainText('20:00'); - await expect(page.locator('#global-banner')).toContainText('超过两小时'); + await expect(page.locator('#global-banner')).toContainText('超过 36 小时未更新'); await expect(page.locator('body')).not.toContainText('把进展与风险放在同一页'); await page.screenshot({path:shot('overview-desktop'),fullPage:true}); await expect(page.locator('.topbar #tabs a')).toHaveCount(9);