前言¶
DeepSeek Harness（DSH）的设计理念是「一切皆插件」。dsh-deeppilot 是其中的一个客户端插件，为 DeepSeek Harness 提供原生的 iPhone 伴侣应用。它不替代或修改 DSH 的 Web 界面，而是通过加密隧道直接连接到你的 DSH 主机，允许你在手机上浏览会话、发送提示词并管理智能体流程。
插件信息¶
- 名称：
dsh-deeppilot - 维护者：Mars-Sea
- 分类：客户端
- 许可证：MIT
核心功能¶
- 全流程交互：从 iPhone 浏览项目、会话、历史记录和实时代理输出；发送提示词、切换模型、创建会话，以及处理系统提示的审批与问题。
- 安全配对：使用五分钟单次有效代码和每设备 P-256 密钥进行配对。物理 iPhone 将私钥保存在 Secure Enclave 中，确保密钥不离设备。
- 连接方式：
- 局域网 (LAN)：默认启用独立 TCP 端口 3098，仅支持 TLS 加密，主机在配对时颁发证书并校验指纹。
- Tailscale Funnel：支持可选的嵌入式 Tailscale Funnel 模式。
- 通知支持：支持实时推送通知，并可选离线 APNs 通知（离线模式下中继模式仅传递 APNs 设备令牌和有限负载，不传输完整对话历史）。
- 自更新：设置页脚显示已安装版本，后台检查 GitHub 稳定版发布，并提供版本更新链接（无第三方依赖）。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dsh-deeppilot
安装完成后，重启 DSH。进入 Settings（设置） → DeepPilot，启用连接并显示配对二维码。在 DeepPilot 应用中扫描二维码即可完成配对。配对面板下方也会显示可复制的地址、一次性代码和证书指纹，方便在无法使用相机时进行粘贴配对。
配置与注意事项¶
- 端口与防火墙：局域网访问默认监听 TCP 3098。如果系统启用防火墙，请在使用的网络中放行该入站端口。端口可在 DeepPilot 的设置页面更改。
- 连接切换：在局域网和公网地址之间切换时，插件会立即生成新的二维码和字符串。
- 协议升级：如果从旧版本升级（旧版本在局域网使用明文
ws://），所有通过局域网配对的设备必须重新配对，以获取新的证书指纹。 - 数据保留：卸载插件不会删除
$DSH_HOME/deeppilot/下的本地状态文件。
适用场景与限制¶
- DeepPilot 状态：DeepPilot 目前处于 Apple TestFlight 审核阶段，邀请链接将在 Apple 审核通过后生效。
- DSH 版本要求：插件源码基于 Node.js 22+ 和 DSH 0.2.x 系列开发（兼容
0.2.0-rc.2至0.3.0之前版本），需要使用web配置文件。 - 安全建议：对话流量直接在 iPhone 和 DSH 主机之间传输，全程加密。在启用远程访问或推送功能前，请阅读
PRIVACY.md和SECURITY.md。
总结¶
dsh-deeppilot 为 DSH 用户提供了原生的移动端操作能力。通过物理设备隔离私钥、TLS 证书绑定以及直接连接模式，它在提供便捷操作的同时保持了较高的安全性。目前该插件正处于测试阶段，适合希望在移动端深入使用 DeepSeek Harness 的开发者。
