feat(bat-api): 实现内嵌 dashboard

Closes #46

docs/guides/bat-workflows.md

@@ -231,15 +231,26 @@ bat parse schedule list --state-dir /tmp/bat-schedule
 `schedule run --force` 会忽略到期时间立即执行指定计划，`--schedule-max-runs N`
 限制本轮最多执行 N 个到期计划。
 
-## bat-api 调度接口
+## bat-api 调度与 dashboard 接口
 
-dashboard 通过 `bat-api` 转发到 Rust `bat.sock`，不维护第二份计划状态。Rust RPC 方法为：
+内嵌 dashboard 由 `bat-api` 直接服务于 `GET /admin/dashboard/`。页面静态资产免
+token 读取，但资源、调度、任务、日志、解析和翻译控制都通过 `bat-api` 转发到
+Rust `bat.sock`，不维护第二份计划状态或翻译状态。Rust RPC 方法为：
 
 - `schedule.list`
 - `schedule.add`
 - `schedule.update`
 - `schedule.remove`
 - `schedule.run`
+- `task.list`
+- `task.status`
+- `task.logs`
+- `task.cancel`
+- `daemon.logs`
+- `daemon.doctor`
+- `parse.status`
+- `parse.text_units`
+- `parse.errors`
 
 `bat-api` 对应接口为 `GET /admin/schedules` 和
 `POST /admin/control/schedule-add|schedule-update|schedule-remove|schedule-run`，
@@ -250,6 +261,18 @@ contract：`id`、`group`、`action`、`args`、`next_run_unix_seconds`、
 `enabled`；`schedule.list` 额外接受 `id`、`group`、`enabled` 过滤，
 `schedule.run` 额外接受 `group`、`force` 和 `max_runs`。
 
+任务和诊断接口同样要求管理 token：`GET /admin/diagnostics` 转发
+`daemon.doctor`，`GET /admin/logs?tail=200` 转发 `daemon.logs`，
+`GET /admin/tasks`、`GET /admin/tasks/status?task_id=...` 和
+`GET /admin/tasks/logs?task_id=...` 转发 `task.*` 查询。取消任务使用
+`POST /admin/control/task-cancel`，请求字段为 `task_id`。
+
+解析查询接口为 `GET /admin/parse/status`、
+`GET /admin/parse/text-units` 和 `GET /admin/parse/errors`，均只读转发当前
+Rust release 的 `parse.*` 数据。`text-units` 与 `errors` 支持 `offset`、
+`limit`、`destination`、`path_pattern`、`archive_entry`、`path_id`、`class_id`、
+`field_path` 和 `format` query，`limit` 范围为 `1..=1000`。
+
 翻译任务状态可由已鉴权的 dashboard 通过 `GET /admin/translation/tasks`
 查询，query 过滤项包括 `offset`、`limit`、`task_id`、`release_id`、
 `destination`、`path_pattern`、`archive_entry`、`status`、`worker_status`、
@@ -259,8 +282,12 @@ Rust `translation.tasks` / `translation.handoff`，不在 Go 侧维护状态。
 
 翻译任务状态也可由已鉴权的 dashboard 通过
 `POST /admin/control/translation-task-update` 回写，请求字段为
-`task_id`、`status`，以及可选的 `failure_reason`、`provider_run_id`；
-该接口只转发 `translation.task.update`。
+`task_id`、`status`，以及可选的 `failure_reason`、`provider`、
+`provider_run_id` 和 `translation_results`；该接口只转发
+`translation.task.update`。人工校对流程提交译文时必须使用 `status=completed`，
+并为每个 `translation_results[]` 提供 `unit_id`、`source_text` 和
+`translated_text`，Rust 会用当前 `official-textunit-index.json` 校验 unit、
+source text、destination 和 archive entry 后再落库。
 
 `POST /admin/control/translation-worker-run` 会触发 Rust 侧
 `translation.worker.run`，请求字段为 `provider`、`fixture_path`、

docs/guides/development.md

@@ -155,7 +155,7 @@ make check-docs
 Go 边界与进度以 `docs/reports/GO_STATUS.md` 为准：
 
 - **同步/运维命令行** = Rust `bat`（近乎全自动）
-- **资源 bootstrap/分发服务** = `cmd/bat-api`（`make build-go-api`）
+- **资源 bootstrap/分发服务与内嵌 dashboard** = `cmd/bat-api`（`make build-go-api`）
 - **默认 Go 门禁** = `make test-go-api`（无 FFI）
 - 试验 CLI 产物为 `bin/bat-go`（`make build-go-cli`），**禁止**与 Rust `bat` 重名
 - 修改 FFI 时再跑 `make test-go-ffi`
