测试：新增 sys_clock 主机侧单测并修复 Zeller 星期缺陷

test/host/README.md

@@ -38,9 +38,13 @@
 | `watchdog/run_unit_test.py` | **看门狗判定状态机单测**：声明 `TestBuild` 后调 harness，用 MSVC 离线编译真实 `App/util/task_watchdog.c`（可观测桩驱动），39 用例穷举边界。零硬件、秒级（退出码 0=PASS/1=FAIL/2=环境错误） |
 | `watchdog/watchdog_test.c` | 测试单元本体（`#include` 生产源码 + 平台钩子桩） |
 | `watchdog/stub/` | 桩头文件（`main.h`/`iwdg.h`/`dbg_log.h`），覆盖 MCU 版以在 PC 上编译 |
+| `sys_clock/run_unit_test.py` | **系统时钟换算单测**：离线编译真实 `App/util/sys_clock.c`，以可控时钟 + 阴影 RTC 桩驱动，100 断言点覆盖闰年/月末/世纪/2038 上限/星期/30 天惰性再基准化/RTC 故障降级 |
+| `sys_clock/sys_clock_test.c` | 测试单元本体（`#include` 生产源码 + 强符号桩；**不改生产代码**） |
+| `sys_clock/stub/` | 桩头文件（`main.h`/`FreeRTOS.h`/`task.h`/`dbg_log.h`），覆盖 MCU 版以在 PC 上编译 |
 
-> 详见 `docs/测试说明/看门狗单元测试说明.md`；harness 用法见 [`common/README.md`](common/README.md)。
-> 已挂 pre-commit 钩子 `watchdog-unit-test`。
+> 详见 `docs/测试说明/看门狗单元测试说明.md`、`docs/测试说明/系统时钟单元测试说明.md`；
+> harness 用法见 [`common/README.md`](common/README.md)。
+> 已挂 pre-commit 钩子 `watchdog-unit-test`、`sys-clock-unit-test`。
 
 ## 运行方式
 
@@ -55,6 +59,9 @@
 
 # 看门狗判定状态机单测（纯逻辑，无需真机）
 & '.venv\Scripts\python.exe' test/host/watchdog/run_unit_test.py
+
+# 系统时钟换算单测（纯逻辑，无需真机）
+& '.venv\Scripts\python.exe' test/host/sys_clock/run_unit_test.py
 ```
 
 > 串口端口配置在 `.opencode/serial_config.json`（单一配置源，当前 COM6/115200）。
@@ -63,13 +70,15 @@
 
 - **PYTHONPATH/路径敏感**：脚本按仓库根相对路径读写，**从仓库根执行**
 - 本目录**被 pre-commit 门禁的 cppcheck / 代码规范排除**（`test/` 豁免）；
-  但 `watchdog/run_unit_test.py` 自身**作为独立钩子**参与门禁（见上）
+  但 `watchdog/run_unit_test.py`、`sys_clock/run_unit_test.py` 自身**作为独立钩子**
+  参与门禁（见上）
 - 台架探针族（TCP 复连 / FTP 中止等）在 `MDK-ARM/*.py`，与本目录分工不同
-- `watchdog/` 单测需要本机装有 MSVC（VS2019/2022 的 C++ 工具链）；无则脚本报环境错误（退出码 2）
+- `watchdog/`、`sys_clock/` 单测需要本机装有 MSVC（VS2019/2022 的 C++ 工具链）；无则脚本报环境错误（退出码 2）
 
 ## 相关文档
 
 - `docs/测试说明/自动化测试流程.md` — `@test` 细节与失败模式
 - `docs/测试说明/测试开发标准流程.md` — 测试分层与门禁
 - `docs/测试说明/看门狗单元测试说明.md` — 主机侧单测（用例 / 平台层 / 扩展方法）
+- `docs/测试说明/系统时钟单元测试说明.md` — 系统时钟换算单测（用例 / 桩 / Zeller 缺陷记录）
 - `docs/测试说明/CH395F_Test_Guide.md`、`FTP_Test_Guide.md`