feat: add sidebar release label

linhay · linhay · commit 515075e4899a · 2026-04-26T00:22:26.000+08:00
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -117,13 +117,18 @@ jobs:
           sudo apt-get update -y
           sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev
 
+      - name: Compute release label
+        shell: bash
+        run: |
+          echo "RELEASE_LABEL=$(TZ=Asia/Shanghai date +'%Y.%m.%d.%H')" >> "$GITHUB_ENV"
+
       # ── Build ─────────────────────────────────────────────────────────────
       - name: Wails build
         run: |
           wails build \
             -platform ${{ matrix.wails-platform }} \
             ${{ matrix.wails-extra || '' }} \
-            -ldflags "-X main.Version=${{ github.ref_name }}"
+            -ldflags "-X main.Version=${{ github.ref_name }} -X main.ReleaseLabel=${RELEASE_LABEL}"
 
       # ── Package ───────────────────────────────────────────────────────────
       - name: Package DMG (macOS)
diff --git a/app.go b/app.go
@@ -12,6 +12,9 @@ import (
 // Version is injected at build time via -ldflags
 var Version = "dev"
 
+// ReleaseLabel is injected at build time for UI display, format: YYYY.MM.DD.HH
+var ReleaseLabel = ""
+
 // GitHubRepo is the repository used for auto-update checks
 const GitHubRepo = "linhay/GetTokens"
 
@@ -94,7 +97,7 @@ type CreateCodexAPIKeyInput struct {
 
 func NewApp() *App {
 	return &App{
-		core: wailsapp.New(Version, GitHubRepo),
+		core: wailsapp.New(Version, ReleaseLabel, GitHubRepo),
 	}
 }
 
@@ -114,6 +117,10 @@ func (a *App) GetVersion() string {
 	return a.core.GetVersion()
 }
 
+
+func (a *App) GetReleaseLabel() string {
+	return a.core.GetReleaseLabel()
+}
 func (a *App) CheckUpdate() (*updater.ReleaseInfo, error) {
 	return a.core.CheckUpdate()
 }
diff --git a/docs-linhay/dev/20260426-release-label-version-boundary.md b/docs-linhay/dev/20260426-release-label-version-boundary.md
@@ -0,0 +1,33 @@
+# Release Label 与 Version 边界
+
+## 背景
+本轮 Sidebar 版本号需求要求界面显示发布日期小时，如 `2026.04.06.11`。但应用现有 `Version` 同时被自动更新逻辑使用，直接改写 `Version` 会把 UI 展示格式和版本比较语义耦合到一起。
+
+## 结论
+GetTokens 后续统一采用双轨元数据：
+
+1. `Version`
+   用于自动更新比较、Git tag / release 语义、对外版本标识。
+2. `ReleaseLabel`
+   仅用于 UI 展示，格式固定为 `YYYY.MM.DD.HH`。
+
+## 规则
+1. 不要把 `Version` 直接用于 Sidebar、角标、构建时间标签等纯展示场景。
+2. 需要展示发布日期时，优先读取后端注入的 `ReleaseLabel`。
+3. release 构建必须在 CI 中显式生成 `ReleaseLabel`，不要依赖运行时猜测。
+4. 生成 `ReleaseLabel` 时必须显式声明时区；当前采用 `Asia/Shanghai`。
+5. 开发态允许前端对空值/`dev` 做本地 fallback，但 release 包必须优先展示注入值。
+
+## 当前落地
+1. Go 入口新增 `ReleaseLabel` 全局变量，通过 `-ldflags` 注入。
+2. Wails 暴露 `GetReleaseLabel()` 给前端读取。
+3. Sidebar 仅消费 `ReleaseLabel`，不再直接消费 `Version`。
+4. GitHub Release workflow 在构建前计算 `RELEASE_LABEL=$(TZ=Asia/Shanghai date +'%Y.%m.%d.%H')`。
+
+## 适用场景
+1. Sidebar / Header / About 面板里的构建标签。
+2. 未来需要区分“用户可见发布日期”与“机器可比较版本号”的任何 UI。
+
+## 不适用场景
+1. 自动更新版本比较。
+2. Git tag、发布说明标题、兼容性判断。
diff --git a/docs-linhay/memory/2026-04-26.md b/docs-linhay/memory/2026-04-26.md
@@ -0,0 +1,7 @@
+# 2026-04-26
+
+## Sidebar Version Label
+- 新增 `ReleaseLabel` 构建注入字段，保留 `Version` 给自动更新比较使用，避免界面发布日期格式影响更新逻辑。
+- `frontend/src/utils/version.ts` 将 Sidebar 版本展示统一格式化为 `YYYY.MM.DD.HH`。
+- `Sidebar` 底部文案改为 `VERSION`，并展示格式化后的发布日期标签。
+- Release 工作流在构建阶段按 `Asia/Shanghai` 时区注入 `ReleaseLabel`。
diff --git a/docs-linhay/spaces/20260426-sidebar-version/README.md b/docs-linhay/spaces/20260426-sidebar-version/README.md
@@ -0,0 +1,34 @@
+# Sidebar Version Label
+
+## 背景
+Sidebar 底部原本直接展示原始 `version` 字符串，缺少统一的版本号展示规则，无法满足“发布日期 + hh”的产品要求。同时自动更新仍依赖原始版本比较，不能直接把界面展示格式塞回 `Version`。
+
+## 目标
+在 Sidebar 底部增加稳定的发布日期标签，格式统一为 `YYYY.MM.DD.HH`，且不影响自动更新的版本比较逻辑。
+
+## 范围
+- 提取前端版本展示格式化逻辑
+- 新增仅供 UI 展示的 `ReleaseLabel` 构建注入字段
+- 在 Sidebar 底部显示格式化后的发布日期标签
+- 为版本格式化补充可执行测试
+
+## 非目标
+- 不修改自动更新使用的原始 `Version` 语义
+- 不调整状态页上的版本展示
+- 不改动自动更新版本比较逻辑
+
+## 验收标准
+- Sidebar 底部显示 `VERSION <YYYY.MM.DD.HH>`
+- Release 构建通过 `-ldflags` 注入真实发布日期标签
+- `dev` 构建可回退到当前日期小时格式展示
+- 日期型版本串会被规范化为 `YYYY.MM.DD.HH`
+- 新增测试可覆盖日期规范化、dev 回退和展示字段读取场景
+
+## 相关链接
+- [Sidebar 组件](/Users/linhey/Desktop/linhay-open-sources/GetTokens/frontend/src/components/biz/Sidebar.tsx)
+- [版本格式化工具](/Users/linhey/Desktop/linhay-open-sources/GetTokens/frontend/src/utils/version.ts)
+- [Release 工作流](/Users/linhey/Desktop/linhay-open-sources/GetTokens/.github/workflows/release.yml)
+
+## 当前状态
+- 状态：done
+- 最近更新：2026-04-26
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useMemo, useState } from 'react';
-import { GetSidecarStatus, GetVersion } from '../wailsjs/go/main/App';
+import { GetReleaseLabel, GetSidecarStatus, GetVersion } from '../wailsjs/go/main/App';
 import { EventsOn } from '../wailsjs/runtime/runtime';
 import Sidebar from './components/biz/Sidebar';
 import AccountsPage from './pages/AccountsPage';
@@ -24,6 +24,7 @@ function AppShell() {
   const [activePage, setActivePage] = useState<AppPage>('accounts');
   const [sidecarStatus, setSidecarStatus] = useState<SidecarStatus>(defaultSidecarStatus);
   const [version, setVersion] = useState('dev');
+  const [releaseLabel, setReleaseLabel] = useState('');
 
   useEffect(() => {
     const isDark =
@@ -37,12 +38,14 @@ function AppShell() {
 
     async function loadInitialState() {
       try {
-        const [currentVersion, currentStatus] = await Promise.all([
+        const [currentVersion, currentReleaseLabel, currentStatus] = await Promise.all([
           trackRequest('GetVersion', { args: [] }, () => GetVersion()),
+          trackRequest('GetReleaseLabel', { args: [] }, () => GetReleaseLabel()),
           trackRequest('GetSidecarStatus', { args: [] }, () => GetSidecarStatus()),
         ]);
         if (!mounted) return;
         setVersion(currentVersion || 'dev');
+        setReleaseLabel(currentReleaseLabel || '');
         if (currentStatus) {
           setSidecarStatus(currentStatus);
         }
@@ -81,7 +84,7 @@ function AppShell() {
       className="flex h-screen w-screen overflow-hidden bg-[var(--bg-main)] selection:bg-[var(--border-color)] selection:text-[var(--bg-main)]"
       data-collaboration-id="MAIN_FRAME"
     >
-      <Sidebar activePage={activePage} setActivePage={setActivePage} version={version} />
+      <Sidebar activePage={activePage} setActivePage={setActivePage} releaseLabel={releaseLabel} />
       <main className="flex-1 overflow-hidden bg-[var(--bg-surface)]">{page}</main>
     </div>
   );
diff --git a/frontend/src/components/biz/Sidebar.tsx b/frontend/src/components/biz/Sidebar.tsx
@@ -1,5 +1,6 @@
 import { useI18n } from '../../context/I18nContext';
 import type { AppPage } from '../../types';
+import { formatSidebarVersion } from '../../utils/version';
 
 const navItems = [
   { id: 'status', label: 'nav.status', icon: 'M12 12m-10 0a10 10 0 1 0 20 0a10 10 0 1 0 -20 0 M12 8v4l3 3' },
@@ -11,11 +12,12 @@ const navItems = [
 interface SidebarProps {
   activePage: AppPage;
   setActivePage: (page: AppPage) => void;
-  version: string;
+  releaseLabel: string;
 }
 
-export default function Sidebar({ activePage, setActivePage, version }: SidebarProps) {
+export default function Sidebar({ activePage, setActivePage, releaseLabel }: SidebarProps) {
   const { t } = useI18n();
+  const sidebarVersion = formatSidebarVersion(releaseLabel);
 
   return (
     <aside
@@ -50,7 +52,7 @@ export default function Sidebar({ activePage, setActivePage, version }: SidebarP
 
       <div className="border-t-2 border-[var(--border-color)] p-6">
         <div className="text-[9px] font-bold uppercase tracking-tighter text-[var(--text-muted)]">
-          BUILD {version}
+          VERSION {sidebarVersion}
         </div>
       </div>
     </aside>
diff --git a/frontend/src/utils/version.test.mjs b/frontend/src/utils/version.test.mjs
@@ -0,0 +1,26 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { buildDateHourLabel, formatSidebarVersion } from './version.ts';
+
+test('buildDateHourLabel formats local date as YYYY.MM.DD.HH', () => {
+  const date = new Date(2026, 3, 26, 8, 15, 0);
+
+  assert.equal(buildDateHourLabel(date), '2026.04.26.08');
+});
+
+test('formatSidebarVersion normalizes date-like version strings', () => {
+  assert.equal(formatSidebarVersion('2026-04-26 08:30:00'), '2026.04.26.08');
+  assert.equal(formatSidebarVersion('2026042608'), '2026.04.26.08');
+  assert.equal(formatSidebarVersion('2026.04.26.08'), '2026.04.26.08');
+});
+
+test('formatSidebarVersion falls back to current date-hour for dev builds', () => {
+  const now = new Date(2026, 3, 26, 9, 0, 0);
+
+  assert.equal(formatSidebarVersion('dev', now), '2026.04.26.09');
+});
+
+test('formatSidebarVersion keeps opaque versions unchanged', () => {
+  assert.equal(formatSidebarVersion('v0.1.0'), 'v0.1.0');
+});
diff --git a/frontend/src/utils/version.ts b/frontend/src/utils/version.ts
@@ -0,0 +1,28 @@
+const dateHourPattern =
+  /^(?<year>\d{4})[./-]?(?<month>\d{2})[./-]?(?<day>\d{2})(?:[T\s_.:+/-]?(?<hour>\d{2}))(?:[:]\d{2}(?::\d{2})?)?/;
+
+function pad(value: number): string {
+  return String(value).padStart(2, '0');
+}
+
+export function buildDateHourLabel(date: Date): string {
+  return `${date.getFullYear()}.${pad(date.getMonth() + 1)}.${pad(date.getDate())}.${pad(date.getHours())}`;
+}
+
+export function formatSidebarVersion(version: string, now: Date = new Date()): string {
+  const normalized = version.trim();
+
+  if (!normalized || normalized === 'dev') {
+    return buildDateHourLabel(now);
+  }
+
+  const match = normalized.match(dateHourPattern);
+  if (match?.groups) {
+    const { year, month, day, hour } = match.groups;
+    if (year && month && day && hour) {
+      return `${year}.${month}.${day}.${hour}`;
+    }
+  }
+
+  return normalized;
+}
diff --git a/frontend/wailsjs/go/main/App.d.ts b/frontend/wailsjs/go/main/App.d.ts
@@ -20,6 +20,8 @@ export function GetAuthFileModels(arg1:string):Promise<Array<Record<string, any>
 
 export function GetCodexQuota(arg1:string):Promise<main.CodexQuotaResponse>;
 
+export function GetReleaseLabel():Promise<string>;
+
 export function GetSidecarStatus():Promise<sidecar.Status>;
 
 export function GetVersion():Promise<string>;
diff --git a/frontend/wailsjs/go/main/App.js b/frontend/wailsjs/go/main/App.js
@@ -34,6 +34,10 @@ export function GetCodexQuota(arg1) {
   return window['go']['main']['App']['GetCodexQuota'](arg1);
 }
 
+export function GetReleaseLabel() {
+  return window['go']['main']['App']['GetReleaseLabel']();
+}
+
 export function GetSidecarStatus() {
   return window['go']['main']['App']['GetSidecarStatus']();
 }
diff --git a/internal/wailsapp/app.go b/internal/wailsapp/app.go
@@ -12,12 +12,14 @@ type App struct {
 	sidecar *sidecar.Manager
 	updater *updater.Updater
 	version string
+	releaseLabel string
 }
 
-func New(version string, repo string) *App {
+func New(version string, releaseLabel string, repo string) *App {
 	return &App{
 		sidecar: sidecar.NewManager(),
 		updater: updater.New(repo, version),
 		version: version,
+		releaseLabel: releaseLabel,
 	}
 }
diff --git a/internal/wailsapp/runtime.go b/internal/wailsapp/runtime.go
@@ -44,3 +44,7 @@ func (a *App) GetSidecarStatus() sidecar.Status {
 func (a *App) GetVersion() string {
 	return a.version
 }
+
+func (a *App) GetReleaseLabel() string {
+	return a.releaseLabel
+}
diff --git a/internal/wailsapp/version_test.go b/internal/wailsapp/version_test.go
@@ -0,0 +1,15 @@
+package wailsapp
+
+import "testing"
+
+func TestGetReleaseLabel(t *testing.T) {
+	app := New("v0.1.0", "2026.04.06.11", "linhay/GetTokens")
+
+	if got := app.GetVersion(); got != "v0.1.0" {
+		t.Fatalf("GetVersion() = %q, want %q", got, "v0.1.0")
+	}
+
+	if got := app.GetReleaseLabel(); got != "2026.04.06.11" {
+		t.Fatalf("GetReleaseLabel() = %q, want %q", got, "2026.04.06.11")
+	}
+}

Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,9 @@ import (`
`12`	`12`	`// Version is injected at build time via -ldflags`
`13`	`13`	`var Version = "dev"`
`14`	`14`
	`15`	`+// ReleaseLabel is injected at build time for UI display, format: YYYY.MM.DD.HH`
	`16`	`+var ReleaseLabel = ""`
	`17`	`+`
`15`	`18`	`// GitHubRepo is the repository used for auto-update checks`
`16`	`19`	`const GitHubRepo = "linhay/GetTokens"`
`17`	`20`
`@@ -94,7 +97,7 @@ type CreateCodexAPIKeyInput struct {`
`94`	`97`
`95`	`98`	`func NewApp() *App {`
`96`	`99`	`return &App{`
`97`		`- core: wailsapp.New(Version, GitHubRepo),`
	`100`	`+ core: wailsapp.New(Version, ReleaseLabel, GitHubRepo),`
`98`	`101`	`}`
`99`	`102`	`}`
`100`	`103`
`@@ -114,6 +117,10 @@ func (a *App) GetVersion() string {`
`114`	`117`	`return a.core.GetVersion()`
`115`	`118`	`}`
`116`	`119`
	`120`	`+`
	`121`	`+func (a *App) GetReleaseLabel() string {`
	`122`	`+ return a.core.GetReleaseLabel()`
	`123`	`+}`
`117`	`124`	`func (a App) CheckUpdate() (updater.ReleaseInfo, error) {`
`118`	`125`	`return a.core.CheckUpdate()`
`119`	`126`	`}`