0827协议修订：姿态数据2改预留 + 状态帧新增剩余发电量 + CCU地址可配置

FC协议(0827 docx)：
- 控制指令域：字节12,13/16,17由纵倾/横倾姿态数据2改为预留（编码恒0、解码忽略）
- 状态反馈域：字节147,148由预留12改为剩余发电量(MWh)，贯通JSON/网页显示
- PM→CCU链路：姿态字段4xuchar改为2xshort(数据1)，结构体大小与线上布局不变
- 同步更新：CCU转发映射、SnapshotBuilder、pCCU网页、fuelcell网页、SQLite列描述、单测/模拟器
- 修正集成测试遗留断言(20B→24B、心跳d[19]→d[23])并增强预留字节校验

CCU地址可配置：
- pPowerManger 支持 moos 配置项 ccuhost/ccuport（默认127.0.0.1:7000）
- build-board.sh 增加 --ccu-host/--ccu-port 参数

文档：FC协议文档更新为0827版，清理过期协议docx

scripts/deploy.sh

@@ -20,6 +20,8 @@
 #   --user <user>    登录用户（默认 root）
 #   --board-dir <dir> 板卡部署根目录（默认 /root/work/h100）
 #   --start          部署后立即启动服务
+#   --ccu-host <ip>  覆盖 mission 中 pPowerManger 的 CCU 地址 (ccuhost)
+#   --ccu-port <n>   覆盖 mission 中 pPowerManger 的 CCU 端口 (ccuport)
 #
 # 板卡布局:
 #   /root/work/h100/bin/        aarch64 二进制
@@ -37,6 +39,8 @@ HOST="192.168.0.223"
 USER="root"
 BOARD_DIR="/root/work/h100"
 DO_START=0
+CCU_HOST=""
+CCU_PORT=""
 
 SERVICES=(moosdb pPowerManger pPowerMangerHost pCCU)
 
@@ -46,7 +50,7 @@ warn() { printf '\033[1;33m[deploy]\033[0m %s\n' "$*"; }
 err()  { printf '\033[1;31m[deploy]\033[0m %s\n' "$*"; }
 
 usage() {
-  sed -n '2,29p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+  sed -n '2,31p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
   exit 0
 }
 
@@ -60,6 +64,8 @@ while [ $# -gt 0 ]; do
         --user)     [ $# -ge 2 ] || { err "--user 需要参数"; exit 1; }; USER="$2"; shift 2 ;;
         --board-dir)[ $# -ge 2 ] || { err "--board-dir 需要参数"; exit 1; }; BOARD_DIR="$2"; shift 2 ;;
         --start)    DO_START=1; shift ;;
+        --ccu-host) [ $# -ge 2 ] || { err "--ccu-host 需要参数"; exit 1; }; CCU_HOST="$2"; shift 2 ;;
+        --ccu-port) [ $# -ge 2 ] || { err "--ccu-port 需要参数"; exit 1; }; CCU_PORT="$2"; shift 2 ;;
         setup-ssh|status|stop|help|-h|--help) ACTION="$1"; shift ;;
         "") shift ;;
         *) err "未知参数: $1（见 help）"; exit 1 ;;
@@ -67,6 +73,10 @@ while [ $# -gt 0 ]; do
 done
 [ -n "${ACTION}" ] || ACTION="deploy"
 
+case "${CCU_PORT}" in
+    ""|*[!0-9]*) [ -z "${CCU_PORT}" ] || { err "--ccu-port 必须是数字端口: ${CCU_PORT}"; exit 1; } ;;
+esac
+
 SSH_TARGET="${USER}@${HOST}"
 SSH="ssh -o BatchMode=yes -o ConnectTimeout=5"
 SCP="scp -o BatchMode=yes -o ConnectTimeout=5"
@@ -164,6 +174,21 @@ WantedBy=multi-user.target
 EOF
 }
 
+#-------------------------------------------------------------------
+# mission 中插入/替换 "key = value"（键已存在则替换，否则插到第一个
+# 顶层 '}' 之前，即 pPowerManger 配置块末尾）
+#-------------------------------------------------------------------
+upsert_moos_param() {
+    local f="$1" key="$2" val="$3"
+    if grep -qE "^[[:space:]]*${key}[[:space:]]*=" "${f}"; then
+        sed -i -E "s|^([[:space:]]*)${key}[[:space:]]*=.*|\1${key} = ${val}|" "${f}"
+    else
+        awk -v kv="   ${key} = ${val}" \
+            '!d && /^[[:space:]]*}[[:space:]]*$/ { print kv; d=1 } { print }' \
+            "${f}" > "${f}.tmp" && mv "${f}.tmp" "${f}"
+    fi
+}
+
 #-------------------------------------------------------------------
 # 命令: deploy
 #-------------------------------------------------------------------
@@ -182,8 +207,19 @@ cmd_deploy() {
               "${SSH_TARGET}:${BOARD_DIR}/bin/" || { err "推送二进制失败"; return 1; }
 
     info "推送 mission h100.moos ..."
-    ${SCP} -q "${PROJECT_ROOT}/missions/h100.moos" \
-              "${SSH_TARGET}:${BOARD_DIR}/missions/" || { err "推送 mission 失败"; return 1; }
+    local mission_src="${PROJECT_ROOT}/missions/h100.moos"
+    local mission_push="${mission_src}" tmp_moos=""
+    if [ -n "${CCU_HOST}" ] || [ -n "${CCU_PORT}" ]; then
+        tmp_moos="$(mktemp)"
+        cp "${mission_src}" "${tmp_moos}"
+        [ -n "${CCU_HOST}" ] && upsert_moos_param "${tmp_moos}" ccuhost "${CCU_HOST}"
+        [ -n "${CCU_PORT}" ] && upsert_moos_param "${tmp_moos}" ccuport "${CCU_PORT}"
+        mission_push="${tmp_moos}"
+        info "CCU 地址覆盖: ccuhost=${CCU_HOST:-<保持原值>} ccuport=${CCU_PORT:-<保持原值>}"
+    fi
+    ${SCP} -q "${mission_push}" \
+              "${SSH_TARGET}:${BOARD_DIR}/missions/" || { err "推送 mission 失败"; [ -n "${tmp_moos}" ] && rm -f "${tmp_moos}"; return 1; }
+    [ -n "${tmp_moos}" ] && rm -f "${tmp_moos}"
 
     ${SSH} "${SSH_TARGET}" "chmod +x ${BOARD_DIR}/bin/pPowerManger ${BOARD_DIR}/bin/pPowerMangerHost ${BOARD_DIR}/bin/pCCU"
     ok "二进制与 mission 已推送"