autotrain/nextgen/docs/CHARTER.md

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：从分支运行时调整为独立根项目，移除父项目路径和文档依赖。