iPhone Use 0.3.6

• 19 个 MCP 工具统一改为 pua_*（Phone Use Agent），常用工具显示 Pua ready、Pua setup、Pua launch app 等标题。
• 同步两项 skill、全部 references、服务指令、恢复 / 下一步调用指引、widget 和命令行入口；保留 WebDriverAgent 底层依赖及既有配置、签名、构建和运行数据。
• 渐变动画顶部 / 底部中央保留微弱光带，随现有 8 秒颜色与 4 秒波点动画自然连接并收回；遮罩只在布局变化时生成，复用透明度交叉渐变。
• 包含滚动查找、滚动验证和输入异常的截图兜底调整，复用已有观察，不重放业务操作。

验证：389 项 Python 测试、31 项 widget DOM 测试、TypeScript 构建、源码包重建与 MCP 协议检查通过。本机已从源码发布包重新安装，并验证 19 个 PUA 工具、无副作用调用及 widget / skill 与源码一致。浏览器动画采样确认中央光带在 12%–62% 之间平滑变化；浏览器截图接口不可用，未完成截图目视核验。

安装后重新连接聊天，以加载新的 PUA 工具、技能和 widget 资源。

iPhone Use 0.3.4

• docs 与 evals 仅保留在本地，不进入 Git、源码包或安装目录；必要屏幕使用说明移入技能 references。
• 精简安装目录的开发测试、CI 与基准 / 冒烟脚本，完整保留 widget 源码、样式、构建脚本、配置、锁文件、测试及已构建页面。
• 中英文 README 补充先在自己的 iPhone 安装、签名并启动 WDA Runner 的步骤，以及 Appium / WebDriverAgent 致谢。
• widget 使用单个静态 CSS 渐变实现极浅灰点阵，无新增动画或绘制循环。
• 包含 0.3.3 英文简介、0.3.2 纯图标异常状态和白底绿蓝玻璃屏幕图标。

验证：379 项 Python 测试、31 项 widget DOM 测试、严格 TypeScript / 自包含构建，以及从源码包重建安装目录与 MCP 屏幕资源读取均通过。

安装后重新连接聊天以加载新的工具、技能和 widget 资源。

iPhone Use 0.3.3

插件简介改为英文：Let Codex control your iPhone（让 Codex 操作你自己的 iPhone）。

包含 0.3.2 的白底绿蓝玻璃插件图标与居中的无画面状态图标。

解压源码包后运行 sh scripts/install.sh，重新连接聊天以加载新版。

iPhone Use 0.3.2

• 插件图标改为白色圆角底板，叠加绿色与蓝色半透明屏幕，增加玻璃高光和柔和阴影。
• 无画面时，黑色 iPhone 屏幕只显示居中的状态图标，覆盖连接中、未连接、锁屏、认证、暂停与画面不可用。
• 状态文字保留给辅助阅读，顶部设备状态照常显示；刷新失败恢复原状态，认证暂停继续禁用手机操作按钮。

376 项 Python 与 31 项界面测试通过，已检查实际发布 HTML 和图标在深浅背景、不同尺寸下的显示。

解压源码包后运行 sh scripts/install.sh，重新连接聊天以加载新版。

iPhone Use 0.3.0

项目与插件统一命名为 iPhone Use。

• 更新项目、技能、MCP 服务、源码入口与实时屏幕资源的名称。
• 重写中文 README，加入依赖说明、安装步骤、一段 Codex 安装提示词、功能与技术亮点；顶部可切换英文版。
• 升级复用已有设备配置和构建，兼容旧状态目录，并清理属于旧安装的重复 MCP 注册。
• 保留 0.2.7 的截图回退、预览重连、黑色未连接占位屏幕，以及此前的图标和动效改进。

下载源代码包后解压，在包目录运行 sh scripts/install.sh，然后重连或新开 Codex 聊天。

验证：376 项 Python 测试、29 项 widget DOM 测试与 UI 构建检查通过；本机安装、stdio 工具发现与源码包一致性已核对。

iPhone Use WDA 0.2.7

修复界面操作失败后的视觉回退，以及锁屏后 widget 一直暂停 / 无画面的问题。

