Skip to content

ThumbAgent v0.1.0 — First Signed & Notarized Release

Latest

Choose a tag to compare

@github-actions github-actions released this 20 Aug 11:59
· 2 commits to main since this 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

  1. 下载 ThumbAgent_0.1.0_aarch64.dmg
  2. 拖入「应用程序」即可——本包已经 Apple Developer ID 签名并完成公证(Notarized),Gatekeeper 不会拦截
  3. 首次启动后在 设置页 填写模型 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。