# Autotrain Next

独立运行的跨平台铁路发票自动化系统；不依赖其原始工程的代码、配置、工作目录或项目管理文档。

> Agent 先读 [docs/CHARTER.md](./docs/CHARTER.md)，再读 [AGENTS.md](./AGENTS.md)；管理规则见 [docs/trio-protocol.md](./docs/trio-protocol.md)，阶段性变更按 [CHANGELOG.md](./CHANGELOG.md) 的强标签格式记录。

## 当前接力点 (Handoff)

> 只保留最新一条，下一轮阶段性收尾时覆盖或清理。

### 概述

**以已验证设备档案和导入名单执行一次真机观察任务，确认视觉识别与任务循环。**

### 明细

- 2026-07-13：项目已完成独立化；硅基流动视觉配置存在于本项目忽略的 `config.local.json`。执行真实提交前仍须由用户明确授权。

## 项目结构

```text
nextgen/
├── autotrain_next/      # 运行时模块
├── scripts/             # CLI 入口
├── tests/               # 单元测试
├── docs/                # CHARTER 与 trio 协议
├── work/                # 忽略的运行数据
├── config.example.json  # 可提交的配置样例
├── config.local.json    # 忽略的本地配置
└── CONVERSATION_LOG.md  # 脱敏对话摘要
```

## 子模块导航

| 位置 | 说明 |
|---|---|
| `autotrain_next/platform.py` | macOS / Windows ADB 与 scrcpy 发现 |
| `autotrain_next/profiles.py` | 按 serial 隔离的设备档案与兼容性校验 |
| `autotrain_next/{recorder,sampling}.py` | 新手机录制与采样导入 |
| `autotrain_next/{tools,planner,runner}.py` | 白名单工具、受控规划与任务循环 |
| `autotrain_next/web.py` | 本地 Web UI（默认端口 8766） |
| `CONVERSATION_LOG.md` | 脱敏的项目对话决策记录 |

## 常用操作

```bash
python3 -m unittest discover -s tests -v
python3 scripts/autotrain_next.py device-status
python3 scripts/autotrain_next.py sample-record --output work/replay/<session>
python3 scripts/autotrain_next.py sample-import work/replay/<session>
python3 scripts/autotrain_next.py profile-verify
python3 scripts/autotrain_next.py web
```

## 相关链接

- [项目总纲](./docs/CHARTER.md)
- [Agent 守则](./AGENTS.md)
- [演绎记录](./CHANGELOG.md)
- [脱敏对话记录](./CONVERSATION_LOG.md)