81 lines
3.5 KiB
Markdown
81 lines
3.5 KiB
Markdown
# 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` 抽象，没有服务地址、认证、轮询、领取、租约或结果提交实现。任务入库与任务开始执行仍是两个独立阶段。
|