ZSeven-W/dsh-ios
AI 工程为编程 Agent 提供 22 个工具,在会话内启动、构建并操控 iOS 模拟器或 USB 真机,带可点拖的实时侧栏。
项目介绍
DSH iOS Simulator 是 DeepSeek Harness 的插件,把一台实时 iOS 模拟器,或者通过 USB 连接的真机 iPhone,放进 Agent 对话里。Agent 可用 22 个工具发现并启动设备、构建并运行 Xcode 工程、通过无障碍标识、OCR 文本或列表行来操作界面,也能读取统一日志、进程、调用栈和内存泄漏信息。右侧常驻面板渲染设备画面,可以直接在视频上点击和拖动。模拟器 udid 走 simctl 和 serve-sim,真机 udid 走 WebDriverAgent。
它面向用 DSH 开发、测试或检查 iOS 应用的开发者,也适合希望 Agent 按元素身份而非猜测坐标来操作界面的人。项目使用 TypeScript 编写,MIT 许可。
安装与首次使用
插件通过 npm 安装进 DSH profile,然后启动 DSH 的 Web 界面:
dsh plugin --profile web add @zseven-w/dsh-ios@latest
dsh web
下面是 README 中的典型首次对话流程:
- 让 Agent 列出设备(
ios_sim_devices),取得 udid 或设备名。 - 让 Agent 启动设备(
ios_sim_boot),实时面板打开,模拟器出现在侧栏中。 - 直接在视频上点击或拖动;也可以让 Agent 通过无障碍树(
ios_sim_ui_tree+ios_sim_tap_element)、OCR(ios_sim_find_text+ios_sim_tap_text)或列表行(ios_sim_ui_rows+ios_sim_tap_row)操作界面。 - 用
ios_sim_build_run构建并运行工程;完整构建需要数分钟,完成后应用会在模拟器上启动。 - 做 SwiftUI 开发时,
ios_sim_preview start会把预览编译成 dylib,源码修改后热替换进正在运行的模拟器,无需重启。 - 对真机 iPhone,用可传数据的 USB 线连接并解锁,运行
ios_real_start_wda构建和启动 WebDriverAgent,面板会切换到手机画面。
使用约束
- 需要完整安装 Xcode 的 macOS,不能只有 Command Line Tools,并且至少安装一个模拟器运行时。在非 macOS 主机上插件可以加载、工具会注册,但调用会返回说明性错误。
- DSH ≥ 0.1.0-rc.6 且带 Web 包才能使用实时面板。无头 profile 仍可使用全部 22 个工具,只是没有画面。
- AXe 是可选项,但模拟器上的 UI 树工具和列表行工具依赖它;可通过 Homebrew 安装,或让插件下载经过 SHA-256 校验的固定版本。Vision OCR 工具首次使用时用
swiftc编译内置 Swift 源码。 - lldb 调用栈需要开启 macOS 开发者模式(
sudo DevToolsSecurity -enable);未开启时回退到 Xcode 的非挂起sample引擎,泄漏分析功能也会降级。 - 真机需保持解锁、使用可传数据的 USB 线、开启开发者模式,并且
~/Library/Caches/dsh-ios/wda/src下已有 WebDriverAgent 检出;插件不会下载或克隆 WDA。首次构建会安装需要信任证书的 runner,免费开发者签名 7 天后过期,需要重新运行ios_real_start_wda。 - 浏览器从不直连 serve-sim 端口:画面、截图和触控都经过 DSH Web 服务同源下签名且有有效期的路由,没有任何消费者时流会在 5 分钟后自动停止。
- 已知问题:即使开启开发者模式,Xcode 的
leaks在 iOS 26.2 模拟器运行时上也可能失败;工具会返回原始诊断信息,并保证目标进程恢复运行。
HotRepo 点评
该仓库暂无 HotRepo 排名、快照或讨论记录,以下观察基于技术材料。比较突出的设计是把设备控制收在插件自有的签名路由之后,而不是把推流端口直接暴露给浏览器;列表行点击用 expect_count 做计数校验,而不是盲点坐标。真机路径也把失败原因明确编码成锁定、证书未信任、签名过期、隧道断开等状态,而不是笼统报错。SwiftUI 预览热替换和 22 个工具的覆盖,让它更像一层可用的 iOS 自动化能力,而非演示品,但实际使用受限于 macOS 和完整 Xcode 环境。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。
- phoneuse-official/phoneuse在 Mac 上通过提示词、实时画面、REST 与 MCP 控制 USB 连接的 iPhone 的开源本地工具。
- hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。
- phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。
- JosssphZhou/poki让 Claude Code、Codex 等 MCP 客户端通过 Mac 操控真实 iPhone,无需越狱或额外硬件。