@@ -172,7 +172,7 @@ BAT_API_SKIP_ENV_FILE=1 go run ./cmd/bat-api \
   --refresh-interval 0
 ```
 
-其中 `make bat-api-local-live-smoke` 会在 `/tmp` 中启动真实 Rust daemon 和 Go API，覆盖 release 切换、清单不完整、无 release、RPC 断开、server-info、CDN Range/缓存和路径越界；报告保留在该次 smoke 的临时目录。单独的 `--resource-root` 命令只验证 fixture HTTP 形态，不替代 live socket 联调。
+其中 `make bat-api-local-live-smoke` 会在 `/tmp` 中启动真实 Rust daemon 和 Go API，覆盖 release 切换、清单不完整、无 release、RPC 断开、server-info、CDN Range/缓存和路径越界；报告保留在该次 smoke 的临时目录。单独的 `--resource-root` 命令只验证 fixture HTTP 形态，不替代 live socket 联调。浏览器检查内嵌 dashboard 时打开 `http://127.0.0.1:18080/admin/dashboard/`，再在页面内填入管理 token。
 
 生产默认路径仍是 `--socket` / `BAT_API_SOCKET`，资源根由 Rust `bat` RPC 返回；`--resource-root` 只用于上述 fixture 或应急只读诊断。
 

docs/reference/rpc-backend-api.md

@@ -256,8 +256,12 @@ offset 和 error。TypeTree-covered managed reference 字段会进入结构化
 `translation.task.update` 只更新当前 release 的 SQLite 状态库，不改写 immutable
 队列文件，也不主动访问 Crowdin。`status` 支持 `queued`、`running`、`failed`、
 `completed` 和 `skipped`；进入 `running` 会增加 attempt count，`completed` 会
-记录完成时间，`failed` 可写入 `failure_reason`。因此 worker 消费 handoff 后，
-bat-api 可通过 `translation.tasks` 查询单项任务，也可通过
+记录完成时间，`failed` 可写入 `failure_reason`。人工校对流程可以在
+`status=completed` 时额外提交 `provider`、`provider_run_id` 和
+`translation_results[]`，每个结果必须包含 `unit_id`、`source_text` 和
+`translated_text`；Rust 会用当前 `official-textunit-index.json` 校验 unit、
+source text、destination 和 archive entry 后再落库。因此 worker 或人工校对流程
+消费 handoff 后，bat-api 可通过 `translation.tasks` 查询单项任务，也可通过
 `translation.handoff` 获取完整 job/unit/provider run 状态。`translation.handoff`
 不会触发下载或 provider 网络请求；没有当前 release 或任务队列时返回
 `data.available=false`。
@@ -468,6 +472,9 @@ CLI 对应关系：
 | `Backend` | `daemon.status`、`daemon.doctor`、`resource.state`、`catalog.status`、`resource.manifest` | 启动发现、周期刷新和资源分发 |
 | `ControlBackend` | `daemon.restart`、`daemon.reload`、`daemon.refresh`、`resource.sync`、`resource.verify`、`resource.repair`、`catalog.refresh` | 鉴权后的管理控制白名单 |
 | `ScheduleBackend` | `schedule.list`、`schedule.add`、`schedule.update`、`schedule.remove`、`schedule.run` | 鉴权后的 dashboard 调度计划控制 |
+| `DaemonLogsBackend` | `daemon.logs` | 鉴权后的 daemon 日志尾部查询 |
+| `TaskBackend` | `task.list`、`task.status`、`task.logs`、`task.cancel` | 鉴权后的 daemon 任务查询和取消 |
+| `ParseBackend` | `parse.status`、`parse.text_units`、`parse.errors` | 鉴权后的当前 release 解析状态、TextUnit 和解析错误只读查询 |
 | `TranslationBackend` | `translation.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` | 鉴权后的 dashboard 翻译任务查询、交接视图、状态回写、provider worker 触发与人工校对标记 |
 | `LocalizedBackend` | `localized.status`、`localized.publish`、`localized.rollback` | 鉴权后的汉化 release 状态、发布与显式回滚 |
 

docs/reports/CURRENT_GAPS.md

@@ -259,19 +259,24 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 
 排期：P2 主体可联调；持久化 API 层与完整 launcher/业务链另议。
 
-### G-010：Web 管理后台尚未实现
+### G-010：完整 Web 管理后台仍未实现
 
 现象：
 
-- `web/` 只有目录结构。
+- `web/` 已提供无构建内嵌 dashboard MVP，作为 `bat-api` 静态资产服务于
+  `/admin/dashboard/`。
+- 当前页面可调用已鉴权的资源、调度、任务、日志、parse、翻译和 localized 发布/回滚
+  接口，但不提供独立登录、角色权限、术语管理、批量审核工作流或构建型前端工程。
 
 影响：
 
