cmroubao/docs/current-state.md

# 当前实现状态

> 可覆盖的项目级快照。任务执行日志写入对应任务文件。

## 当前快照

- 日期：2026-07-25
- 阶段：T-003 Android workflow 测试骨架完成，准备执行 T-004
- Git：当前分支为 `main`；T-001 至 T-003 均已纳入 Git 历史
- 生产代码：`android-buyer/` 已接入 Roubao Android 源码
- Android：固定 `main@c8a6d7f03422eb01744b01f3ee77bf7757741f7e`；MIT 许可证已保留
- 后端：已决定使用 Go 1.23.0 + Gin 1.11.0；Go Blueprint v0.10.11 骨架尚未接入
- 本机 Android 工具：JDK 17.0.13、Command-line Tools 22.0、SDK 34、
  Build Tools 34.0.0、Platform Tools/ADB 37.0.0；用户级 SDK 环境变量已设置
- Android Studio：未安装；`winget` 静默安装卡住后已终止，不阻塞命令行构建
- 测试：`lintDebug test assembleDebug` 成功；T-002/T-003 共 11 个纯 Kotlin
  测试，Debug/Release 两个变体共执行 22 次且全部通过
- Workflow：纯 Kotlin runner 已支持步骤 timeout、最多 3 次 retry、安全阻塞、
  用户停止和单 runner 并发拒绝；尚未连接真实拼多多动作
- 测试设备：OnePlus PKG110，Android 16/API 36；肉包 `1.4.2 (7)`；拼多多
  `8.17.0 (81700)`
- 设备就绪：肉包采购无障碍已启用并连接；可观察前台包名；拼多多首页未发现登录、
  验证码或风控文案，但该结果不等于账号已确认登录
- 版本控制内数据：只有 `deepseek总结.txt` 背景摘要和本套项目文档
- 本地私有样本：仓库根目录存在一组未跟踪、已本地排除的同名蝦皮文本/JPEG；
  已核实 UTF-8 四行字段格式和图片可解码，真实内容未纳入 Git
- 标准启动路径：`$env:RUN_START_COMMAND="1"; .\init.ps1`
- 标准验证路径：`.\init.ps1`
- 当前 blocker：拼多多账号是否满足后续搜索流程仍需在 T-101 用页面状态确认；
  蝦皮样本正式私有目录、更多图片类型和一单多 SKU 规则未确认；VLM 供应商和
  测试凭证未确认

## 当前目录

| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `AGENTS.md` | 已有 | agent 权威入口 |
| `docs/` | 已有 | Harness Coding 文档 |
| `docs/tasks/T-001.md` | DONE | Android 可构建、可安装、可启动基线 |
| `docs/tasks/T-002.md` | DONE | 设备版本、无障碍、前台和登录阻塞就绪检查 |
| `docs/tasks/T-003.md` | DONE | 可注入 Fake automation 的受限 workflow runner |
| `deepseek总结.txt` | 已有 | 历史讨论摘要，不是正式需求权威 |
| `android-buyer/` | 已有 | Roubao `main` 固定 commit 的 Android 基线 |
| `backend-api/` | 待建 | Go-Gin、管理 Web 和数据目标目录 |
| `init.ps1` / `init.sh` | 已验证 | Android 构建入口；可选真机安装启动 |

## 任务摘要

- 已完成：T-001 Android 基线；T-002 设备就绪检查；T-003 workflow 测试骨架。
- 正在进行：无。
- 下一个可领取任务：T-004 导入本机蝦皮订单验证样本。

## 当前可运行内容

```powershell
.\init.ps1

$env:RUN_START_COMMAND = "1"
.\init.ps1
```

2026-07-25 已在 PKG110、Android 16/API 36 上完成 Debug APK 更新安装和启动；
首屏为设备就绪检查，肉包采购无障碍服务已绑定，进程存活且 logcat 无崩溃。

## 维护规则

发生以下变化时覆盖更新本文：

- 初始化 Git 或接入上游代码。
- 获得首个可复现 Android 构建、安装或启动命令。
- 建立后端和真实测试命令。
- 设备、拼多多和 VLM 基线确定。
- 项目阶段、目录或 blocker 变化。

任务的详细状态、验证和决策写入 `docs/tasks/T-<编号>.md`，本文只保留快照。