0974d8dfa2
build / build (push) Successful in 57s
按已确认的契约实现(口径见 docs/VERSION_HISTORY.md):
- **版本号口径(只给有证据的)**:注释 tag + tag 指向该提交 + 该提交内 CHANGELOG 顶部三者一致 ⇒ 正式版本;
tag 之后的提交按 `<主>.<次>.<自该 tag 的提交数>` 显示开发号(与 scripts/version.py **同规则**);
证据不足 ⇒ 「历史提交 · 短SHA」+ 原因码,**不补造版本号**。完整 SHA 是唯一身份、版本号不是唯一键
(tag 之后两条并行分支各自的第 1 个提交都算 0.1.1 ⇒ 两条都保留,用短 SHA 区分)。
- **迁移 000046**:version_history_commits(提交记录,主键 repo_key+commit_sha)+ version_history_sync_runs
(同步状态)。快照 = 一次同步:抓完并与 X-Total-Count 对账通过才切换;失败不切换快照、不清空历史、
last_success_at 不动(页面显示"上次同步失败(原因)· 仍展示上次成功数据");「同步成功」≠「历史完整」。
- **只读客户端(匿名,不使用任何凭据)**:白名单 origin + 固定仓库、拒绝任意 URL 与跨主机重定向、
响应上限 5MB / 超时 15s、仅 5xx/429 退避重试(最多 3 次);逐页抓到短页为止;每次全量扫 tag
⇒ 旧提交后补的 tag 会更新既有记录(不新增第二行)。
- **接口**(三个都登记进 api/openapi.yaml):GET /api/v1/build-info(viewer)、
GET /api/v1/version-history(viewer;游标绑定快照,过期返回 409 cursor_expired;不返回伪造 total)、
POST /api/v1/version-history/sync(admin;并发同步复用同一作业,靠 IdempotencyKey)。
- **「当前运行」只认精确匹配**:产物注入的完整 SHA 命中某条记录才标该条;开发构建显式标注"开发构建";
没有可用标识 ⇒ "当前运行版本未知";**不拿最新 main / 最新 tag 顶替**,CI 成功不等于已部署。
- **前端**:一级菜单第 5 项(版本记录)+ 时间线页面(全部/正式/开发/历史四段筛选、正文展开、
加载更多、760px 单列无横向溢出、提交正文与变更记录按纯文本渲染);无打 tag / 发布 / 部署入口。
新增配置(留空即未接线,页面降级):VERSION_HISTORY_GITEA_BASE_URL / _REPO / _ALLOWED_ORIGINS /
_HTTP_TIMEOUT / _MAX_PAGES。
验证:`make verify` 15/15 success(tests-go 578 通过 / 0 失败;tests-web 209 通过 / 0 失败);
新增 Go 用例 30(版本口径与图遍历 12、客户端守卫 6、同步编排 5、接口 7);前端新增 18(组件 10 + 客户端 8);
真实仓库匿名快照拉取(`VERSION_HISTORY_LIVE_BASE_URL=… go test -run TestLiveSyncAgainstRealRepository`):
抓到 113 条与 X-Total-Count 一致、v0.1.0 是注释 tag 且目标与 `git rev-parse v0.1.0^{commit}` 一致、
开发号逐个等于 `git rev-list --count v0.1.0..<sha>`(正式 1 / 开发 22 / 历史 90)。
172 lines
3.4 KiB
CSS
172 lines
3.4 KiB
CSS
/* 「版本记录」页:只读时间线。窄屏(≤760px,与工作台既有断点一致)单列、无横向溢出。 */
|
|
.version-history {
|
|
display: flex;
|
|
flex-direction: column;
|
|
gap: 12px;
|
|
min-width: 0;
|
|
}
|
|
.version-history-header {
|
|
display: flex;
|
|
align-items: flex-start;
|
|
justify-content: space-between;
|
|
gap: 12px;
|
|
flex-wrap: wrap;
|
|
}
|
|
.version-history-header h2 {
|
|
margin: 0 0 4px;
|
|
font-size: 18px;
|
|
}
|
|
.version-history-header p {
|
|
margin: 0;
|
|
color: var(--muted, #666);
|
|
font-size: 13px;
|
|
}
|
|
.version-history-sync-line {
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
margin-top: 4px !important;
|
|
}
|
|
.version-history-notice {
|
|
padding: 8px 10px;
|
|
border-radius: 6px;
|
|
background: rgba(64, 158, 255, 0.12);
|
|
font-size: 13px;
|
|
}
|
|
.version-history-filters {
|
|
display: flex;
|
|
gap: 8px;
|
|
flex-wrap: wrap;
|
|
}
|
|
.version-history-filters button.active {
|
|
font-weight: 600;
|
|
border-color: currentColor;
|
|
}
|
|
.version-history-timeline {
|
|
list-style: none;
|
|
margin: 0;
|
|
padding: 0;
|
|
display: flex;
|
|
flex-direction: column;
|
|
gap: 10px;
|
|
min-width: 0;
|
|
}
|
|
.version-history-entry {
|
|
border-left: 3px solid rgba(127, 127, 127, 0.35);
|
|
padding: 10px 12px;
|
|
background: rgba(127, 127, 127, 0.06);
|
|
border-radius: 6px;
|
|
min-width: 0;
|
|
}
|
|
.version-history-entry.release {
|
|
border-left-color: #2f9e44;
|
|
}
|
|
.version-history-entry.development {
|
|
border-left-color: #1c7ed6;
|
|
}
|
|
.version-history-entry-head {
|
|
display: flex;
|
|
justify-content: space-between;
|
|
gap: 8px;
|
|
flex-wrap: wrap;
|
|
}
|
|
.version-history-entry-head strong {
|
|
font-size: 15px;
|
|
}
|
|
.version-history-entry-meta {
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
flex-wrap: wrap;
|
|
margin-top: 4px;
|
|
font-size: 12px;
|
|
color: var(--muted, #666);
|
|
}
|
|
.version-history-badge {
|
|
padding: 1px 6px;
|
|
border-radius: 999px;
|
|
border: 1px solid currentColor;
|
|
font-size: 12px;
|
|
}
|
|
.version-history-badge.release {
|
|
color: #2f9e44;
|
|
}
|
|
.version-history-badge.development {
|
|
color: #1c7ed6;
|
|
}
|
|
.version-history-badge.historical {
|
|
color: #868e96;
|
|
}
|
|
.version-history-badge.current {
|
|
color: #e8590c;
|
|
}
|
|
.version-history-badge.pending {
|
|
color: #1c7ed6;
|
|
}
|
|
.version-history-badge.warn {
|
|
color: #c92a2a;
|
|
}
|
|
.version-history-sha {
|
|
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
overflow-wrap: anywhere;
|
|
}
|
|
.version-history-subject {
|
|
margin: 6px 0 0;
|
|
overflow-wrap: anywhere;
|
|
}
|
|
.version-history-reason {
|
|
margin: 4px 0 0;
|
|
font-size: 12px;
|
|
color: #c92a2a;
|
|
overflow-wrap: anywhere;
|
|
}
|
|
.version-history-toggle {
|
|
margin-top: 6px;
|
|
}
|
|
.version-history-detail pre {
|
|
margin: 6px 0 0;
|
|
padding: 8px;
|
|
max-height: 320px;
|
|
overflow: auto;
|
|
background: rgba(127, 127, 127, 0.1);
|
|
border-radius: 6px;
|
|
white-space: pre-wrap;
|
|
overflow-wrap: anywhere;
|
|
font-size: 12px;
|
|
}
|
|
.version-history-links {
|
|
display: flex;
|
|
gap: 10px;
|
|
flex-wrap: wrap;
|
|
margin-top: 6px;
|
|
font-size: 13px;
|
|
}
|
|
|
|
@media (max-width: 760px) {
|
|
.version-history-header {
|
|
flex-direction: column;
|
|
align-items: stretch;
|
|
}
|
|
.version-history-entry {
|
|
padding: 8px 10px;
|
|
}
|
|
.version-history-entry-head {
|
|
flex-direction: column;
|
|
gap: 2px;
|
|
}
|
|
/* 窄屏单列:正文/标题/hash 一律换行,不出现横向滚动 */
|
|
.version-history,
|
|
.version-history-timeline,
|
|
.version-history-entry,
|
|
.version-history-subject,
|
|
.version-history-sha,
|
|
.version-history-reason {
|
|
max-width: 100%;
|
|
overflow-wrap: anywhere;
|
|
word-break: break-word;
|
|
}
|
|
.version-history-detail pre {
|
|
max-height: none;
|
|
}
|
|
}
|