Files
knowledge-governance/web/src/versionHistory.css
T
姚章浩 0974d8dfa2
build / build (push) Successful in 57s
feat(version-history): 「版本记录」页 —— 追踪远端 main 全部提交(只读 + 管理员手动同步)
按已确认的契约实现(口径见 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)。
2026-10-13 19:40:19 +08:00

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;
}
}