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 为准。

仓库结构

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

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

常用入口

开始开发：开发工作流
查找代码：架构与代码地图
运行项目：本地开发与验证
修改任务动作：常见改动指南
查看协议：Agent 文档

当前能力边界

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

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

3.5 KiB Raw Permalink Blame History Unescape Escape