refactor: OCR on ONNX Runtime, WebUI on FastAPI, desktop shell on Tauri 2

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [master, "refactor/*"]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python 3.13
+        run: uv python install 3.13
+
+      - name: Sync dependencies
+        run: uv sync --frozen
+
+      # The lint/type gates are scoped to the directories that are currently
+      # clean; widen them as the legacy codebase goes green (module/config,
+      # module/core and friends still carry pre-existing findings - the cv2
+      # stubs reject scalar/tuple image ops all over module/core).
+      - name: Lint (scoped)
+        run: uv run ruff check alas.py module/logger.py module/scheduler module/tasks module/core module/base module/device module/map_detection tests dev_tools/verify_alas_structure.py
+
+      - name: Type check (scoped)
+        run: uv run pyright module/logger.py module/scheduler module/tasks tests
+
+      - name: Import smoke (full tree)
+        run: uv run python dev_tools/smoke_import_all.py
+
+      - name: Structure verification
+        run: |
+          uv run python dev_tools/verify_alas_structure.py
+          uv run python dev_tools/verify_task_registry.py
+          uv run python dev_tools/verify_task_record.py
+
+      - name: Tests
+        run: uv run pytest tests -v
+
+      - name: Equivalence gates (Phase 456)
+        run: |
+          uv run python dev_tools/verify_config_generated.py
+          uv run python dev_tools/verify_task_families.py
+          uv run python dev_tools/verify_stage_meta.py
+          uv run python dev_tools/verify_map_data.py --all
+          uv run python dev_tools/verify_assets.py check .qoder/phase456/assets_before.json

.github/workflows/release.yml

@@ -0,0 +1,73 @@
+name: Release
+
+# Build the desktop release asset and publish it as a GitHub Release.
+# A release is a single NSIS installer (shell + bundled sidecar); the
+# installed app's updater (module/webui/updater.py) lists releases,
+# downloads the installer and runs it silently - the installer replaces
+# the shell and sidecar files and restarts the app.
+
+on:
+  push:
+    # Version tags (vYYYY.MM.DD, e.g. v2026.08.21); see deploy/packaging/README.md
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python 3.13
+        run: uv python install 3.13
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # Main dependency group only; the dev group is not needed to package.
+      - name: Sync dependencies
+        run: uv sync --frozen --no-group dev
+
+      - name: Build frontend
+        working-directory: webapp-tauri
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm build
+
+      - name: Build backend sidecar
+        run: |
+          uv tool install "pyinstaller>=6.19"
+          $env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"
+          pyinstaller --clean --noconfirm deploy/packaging/alas_backend.spec
+          # version.txt = the release tag; the updater reports it as the
+          # current version of the running build.
+          Set-Content -Path "dist/alas-backend/version.txt" -Value "$env:GITHUB_REF_NAME" -NoNewline
+
+      - name: Build NSIS installer
+        working-directory: webapp-tauri
+        env:
+          CI: "true"
+        run: |
+          pnpm tauri build
+          Copy-Item -ErrorAction Stop "src-tauri/target/release/bundle/nsis/*-setup.exe" "..\Alas_${{ github.ref_name }}_x64-setup.exe" -Force
+          Get-ChildItem "..\Alas_*" | ForEach-Object { $_.FullName }
+
+      - name: Publish release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            Alas_${{ github.ref_name }}_x64-setup.exe

.gitignore

@@ -15,6 +15,9 @@ dev_tools/debug_tools
 /campaign/test/
 /toolkit
 *.lock
+!uv.lock
+# The Tauri shell's lockfile is source-controlled (reproducible builds)
+!webapp-tauri/src-tauri/Cargo.lock
 config/reloadflag
 config/reloadalas
 test.py
@@ -112,8 +115,8 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
-lib64/
+/lib/
+/lib64/
 parts/
 sdist/
 var/
@@ -130,6 +133,8 @@ MANIFEST
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 *.manifest
 *.spec
