chore: freeze MapLibreParticleLab step 0 baseline

工具/仓库自检.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+cd "$(git rev-parse --show-toplevel)"
+echo "分支：$(git branch --show-current)"; echo "HEAD：$(git rev-parse HEAD)"; git remote -v
+[[ "$(git remote get-url --push upstream || true)" == DISABLED ]] && echo '[OK] upstream push disabled' || echo '[警告] upstream push'
+[[ "$(git config --get rerere.enabled || true)" == true ]] && echo '[OK] rerere=true' || echo '[警告] rerere=false'
+git submodule status --recursive
+for p in AGENTS.md PARTICLE_BASELINE.md docs/00_项目规范/00_文档目录与命名规范_v1.md docs/报告; do [[ -e "$p" ]] && echo "[OK] $p" || echo "[缺少] $p"; done
+git status --short

工具/同步上游.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+cd "$(git rev-parse --show-toplevel)"; git fetch upstream --tags --prune; git tag --sort=-creatordate | head -n20

工具/完整构建验证.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+JOBS=3
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --jobs) JOBS="$2"; shift 2 ;;
+    *) echo "未知参数：$1"; exit 2 ;;
+  esac
+done
+
+ROOT="$(git rev-parse --show-toplevel)"
+cd "$ROOT"
+
+mkdir -p build-particle
+REPORT="build-particle/构建验证报告.txt"
+: > "$REPORT"
+exec > >(tee -a "$REPORT") 2>&1
+
+# 环境文件内部会安全处理 nvm + nounset。
+if [[ -f "$HOME/.maplibre-particle-env" ]]; then
+  # shellcheck disable=SC1090
+  source "$HOME/.maplibre-particle-env"
+fi
+
+export CMAKE_BUILD_PARALLEL_LEVEL="$JOBS"
+export CTEST_PARALLEL_LEVEL="$JOBS"
+
+echo "=== MapLibreParticleLab 完整构建验证 ==="
+echo "HEAD：$(git rev-parse HEAD)"
+echo "并行度：$JOBS"
+echo "Node：$(node -v)"
+echo "npm：$(npm -v)"
+echo "Java：$(java -version 2>&1 | head -n1)"
+echo
+
+echo "[1/3] Linux OpenGL"
+cmake --preset linux-opengl
+cmake --build build-linux-opengl --target mbgl-render mbgl-render-test-runner -j "$JOBS"
+
+echo
+echo "[2/3] Android OpenGL Debug"
+(
+  cd "$ROOT/platform/android"
+  RENDERER=opengl BUILDTYPE=Debug JOBS="$JOBS" make apackage
+)
+
+echo
+echo "[3/3] Android Vulkan Debug"
+(
+  cd "$ROOT/platform/android"
+  RENDERER=vulkan BUILDTYPE=Debug JOBS="$JOBS" make apackage
+)
+
+cd "$ROOT"
+
+sed -i \
+  's/- \[ \] Linux Native 构建/- [x] Linux Native 构建/; s/- \[ \] Android OpenGL 构建/- [x] Android OpenGL 构建/; s/- \[ \] Android Vulkan 构建/- [x] Android Vulkan 构建/' \
+  docs/50_Step记录/STEP-000_完整环境初始化_v1.md 2>/dev/null || true
+
+echo
+echo "全部构建验证完成。"

工具/生成Codex任务.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+NUM="${1:-}"; TOPIC="${2:-}"; [[ -n "$NUM" && -n "$TOPIC" ]] || { echo "用法：$0 001 粒子接入调查"; exit 2; }; cd "$(git rev-parse --show-toplevel)"; F="docs/40_任务/STEP-${NUM}_${TOPIC}_Codex任务_v1.md"; [[ ! -e "$F" ]] || exit 1
+cat > "$F" <<EOF
+# STEP-${NUM} ${TOPIC} — Codex 任务 v1
+## 执行前必读
+- AGENTS.md
+- PARTICLE_BASELINE.md
+- docs/00_项目规范/
+- docs/50_Step记录/STEP-${NUM}_${TOPIC}_v1.md
+## 目标
+待填写。
+## 必做项
+- [ ] 待填写
+## 允许修改范围
+待填写。
+## 禁止修改范围
+待填写。
+## 构建与测试
+待填写。
+## 必做输出
+- [ ] 更新 Step
+- [ ] 更新 粒子开发记录.md
+- [ ] 生成 docs/报告/STEP-${NUM}_${TOPIC}_Codex完成报告_v1.md
+## 停止条件
+遇到架构不确定、上游接口不足或必须扩大范围时停止扩大修改并报告。
+EOF
+echo "已生成 $F"

工具/生成新Step.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+NUM="${1:-}"; TOPIC="${2:-}"; [[ -n "$NUM" && -n "$TOPIC" ]] || { echo "用法：$0 001 粒子接入调查"; exit 2; }; cd "$(git rev-parse --show-toplevel)"; F="docs/50_Step记录/STEP-${NUM}_${TOPIC}_v1.md"; [[ ! -e "$F" ]] || exit 1
+cat > "$F" <<EOF
+# STEP-${NUM} ${TOPIC}
+## 状态
+计划
+## 目标
+待填写。
+## 基线
+- MapLibre：见 PARTICLE_BASELINE.md
+- 分支：$(git branch --show-current)
+- HEAD：$(git rev-parse HEAD)
+## 必做项
+- [ ] 待填写
+## 允许修改范围
+待填写。
+## 禁止修改范围
+待填写。
+## 构建与测试
+待填写。
+## 必做输出
+- [ ] 更新本 Step
+- [ ] 更新 粒子开发记录.md
+- [ ] 生成 docs/报告/STEP-${NUM}_${TOPIC}_Codex完成报告_v1.md
+## 当前结果
+未开始。
+## 未完成/阻塞
+无。
+## 下一步
+待填写。
+EOF
+echo "已生成 $F"

工具/首次推送Gitea.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+cd "$(git rev-parse --show-toplevel)"; [[ "$(git branch --show-current)" == particle/main ]] || { echo '当前不是 particle/main'; exit 1; }; git push -u origin particle/main