NanoAI DeepSeek Harness 远程连接
English · 文档索引
DeepSeek Harness 远程连接 通过 NanoAI 平台授权，让已获准设备继续访问远程 DeepSeek Harness 主机的会话与工作区；执行与权限检查仍由 Host 负责。
安装与使用
- 在同一个 DSH profile 中直接安装并启用「DeepSeek Harness 远程连接」，按运行时提示重启；无需先安装 NanoAI 插件市场。
- 打开DeepSeek Harness 远程连接 的「NanoAI 连接」设置，保存服务根地址和 API Key。Remote 与 NanoAI 插件管理器 默认各自使用独立的
@deepseek-ai/dsh-credentials 记录；独立使用 Remote 无需安装管理器。Key 必须具备 remote:connect 权限。
- 打开DeepSeek Harness 远程连接，明确允许当前电脑作为 Host。profile 必须提供匹配的官方 Harness Remote carrier，平台也须启用远程访问；无需独立 Remote 密码、二维码或注册码登录。
- 在同一个 NanoAI 平台打开「DeepSeek Harness 远程连接」，选择有权控制的在线主机和工作区。网页自动登记浏览器客户端并获取连接凭据。
两个插件都提供明确的复选框，可选择复用同一 profile 中另一插件的服务地址和 API Key。复用时保留自己的原始配置，关闭复用后恢复使用。一次只允许一方复用另一方：拒绝开启双向复用，已存配置发生冲突时拒绝操作。每次操作都会重新读取所选来源的凭据记录，以获取轮换后的 Key；凭据缺失、无效、过期或撤销时，应在所选来源中修正。共用的 Key 需要 remote:connect，以及实际使用的管理器目录/下载操作所需权限。
在所选凭据来源中修改服务地址与 Key。Remote 实际使用的地址改变时，必须提供匹配的 Key 并重新加载 Remote；同一地址下的变更会在下一次请求生效。存储的 API Key 不会返回前端。Relay 服务账号和密码仅供服务端使用。
设备默认仅个人可见。所有者可以将主机明确共享给指定成员。空间成员身份、付费归属或运营管理员权限不会自动授予他人的会话访问权；仅设备信息权限也不授予控制权。平台在发现、连接和持续访问期间检查权限，撤销后拒绝或关闭连接。
功能与边界
- 通过官方 Harness Remote carrier 和加密通道继续使用 Host 工作区与会话。
- 提供受支持的工作区文件树、受限只读预览、主机本地终端及已授权开发服务预览。终端遵循 Host 本地开关，以 Host 用户身份运行。
- 保留上游 Noise 协议和传输实现；设备私钥留在端点。Host 仅建立出站连接，无需公网监听端口。
- Codex、Cursor、Antigravity 保留为上游实验能力，实际可用性取决于主机配置和匹配的 carrier。
apps/server 中的 Node relay 仍是 NanoAI Go 网关后的在用组件，其服务账号密码鉴权属于服务端基础设施。NanoAI 网关负责用户授权与个人共享，公网访问必须经过网关。部署与验证见Remote 部署运维和平台部署。
Android 客户端代码已于 2026-10-17 从本仓库删除；仓库原本没有 iOS App 源码，现已移除 iOS 内测入口。浏览器扩展与 VS Code 目录仍作为上游参考保留，未经 NanoAI 产品验收。历史移动端发布不是本分支的安装或连接路径。文档索引区分当前使用说明与上游技术参考。
源码构建
使用 Node.js 24.20.0 和固定版本 pnpm@12.9.1。在本目录执行：
pnpm install --frozen-lockfile
pnpm --filter @dsh-remote/protocol --filter @dsh-remote/crypto --filter @dsh-remote/webrtc --filter @dsh-remote/client-core build
pnpm --filter ./packages/plugin check
pnpm --filter ./packages/plugin build
这些命令构建插件与共享包，不会部署平台、发布包，也不代表真实 NanoAI 连接验收。安装说明列出 profile 与凭据要求。Relay 打包及平台验证遵循上述部署文档。
网页兼容
Remote 0.5.34 从正在运行的 Host 加载官方网页界面，让侧栏、会话和模块使用同一 Harness 版本。请将 Host 插件更新到 0.5.34，并重新加载 NanoAI 页面。Host profile 必须提供官方 Web 服务和兼容的 Harness Remote carrier；后续 Host 升级仍可能需要相应的 Remote 支持，peer 范围不代表所有未来版本均已验证。
公网 NanoAI 服务使用 HTTPS。HTTP 支持 localhost 和字面量私有、链路本地、运营商级 NAT IPv4 地址；发送到 HTTP 服务的凭据没有 TLS 保护。
来源与许可
基于上游项目 liguobao/ds-harness-remote，NanoAI 适配维护于本仓库。保留上游作者信息、版权及协议标识。采用 MIT 许可，版权归 2026 DSH Remote contributors。
本项目是独立社区项目，不是 DeepSeek 官方产品。DeepSeek 及相关名称和商标归各自权利人所有。