docs(project): 同步维护冻结与运行文档

补齐解析模块维护冻结规则，并同步 CURRENT_STATUS、CURRENT_GAPS、PROJECT_PLAN、RPC 参考、部署指南、用户指南和官方资源运行说明。

文档同时反映 bat-api 资源 bootstrap/分发边界、官方同步解析缓存、TextUnit 队列、双目录发布和 patch 入口的当前状态。

验证：未运行新命令；本轮已按要求停止重复构建/测试。

docs/architecture/resource-release-layout.md

@@ -1,7 +1,7 @@
 # 官方资源 Release 布局与资源侧契约
 
-- **更新时间**：2026-07-24
-- **用途**：冻结日服官方资源在本地发布根上的布局、URL 映射、seed 规则，以及 `bat-api` 分发 path 的 1:1 对应关系。
+- **更新时间**：2026-07-27
+- **用途**：冻结日服官方资源在本地发布根上的布局、URL 映射、seed 规则、`bat`/`bat-api` 关系，以及 `bat-api` 分发 path 的 1:1 对应关系。
 - **范围**：资源发现 / 清单 / 落盘 / 只读分发（**不是**完整游戏业务 API）。
 - **权威代码**：
   - URL / 平台 / seed：`adapters/src/official/yostar_jp.rs`
@@ -17,7 +17,7 @@
 | 角色 | 组件 | 职责 |
 |---|---|---|
 | 同步 / 运维（近乎全自动） | Rust `bat` | auto-discover、拉取、校验、发布、watch/daemon、RPC 后端 |
-| 资源只读分发 | Go `bat-api` | 按官方 CDN path 提供已发布字节；经 `bat.sock` 发现版本 |
+| 资源 bootstrap / 只读分发 | Go `bat-api` | 同环境经 `bat.sock` 发现已发布版本和 `resource_root`，提供 `/v1/bootstrap`、server-info 改写和官方 CDN path 字节 |
 | 试验 CLI | Go `cmd/bat` → `bin/bat-go` | 非产品；禁止与 Rust `bat` 重名 |
 
 **禁止**：把已安装客户端目录或 `/home/wanye/D/BlueArchive` 当作生产输入；真实全量样本优先服务器 release 或 `/tmp` 隔离目录。
@@ -32,7 +32,11 @@
   versions/<id>/                   # 已发布 versioned release（= resource_root）
     official-download-manifest.json
     official-parse-cache.json       # 校验后派生解析缓存，不是汉化产物
-    official-sync-snapshot.json    # 常在 active root / current 下
+    official-textunit-index.json    # TextUnit 明细与解析错误索引，不是汉化产物
+    official-textunit-tasks.json    # 翻译任务候选派生队列，不发 Crowdin 网络请求
+    crowdin-textunit-queue.json     # Crowdin worker 离线输入队列
+    official-sync-snapshot.json     # 常在 active root / current 下
+    official-launcher-bootstrap.json # 官方 launcher 引导链版本化产物
     prod-clientpatch.bluearchiveyostar.com/
       <root_token>/
         TableBundles/
@@ -65,6 +69,7 @@
   .staging/<id>/                   # 未发布写侧（失败可复用）
   official-version-state.json      # 发布根级版本状态
   official-bootstrap-cache.json    # auto-discover 缓存
+  official-launcher-bootstrap.pending.json # 维护期 launcher 已前进但资源未开放时的待处理证据
 
 <localized-output>/                # 汉化产物发布根（--localized-output / BAT_LOCALIZED_OUTPUT）
   current -> versions/<id>         # 已汉化后才切换；未汉化状态不发布
@@ -83,7 +88,7 @@
 |---|---|
 | 下载写入 | `<output>/.staging/<id>` |
 | 发布完成 | rename 到 `versions/<id>`，再切换 `current` |
-| 生产读取 / bat-api | `current` 解析后的 versioned 目录，或 RPC 给出的 `version.resource_root` |
+| 生产读取 / bat-api | RPC 给出的 `version.resource_root`；通常等价于 `current` 解析后的 versioned 目录 |
 
 ---
 
