搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

ZSeven-W/dsh-ios

AI 工程

为编程 Agent 提供 22 个工具,在会话内启动、构建并操控 iOS 模拟器或 USB 真机,带可点拖的实时侧栏。

469
41
TypeScript
MIT
创建于 3 个月前

项目介绍

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 中的典型首次对话流程:

  1. 让 Agent 列出设备(ios_sim_devices),取得 udid 或设备名。
  2. 让 Agent 启动设备(ios_sim_boot),实时面板打开,模拟器出现在侧栏中。
  3. 直接在视频上点击或拖动;也可以让 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)操作界面。
  4. 用 ios_sim_build_run 构建并运行工程;完整构建需要数分钟,完成后应用会在模拟器上启动。
  5. 做 SwiftUI 开发时,ios_sim_preview start 会把预览编译成 dylib,源码修改后热替换进正在运行的模拟器,无需重启。
  6. 对真机 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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。TypeScript355
  2. phoneuse-official/phoneuse在 Mac 上通过提示词、实时画面、REST 与 MCP 控制 USB 连接的 iPhone 的开源本地工具。Python132
  3. hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。Rust150
  4. phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。Python812
  5. JosssphZhou/poki让 Claude Code、Codex 等 MCP 客户端通过 Mac 操控真实 iPhone,无需越狱或额外硬件。JavaScript109