# AgentAdmin 项目概况

## 项目定位

AgentAdmin 是内部 Agent 管理系统仓库。当前已实现的交付单元是原生 Kotlin Android 任务 Agent：它接收类型化任务，筛选属于本机设备的任务，将任务持久化到 SQLite，并通过 Android 无障碍能力执行已支持的 UI 动作。

当前代码主要是通用 Android Agent 内核，不包含管理端实现，也不包含特定目标 App 的采购、订单、采集或支付业务。

## 固定标识

| 项目 | 当前值 |
|---|---|
| 仓库 / 项目名 | `AgentAdmin` |
| 当前 Android 子项目 Gradle 名 | `AutoAgent` |
| Android 包名 / Application ID | `cn.auto.agent` |
| Kotlin namespace | `cn.auto.agent` |
| 应用显示名 | `Auto Agent` |
| 无障碍服务显示名 | `autoagent` |

`AgentAdmin` 是仓库级项目名；其余为当前 Android 子项目的既有标识。除非需求明确要求，不修改 Android 标识。

## 开发方式

本项目采用需求驱动的轻量流程：理解需求、检查现状、分析方案、实施、验证、交付。它是内部系统，不设置额外的安全审批、工单、原型、Wiki 同步或发布门禁。

文档结构参考 `D:\OPC\dev_harness`，参考基线为提交 `ecab8995026e57f2c28f307a6aa32b871cb3163f`。本项目只采用其中适合现有仓库的做法：

- 先盘点现有代码和规则，再增量补充文档；
- 将项目概况、工作流、架构、开发验证和排障分开维护；
- 让文档链接到真实代码、命令和测试；
- 保留项目自己的历史、目录和开发规则。

未引入 DevHarness 的 Gitea、Wiki 镜像、任务归档、模板同步和门禁流程，也不复制其项目专用事实或脚本。

## 技术基线

| 项目 | 当前值 |
|---|---|
| 语言 | Kotlin |
| UI 平台 | 原生 Android Views / AppCompat |
| JDK | 17 |
| Gradle Wrapper | 8.2 |
| Android Gradle Plugin | 8.2.0 |
| Kotlin Android Plugin | 1.9.22 |
| `compileSdk` / `targetSdk` | 34 / 34 |
| `minSdk` | 23 |
| 应用版本 | `0.1.0`（`versionCode` 1） |
| 本地存储 | Android SQLite |
| UI 自动化能力 | `AccessibilityService` |

可执行版本事实以 `android/gradle/wrapper/gradle-wrapper.properties`、`android/build.gradle.kts` 和 `android/app/build.gradle.kts` 为准。

## 仓库结构

```text
agent_admin/                 AgentAdmin 仓库
├─ android/                 Android Gradle 工程
│  └─ app/src/              应用代码、资源和测试
├─ admin/                   管理端预留目录，当前无实现
├─ docs/                    项目文档
│  └─ agent/                任务协议和动作规范
├─ AGENTS.md                仓库开发规则
└─ README.md                项目入口
```

当前只有 `android/` 是可构建交付单元。`admin/` 没有已确认需求时不预建框架，也不据此把整个项目称为 AutoAgent。

## 常用入口

- 开始开发：[开发工作流](01-workflow.md)
- 查找代码：[架构与代码地图](02-architecture-and-code-map.md)
- 运行项目：[本地开发与验证](04-local-development-and-verification.md)
- 修改任务动作：[常见改动指南](05-common-changes.md#新增或修改任务动作)
- 查看协议：[Agent 文档](agent/README.md)

## 当前能力边界

已实现动作：`WAIT`、`CLICK`、`INPUT`、`BACK`、`EXTRACT_TEXT`。

外部服务接口尚未确定，因此当前只有 `TaskGateway` 抽象，没有服务地址、认证、轮询、领取、租约或结果提交实现。任务入库与任务开始执行仍是两个独立阶段。