返回目录

dsh-ios

编辑精选维护状态: 活跃

zseven-w/dsh-ios

在对话中直接操控 iOS 模拟器与 USB 真机的 DSH 插件,提供 21 个 agent 工具,可按无障碍标识、OCR 文本或列表行驱动 UI,并支持可拖拽的流式侧边面板。

安装
$ dsh plugin --profile web add @zseven-w/dsh-ios@latest

204

星标

22

Fork

TypeScript

语言

MIT

许可证

2026-08-19

创建于

2026-08-21

最近推送

MIT 协议的原生 DSH 插件,在对话里呈现实时 iOS 模拟器与 USB iPhone:22 个工具、常驻实时面板、语义化 UI 自动化与 SwiftUI 预览热重载。需要 Mac / Xcode。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-23

许可证

MIT

01它能帮你完成什么?

  • 在 DeepSeek Harness 对话里交互式地驱动真实 iOS 模拟器(或 USB 连接的 iPhone)

    已启动设备的实时 MJPEG 面板,支持点击 / 拖拽 / 旋转 / 回主屏,外加 JSON 工具结果:开机、构建并运行 Xcode 工程或 Swift 包、无障碍 UI 树、OCR 查找 / 点击、日志、进程 / 回溯 / 内存泄漏

    需要测试或自动化 iOS 应用、并希望把设备画面和控制直接呈现在 DSH 内的移动开发者与 agent

02如何接入 DeepSeek Harness?

前置条件

  • 已安装 DeepSeek Harness(DSH)——README 说明其基于 DSH 0.1.1-rc.1 测试
  • 一台装有 iOS 模拟器 / Xcode 的 Mac(用于模拟器与真机流程;README 说明在非 macOS 主机上工具仍会注册,但会报错失败)

安装步骤

  1. 01

    添加插件:`dsh plugin --profile web add @zseven-w/dsh-ios@latest`

    $ dsh plugin --profile web add @zseven-w/dsh-ios@latest

  2. 02

    启动 Web UI:`dsh web`

    $ dsh web

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DSH 插件——在 DeepSeek Harness 对话里直接驱动实时 iOS 模拟器与 USB 连接的真机,通过 22 个已注册 agent 工具和一个常驻的实时 MJPEG 面板

  • 对话内的实时模拟器

    来自 `ios_sim_devices` 的已启动设备 udid / 名称serve-sim 的 MJPEG 流经签名的 `/_dsh/dsh-ios/*` 路由代理到常驻的右侧面板

    serve-sim 在专用端口范围绑定 127.0.0.1(仅回环传输)
  • USB 连接的真机

    已解锁、开启开发者模式的 USB 连接 iPhone`ios_real_start_wda` 在手机上构建并启动 WebDriverAgent,把控制(REST)和屏幕(MJPEG)端口通过回环隧道接入同一面板

    在手机上构建并启动 WebDriverAgent(写入设备)每次真机账号点击都受插件的 identify-before-tap 规则约束
  • 语义化 UI 自动化与 SwiftUI 预览热重载

    `ios_sim_ui_tree` / `ios_sim_find_text` 用于基于标识或 OCR 的点击;`ios_sim_preview` 用于 SwiftUI 预览无障碍树点击、OCR 查找 / 点击,以及约 2–5 秒把 SwiftUI 预览改动热替换进运行中的模拟器

04适合谁?何时不该用?

适合

  • 需要测试或自动化 iOS 应用、并希望把设备画面和控制直接呈现在 DSH 内的移动开发者与 agent

不适合

  • 模拟器和真机工具需要 Mac(iOS 模拟器 / Xcode)。README 说明在非 macOS 主机上工具仍会注册,但会报错失败,只有 `ios_sim_preview` 的 status 在任何主机上都如实返回 `{ running: false }`。
  • 真机必须已解锁并开启开发者模式;每次真机账号点击都受插件的 identify-before-tap 规则约束,且设备需通过 USB 连接。

05兼容性、维护与安全提示

  • 模拟器和真机工具需要 Mac(iOS 模拟器 / Xcode)。README 说明在非 macOS 主机上工具仍会注册,但会报错失败,只有 `ios_sim_preview` 的 status 在任何主机上都如实返回 `{ running: false }`。
  • 真机必须已解锁并开启开发者模式;每次真机账号点击都受插件的 identify-before-tap 规则约束,且设备需通过 USB 连接。
  • 画面字节只通过 DSH webserver 提供的带签名、会过期的 URL 抵达 UI;每个路由都要求回环对等端、回环 Host 以及 Fetch-Metadata/Origin 校验,HMAC 凭证在 10 分钟内过期。
2026-08-192026-08-21v0.1.0-rc.4

MIT · 预发布(最新 v0.1.0-rc.4,2026-08-23;基于 DSH 0.1.1-rc.1 测试)

06常见问题

怎么安装 DSH iOS Simulator?

运行 `dsh plugin --profile web add @zseven-w/dsh-ios@latest` 添加插件,再运行 `dsh web` 打开 Web UI。README 说明其基于 DSH 0.1.1-rc.1 测试。

我需要 Mac 吗?

模拟器和真机流程需要——README 说明在非 macOS 主机上工具仍会注册,但会报错失败(只有 `ios_sim_preview` 的 status 在任何地方都安全,返回 `{ running: false }`)。

它能控制真实的 iPhone 吗?

可以。`ios_real_start_wda` 在已解锁、开启开发者模式的 USB 连接 iPhone 上构建并启动 WebDriverAgent,把控制和屏幕端口通过回环隧道接回同一面板。每次真机账号点击都受 identify-before-tap 规则约束。

设备画面是怎么保证安全的?

画面字节只通过 DSH webserver 提供的带签名、会过期的 URL 抵达 UI。每个路由都要求回环对等端、回环 Host 以及 Fetch-Metadata/Origin 校验,HMAC 凭证 10 分钟内过期——没有图片块,也没有录屏文件。

08数据与来源

  • 作者声明github.comea148b9eec1b…

    A live, interactive iOS Simulator inside a DeepSeek Harness conversation — plus your real iPhone over USB.

  • 作者声明github.comea148b9eec1b…

    22 agent tools · live MJPEG sidebar panel · simulator & real iPhone over USB

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-23。发现错误?提交更正。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。