@@ -110,7 +115,7 @@ https://{host}/{path...}  →  <resource_root>/{host}/{path...}
 | `prod-clientpatch.bluearchiveyostar.com` | Addressables / Table / Media / PatchPack 内容 |
 | `yostar-serverinfo.bluearchiveyostar.com` | server-info JSON |
 
-（launcher 包 CDN 属于启动器链，**不是**默认资源 release 主体。）
+（launcher 包 CDN 属于启动器链，**不是**默认资源 release 主体。Rust `bat` 会把启动器链中与资源发现相关的 launcher metadata、CDN config、remote manifest 文件列表、选中的 `resources.assets` 来源和 `GameMainConfig` 摘要写入 `official-launcher-bootstrap.json`，供后续 `bat-api` / 自研客户端在 Rust 侧完成前继续以 versioned release 为权威来源。）
 
 ### 3.2 bat-api 对外 path（1:1）
 
@@ -121,6 +126,45 @@ GET {public-base-url}/prod-clientpatch.bluearchiveyostar.com/<root_token>/...
 
 默认仅服务 **download manifest 索引内且 Present + size 匹配** 的文件。
 
+### 3.3 launcher 资源引导兼容
+
+只读分析本机样本时可见两类启动器形态：
+
+| 目录形态 | 说明 |
+|---|---|
+| `AllResources/YostarGames/BlueArchive_JP_Gamelauncher` | 官方 Electron 启动器目录 |
+| `Localized` / `Localized_Official` | 汉化或改造启动器目录 |
+| `AllResources/YostarGames/BlueArchive_JP` | 官方安装后的游戏客户端目录，含 `game-launcher-config.json`、`manifest.json` 和 `BlueArchive_Data/StreamingAssets/catalog_Remote.*` |
+
+这些目录只作为开发期样本；生产链路不得依赖 `/home/wanye/D/BlueArchive` 或任何已安装客户端目录。
+
+官方启动器样本中与资源发现相关的 HTTP path：
+
+| Host / path | 资源侧意义 |
+|---|---|
+| `https://api-launcher-jp.yo-star.com/api/launcher/game/config` | 返回 launcher 观察到的最新客户端版本和包路径 |
+| `https://api-launcher-jp.yo-star.com/api/launcher/game/config/json?version=...&file_path=...` | 返回远端 package manifest URL |
+| `https://api-launcher-jp.yo-star.com/api/launcher/advanced/game/download/cdn` | 返回 launcher package CDN primary / backup |
+
+`bat-api` 的兼容范围是**资源引导**，不是完整启动器更新服务：
+
+| bat-api path | 行为 |
+|---|---|
+| `/v1/launcher/bootstrap` | 返回资源引导聚合视图：已发布 release、launcher metadata、GameMainConfig 摘要、server-info URL、client-patch base、改写后的 Addressables root |
+| `/api/launcher/game/config` | 返回 `{code,message,data}` envelope，字段来自 Rust `bat` snapshot/RPC 中的 `launcher_metadata`，并附带 `resource_bootstrap_url` |
+| `/api/launcher/game/config/json` | 返回指向 `/api-launcher-jp.yo-star.com/api/launcher/resource/bootstrap.json` 的资源引导 JSON URL，显式标记 `package_update_manifest=false` |
+| `/api/launcher/advanced/game/download/cdn` | 返回 `public-base-url` 作为资源引导 CDN 根，显式标记 `package_update_manifest=false` |
+| `/api-launcher-jp.yo-star.com/...` | 与上面裸 path 等价，便于反向代理或 hosts 映射保持官方 host 形状 |
+
+数据来源只能是 Rust `bat` 已发布状态；当前 Go `bat-api` 仍主要消费 snapshot/RPC 摘要，后续字段统一与联调时应把 versioned launcher artifact 纳入 contract fixture：
+
+1. `catalog.status` / `official-sync-snapshot.json` 中的 `launcher_metadata`。
+2. `catalog.status` / `official-sync-snapshot.json` 中的 `game_main_config_bootstrap`。
+3. `official-launcher-bootstrap.json` 中的官方 launcher bootstrap versioned artifact。
+4. `resource.manifest` 和磁盘 Present/size 检查得到的当前 release 索引。
+
+`bat-api` 不下载 launcher 包、不生成官方 PC package update manifest、不执行启动器签名/鉴权链、不仿造登录、账号、网关或游戏业务 API。需要真实资源拉取时，仍由 Rust `bat --auto-discover` 在隔离 staging 中通过官方 HTTP metadata 完成，并把已发布结果通过 RPC 暴露给 `bat-api`。
+
 ---
 
 ## 4. `official-download-manifest.json`
