From 50911ea7d6297dbad1e47ea72c3cebd8a95ab712 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 14 Nov 2026 11:57:08 +0800 Subject: [PATCH] =?UTF-8?q?feat(version):=20=E6=9E=84=E5=BB=BA=E8=BA=AB?= =?UTF-8?q?=E4=BB=BD=E5=9B=9B=E4=BB=B6=E5=A5=97=EF=BC=8C=E4=B8=BA=E6=8C=89?= =?UTF-8?q?=E7=89=88=E6=9C=AC=E5=8F=91=E6=A0=87=E5=87=86=E5=8C=85=E6=89=93?= =?UTF-8?q?=E5=BA=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 build.rs 注入 version/gitSha/target/buildTime;`--version` 打印一行。 gitSha 带 `-dirty` 后缀,避免「sha 对得上但代码其实改过」的误判。 - 版本行同时拼成静态字符串(TDC_VERSION_LINE):armv7 产物在 x86 打包机上 跑不起来,打包脚本要靠 strings 捞同一行。 - /api/health 增 gitSha/target/buildTime(纯新增,既有字段一个不动)。 - 版本 0.1.0 → 0.2.0。 动机:设备上跑的到底是哪个构建,此前只能靠 md5 比对几十兆的 `.bak`; 排查 carol 上一个 1.27M 的 mpc 时就卡在无法自证来源。 --- Cargo.toml | 2 +- build.rs | 114 +++++++++++++++++++++++++++++++++++ src/main.rs | 17 +++++- src/tdc/controller/health.rs | 12 ++++ 4 files changed, 141 insertions(+), 4 deletions(-) create mode 100644 build.rs diff --git a/Cargo.toml b/Cargo.toml index 1df52b6..36fa604 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "tdc-connector" -version = "0.1.0" +version = "0.2.0" edition = "2021" description = "TDC (数据接入连接器) MVP — Rust + 静态 HTML + PGlite 本地优先实现" diff --git a/build.rs b/build.rs new file mode 100644 index 0000000..ac0b686 --- /dev/null +++ b/build.rs @@ -0,0 +1,114 @@ +//! 构建期元信息注入:版本号之外,再钉住 **git sha / 构建时间 / 目标三元组**。 +//! +//! 🔴 为什么需要:此前二进制里只有 `CARGO_PKG_VERSION`(恒为 `0.1.0`), +//! 而版本一直没 bump ⇒ 三台设备上跑的到底是哪个构建,只能靠 md5 猜。 +//! 2026-11-14 排查 carol 上一个 1.27M 的 `mpc` 时,正因为无版本串而无法自证来源。 +//! +//! 🔴 本仓 `[dependencies]` 为空(平台走预编译 rlib 闭包),所以 build.rs 只用 std。 +//! +//! 🔴 **不注入 GLIBC 需求**:build.rs 跑的时候二进制还不存在,算不出来。 +//! 那个交给打包脚本对**产物**跑 `objdump -T` 得出并写进 manifest —— 以实物为准, +//! 不以声明为准(声明会和实际脱钩,实物不会)。 + +use std::process::Command; + +fn main() { + // 🔴 构建期自检:`#[cfg(test)]` 在 build.rs 里**不会**被 `cargo test` 执行, + // 所以日历换算只能这样验 —— 错了就让构建失败,而不是留个永不运行的测试。 + assert_eq!(fmt_utc(0), "1970-01-01T00:00:00Z"); + assert_eq!(fmt_utc(1_794_628_200), "2026-11-14T03:50:00Z"); + assert_eq!(fmt_utc(1_709_208_000), "2024-02-29T12:00:00Z"); // 闰日 + + // sha:允许构建脚本用环境变量覆盖(容器里没装 git 时也能钉版本),否则现场问 git。 + let sha = std::env::var("TDC_GIT_SHA") + .ok() + .filter(|s| !s.trim().is_empty()) + .or_else(git_sha) + .unwrap_or_else(|| "unknown".to_string()); + + let epoch = std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .map(|d| d.as_secs()) + .unwrap_or(0); + + let target = std::env::var("TARGET").unwrap_or_else(|_| "unknown".to_string()); + let utc = fmt_utc(epoch); + + // 🔴 版本行**只在这里拼一次**,`--version` 直接打印它。 + // 第二个用途:armv7 产物在 x86_64 打包机上**跑不了**,拿不到 `--version` 输出, + // 打包脚本只能用 `strings` 从二进制里捞这一行 ⇒ 它必须是**完整的静态字符串** + // (`println!` 的格式串加参数在二进制里是碎的,捞不出来)。 + let ver_line = format!( + "tdc-connector {} ({sha} {target} {utc})", + env!("CARGO_PKG_VERSION") + ); + + println!("cargo:rustc-env=TDC_GIT_SHA={sha}"); + println!("cargo:rustc-env=TDC_BUILD_EPOCH={epoch}"); + println!("cargo:rustc-env=TDC_BUILD_UTC={utc}"); + println!("cargo:rustc-env=TDC_BUILD_TARGET={target}"); + println!("cargo:rustc-env=TDC_VERSION_LINE={ver_line}"); + + // 不设这个的话 sha 会永远停在第一次构建的值 —— git 换了也不重跑 build.rs。 + println!("cargo:rerun-if-changed=build.rs"); + println!("cargo:rerun-if-changed=.git/HEAD"); + println!("cargo:rerun-if-changed=.git/index"); + println!("cargo:rerun-if-env-changed=TDC_GIT_SHA"); +} + +/// `git rev-parse --short HEAD`,工作区有未提交改动时追加 `-dirty`。 +/// +/// `-dirty` 很重要:否则「sha 对得上但代码其实改过」会造成误判, +/// 而这正是本轮要消灭的那类问题(设备状态与源码无法对应)。 +fn git_sha() -> Option { + let out = Command::new("git") + .args(["rev-parse", "--short", "HEAD"]) + .output() + .ok()?; + if !out.status.success() { + return None; + } + let sha = String::from_utf8_lossy(&out.stdout).trim().to_string(); + if sha.is_empty() { + return None; + } + + // --untracked-files=no:未跟踪的临时文件不算脏,避免每轮都标 -dirty。 + let dirty = Command::new("git") + .args(["status", "--porcelain", "--untracked-files=no"]) + .output() + .ok() + .filter(|o| o.status.success()) + .map(|o| !o.stdout.is_empty()) + .unwrap_or(false); + + Some(if dirty { format!("{sha}-dirty") } else { sha }) +} + +/// epoch 秒 → `YYYY-MM-DDTHH:MM:SSZ`(UTC),手写以免引入 chrono 依赖。 +/// +/// 算法照 Howard Hinnant 的 `civil_from_days`(把 1970-01-01 起的日数转年月日)。 +fn fmt_utc(secs: u64) -> String { + let days = (secs / 86_400) as i64; + let rem = secs % 86_400; + let (y, m, d) = civil_from_days(days); + format!( + "{y:04}-{m:02}-{d:02}T{:02}:{:02}:{:02}Z", + rem / 3600, + (rem % 3600) / 60, + rem % 60 + ) +} + +fn civil_from_days(z: i64) -> (i64, u32, u32) { + let z = z + 719_468; + let era = if z >= 0 { z } else { z - 146_096 } / 146_097; + let doe = (z - era * 146_097) as u64; // [0, 146096] + let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365; // [0, 399] + let y = yoe as i64 + era * 400; + let doy = doe - (365 * yoe + yoe / 4 - yoe / 100); // [0, 365] + let mp = (5 * doy + 2) / 153; // [0, 11] + let d = (doy - (153 * mp + 2) / 5 + 1) as u32; // [1, 31] + let m = if mp < 10 { mp + 3 } else { mp - 9 } as u32; // [1, 12] + (if m <= 2 { y + 1 } else { y }, m, d) +} diff --git a/src/main.rs b/src/main.rs index 240beb1..7dc10e5 100644 --- a/src/main.rs +++ b/src/main.rs @@ -64,11 +64,22 @@ fn resolve_project_dir() -> PathBuf { #[tokio::main] async fn main() { - // 🔴 `--enc <明文>`:**自证**工具(v3 spec §2.4「cipher 用后端 `--enc` 之类的自证手段」)。 - // 用途:让 `scripts/smoke.sh` **零 node / 零 openssl 依赖**地造出上游前端同款的密文。 - // 🔴 纯 CLI 旁路,**不碰任何 HTTP 路由** ⇒ 对外契约零变化。 + // 🔴 纯 CLI 旁路(**不碰任何 HTTP 路由** ⇒ 对外契约零变化): + // + // `--enc <明文>`:**自证**工具(v3 spec §2.4「cipher 用后端 `--enc` 之类的自证手段」)。 + // 用途:让 `scripts/smoke.sh` **零 node / 零 openssl 依赖**地造出上游前端同款的密文。 + // + // `--version`:打印构建身份四件套。存在的理由是「设备自查」—— + // 登到机器上跑一句就知道跑的是哪个 git 提交、哪个架构、什么时候编的, + // 不必再靠 md5 去比对一堆 69M 的 `.bak`(那是 2026-11-14 之前的做法)。 { let args: Vec = std::env::args().collect(); + if args.len() >= 2 && (args[1] == "--version" || args[1] == "-V") { + // 整行由 build.rs 拼好(`TDC_VERSION_LINE`):打包脚本要能从 armv7 二进制里 + // 用 strings 捞到同一行,所以这里不能再拆成 println! 的格式串 + 参数。 + println!("{}", env!("TDC_VERSION_LINE")); + return; + } if args.len() >= 3 && (args[1] == "--enc" || args[1] == "-e") { println!("{}", tdc_connector::platform::cipher::encrypt_login_password(&args[2])); return; diff --git a/src/tdc/controller/health.rs b/src/tdc/controller/health.rs index 806524f..fa0e7fc 100644 --- a/src/tdc/controller/health.rs +++ b/src/tdc/controller/health.rs @@ -9,6 +9,15 @@ //! |---|---| //! | `tables` | **业务表数** = `public` schema 下 `tdc_*` 表的条数(P0 验收口径:30) | //! | `baseTables` | 账号层表数 = `migrate.sql` **声明的** 3 张 `base_*` 表在库中的条数 | +//! | `version` / `gitSha` / `target` / `buildTime` | 构建身份(见下) | +//! +//! 🔴 **构建身份四件套**(2026-11-14 新增):此前只有 `version` 且版本号长期停在 `0.1.0`, +//! 于是「设备上跑的是哪个构建」只能靠 md5 猜 —— 排查 carol 上一个 1.27M 的 `mpc` +//! 时就卡在这里,无法自证来源。四个字段由 `build.rs` 在编译期钉进二进制: +//! `gitSha` 带 `-dirty` 后缀表示工作区有未提交改动;`target` 是三元组(能区分 +//! x86_64 / armv7);`buildTime` 是 UTC ISO 8601。 +//! ⚠️ GLIBC 需求**不在这里**:那是产物属性,由打包脚本对二进制跑 `objdump` 后写进 +//! `manifest.json` —— 以实物为准,声明会脱钩,实物不会。 //! //! 两个计数都**真查库**(不是静态 JSON)⇒ 与 `schema/migrate.sql` 逐名对账由 //! `scripts/smoke.sh` 守住。 @@ -73,6 +82,9 @@ async fn health(State(state): State) -> axum::Json "status": "UP", "service": "tdc-connector", "version": env!("CARGO_PKG_VERSION"), + "gitSha": env!("TDC_GIT_SHA"), + "target": env!("TDC_BUILD_TARGET"), + "buildTime": env!("TDC_BUILD_UTC"), "protocolVersion": crate::platform::protocol::PROTOCOL_VERSION, "tdsMode": if state.config.tds_base_url.is_some() { "HTTP" } else { "NOOP" }, "tdsBaseUrl": state.config.tds_base_url.clone().unwrap_or_default(),