-- 翻译审核、术语管理、Dashboard 无 UI。
+- 基础资源/调度/翻译控制可以在 dashboard 上完成。
+- 协作式翻译审核、术语管理和权限隔离仍缺少完整 UI。
 
 验收：
 
 - 登录、权限、翻译审核、术语管理基础流程可用。
+- Dashboard E2E、静态资产构建/发布策略和错误态交互纳入常规门禁。
 
 ---
 

docs/reports/GO_STATUS.md

@@ -1,6 +1,6 @@
 # Go 侧进度与边界（权威）
 
-- **更新时间**：2026-08-29
+- **更新时间**：2026-08-31
 - **用途**：统一 Go module `bat-api` 的产品边界、既有约定和组件进度；其他文档与此冲突时以本文为准。
 - **关联**：issue #19 / G-009（资源 bootstrap/分发）、G-008（已决策关闭）、`docs/architecture/official-resource-backend.md` §7、`docs/guides/bat-api-local-live-smoke.md`
 
@@ -11,7 +11,7 @@
 | 名称 | 路径 / 产物 | 角色 | 是否产品入口 |
 |---|---|---|---|
 | **Rust `bat`** | `infrastructure` bin → 正式同步二进制 | 官方资源**自动**发现 / 拉取 / 校验 / 发布 / watch·daemon / 运维子命令 | **是（同步与运维命令行）** |
-| **Go `bat-api`** | `cmd/bat-api` → `bin/bat-api` | **资源 bootstrap + 分发 HTTP 服务**（官方 CDN path 形态）+ release 观察 API | **是（bootstrap/分发服务）** |
+| **Go `bat-api`** | `cmd/bat-api` → `bin/bat-api` | **资源 bootstrap + 分发 HTTP 服务**（官方 CDN path 形态）+ release 观察 API + 内嵌 dashboard | **是（bootstrap/分发服务与管理入口）** |
 | **Go 试验 CLI** | `cmd/bat` → `bin/bat-go`（不得再叫 `bin/bat`） | FFI 演示骨架 | **否** |
 
 ### 1.1 「同步命令行 = Rust `bat`」的含义
@@ -20,7 +20,7 @@
 
 这**不是**说整个项目只有 Rust，也**不是**取消 Go 入口：
 
-- Go 的正式产品入口是 **`bat-api` 服务进程**（给客户端/工具提供启动前资源 bootstrap、server-info 改写和已发布资源字节），不是再做一套同步 CLI。
+- Go 的正式产品入口是 **`bat-api` 服务进程**（给客户端/工具提供启动前资源 bootstrap、server-info 改写、已发布资源字节和内嵌管理 dashboard），不是再做一套同步 CLI。
 - Go `cmd/bat` 仅试验，禁止与 Rust `bat` 二进制重名。
 
 ### 1.2 `bat` 与 `bat-api` 的关系
@@ -31,8 +31,8 @@
 |---|---|---|
 | 资源发现 | 读取官方 launcher/resource metadata，解析 `GameMainConfig`、server-info 和 Addressables root | 通过 `bat.sock` 读取已发布版本摘要，不重新探测官方 metadata |
 | 下载与发布 | 下载、校验、staging、原子发布 `current -> versions/<id>`，维护 manifest/snapshot/version-state | 不下载、不写 staging、不改 version-state；生产资源根来自 RPC 返回的 `resource_root` |
-| 启动前资源入口 | 暴露 `catalog.status` / `resource.manifest` 等 RPC 数据 | 提供 `/v1/bootstrap`、`/v1/launcher/bootstrap`、launcher 资源 metadata 兼容端点、`/v1/server-info` 和 CDN path，组织给客户端/补丁器使用 |
-| 长期状态 | watch/daemon、任务队列、日志、错误码、repair/sync/verify | 周期性经 RPC 刷新内存索引；认证 Web 控制面仅白名单转发 reload/refresh/restart/sync/verify/repair/catalog-refresh，不持有或写入同步状态 |
+| 启动前资源入口 | 暴露 `catalog.status` / `resource.manifest` 等 RPC 数据 | 提供 `/v1/bootstrap`、`/v1/launcher/bootstrap`、launcher 资源 metadata 兼容端点、`/v1/server-info`、CDN path 和 `/admin/dashboard/`，组织给客户端/补丁器/维护者使用 |
+| 长期状态 | watch/daemon、任务队列、日志、错误码、repair/sync/verify | 周期性经 RPC 刷新内存索引；认证 Web 控制面仅白名单转发 reload/refresh/restart/sync/verify/repair/catalog-refresh、schedule/task/log/parse/translation/localized 方法，不持有或写入同步状态 |
 
 这条边界允许 `bat-api` 做资源 bootstrap 兼容，但不允许它复制 Rust 下载器或伪装完整游戏业务服务。
 
