# Autotrain Next · 项目总纲（CHARTER）

## 一句话定位

独立、跨平台、按手机配置隔离的铁路发票 Android 自动化运行时。

## 背景与目标

旧式自动化将 ADB 路径、屏幕坐标、名单导入和流程控制耦合在单体脚本中，难以跨 macOS、Windows 和不同分辨率手机复用。Autotrain Next 要让用户只在 Web UI 管理设备、采样、名单和任务；运行时由可审计的小工具循环完成页面识别、操作与结果归档。

成功标准：项目目录可以脱离任何旧工程单独复制运行；每台手机持有独立档案；新手机可经录制完成初次采样；遇到未知页面时可在受控边界内调用视觉/LLM 重新规划；未经授权不提交业务操作。

## 范围

**做**：

- 发现跨平台 ADB/scrcpy，按 serial 操作 Android 设备。
- 录制和导入设备采样，维护独立设备档案。
- 导入乘车人名单、接收二维码截图、创建并监控任务。
- 通过白名单原子工具、确定性规则和受校验的 LLM 规划执行流程。
- 保存可审计的任务结果与脱敏项目对话摘要。

**不做**：

- 不导入、调用或依赖任何父项目的 Python 模块、配置、运行数据或文档。
- 不将密钥、身份证号、二维码、截图或录制数据提交到仓库。
- 不在未确认档案、未指定设备或未明确授权的条件下执行提交动作。

## 关键决策与约束

| 决策 | 原因 |
|---|---|
| ADB 操作必须带 serial | 防止多设备时误操作 |
| 坐标仅存归一化值 | 兼容不同屏幕分辨率 |
| 设备档案按 serial 存放 | 设备采样与配置相互隔离 |
| UI 只管理任务，Runner 编排工具 | 降低前端与业务脚本耦合 |
| LLM 输出经白名单验证 | 防止模型产生未授权动作 |
| `config.local.json` 与 `work/` 独立忽略 | 项目可复制且不泄露本地数据 |

## 演进记录

- 2026-07-13：从分支运行时调整为独立根项目，移除父项目路径和文档依赖。