diff --git a/README.zh.md b/README.zh.md new file mode 100644 index 0000000..35ed901 --- /dev/null +++ b/README.zh.md @@ -0,0 +1,341 @@ +
+
+
+
+ English + · + 中文 + · + 日本語 +
+ + + + + + +## 一次连接,随时可用。 + +从手机、电脑、浏览器继续使用你的 DeepSeek Harness 实例。无论使用哪台设备,都可以回到同一个 Harness 会话。 + +Harness 始终运行在工作电脑上,原有的工作区、工具和项目配置保持不变。DS Harness Remote 只是通往这个工作环境的另一个窗口。 + +已支持 DeepSeek Harness 桌面版,使用最新版本安装即可: + +`ds-harness-remote@0.6.4` + +## 主要特性 + +- 从另一台设备(Web、PC、移动端)远程到本地Harness实例:DSH 优先,CodeX、Cursor、Antigravity 一样可用。 +- 已支持 DeepSeek Harness 桌面版,安装即可使用。原生界面,不另外维护一套桌面会话 UI。 +- 支持新建工作区、模型配置、对话模型切换,远端如本地一样丝滑。 +- Harness 主机无需开放公网监听端口,无需公网IP,可以从任意可上网的地方,通过双向端到端加密链路安全连接。 +- 优先使用P2P网络,全球多TURN节点中转,极端情况下使用多Server Relay兜底,一切畅通无阻。 +- 通过 Harness 原生侧栏提供工作区文件、只读预览、远程终端和已授权本机开发服务预览。 +- Remote Tool 上下文注入,支持 发现主机与工作区、创建和管理 Harness 会话、读取历史、等待执行、请求中断及传输获准文件。[详情](packages/plugin/README.md#remote-agent-tools) +- 除了支持DeepSeek Harness,同时通过ACP协议支持 Codex、Cursor、Google Antigravity、Pi、OpenCode、Claude Code、Harness Agent等工具的原生工作区,远程文件浏览、终端均可使用。 +- Android、iOS、Web、原生DSH 都有对应客户端,全平台可用。 +- 多个客户端可以同时连接同一个 Harness Host,RPC 与数据流按连接隔离。 + +## 支持的客户端 + +| 客户端 | 形态 | 状态 | 说明 | +| --- | --- | --- | --- | +| DSH Desktop 插件 | Remote 侧栏 | 已支持 | 装 `ds-harness-remote@0.6.4`;Host 也可以就是这台电脑 | +| Web | 浏览器页面 | 已支持 | 打开 [https://dsh.r2049.cn](https://dsh.r2049.cn),复用 Harness 原生界面 | +| Android | 原生 App | 已支持 | 从 [Releases](https://github.com/liguobao/ds-harness-remote/releases/latest) 下载 APK,见 [Android 说明](apps/android/README.md) | +| DSH Go | C佬精品 | 已支持 | 详情见:[ccch1mneyyy/dsh-go: DeepSeek Harness 的 Android 客户端。手机上直接跑,也能遥控你电脑上的 DSH。](https://github.com/ccch1mneyyy/dsh-go) +| iOS | TestFlight 内测 | 内测 | 未公开上架,入口见 [issue #20](https://github.com/liguobao/ds-harness-remote/issues/20) | +| 浏览器扩展 | Chrome | 仅入口 | 读取已登录 Web 的授权换取独立设备凭据、列出在线 Host、打开同源 Remote Web,不承载会话界面 | +| dsh-TUI | 纯终端 CLI | 计划中 | 本版本不包含该集成,将在后续版本单独提供;安装脚本不会为它自动创建 Web 服务 | +| Linux | 云服务器 | 已支持 | [官网](https://dsh.r2049.cn/)登录后一键安装。 + +多个客户端可以同时连接同一个 Host,RPC 与数据流按连接隔离。 + +## 安装 + +### 支持 DeepSeek Harness 桌面版 + +在 DeepSeek Harness Desktop 的 **扩展 / 插件管理** 中,选择从 **npm** 安装,输入包名和版本: + +`ds-harness-remote@0.6.4` + +安装后重启 Desktop。也可使用它的官方 `dsh` 启动器安装固定版本: +`dsh plugin --profile desktop add -w ds-harness-remote@0.6.4`。 + +DSH 0.2.2 起,npm 安装支持在插件页检查版本和一键更新;热更新失败时由 DSH 尝试恢复旧版。GitHub / 本地 link 安装需先切换到 npm,见[在线更新说明](docs/installation.zh.md#dsh-插件页在线更新)。 + +### Linux 一键安装 + +见官网首页[https://dsh.r2049.cn](https://dsh.r2049.cn/),登陆后获取一键安装授权码安装即可。 + +### 原生Android 客户端 + +支持同时使用多工作区连接对话,同时创造性加入了 「Bot 模式」( Power by [Fei2411/DS-Bot](https://github.com/Fei2411/DS-Bot)) + +从 [GitHub Releases](https://github.com/liguobao/ds-harness-remote/releases/latest) 下载最新 APK,登录同一账号即可看到主机。 + +## DSH Go - DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。 + +[ccch1mneyyy/dsh-go](https://github.com/ccch1mneyyy/dsh-go):已内置 ds-harness-remote 协议,既可以在手机本机运行 DeepSeek Harness,也可以远程连接电脑。 + +在手机端DSH Go安装 ds-harness-remote 插件后,电脑端、Web端一样可以远程到手机上的DSH,丝滑使用Mobile Use. + +### iOS 客户端 + +- [内测招募](https://github.com/liguobao/ds-harness-remote/issues/20) + +## 快速开始 + +1. 从 DeepSeek Harness 侧边栏打开 **Remote** 入口。 +2. 按需选择登录方式:「知乎」、「Github」、[Google ] 授权登录均已支持,账号密码登录(使用邀请码注册,可邮件本仓库作者申请) +3. 在另一台设备上使用 DeepSeek Harness安装同样插件,根据1、2完成同样方式的登录。也可以按需使用Remote Web、iOS、Android、DSH Go等客户端,即开即用,无需安装任何插件。 +4. 选择在线 Host,再选择已有 Workspace 或浏览远端目录后打开。 + +默认使用本项目提供的[https://dsh.r2049.cn](https://dsh.r2049.cn)托管 Remote Server。 + +自建托管Server可使用仓库内的[最小 Server](apps/server/README.zh.md),当前版本已包含 WebRTC LAN/P2P/TURN 连接协调(TURN 需自行部署 coturn)与加密 Relay Server 等功能,暂不支持托管Remote Web的完整功能。 + +## 界面截图 + +### 桌面端 + +在另一台电脑上选择在线 Host,然后打开它的 Workspace。Workspace 会在 Harness 原生界面中打开,顶部显示当前 Host 和加密连接状态。 + + +
+
+
+
+
+
+
+
+
+
+
+
+ 衷心感谢每一位让这个项目变得更好的贡献者! +
+ +## 项目声明与商标 + +本项目是独立的社区项目,不是 DeepSeek 官方产品。DeepSeek 及相关名称和商标归其各自权利人所有。 + +## 连接问题排查 + +Android:复现问题后打开 **设置 → 诊断 → 导出连接日志**,选择文件夹保存 `.txt`。日志保留本次 App 进程启动以来最近 500 条连接诊断;重启 App 后清空,不包含凭据和会话内容。 + +Host:在 **插件 → Remote 设置** 开启 **Debug 日志**,立即生效并持久保存;排查完成后关闭(恢复 `info` 级别)。日志带 `[ds-harness-remote]` 前缀,Desktop 可在 `desktop.log` 查找。手动配置可设置 `logLevel: debug`。 + +## License + +[MIT](packages/plugin/LICENSE) + +### 与 DSH-Go 配对 + +在电脑本机 Remote 设置的「登录账号 → DSH-Go 扫码」中生成二维码,使用支持此协议的 DSH-Go 扫码确认,再将手机验证码输入电脑。仅允许校验一次,错误后整个配对作废。新 Host 默认仅被控,新建 Device-only 账号无 Web/Admin 权限。需要完整 Server 配对 v1 API 及按[接入文档](docs/dsh-go-pairing-integration.md)改造的 DSH-Go;随仓库提供的最小 Server 暂不支持此流程。