Repository navigation
Releases
Agent-VScreen 1.4.0
可直接覆盖安装 1.3.x,签名不变。
新功能
- 全新 App:现在、接入、记录、设置四个标签,紫色玻璃风格,说明收进二级页。
- 每个 agent 各自独立:各自的令牌、记录和步骤,示教共享;首页收件箱收齐 agent 要你做的事。
- 示教重做:录制键直接回应请求,审阅与实时画面并排;同一条 teach 再发直接返回已存的示教。
- 键盘:
key ctrl+a等组合键,type一次输入或slow逐字;全屏用手机自己的输入法。 - 应用静音页:列出被静音的应用并一键恢复;agent 用
sound命令。
改进
fix能恢复被留下静音的应用、前台服务和内置 Tailscale,修完重新检查。- 端口被占用时自动换到空闲端口并说明是谁占着;agent 和 Tailscale 自己跟过去。
- OCR 换成 PP-OCRv6(11.5 MB),
collect跳过搜索栏、收到真正的底部。 repeat … until最后一次按画面现在的内容判断;agent 请求示教前先把页面整理回起始状态。
下载
agent-vscreen-1.4.0.apk:Android 11+,arm64,需要 Shizuku。agent-vscreen-1.4.0.toolpkg:Operit 工具包 1.4.0(Operit ≥ 1.10.0)。
SHA-256 10c2372b8f468a7fd069435128db00c450b100d5985b1284fbd3a19bc1d4c8ab
Agent-VScreen 1.4.0-beta12
预发布测试版,可直接覆盖安装 1.3.0,签名不变。
新功能
- 全新界面:底部标签分为现在、接入、记录、设置;首页“等你处理”集中显示 agent 的提问、待保存的示教和交给你的应用。
- 多个 agent:每个 agent 有自己的令牌、记录、定时和提问;agent 页可以看到它正在做什么。
- 示教重做:分准备和示范两步,悬浮窗和全屏共用一条示教条,保存页并入全屏页;示教中可以对 agent 说一句。
- 检查步骤:
check "看什么"让 agent 在流程中途检查、修正后再继续。 - 经验:你示教的和 agent 自己存的放在一起,按应用查看和删除。
- 接入向导:分步接入新的 agent,自动检测 Tailscale 状态,开着别的 VPN 时给出处理办法。
改进
- OCR 模型更小、更快。
- 通知都能点,点了直接打开对应的页面。
- 副屏静音改由副屏服务负责,卸载或异常退出后不会再让应用一直没声音;设置里新增“恢复被静音的应用”。
- 页面总是打开在主屏上。
下载
agent-vscreen-1.4.0-beta12.apk:Android 11+,arm64,需要 Shizuku。agent-vscreen.toolpkg:Operit 工具包,需要 Operit 1.10 及以上。
SHA-256 50ab8227d0ce78ebfebe51687160ba9a3f042144f46e65790ef9708618e5efc1
Agent-VScreen 1.3.0
可直接覆盖安装 1.2.x,签名不变。
新功能
- 示教:在副屏上亲手做一遍,存成 agent 能重放的段;agent 也能用
teach请你演示。存下的示教带关键步骤缩略图。 - 指给我看:
ask把问题放到手机上,你在画面上点一下、框一下或选一项就能回答。 - 步骤语言:
*通配、字@2第 N 处、try/if/repeat,脚本、段和示教共用一套。 - 定时预约:
schedule预约 agent 来用手机的时间,到点前自动准备好。 - 仿人节奏:
act --human或note human on。 - 检查更新:App 里一键检查 GitHub 新版本。
改进
- 核对只看动作之后的画面;换页后旧编号失效,不会点错。
- 按文字点更快;视频、轮播等动态区域不再拖慢每一步。
- 服务分为常驻、收起、禁止访问三种状态;副屏静音。
- 内置 Tailscale 更稳:单节点、断线保留登录、显示真实连接状态。
- 悬浮窗和 App 统一为紫色玻璃风格;悬浮窗可滑进边缘折叠,回答页和全屏退出后都回到正常悬浮窗。
下载
agent-vscreen-1.3.0.apk:Android 11+,arm64,需要 Shizuku。agent-vscreen.toolpkg:Operit 工具包 1.3.0。
SHA-256 439ee24cb1ee5049279d6483b877b5434143e66368447ee06f06129a8e3f742d
Agent-VScreen 1.2.0
Agent-VScreen 1.2.0,可直接覆盖安装 1.1.x,签名不变。
给 agent 的结果和命令
- 结果是结构化的:每次回复带
ok、code、next(先看画面 / 改命令 / 问用户 / 稍后重试),以及每一步的状态和画面元素。一段操作停在某一步就是失败,不用从文字里判断。新接口是/v2,/v1行为不变,再保留一个版本(升级对照见 API.md 第 9 节)。 - 一张命令表:参数检查、帮助、MCP 工具和参考文档(docs/REFERENCE.md)都从同一张表生成。MCP 每条命令有自己的工具。
- 点得更准:同样的字有几处时列出坐标让 agent 选;编号在同一块副屏上只指一个元素,滚动后同一元素保留编号,用了已经不在画面上的旧编号会得到 STALE_ELEMENT,不会点到别的东西;动作后画面没变会提示。
- 等得更短:只剩转圈、光标闪烁这类小动画也算稳定,不再每步等满 3 秒。
- 输入只走副屏服务注入,去掉了 dumpsys 解析和 shell
input。 - 长操作可以
--async后用task取结果;调用方断开后命令会停;同一个请求重发不会执行两遍。 - 盯守和事件:事件保留到下一次取、可重取、写在磁盘上;盯守在 App 重启后继续。
- 给 agent 的说明重写:围绕“看 → 做 → 核对”一个循环,
vscreen guide一页讲完。
权限和安全
- 默认放手跑:App 的“权限”里有两档。“放手跑”只有真正付钱的那一步(支付、提交订单、转账、充值)和你设为“每次询问”的应用会在手机上问你;“谨慎”档再加上删除这类不可撤销的按钮、去购买的步骤、强制结束和接走主屏应用。确认只能由你在手机上点,agent 自己加参数不算数。
- 每个 agent 一个令牌,可以限定只看 / 可操作 / 全部,单独撤销。
- 其它设备连接要签名,令牌本身不上网络,请求不能重放或改动。
- 操作日志记下每条命令和每次确认,输入的文字和等待的文字只记字数。
- HTTP 服务有连接数、大小和时间限制,空闲连接会给新请求让位。
App 和悬浮窗
- 首页按 接入 → 权限 → 设置 → 操作日志 重新排列。
- 悬浮窗画面单独按显示尺寸生成,每秒 20 帧(接管时 30 帧);拖动跟手;接管后手指按下就实时传到副屏。横屏默认约为手机宽度的四分之三,窗口出现和换方向时整个留在屏幕内。
说明
- 需要 Android 11+、arm64 设备,特权只用 Shizuku。
- Operit 工具包
agent-vscreen.toolpkg用的是/v1接口,可以照常用,目前只连本机。
校验
- APK SHA-256:
c582cdf30db3cde7000cc9425159b17276cf30859c64093ad52f89bfb6c259ba - 签名证书 SHA-256:
56b14824549e698017eba907cbc3347ee3a4ba30907efbd6068ea51ff4495756
可以用 sha256sum 核对下载的文件,用 apksigner verify --print-certs 核对签名证书。
Agent-VScreen 1.1.7
Agent-VScreen 1.1.7,可直接覆盖安装 1.1.6,签名和配置不变。
新功能与改动
- 支持英语:设置里的“语言”可选跟随系统 / 中文 / English。App 界面、悬浮窗、通知,以及给 agent 的话、能力说明、skill、命令返回和 help 都跟着换。已安装的命令行在下一次调用时会自动换成新语言。
- 接入页重新排版:先选 agent 在哪(这台手机 / 其它设备),选其它设备时 Tailscale 设置就在下面,再选接入方式和复制,最后是令牌;区分本机和其它设备的切换不再偶尔消失。
- 远程也能一键复制:开了 Tailscale(内置或 App)后,“接入 agent”可以切到“在其它设备上”,复制给 agent 的话、安装命令、MCP 配置和能力说明都会带上 Tailscale 地址。
- 能力说明重写:存进 agent 记忆的是“我能在用户手机上后台操作应用”这项能力本身,写明什么时候用、怎么开始、连不上时怎么办。
- Operit ToolPkg:附件
agent-vscreen.toolpkg可直接导入 Operit,截图会直接交给模型。源码在integrations/operit/。 - 修复内置 Tailscale 一直显示 NeedsLogin、不出现登录按钮:拿不到登录链接时会自动反复去要,页面写明在等什么,也可以手动“重新获取登录链接”;连不上 Tailscale 服务器时会直接说明。
说明
- 需要 Android 11+、arm64 设备,特权只用 Shizuku。
SHA-256:6a7c179bf9ddc378e956979603c44ea6eecce1e6090624424d0fb0425f72f9f7
Agent-VScreen 1.1.6
Agent-VScreen 1.1.6,可直接覆盖安装 1.1.5,签名和配置不变。
新功能与改动
- 内置 Tailscale:“让其它设备连进来”新增“关 / 内置 Tailscale / Tailscale App”三个选项。选内置后在 App 里点“在浏览器里登录 Tailscale”即可,不用装 Tailscale App,也不占系统 VPN。
- 记住 VScreen:接入页主按钮改为“复制给 agent 的话”;首页显示 agent 是否确认记住,以及之后的新对话里有没有主动用起来。
- 关闭和停止分开:× 始终可用、一点就生效。AI 在干活时只收起小窗,AI 继续工作;没任务时直接关掉副屏。关闭不再触发安全锁。“停止 AI”单独放在左下角,停住后通知栏常驻一条带“允许继续”的提示,agent 收到的返回里也写明了解除方法。
- 修复后台设置反复要求重配:电池白名单被系统收回后会自动补上;熄屏期间的冻结不再算作异常。
说明
- 需要 Android 11+、arm64 设备,特权只用 Shizuku。
SHA-256:4250a8e2797d22926848757ce51e180d9fabd2c7308ed9265cc278afdf666da8
Agent-VScreen 1.1.5
Agent-VScreen 1.1.5:给任何手机 agent 用的后台副屏。
- 只需 Shizuku,不需要 root
- 命令行 / MCP / HTTP 三种接入方式
- 内置离线 OCR(PaddleOCR ONNX)
安装:下载 agent-vscreen-1.1.5.apk,需要 Android 11+、arm64 设备。
SHA-256:df8bac3f592bd3727ae585120aa19372efd933ea5f1d68281b4550a426f4de7b