• 失败先看截图、处理浮层，再按像素换算点击；补充图片转发指引，避免把截图输出为 base64 文本。
• 遮挡错误不再自动建议后台控件坐标，焦点失败不盲目重复旧坐标。
• 解锁后的 READY 恢复对应锁屏暂停；用户点击刷新重建预览连接并在确认解锁后恢复点击时的暂停，兼容旧版暂停。
• 无画面时保留 iPhone 外壳、黑色关闭屏幕质感和小字「未连接」。暂停显示对应提示，已有画面在短暂断流时保留。
• 保留 0.2.6 的深灰底 / 灰色后层 / 白色前层插件图标，以及波点 4s、渐变 8s、灰色点击 / 拖拽动效。

370 项 Python、29 项 widget DOM、135 项独立视觉插件测试及构建 / manifest 检查通过。浏览器验证了实际 AppBridge 刷新与黑屏占位；未操作手机或重启 WDA。已打开聊天需要重新连接并重开手机屏幕以加载新版。

iPhone Use WDA 0.2.6

插件图标换成黑白叠层手机设计：圆角深灰色底板、灰色后层手机、半透明白色前层手机，配轻微立体阴影和高光。logo 与 composerIcon 使用同一自包含 512×512 SVG，小尺寸保持清晰。

363 项 Python、25 项 widget DOM、TypeScript / Node / manifest 检查通过；深浅背景及 16–256px 渲染检查通过。

安装后重新连接聊天以加载新版插件资源。手机屏幕样式和 4s 波点 / 8s 渐变周期保留。

iPhone Use WDA 0.2.5

• 重复 setup / READY，以及预览 open / pause / resume 复用本聊天已有手机屏幕标签；MCP 重连后会话标识保持一致。
• 顶部留白增加至 28px，浅色 widget 背景改为极浅灰 #f8f8f8。
• 顶部状态栏和底部工具栏采用白底、0.5px 极浅灰描边与轻微弥散阴影。
• 波点大小变化独立使用 4 秒周期；渐变交替与呼吸使用 8 秒周期。
• 保留统一工具栏图标、灰色点击 / 拖拽手势和 1.6–2 秒显示时长。

本地 363 项 Python、25 项 widget DOM、TypeScript 构建与 manifest 检查通过；最终 HTML 已检查深浅色、窄面板及隐藏 / 减少动态效果状态。

安装后重新连接聊天以加载新版 MCP 与 widget；旧版已产生的重复标签需关闭一次。真实宿主标签数量尚未在重连后现场验收。

iPhone Use WDA 0.2.4

波浪点阵的交替周期从 12 秒缩短到 4 秒，波点大小范围从网格间距的 6%–23% 扩大到 4%–27%，变化更明显。

同时修复动画样式优先级：减少动态效果时停止动画，页面隐藏时暂停动画。

Python 与 widget 测试、构建和 manifest 检查通过；浏览器确认最终动画周期为 4 秒。本机已安装并验证 0.2.4。现有聊天重新连接插件，并关闭后重新打开手机屏幕，即可加载新界面。

附件为普通 WDA 插件的源码安装包。

iPhone Use WDA 0.2.3 / Vision 0.2.0

The phone widget now fades its halo, bright rim and dots to transparent at the middle of all four edges, retaining soft sky-blue light at the corners. Dots vary in size and brightness along waves; three static texture phases crossfade using opacity animation.

The toolbar now uses a matching set of rounded refresh, Home and camera icons. All three share the same grid, size and stroke weight; the refresh arrow and arc join at one endpoint.

Gesture feedback uses neutral gray. Taps last 1.6 seconds with a small press and rebound; drags last 1.6–2 seconds with visible press, movement, release and endpoint hold. Consecutive indications finish independently instead of cancelling one another. Reduced-motion mode keeps a stationary marker for the same duration, and authentication pause clears every indicator.

This release also includes the 0.2.0 task improvements: compact observation results, inline scaled screenshots, coordinate fallback after selector failures, bounded long-text input with continuation, responsive preview and the device-status / refresh / Home / screenshot widget.

Packages:

• iPhone Use WDA 0.2.3
• Independent iPhone Use WDA Vision 0.2.0

Validation passed: 360 Python tests, 25 widget DOM tests, 135 Vision tests, TypeScript build, bundled HTML and manifest checks. Browser rendering covered dark and light frames, a historical Settings screenshot, narrow panels and authentication pause. Installed WDA 0.2.3 passed stdio initialize / tools/list / ping and matched all 80 staged files. Device measurements and remaining device-validation limits are documented in docs/validation.md.

Reconnect existing Codex chats and reopen the phone-screen widget to load the new plugin and versioned UI resource. This update did not operate the phone or restart WDA.