# OSH-2026 Agent Runtime：面向 Android 端侧智能体的结构化执行系统

> 中国科学技术大学 OSH-2026 课程项目，构建了一套可在 Android 本地部署的 Agent Runtime，包含 DAG 驱动的 Action Fabric 执行框架和端侧 LLM 推理能力，实现从模型规划到系统工具执行的完整链路。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-12T06:15:40.000Z
- 最近活动: 2026-06-12T06:21:08.568Z
- 热度: 143.9
- 关键词: Android, Agent, LLM, 端侧推理, DAG, Rust, Kotlin, gRPC, Action Fabric
- 页面链接: https://www.zingnex.cn/forum/thread/osh-2026-agent-runtime-android
- Canonical: https://www.zingnex.cn/forum/thread/osh-2026-agent-runtime-android
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者**：OSH-2026（中国科学技术大学 OSH-2026 课程组织）
- **来源平台**：GitHub
- **原始标题**：agent_runtime
- **原始链接**：https://github.com/OSH-2026/agent_runtime
- **发布时间**：2026年6月12日

---

## 项目概述

OSH-2026 Agent Runtime 是中国科学技术大学 OSH-2026 课程的大作业项目，目标是面向 Android 端侧智能体构建一套可本地部署、可结构化执行、可观测且可扩展的 Agent Runtime。该项目围绕两个核心子系统展开：**Action Fabric**（结构化执行系统）和**端侧 LLM 推理框架**，共同构成从模型规划到系统工具执行的完整技术栈。

---

## 核心架构设计

### Action Fabric：显式 DAG 执行系统

传统 Agent 的执行流程往往隐含在对话上下文中，难以追踪、调试和恢复。Action Fabric 的创新在于将执行过程显式表示为**有向无环图（DAG）**，在执行前即可校验依赖关系，在运行时计算就绪节点集合，并对执行状态、错误恢复和副作用进行统一控制。

整个执行链路如下：

```
ActionFlow YAML
      │
      ▼
Rust Loader ── DAG 校验与依赖构建
      │
      ▼
Dispatcher ── Ready Set / Policy / Side-effect Control
      │
      ▼
Action Executor ── Local Action / gRPC Remote Action
      │
      ▼
Kotlin Action Runtime ── Android SDK 与系统能力
      │
      ▼
Result / State / Audit / Diagnostics
```

### Rust 调度内核

调度内核采用 Rust 实现，具备以下关键能力：

**DAG 构建与校验**
- 实现 ActionFlow YAML loader，根据 `${node}` 数据引用自动建立 DAG 依赖
- 检测重复节点、缺失引用、自环与循环依赖
- 实现节点状态机和前驱依赖检查

**调度策略**
- 计算 Ready Set（就绪节点集合）
- 支持无依赖节点的批量异步执行
- 对非幂等 Action 施加串行约束

**容错与恢复**
- 建立 Action Policy，支持风险等级、确认门控、超时与重试策略
- 实现有界恢复机制，根据重试预算和副作用等级执行 Retry、Patch 或 Replan
- 完整记录节点状态迁移和执行审计日志

---

## Android Action Runtime

Kotlin Runtime 已实现并注册 **59 个 Android Action**，覆盖设备状态、应用管理、网络、文件、媒体、联系人、短信、日历、通知、相机、录音、屏幕捕获和 Intent 等能力。

| 能力类别 | 已实现 Action 示例 |
|---------|------------------|
| 设备与系统 | `device_info`、`system_info`、`power_status`、`storage_info` |
| 网络与连接 | `network_status`、`http_call`、`wifi_toggle`、`bluetooth_toggle` |
| 应用与 Intent | `list_installed_apps`、`launch_app`、`intent_show_map`、`intent_compose_email` |
| 数据与文件 | `read_file`、`search_files`、`clipboard_read`、`clipboard_copy` |
| 个人信息 | `search_contacts`、`read_sms`、`list_calendar_events` |
| 媒体与传感 | `take_photo`、`record_audio`、`screenshot`、`screen_record` |
| 系统交互 | `set_alarm`、`set_timer`、`list_notifications`、`media_play_pause` |

Android Runtime 以前台服务形式运行 gRPC Server，并配套实现权限申请、Intent Host、MediaProjection 协调、通知监听和执行审计。

---

## 跨语言执行链

项目定义了统一的 Action 输入、输出、错误和注册表抽象，完成基于 Protocol Buffers 与 gRPC 的 Rust-Kotlin 通信协议：

1. Rust `RemoteAction` 可将任意注册的工具节点转发至 Kotlin Runtime
2. Kotlin 侧通过 `ActionExecutor + JsonCodec + ActionRegistry` 完成类型化输入解码、执行和结果编码
3. 网络层使用 Rustls，已完成 Android `aarch64-linux-android` 交叉编译与链接验证

---

## Tauri 演示应用

项目提供了面向最终演示的 Tauri 2 Android 应用，支持：

- 在移动端界面直接编辑 ActionFlow YAML
- 自动解析 DAG 并由 Rust Dispatcher 调度
- 通过可配置的 gRPC endpoint 调用同机或局域网内的 Kotlin Action Runtime
- 展示各节点执行状态、输出结果、审计轨迹和诊断信息

该应用验证了完整场景：用户输入 Workflow → Rust 构图和调度 → gRPC 调用 Kotlin 工具 → Android 执行真实系统能力 → 结果返回并显示于界面。

---

## 技术意义与展望

OSH-2026 Agent Runtime 展示了端侧智能体的工程化路径：

1. **结构化执行**：将隐式执行转为显式 DAG，提升可观测性和可控性
2. **端侧部署**：完整运行于 Android 本地，保护用户隐私
3. **可扩展架构**：通过注册表机制支持新 Action 的动态添加
4. **跨语言协作**：Rust 的高性能调度与 Kotlin 的 Android 生态优势互补

该项目为端侧 Agent 的工程实现提供了可参考的架构范式，特别是在执行可靠性、错误恢复和系统能力调用方面具有实践价值。