@@ -226,10 +270,14 @@ https://prod-clientpatch.bluearchiveyostar.com/<root_token>
 
 | 面 | 假设（当前工程） | bat-api 行为 |
 |---|---|---|
-| client-patch 内容 | GET 官方 path；无业务鉴权头（资源 CDN） | `GET/HEAD /prod-clientpatch.../...` 原样字节 |
+| 启动前资源发现 | 客户端/补丁器需要知道当前资源版本、server-info 和 client-patch 根 | `GET /v1/bootstrap` 返回 `bat` RPC 健康、release 摘要、server-info URL、client-patch base 和改写后的 Addressables root |
+| 服务就绪 | 运维需要区分进程存活和 release 是否可分发 | `GET /healthz` 返回 liveness + RPC refresh 诊断；`GET/HEAD /readyz` 无可分发 release 时返回 `503` |
+| client-patch 内容 | GET 官方 path；无业务鉴权头（资源 CDN） | `GET/HEAD /prod-clientpatch.../...` 原样字节，支持 Range |
 | server-info | GET JSON；字段 PascalCase（`ConnectionGroups` 等） | 可选加载并**只改** `AddressablesCatalogUrlRoot` 指向 `{public-base}/prod-clientpatch.../{token}` |
+| launcher bootstrap | 启动器链会先查 launcher metadata，再找到 server-info / Addressables root | `/v1/launcher/bootstrap` 与 `/api/launcher/...` 只输出资源引导兼容信息，来源是 Rust snapshot/RPC |
 | seed `.hash` | 纯文本十进制（可含空白） | 原样分发 |
-| Range / 断点 | 官方客户端下载器用 Range；bat 用 curl `.part` | **本轮 bat-api 可不实现 Range**；记入后续 |
+| Range / 断点 | 官方客户端下载器用 Range；bat 用 curl `.part` | `ServeContent` 支持 Range / `206` / `416` / `If-Range` |
+| 缓存 / 条件请求 | 资源位于 versioned root；manifest 有 BLAKE3 | ETag 优先使用 manifest BLAKE3；返回 Last-Modified、Accept-Ranges、长期 Cache-Control |
 | 业务 ApiUrl/Gateway | 游戏协议 | **不改写、不仿造** |
 
 Addressables 改写后客户端拼接：
@@ -245,7 +293,7 @@ Addressables 改写后客户端拼接：
 
 ## 8. RPC 与分发发现顺序
 
-`bat-api`（及任何 Go 服务层）发现当前 release：
+`bat-api`（及任何 Go 服务层）发现当前 release，并由 `/v1/bootstrap` 组织为启动前资源入口：
 
 1. `daemon.status`
 2. `daemon.doctor`
@@ -255,7 +303,7 @@ Addressables 改写后客户端拼接：
 
 **不读** `bat-status.json` / `bat-tasks.json` 作为常规路径。
 
-配置：`--socket` / `BAT_API_SOCKET`；应急 `--resource-root`。见 `cmd/bat-api/.env.example`。
+生产配置：`--socket` / `BAT_API_SOCKET`，`bat-api` 与 `bat` 在同服务器、同容器或同共享文件系统环境内运行。`--resource-root` 只用于本地 fixture 或应急只读诊断，不作为生产资源根配置。`BAT_API_REFRESH_INTERVAL` 控制 bat-api 周期重读 RPC，以跟随 Rust `bat` 发布新 release。见 `cmd/bat-api/.env.example`。
 
 ---