+# Hand-authored packaging spec is source-controlled
+!deploy/packaging/*.spec
 
 # Installer logs
 pip-log.txt
@@ -254,4 +259,24 @@ console.bat
 .vscode/*
 
 # Pylance configuration file
-pyrightconfig.json
+pyrightconfig.json
+# Qoder files
+.qoder/
+
+# Python virtual environments created by uv
+.venv*
+
+# Tauri shell
+webapp-tauri/node_modules/
+webapp-tauri/src-tauri/target/
+webapp-tauri/dist/
+webapp-tauri/.env.development
+
+# Runtime adb copied from adbutils (dev environment)
+/bin/adb/
+
+# Rope refactoring config
+.ropeproject/
+
+# Local pnpm content-addressable store (sandbox/dev artifact)
+.pnpm-store/

.qoder/phase456/FINAL.md

@@ -0,0 +1,58 @@
+# Phase456 终验报告(FINAL)
+
+日期:2026-08-29(含 followup 三项 + 上游/支线合并)
+分支:`refactor/phase456`(基线 master @ afcab3d13;已合并 qoder/master @ 6ec24bb25)
+
+## Followup 终验门禁(最新)
+
+| 门禁 | 结果 |
+|---|---|
+| ruff(scoped) / pyright(scoped) | 0 / 0 |
+| smoke_import_all | 427/427 |
+| verify_config_generated | ZERO DRIFT |
+| verify_task_families | OK(8 族 18 任务) |
+| verify_stage_meta | OK(1982 cases;27 meta.json) |
+| verify_map_data --all | **1353/1353 maps OK,3 skipped(死导入)** |
+| verify_assets check | OK(1345 buttons / 437 templates,含合并后新按钮) |
+| pytest / 桥接导入 | 55 passed / ok |
+
+## Followup 变更摘要
+- 地图数据文件:JSON → **YAML(网格文本块为行数组)**,并修复 4A 遗留的 MAP.name 丢失 bug。
+- 数据化补完:跳过 12 → 3(仅剩资产缺失的死导入地图);OCR 重写入 meta.json;
+  事件入口流 D2 三助手抽取(5 事件收敛);battle_clear_roadblocks 助手(32 处精确模式重写)。
+- 合并:qoder/master(上游 5 修复 + MAP_PREPARATION_HARD/raid_20260827 UI 更新);
+  island 全面守护 0 改动;冲突仅 4 个 assets.py。raid_20260827 的 Readme 源行上游缺失,
+  其 args/i18n 选项按零漂移原则未保留(详见 NOTES.md)。
+
+## 首次终验(合并前)
+
+| 门禁 | 结果 |
+|---|---|
+| verify_map_data --all | 1348/1348 maps OK,12 skipped |
+| pytest | 55 passed |
+| 桥接导入(AlasMaa/AlasFpy) | ok |
+
+## 规模变化
+
+- campaign 树:1423 个 .py / 102,420 行 → **1348 个 .json + 片段 .py(纯逻辑)+ 12 个 legacy 跳过文件**
+- assets.py:48 文件 **-28,996 行** 四服冗余(area/button 相同者广播为裸值)
+- config_updater.py:825 行 → 4 模块 mixin 组合(225 行门面)
+- 任务族:3 处手写列表 → registry family 标签单一来源
+- 阶段名特判:~120 行 if 链 → 27 个 meta.json 规则表
+
+## 用户真机自动化测试清单
+
+1. 主线:Main 跑 12-4(或 2-4 快速图),确认地图加载/格子识别正常
+2. 困难模式:Hard 任务(hard.py 走新 load_map)
+3. 战争档案:WarArchives 任一(map_files 含 .json)
+4. 活动图:任一 event(含 vsp/esp 别名事件,确认 stage 名规范化)
+5. GemsFarming:一轮换船流程(确认 ChangeFlagship/ChangeVanguard 日志键与换船成功)
+6. 配置重生成:`dev_tools/regenerate_config.py` 后 git 干净
+7. 回滚演练:`git revert <4A 任一 batch commit>` 恢复旧路径
+
+## 已知遗留(全部在 NOTES.md)
+
+- 12 个跳过文件保持 legacy(自定义 Grid 类 / 历史损坏 import / actions 字典 / __main__ 块),占比 0.9%
+- module/campaign/run.py 有 1 处既有 SIM105 lint(非本次改动面)
+- OCR 结果重写(event_20240425_cn / event_20260417_cn)仍为事件级覆盖,未并入 meta.json(基类为 staticmethod 无 config 访问,需签名改造)
+- 事件入口流(ui_goto_event)的 D2 抽取、battle_clear_roadblocks 助手(C5)未做,见 refined_plan 后续项

.qoder/phase456/NOTES.md

@@ -0,0 +1,88 @@
+# Phase456 执行笔记
+
+## S0 基线(2026-08-22)
+- ruff (scoped): exit 0
+- pyright (scoped): exit 0
+- smoke_import_all: Imported 424/424 modules(执行规格写 423/423,实际为 424/424)
+- verify_alas_structure: exit 0
+- verify_task_registry: exit 0(该脚本对比 master:alas.py,master 已完成 P1.4 注册表重构,
+  "old task methods: 1 / registry extras 68 项" 为预期噪音;mapping completeness 68/68)
+- verify_task_record: exit 0
+- pytest: 55 passed, 10 warnings
+
+## 环境备忘
+- 本机禁用 `uv run`(沙箱下触发全量重装),统一用 `.venv\Scripts\python.exe|ruff.exe|pyright.exe`。
+- CI 仍用 uv run。
+- 基线存档 .qoder/phase456/baseline/(.qoder 被 gitignore,已 `git add -f`)。
+
+## S1 历史陈旧产物刷新(S1.2 commit)
+首次运行 regenerate_config 暴露的历史漂移(4C 零漂移门的首次清扫):
+- config/deploy.template*.yaml ×8:源 deploy/utils.py DEPLOY_TEMPLATE 文案已更新,产物未重生成。
+- module/config/i18n/*.json ×4:gui.yaml 已删除的 webui updater 旧键残留在产物中
+  (Modified/CurrentVersion/Repo/Refresh/Install/Installing/NoReleases/InstallHint),重生成后移除,
+  与近期 webui updater 重写提交一致。
+- args.json/menu.json/config_generated.py/campaign/Readme.md 无漂移。
+
+## P1(S1-S3)完成记录
+- 提交链:S1.1 4a22f8d23 → S1.2 842304a71 → S2.1 9308c927b → S2.2 deacc862d → S3 2dee1af31 → style e10dc162c。
+- 全门禁绿:verify_config_generated ZERO DRIFT / verify_task_families OK / bridges ok / pytest 55 / smoke 427(424+3 新模块)。
+- 执行方式偏离说明:原计划由 subagent 执行,但本环境 subagent 连续 3 次卡死(无进程活动),改由主代理按同一规格小步执行。
+- S3 拆分方式:AST 脚本搬移 + mixin 组合;`event` 方法整体搬移(未做 parse_readme/normalize_readme 拆分,
+  与规格偏差已记录:该拆分仅为可测性,行为等价)。
+- S2.2 曾因 PowerShell -replace 大小写不敏感误替换局部变量 `events` 与注释,已修复(教训:替换常量引用用逐处 edit,不用全局 replace)。
+
+## P2-P6 完成记录(2026-08-29)
+- P2(S4):8d0f3859c 语义快照+校验器 / 6413f5567 四服广播重生成(assets -28,996 行)。运行时零改动。
+- P3(S5):5291d1a80 策略表(CV/DD/FLEET_SLOTS)/ 6f860d109 换角色骨架 ROLES。
+- P4(S6):4d302cc42 stage_meta.py + 27 个 meta.json + handle_stage_name 表驱动(verify 1982 例全等)。
+- P5(S7):42ab4f087 加载器 / f52a91a19 转换器硬化 / 4e4a3d211 格值标记 / 1502819d9 B2 /
+  3619529a9+8c7023532 B3 / e1d786b4c 垫片注册 / 7e6383749 B4 终转。
+  **最终:1348/1348 地图等价通过,12 跳过(0.9%)**。
+- P6(S8):CI equivalence job;S9 终验全绿,报告见 FINAL.md。
+
+## 4A 遗留(12 个 legacy 跳过文件)
+- 自定义 Grid 类:t4.py(EventGrid,war_archives_20190321_en/a1 等 4-5 个)
+- 历史损坏 import(assets 中不存在的 C2/D3/EVENT_20200312CN_SP3):legacy 下同样 ImportError,行为不变
+- actions 字典 sp.py(复杂格名字典,1 个)
+- ttl1.py `if __name__ == '__main__':` 调试块(1 个)
+可在后续逐个支持;当前全部走 legacy 路径,行为与重构前完全一致。
+
+## 加载器关键设计(供后续维护)
+- YAML 优先、legacy 回退;片段无 import,全部名字由 ns 注入。
+- 网格文本块(map_data/weight_data/map_data_loop)以**行数组**存 YAML,loader join 还原
+  (CampaignMap._parse_text 逐行 strip,语义全等)。
+- legacy 兄弟文件导入已转换图:早期 shim 注册 + _inflight/_loading 守卫解决循环。
+- campaign 内引用优先取垫片(yaml 存在时),否则 _legacy_import;module.* 引用走 importlib 前缀循环。
+- from_data 依赖字段顺序(shape 先于 map_data 等),转换器按源文件顺序保序。
+
+## Followup(2026-08-29)完成记录
+- **followup-2**(YAML+行数组):1ea13c46b。1348 地图 json→yaml;迁移时发现并修复 **MAP.name 丢失 bug**
+  (转换器从未捕获 `CampaignMap('10-1')` 位置参数,自 4A 起全部地图 name=None;已从基线 git 树恢复,
+  后续转换器已修)。
+- **followup-1a**(转换器模式扩展):6920f9984。片段允许前置类/顶层函数、globals 字段、__main__ 块丢弃;
+  跳过从 12 → 3(仅剩死导入地图,资产确实缺失,legacy 同样 ImportError)。
+- **followup-1b**(OCR 入 meta):04879b688。campaign_ocr._get_stage_name 应用 ocr_rewrite 规则;
+  2 个事件覆盖删除。
+- **followup-1c**(D2 事件入口流):3c8179125。campaign_event 新增 event_entrance_ensure/click/from_main;
+  5 个事件 ui_goto_event 收敛(war_archives 滚动搜索保留专用)。
+- **followup-1d**(C5 战斗助手):cffbe168f。battle_clear_roadblocks 助手;32 处精确模式 AST 重写(6 简单+26 potential);
+  其余混杂模式未动(需真机逐个验证)。
+- **merge**:a2b4bce57 合并 qoder/master(上游 5 提交 + 2 游戏更新提交)。冲突仅 4 个 assets.py(取对方→广播重生成)。
+  gems_farming/fast_forward 自动合并成功,双方改动均在。island 全面守护:diff 中 0 个 island 路径。
+  **注意**:对方 args.json/i18n 中的 raid_20260827 选项与事件名("大人物的预告信")因上游未提供
+  campaign/Readme.md 源行,按零漂移原则被 regenerate 归一丢弃;raid 按钮/raid.py/地图模块改动均已保留。
+  待上游补 Readme 行 + raid 地图目录后可自然恢复。
+- **followup-1e**(声明式战斗模式):battle_patterns.py 模式库(11 种:clear_filter/boss/clear_siren/
+  default/clear_mode_filter/protect_siren/mystery/clear_scale/bouncing_filter/roadblocks)。
+  转换器+变换器双通道提取;**2472 个方法**从片段移入 YAML `battles` 字段,loader 按模式合成方法;
+  片段 15,638 → 6,725 行(-57%),battle_N 定义 2990 → 450。
+  等价硬门:快照 `battle_bodies` 记录提取前方法体,verify 逐方法断言"规范源码 == 原方法体"
+  (canonical_source 与 match_body 共用同一 AST 构建器,匹配时即断言)。
+  未匹配模式的手写方法(~450)保留在片段,含全部真机差异策略。
+- **followup-1f**(死代码清理):754 个纯 pass 空壳片段删除(loader 现支持无片段时由 type() 合成
+  Campaign 类);3 个死导入地图删除(load 报 ModuleNotFoundError → 友好的"Map file not found",
+  比原先 ImportError 更明确)。campaign .py 1423 → **666**;skipped 计数归零。
+
+
+
+