MIT 开源的 DSH 配套插件:通过 3098 端口上锁定指纹的 TLS 监听加可选 Tailscale Funnel,把 DeepPilot iPhone App 接到你自己的 DSH Host——会话、审批、预览与通知都能在手机上处理,DSH Web UI 保持原样。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-11-13
许可证
MIT
01它能帮你完成什么?
在你自己的电脑上让宿主持续运行的同时,用 iPhone 操作一个 DeepSeek Harness 会话
浏览项目与会话、流式助手文本与推理(重连后会恢复持久历史)、发送提示词、切换模型、新建会话,以及在手机上回应审批与提问
想用手机查看并引导正在运行的 agent、又不想把整个 Web UI 暴露出去的 DSH 用户
在局域网之外连到宿主,而不用把 DSH web server 暴露到网络上
在插件自己的 3098 端口上建立已配对、仅走 TLS 的连接并锁定证书指纹;离开局域网时退回可选的嵌入式 Tailscale Funnel
离开工位、但仍需要在手机上处理审批、提问和实时输出的开发者
收到通知,并留下 agent 做过什么的记录
实时通知,离线时还有可选的 APNs 推送;可导出完整的 ZIP 日志归档或 Markdown 对话记录;安静的定时运行可以跳过完成通知
长时间运行或定时执行 DSH 任务、不想一直盯着屏幕的人
02如何接入 DeepSeek Harness?
前置条件
- DSH 宿主须落在滚动兼容范围 `>=0.2.1-rc.5 <0.3.0-0` 内,并使用 `web` profile;0.3.0 及其预发布版本在重新审计之前一律拒绝
- 宿主机器上需装有 Node.js 22+
- DeepPilot iPhone App——README 说明它目前仍在 TestFlight 审核中,因此邀请链接要等 Apple 通过该构建后才会接受测试者
- 在你使用的网络上,需让防火墙放行入站 TCP `3098`
安装步骤
- 01
运行 `dsh plugin --profile web add dsh-deeppilot`,再用 `dsh web` 启动宿主
$ dsh plugin --profile web add dsh-deeppilot
- 02
DSH 重启后,打开设置 → DeepPilot,开启「允许手机连接」,点「已配对设备」旁的「添加手机」扫 App 里的二维码;也可以粘贴可复制的地址、一次性码和证书指纹
- 03
更新时,可以在 `dsh plugin --profile web update dsh-deeppilot` 之后重启 DSH;或者——更推荐,因为 HMR 会把原地更新回滚——先退出 DSH,再运行 `dsh plugin --profile web add dsh-deeppilot@<目标版本>`
$ dsh plugin --profile web update dsh-deeppilot
验证接入成功
作者未说明
回滚
- `dsh plugin --profile web remove dsh-deeppilot` 会卸载插件;`$DSH_HOME/deeppilot/` 下的本地 DeepPilot 状态不会被删除
03DSH 适配与能力边界
把 DSH Host 与 DeepPilot iPhone App 连起来的 DSH 插件:走它自己在 TCP 3098 上的 TLS 监听,再加可选的嵌入式 Tailscale Funnel;它从不替换也不修改 DSH Web UI。
配对与锁定指纹的 TLS 传输
一个五分钟有效的一次性配对码,以及每台设备各自的 P-256 密钥→一台已配对的设备,其 App 锁定宿主证书指纹;TLS 走插件自己的 3098 端口,离开局域网时以 Funnel 作为回退
在 `$DSH_HOME/deeppilot/lan-tls/` 下写入自签名证书与密钥独立于 DSH web server 监听 TCP `3098`从手机控制会话
提示词、模型选择、新建会话请求、审批与提问的答复→流式的助手文本与推理、重连后恢复的持久历史,以及在手机上完成的审批
把新会话与轮次历史写入 DSH 宿主通知与导出
会话事件;离线推送需要可选的 APNs 设备令牌→实时通知、可选的 APNs 推送、完整的 ZIP 日志归档,以及宿主提供该路由时的 Markdown 对话记录
在中继模式下,只有 APNs 设备令牌和受限的载荷会离开本机本地网页预览与桌面 Web UI 透传
会话中已经出现过的 `http://127.0.0.1:<port>` 或 `localhost:<port>` 链接,或需要主动开启的桌面 Web UI 开关→在 App 内渲染该页面或 DSH Web UI,并保留实时重载,走一条独立的、已鉴权的预览连接
打开桌面 Web UI 开关后,手机获得与本地浏览器相同的所有者权限,包括设置与插件管理App 内插件更新与诊断
显式确认过的兼容插件版本;宿主上的失败记录→由宿主驱动的安装(失败时回滚)、设置页的版本提示,以及连接诊断列表和 `/phone/health` 的阶段报告
在开启 HMR 时更新,会因 directory-picker 的组合冲突被宿主回滚失败记录保留 7 天、上限 5 MB,且只保存来源哈希
04适合谁?何时不该用?
适合
- 想用手机查看并引导正在运行的 agent、又不想把整个 Web UI 暴露出去的 DSH 用户
- 离开工位、但仍需要在手机上处理审批、提问和实时输出的开发者
- 长时间运行或定时执行 DSH 任务、不想一直盯着屏幕的人
不适合
- DSH 每次启动都会重新检查插件声明的依赖要求,因此落在 `>=0.2.1-rc.5 <0.3.0-0` 之外的宿主会拒绝激活该插件;0.3.0 及其预发布版本在重新审计之前始终被拒绝。
- DSH 默认开启 HMR,而原地更新插件会在组合过程中移除软件包,于是本插件的 directory-picker 补丁与宿主的 `directory-picker-auto` 重复注册同一个服务,宿主便把更新回滚。请在 DSH 停止时更新,或为该 profile 关闭 HMR。
- 手机通过插件自己的 TCP 3098 端口,以 TLS 连到宿主——请在防火墙放行入站 `3098`。Funnel 模式需要随附的 Go 辅助程序,而它要求 macOS 13 Ventura 或更新版本;可信局域网模式在更旧的 macOS 上仍可继续使用。
- 可选的桌面 Web UI 透传会让已配对的手机获得与宿主浏览器相同的所有者权限——包括设置与插件管理——所以除非确有需要,请保持该开关关闭。
05兼容性、维护与安全提示
- DSH 每次启动都会重新检查插件声明的依赖要求,因此落在 `>=0.2.1-rc.5 <0.3.0-0` 之外的宿主会拒绝激活该插件;0.3.0 及其预发布版本在重新审计之前始终被拒绝。
- DSH 默认开启 HMR,而原地更新插件会在组合过程中移除软件包,于是本插件的 directory-picker 补丁与宿主的 `directory-picker-auto` 重复注册同一个服务,宿主便把更新回滚。请在 DSH 停止时更新,或为该 profile 关闭 HMR。
- 手机通过插件自己的 TCP 3098 端口,以 TLS 连到宿主——请在防火墙放行入站 `3098`。Funnel 模式需要随附的 Go 辅助程序,而它要求 macOS 13 Ventura 或更新版本;可信局域网模式在更旧的 macOS 上仍可继续使用。
- 可选的桌面 Web UI 透传会让已配对的手机获得与宿主浏览器相同的所有者权限——包括设置与插件管理——所以除非确有需要,请保持该开关关闭。
MIT · 最新版本 v0.9.20(2026-11-11),仅 README 证据,未做安全审计
06常见问题
怎么把 iPhone 连到 DeepSeek Harness?
运行 `dsh plugin --profile web add dsh-deeppilot`,启动 `dsh web`,然后在 DSH 里打开设置 → DeepPilot,开启「允许手机连接」,点「已配对设备」旁的「添加手机」扫二维码;也可以粘贴可复制的地址、一次性码和证书指纹。配对码一次性、有效期五分钟,App 会锁定二维码里携带的 Host 证书指纹。
现在能拿到 iPhone App 吗?
不保证。README 说明 DeepPilot 目前仍在 TestFlight 审核中,邀请链接要等 Apple 通过该构建后才会接受测试者。插件可以现在装,App 要等审核通过。
它会替换 DSH Web UI 或把它暴露到网络吗?
不会。插件不替换也不修改 DSH Web UI;3098 端口的局域网监听只暴露 DeepPilot 连接、一次性配对和健康检查端点,不是整个 Web UI。可选的「允许手机打开桌面 Web UI」默认关闭,一旦打开,手机就拥有与宿主浏览器相同的所有者权限,包括设置和插件管理。
为什么插件更新被回滚了?
DSH 默认开启 HMR,其更新流程会先卸载已安装的包再装目标版本,于是本插件的 directory-picker 补丁与宿主的 `directory-picker-auto` 重复注册同一个服务,宿主就把整次更新回滚。插件本身没有损坏,仍可正常使用。请在 DSH 停止时更新:退出 DSH,运行 `dsh plugin --profile web add dsh-deeppilot@<目标版本>`,再启动;或为该 profile 关闭 HMR。
它会在宿主机上写哪些文件?
首次启动会在 `$DSH_HOME/deeppilot/lan-tls/` 下生成自签名证书与密钥,并把连接失败诊断写到插件数据目录(保留 7 天、上限 5 MB,只记来源哈希)。卸载包不会删除 `$DSH_HOME/deeppilot/` 下的状态。
07相关的 DSH 工作流
open-design
作者 nexu-io
DeepSeek Harness 的开源 AI 设计插件,本地优先桌面应用,让编码智能体变身设计引擎,生成原型、落地页、幻灯片、图片与视频,支持多种格式导出。
mole
作者 tw93
将 Mole 命令行工具作为 DSH 技能使用,进行磁盘分析、预览清理、卸载应用和系统健康检查。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
picgo
作者 molunerfinn
PicGo:面向高效创作者的图片上传神器,支持 Obsidian、Typora、VS Code 等编辑器,以及 S3、GitHub、Cloudflare R2、Imgur、阿里云 OSS 等 60+ 图床,粘贴即上传。
08数据与来源
The open-source DSH companion plugin for **DeepPilot**, a native iPhone client for using DeepSeek Harness remotely.
It connects the app directly to the DSH Host on your own computer and does not replace or modify the DSH Web UI.
- Connect over the LAN (TLS with a Host-issued certificate pinned during pairing) or the optional embedded Tailscale F…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-13。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