@@ -40,7 +40,7 @@
 
 1. **G-008 决策关闭（wontfix）**：不另做产品级 Go 同步/运维 CLI。
 2. **G-009**：资源 bootstrap/分发 MVP 部分完成；非完整游戏业务 API。
-3. **USERGUIDE 的 bat-api 基础章节已补**；同机 live 联调 runbook 已补，真实官方网络下载仍由独立 smoke 负责。
+3. **USERGUIDE 的 bat-api 基础章节已补**；同机 live 联调 runbook 和内嵌 dashboard MVP 已补，真实官方网络下载仍由独立 smoke 负责。
 
 ---
 
@@ -96,11 +96,11 @@
 |---|---|---|---|
 | Module | `go.mod` → `bat-api` | 已用 | 服务层模块名 |
 | RPC client | `internal/backendrpc` | **完成** | Unix socket JSON-RPC transport + typed helper；typed helper 覆盖 daemon 已实现控制/查询、`resource.state/sync/verify/repair/manifest/list`、`catalog.*`、`parse.*`、`localized.status/publish/rollback`、`task.*`、`translation.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` 和文件级 UnityFS patch 调用；`resource.index`、`patch.apply` 仍通过通用 `Call` 走同一 contract；fake transport 单测，配合 `internal/api/testdata/contract/` 固化 Rust 输出 mirror |
-| 资源 bootstrap/分发 | `cmd/bat-api` + `internal/api` | **MVP+生产控制面** | RPC 发现 + 周期刷新/诊断 + `/v1/bootstrap` + `/v1/launcher/bootstrap` + launcher 资源 metadata 兼容 + `/readyz` + CDN Range/缓存头 + 鉴权/限流/访问日志/反代适配 + OpenAPI + 管理控制白名单 + `.env` |
+| 资源 bootstrap/分发 | `cmd/bat-api` + `internal/api` | **MVP+生产控制面** | RPC 发现 + 周期刷新/诊断 + `/v1/bootstrap` + `/v1/launcher/bootstrap` + launcher 资源 metadata 兼容 + `/readyz` + CDN Range/缓存头 + 鉴权/限流/访问日志/反代适配 + OpenAPI + 管理控制白名单 + 内嵌 dashboard + `.env` |
 | 试验 CLI | `cmd/bat` | **试验** | doctor 固定 ok；manifest/sync 走 FFI |
 | FFI | `internal/ffi` | **可选** | 需 `build-ffi` |
 | 空骨架 | `api/`、`pkg/*`、部分 `internal/*` | **空** | 见各目录 README |
-| Web | `web/` | **空** | G-010 |
+| Web | `web/` | **内嵌 dashboard MVP** | issue #46；完整协作后台、登录/角色和术语管理仍属 G-010 剩余 |
 
 `go list ./...` 当前包：
 
@@ -134,9 +134,9 @@ make build-go-cli   # 产出 bin/bat-go
 | 项 | 状态 |
 |---|---|
 | G-008 Go 同步 CLI | **已决策关闭**（正式同步 CLI = Rust `bat`） |
-| G-009 bat-api 资源 bootstrap/分发 | **资源面完成（非完整官方游戏 API）**；已含资源 bootstrap、launcher resource metadata 兼容、HTTP 鉴权/限流/日志/反代适配、RPC 周期刷新/诊断、readiness、OpenAPI、管理控制白名单、Rust-owned `schedule.*` dashboard 代理、翻译状态回写代理、同机 live smoke 和部署模板；持久化仍另议 |
+| G-009 bat-api 资源 bootstrap/分发 | **资源面完成（非完整官方游戏 API）**；已含资源 bootstrap、launcher resource metadata 兼容、HTTP 鉴权/限流/日志/反代适配、RPC 周期刷新/诊断、readiness、OpenAPI、管理控制白名单、Rust-owned `schedule.*`、`task.*`、`parse.*`、翻译状态回写代理、内嵌 dashboard、同机 live smoke 和部署模板；持久化仍另议 |
 | issue #19 | **验收完成，本提交关闭**；`make bat-api-local-live-smoke` 已在同机隔离环境覆盖 live RPC、release 切换、清单不完整、未 ready、server-info 和 CDN path |
-| G-010 Web | 未开始 |
+| G-010 Web | 内嵌 dashboard MVP 已完成；完整协作后台、登录/角色、术语管理和构建型前端未开始 |
 
 ---