Releases: LiuShiYi1027/ThumbAgent
Releases · LiuShiYi1027/ThumbAgent
Release list
ThumbAgent v0.1.0 — First Signed & Notarized Release
ThumbAgent v0.1.0
Local-first platform that gives AI agents a real thumb on mobile devices.
ThumbAgent 是一个本地优先、面向 AI Agent 的移动设备 Skills 平台:用自然语言描述目标,Agent 自主完成「观察 → 规划 → 操作 → 验证 → 恢复」的完整闭环,并产出可复现、可审计的执行报告。这是第一个正式签名 + 公证的发布版本。
📥 安装
要求:macOS(Apple Silicon)+ 一台开启 USB 调试的 Android 设备 + 本机已安装 ADB
- 下载
ThumbAgent_0.1.0_aarch64.dmg - 拖入「应用程序」即可——本包已经 Apple Developer ID 签名并完成公证(Notarized),Gatekeeper 不会拦截
- 首次启动后在 设置页 填写模型 Provider(Base URL、模型名称、API Key)——API Key 只存入 macOS 钥匙串,永不落盘
✨ 核心能力
- 自然语言任务:桌面工作台直接输入目标(如「打开设置并截图 Wi-Fi 页面」),Agent 自主规划执行
- 真实设备闭环:设备发现 → 画面观察 → 基础动作(点击/滑动/输入等)→ 结果验证 → 异常有界重试与自主恢复
- 执行时间线与报告:每个轮次的截图、决策、动作与结果完整留痕,支持随时回看
- 人工接管(Manual Takeover):执行中可在安全边界暂停 Agent,人工操作设备后恢复续跑,接管区间计入事件流
- 诊断证据包:一次受控调用采集日志、截图、性能等现场证据,支持本地留存策略与授权清理
- 安全模型:所有设备动作经过 Schema / Capability / Policy 三重校验,绑定明确设备;密钥只进系统钥匙串
- 开放接口:Local HTTP API + MCP Server,可接入 Codex 等外部 Agent(
./scripts/run-mcp-preview.zsh一键预览)
🖥️ 桌面工作台
Tauri 2 打造的原生桌面应用,mono 编辑风品牌主题:自动拉起并认证本地 Runtime、就绪诊断、设备列表、实时设备画面(手机框呈现)、任务提交与时间线、设置页开箱配置。
⚠️ 已知限制(V1 边界)
- 仅支持单台 Android 设备(真机,经 ADB);iOS / 鸿蒙、多设备并行不在 V1 范围
- 仅提供 macOS Apple Silicon 安装包;Windows / Linux / Intel Mac 暂无
- 高风险动作(支付、验证码等)按安全策略要求人工确认或被拒绝
- 全部数据本地存储,无云端账号与遥测
🔧 从源码构建
git clone https://github.com/LiuShiYi1027/ThumbAgent.git
cd ThumbAgent
make check && make run # Runtime(Python 3.11+)
cd apps/desktop && npm install && npm run tauri dev # 桌面工作台签名发布:scripts/release-local.zsh --notarize(详见 docs/engineering/distribution.md)
57 个迭代、从契约定义到签名公证的完整工程闭环。感谢关注,欢迎 Issue 与 PR。