返回目录

dsh-deeppilot

精选清单收录维护状态: 活跃

mars-sea/dsh-deeppilot

DeepSeek Harness 原生 iPhone 伴侣插件:会话、审批、问答、通知与安全的远程访问。

前往 GitHub
$ dsh plugin --profile web add dsh-deeppilot

17

星标

1

Fork

TypeScript

语言

MIT

许可证

2026-08-24

创建于

2026-11-13

最近推送

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`

安装步骤

  1. 01

    运行 `dsh plugin --profile web add dsh-deeppilot`,再用 `dsh web` 启动宿主

    $ dsh plugin --profile web add dsh-deeppilot

  2. 02

    DSH 重启后,打开设置 → DeepPilot,开启「允许手机连接」,点「已配对设备」旁的「添加手机」扫 App 里的二维码;也可以粘贴可复制的地址、一次性码和证书指纹

  3. 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 适配兼容

把 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 透传会让已配对的手机获得与宿主浏览器相同的所有者权限——包括设置与插件管理——所以除非确有需要,请保持该开关关闭。
2026-08-242026-11-10v0.9.20

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/` 下的状态。

08数据与来源

  • 作者声明github.comeb14105dd456…

    The open-source DSH companion plugin for **DeepPilot**, a native iPhone client for using DeepSeek Harness remotely.

  • 作者声明github.comeb14105dd456…

    It connects the app directly to the DSH Host on your own computer and does not replace or modify the DSH Web UI.

  • 作者声明github.comeb14105dd456…

    - 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 个值得优先安装的插件,覆盖各个分类。

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

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