初始导入：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/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