From f84ed930b2731e6e58d84b0810cabb075d9f4823 Mon Sep 17 00:00:00 2001
From: EMRG Evolution <emrg@argszero.dev>
Date: Wed, 5 Aug 2026 20:33:37 +0800
Subject: [PATCH] =?UTF-8?q?emrg:=20=E7=89=88=E6=9C=AC=E4=B8=80=E8=87=B4?=
 =?UTF-8?q?=E6=80=A7=E6=B5=8B=E8=AF=95=20=E2=80=94=20=E9=98=B2=E6=AD=A2=20?=
 =?UTF-8?q?#408=20=E7=B1=BB=20bump=20=E9=81=97=E6=BC=8F=EF=BC=88gui/packag?=
 =?UTF-8?q?e.json=EF=BC=89=E5=A4=8D=E5=8F=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

#408 教训：bump 版本时遗漏 emrg/gui/package.json → 发布后发现
版本不一致 → 删 release + 删 tag + 重打 + 触发重建。

新增 tests/test_version_sync.py：从 emrg/__init__.py 取基准版本，
校验 6 处版本声明一致（pyproject / gui package.json / uv.lock /
make-installer.sh / build-runtime.sh fallback）。纯逻辑测试，
Windows CI 亦可执行（#406）。472 passed。
---
 tests/test_version_sync.py | 76 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 tests/test_version_sync.py

diff --git a/tests/test_version_sync.py b/tests/test_version_sync.py
new file mode 100644
index 00000000..97b0ae5a
--- /dev/null
+++ b/tests/test_version_sync.py
@@ -0,0 +1,76 @@
+"""版本一致性检查 —— 防止 #408 类发布事故复发。
+
+背景（PR #408 教训）：bump 版本时遗漏了 emrg/gui/package.json，
+发布后发现版本不一致 → 删 release + 删 tag + 重打 + 触发重建，
+浪费整个发布流程。本测试从 emrg/__init__.py 取基准版本，校验
+全部 6 处版本声明一致（pyproject / gui package.json / uv.lock /
+make-installer.sh / build-runtime.sh）。
+
+纯逻辑测试（正则解析文本），无平台/网络依赖 —— Windows CI
+亦可执行（#406 起纯逻辑测试全平台跑）。
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+
+
+def _base_version() -> str:
+    """基准版本：emrg/__init__.py 的 __version__。"""
+    content = (REPO_ROOT / "emrg" / "__init__.py").read_text(encoding="utf-8")
+    m = re.search(r'__version__\s*=\s*"([^"]+)"', content)
+    assert m, "emrg/__init__.py 中找不到 __version__"
+    return m.group(1)
+
+
+def _pyproject_version() -> str:
+    content = (REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    m = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)
+    assert m, "pyproject.toml 中找不到 version"
+    return m.group(1)
+
+
+def _gui_package_version() -> str:
+    content = (REPO_ROOT / "emrg" / "gui" / "package.json").read_text(encoding="utf-8")
+    m = re.search(r'"version"\s*:\s*"([^"]+)"', content)
+    assert m, "emrg/gui/package.json 中找不到 version"
+    return m.group(1)
+
+
+def _uv_lock_version() -> str:
+    content = (REPO_ROOT / "uv.lock").read_text(encoding="utf-8")
+    m = re.search(r'name = "emrg"\nversion = "([^"]+)"', content)
+    assert m, "uv.lock 中找不到 emrg 自身版本"
+    return m.group(1)
+
+
+def _shell_fallback_versions() -> list[tuple[str, str]]:
+    """各 shell 脚本的版本 fallback（打包时无法读取 __version__ 时使用）。"""
+    results: list[tuple[str, str]] = []
+    for rel in ("packaging/make-installer.sh", "packaging/build-runtime.sh"):
+        content = (REPO_ROOT / rel).read_text(encoding="utf-8")
+        m = re.search(r'\|\| echo "?(\d+\.\d+\.\d+)"?', content)
+        assert m, f"{rel} 中找不到版本 fallback"
+        results.append((rel, m.group(1)))
+    return results
+
+
+def test_all_version_sources_consistent():
+    """全部 6 处版本声明必须与 emrg.__version__ 一致。"""
+    base = _base_version()
+    assert _pyproject_version() == base, "pyproject.toml 版本与 __version__ 不一致"
+    assert _gui_package_version() == base, (
+        "emrg/gui/package.json 版本与 __version__ 不一致（#408 教训：bump 勿漏 GUI 版本）"
+    )
+    assert _uv_lock_version() == base, "uv.lock 版本与 __version__ 不一致"
+    for rel, ver in _shell_fallback_versions():
+        assert ver == base, f"{rel} fallback 版本与 __version__ 不一致"
+
+
+def test_base_version_is_semver():
+    """基准版本必须是合法 semver（x.y.z）。"""
+    base = _base_version()
+    assert re.fullmatch(r"\d+\.\d+\.\d+", base), f"非法版本号格式: {base!r}"