feat: 捆绑 AFA

Author: Windsland52

.github/workflows/release.yml

@@ -27,6 +27,18 @@ jobs:
             - run: pnpm check:py
             - name: Build (PyInstaller)
               run: uv run pyinstaller aao.spec --noconfirm
+            - name: Download AFA (ArknightsFrameAssistant)
+              shell: bash
+              run: |
+                  mkdir -p dist/aao.app/afa
+                  # AFA 是 GPL-3.0（CloudTracey/arknights-frame-assistant），凹图热键依赖。
+                  # 查最新 release tag，下对应 AFA.exe + LICENSE（满足 GPL 分发要求）。
+                  repo="CloudTracey/arknights-frame-assistant"
+                  tag="$(curl -fsSL "https://api.github.com/repos/$repo/releases/latest" | sed -n 's/.*"tag_name": *"\([^"]*\)".*/\1/p')"
+                  echo "AFA latest tag: $tag"
+                  curl -fsSL "https://github.com/$repo/releases/download/$tag/AFA.exe" -o dist/aao.app/afa/AFA.exe
+                  curl -fsSL "https://raw.githubusercontent.com/$repo/$tag/LICENSE" -o dist/aao.app/afa/LICENSE || echo "[WARN] AFA LICENSE 未取到"
+                  ls -la dist/aao.app/afa/
             - name: Convert logo.png to ico
               shell: bash
               run: uv run python -c "from PIL import Image; Image.open('logo.png').save('logo.ico', format='ICO', sizes=[(256,256),(128,128),(64,64),(48,48),(32,32),(16,16)])"

README.md

@@ -62,9 +62,12 @@ loguru 双 sink：
 - [loguru](https://github.com/Delgan/loguru) — 日志
 - [numpy](https://numpy.org/) / [websockets](https://websockets.readthedocs.io/) / [Pillow](https://python-pillow.org/) / [json5](https://github.com/dpranke/pyjson5)
 
+### 捆绑组件
+
+- [**ArknightsFrameAssistant (AFA)**](https://github.com/CloudTracey/arknights-frame-assistant)（GPL-3.0）— 凹图的暂停/步进/技能/撤退依赖 AFA 的全局热键。**发版包自带 AFA.exe**（从上游 release 下载），启动时自动拉起。AFA 源码与许可见上游仓库；本仓库不持有其版权，仅作分发。
+
 ### 参考项目
 
 - [MaaAssistantArknights](https://github.com/MaaAssistantArknights/MaaAssistantArknights) — 地图数据（`Arknights-Tile-Pos`，运行时同步）+ 粗流程参照
 - [ArknightsCostBarRuler](https://github.com/ZeroAd-06/ArknightsCostBarRuler) — 费用条计时 / 悬浮窗 / 打轴对轴（测量层、校准、tick 检测来源）
 - [prts-plus](https://github.com/jue-ce-zhe/prts-plus) — 帧级自动操作的执行器算法（action / 投影 / 配置）
-- [ArknightsFrameAssistant](https://github.com/CloudTracey/arknights-frame-assistant) — PC 端帧操、AFA 热键输入模型

aao/app.py

@@ -393,6 +393,10 @@ def main() -> int:
     _ensure_admin()
     # 先 configure_paths 让 settings_page 能读到 config/settings.json
     configure_paths()
+    # 确保 AFA 在运行（凹图热键依赖；没在则拉起自带 AFA.exe）
+    from aao.core.afa import ensure_afa
+
+    ensure_afa()
     from aao.ui.settings_page import load_settings
 
     saved = load_settings()

aao/core/afa.py

@@ -0,0 +1,89 @@
+"""AFA（明日方舟帧操小助手）进程管理：检测 + 拉起自带 AFA.exe。
+
+AFA 是独立常驻 AutoHotkey 工具，注册全局热键完成暂停/步进/技能/撤退时序。
+executor.afa_hotkey 通过 SendInput 模拟按键触发 AFA 热键——故 AFA 必须先运行。
+
+本模块：
+- is_afa_running()：查 AFA.exe 进程是否在
+- ensure_afa()：没在则拉起自带的 AFA.exe（打包在 exe 同级 afa/AFA.exe）
+
+AFA 用默认热键配置（F/Space/R/W/S/A），与 afa_hotkey 假设一致。
+AFA 是 GPL-3.0（CloudTracey/arknights-frame-assistant），自带分发见 README 许可声明。
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+from aao.utils.logger import logger
+from aao.utils.runtime_paths import project_root
+
+_AFA_PROCESS = "AFA.exe"  # AFA 进程名（编译后）
+_AFA_REL_PATH = "afa" / Path(_AFA_PROCESS)  # 相对项目根/exe 同级
+
+
+def _afa_exe_path() -> Path:
+    """自带 AFA.exe 路径（项目根 或 exe 同级的 afa/AFA.exe）。"""
+    return project_root() / _AFA_REL_PATH
+
+
+def is_afa_running() -> bool:
+    """AFA.exe 进程是否在运行。非 Windows 返回 False。"""
+    if sys.platform != "win32":
+        return False
+    try:
+        import ctypes
+
+        # 用 CreateToolhelp32Snapshot 枚举进程，避免依赖 tasklist/PowerShell
+        # 简单起见用 tasklist（Windows 自带）
+        out = subprocess.run(
+            ["tasklist", "/FI", f"IMAGENAME eq {_AFA_PROCESS}", "/NH", "/FO", "CSV"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+            check=False,
+        )
+        running = _AFA_PROCESS.lower() in out.stdout.lower()
+        # 引用 ctypes 防止 pyright 报未用（保留 Windows 判断接口）
+        _ = ctypes
+        return running
+    except (OSError, subprocess.SubprocessError):
+        logger.warning("无法检测 AFA 进程，假定未运行")
+        return False
+
+
+def ensure_afa() -> bool:
+    """确保 AFA 在运行：没在则拉起自带 AFA.exe（后台、无窗口阻塞）。
+
+    Returns:
+        True 若 AFA 已在运行 或 成功拉起；False 若拉起失败。
+    """
+    if is_afa_running():
+        logger.info("AFA 已在运行")
+        return True
+
+    exe = _afa_exe_path()
+    if not exe.exists():
+        logger.warning("未找到自带 AFA.exe（%s），请手动启动 AFA 或重新安装", exe)
+        return False
+
+    try:
+        # 后台启动 AFA（ detached，不随本进程退出而终止）
+        # CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS（Windows）
+        flags = 0x00000008 | 0x00000200 if sys.platform == "win32" else 0  # noqa: S107
+        subprocess.Popen(
+            [str(exe)],
+            cwd=str(exe.parent),
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            close_fds=True,
+            creationflags=flags,
+        )
+        logger.info("已拉起自带 AFA： %s", exe)
+        return True
+    except (OSError, subprocess.SubprocessError):
+        logger.exception("拉起 AFA 失败")
+        return False