初始导入：PhoneRail 五路手机直供电源板

原理图/PCB 已在 EasyEDA 里做到 12 页跨页 0 漏接，固件刚完成骨架包 A1。
这次是把已有的一切一次性纳入版本控制，没有改动任何设计内容。

纳入：
- 设计与需求文档、PROGRESS.md、小米8 参考原理图 PDF 与追脚脚本
- .claude/ 下的 EasyEDA 桥接工具链与几何/网表缓存（eda-parts.json、
  pcb-parts.json、pcb-pads.json、p2-ch1.json 等，是重画各页的唯一事实来源）
- 117 张验证截图（本项目所有方向问题都是靠人眼看截图发现的，属于证据不是垃圾）
- firmware/ 的 A1 骨架与 site/ 文档站源码

.gitignore 排除：构建产物（firmware/build、host/build、sdkconfig）、
site/node_modules、__pycache__、桥接日志 _bridge.log、脚本自标的 *.stale。

.gitattributes 默认 `* -text`：现有 .py/.json 大多是 CRLF，原样存，
不让 git 重写行尾。唯一例外是 *.sh 强制 LF —— 带 \r 的 shell 脚本 bash 跑不了。

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01QYuExfgyYa6DzRRcUso8M8

firmware/host/CMakeLists.txt

@@ -0,0 +1,41 @@
+# PhoneRail 宿主机构建 —— 不依赖 ESP-IDF，用来跑单元测试（CTest）。
+#
+#   bash host/test.sh            配置 + 编译 + ctest
+#
+# 与 IDF 目标共享的源码只有 ../main 里的与硬件无关部分。
+# 新增一个既要上板又要被测的 .c，必须同时加进：
+#   ../main/CMakeLists.txt 的 SRCS   和   下面的 PHONERAIL_CORE_SRCS
+cmake_minimum_required(VERSION 3.16)
+project(phonerail_host C)
+
+set(CMAKE_C_STANDARD 11)
+set(CMAKE_C_STANDARD_REQUIRED ON)
+add_compile_options(-Wall -Wextra -Werror)
+
+set(FW_ROOT ${CMAKE_CURRENT_SOURCE_DIR}/..)
+
+# ---- 被测代码 -------------------------------------------------------------
+set(PHONERAIL_CORE_SRCS
+    ${FW_ROOT}/main/version.c
+)
+
+add_library(phonerail_core STATIC ${PHONERAIL_CORE_SRCS})
+target_include_directories(phonerail_core PUBLIC ${FW_ROOT}/main)
+
+# ---- 测试框架 Unity（从 ESP-IDF v5.4 原样复制到 third_party/，与上板测试同一套）
+add_library(unity STATIC ${FW_ROOT}/third_party/unity/unity.c)
+target_include_directories(unity PUBLIC ${FW_ROOT}/third_party/unity)
+target_compile_definitions(unity PUBLIC UNITY_OUTPUT_COLOR)
+# 第三方源码不吃本工程的 -Werror
+target_compile_options(unity PRIVATE -w)
+
+# ---- 测试用例：test/test_*.c 一个文件一个可执行 + 一条 ctest ---------------
+enable_testing()
+
+file(GLOB PHONERAIL_TESTS ${FW_ROOT}/test/test_*.c)
+foreach(test_src ${PHONERAIL_TESTS})
+    get_filename_component(test_name ${test_src} NAME_WE)
+    add_executable(${test_name} ${test_src})
+    target_link_libraries(${test_name} PRIVATE phonerail_core unity)
+    add_test(NAME ${test_name} COMMAND ${test_name})
+endforeach()

firmware/host/test.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# 宿主机验收：配置 + 编译 + 跑全部单元测试。
+#
+# 用 cygwin 的 cmake/make/gcc。两个坑，改这个脚本前先看一眼：
+#  1) Windows 版 CMake 配 cygwin gcc 会认错平台，所以显式用 /c/cygwin64/bin/cmake；
+#  2) cygwin cmake 只认 /cygdrive/... 路径，喂它 "D:/..." 会被当成相对路径
+#     （报 "Found relative path while evaluating include directories"）。
+#     所以这里先 cd 进目录，全部用相对路径，不传任何绝对路径进去。
+set -euo pipefail
+
+CMAKE=${CMAKE:-/c/cygwin64/bin/cmake}
+CTEST=${CTEST:-/c/cygwin64/bin/ctest}
+
+cd "$(dirname "$0")"
+export CC=${CC:-gcc}   # 走 PATH 里的 cygwin gcc；传绝对路径会被 Git Bash 的路径转换搞坏
+
+"$CMAKE" -S . -B build -G "Unix Makefiles" >/dev/null
+"$CMAKE" --build build -j 4
+"$CTEST" --test-dir build --output-on-failure