autotrain/nextgen/AGENTS.md

trio	trio-initialized	trio-migrated-v3	trio-migrated-v4	status	desc
standard-v4	2026-07-13	2026-07-13	2026-07-13	active	跨平台铁路发票自动化独立运行时

Autotrain Next · Agent 操作守则

上来先读这份，再看 INDEX.md 找模块、当前接力与常用命令。

本项目是独立根项目，通用项目管理协议见 docs/trio-protocol.md，目标与边界见 docs/CHARTER.md。不得读取、导入或运行其所在目录之外的旧工程代码、配置或工作文件。

这是什么项目

跨 macOS / Windows 的铁路发票 Android 自动化运行时。它以手机 serial 隔离档案、录制采样和任务数据，并以受控原子工具循环取代单体脚本。

上手三步

1. 读 docs/CHARTER.md，确认目标、范围与安全边界。
2. 读 INDEX.md，确认模块、当前接力和本项目内命令。
3. 先运行 python3 -m unittest discover -s tests -v；真机前运行 python3 scripts/autotrain_next.py device-status。

项目专属硬规则

• 本项目必须在自身目录内可运行：禁止 import 父目录模块、引用父目录相对路径，或读取父项目的配置/工作文件。
• 密钥仅可放在被忽略的 config.local.json 或环境变量；身份证号、二维码、截图、录制与任务日志仅存 work/，严禁提交。
• 所有 ADB 操作必须携带任务 device_serial；多台设备连接时不得默认选择设备。
• 坐标只能持久化为 0..1 归一化值；不得新增机型或分辨率专用像素常量。
• LLM 输出必须经过 planner.validate_llm_steps；业务提交权限默认关闭，须由创建任务者明确授权。
• 对话记录只保存脱敏摘要到根目录 CONVERSATION_LOG.md，不得写入密钥、身份证号、二维码或截图内容。

目录约定

目录 / 文件	用途
autotrain_next/	核心运行时：ADB、档案、采样、视觉、工具、规划与 Web UI
scripts/	独立 CLI 入口
tests/	无真机单元测试
work/	忽略的设备档案、导入物、任务及输出
docs/	总纲、项目管理协议与详细文档
config.local.json	忽略的本地模型与安全配置

项目专属反例

• ❌ 为“兼容”而调用或复制父项目 Python 模块。
• ❌ 把本地凭证、乘车人数据或手机采样纳入版本控制。
• ❌ 未经用户确认启动真实提交任务，或绕过设备档案验证。