|
|
||
|---|---|---|
| .. | ||
| archive | ||
| design | ||
| images | ||
| CHANGELOG.md | ||
| PRIVACY.md | ||
| README.md | ||
| TODO.md | ||
| acp-integration.md | ||
| acp-remote.md | ||
| codex-remote.md | ||
| compatibility.md | ||
| compatibility.zh.md | ||
| device-pairing-v1.md | ||
| dsh-go-pairing-integration.md | ||
| end-to-end-encryption.md | ||
| fast-mode.png | ||
| installation.md | ||
| installation.zh.md | ||
| intelligent-ui-android.md | ||
| logo.svg | ||
| network.md | ||
| official-menu-icons.md | ||
README.md
DSH Remote 文档
当前仓库边界
本仓库只实现以下内容:
- DeepSeek Harness Plugin(常驻 Host + 本地 Remote 工作区入口,无用户可见的 Client 模式)
- Android Client(账号授权 + Adaptive transport + Typert Remote 数据面 + 可选 Codex Remote)
- VS Code Client(账号授权 + Host 信任固定 + rc.2 ApiProxy / v0.1.2 Typert Remote 会话/Prompt)
- Browser Chrome/Edge MV3 入口(独立设备凭据、在线 Host 列表、打开 Remote Web)
protocol、crypto、webrtc、client-core等共享包- 已冻结的 Mock Host 互操作工具
本仓库另提供 最小自部署 Server:单账号环境变量鉴权、设备注册与凭据、Control/Relay,以及登录和设备状态页。
完整多账号 Server、Remote Web 会话 UI 和 Admin 仍在独立 Server 项目实现;这里的最小版本复用相同协议子集,保持独立进程,不扩展为完整站点。
权威文档
- Server 设计说明:定义外部 Server 的职责、API、安全边界、数据模型和部署要求;完整站点设计;最小自部署子集见上述运行文档。
- Host Plugin 接入指南:定义账号登录、Host 授权注册、设备凭证轮换、WebSocket 和本地状态隔离要求。
- Remote Protocol v1:定义 Host、Server、Client 的线协议,是本仓库 Plugin、Client 和共享协议包的实现依据。
- 产品与功能设计:当前产品、Plugin、共享能力和界面设计;线协议以 protocol.md 为准。
主题说明
- 开发任务与路线图:跟踪未完成的工作和验证边界。
- 更新记录:记录版本变更。
- 隐私说明:说明数据处理与隐私边界。
- 插件安装指南(English):已有 Harness 插件安装、Desktop 插件管理、profile 选择与插件卸载。
- Codex Remote 技术说明:说明 Codex 工作区展示、数据边界、配置、安全限制和当前验证状态。
- Agent 工作区接入指南:启用 Cursor / AGY / Pi / OpenCode / Claude / Codex,以及新增 ACP adapter 的接入点。
- ACP Remote / Agent adapters:说明 Agent ACP gateway、后端 adapter、allowlist 与配置。
- 端到端加密:解释 Noise IK、设备身份固定、密钥生命周期、Server 可见元数据、重放保护与安全边界。
- 网络与传输:解释出站连接、Control/Data plane、LAN/P2P/TURN/Relay 选路、NAT、降级、断线恢复与当前验证状态。
- 版本兼容说明(English):记录 Plugin 与各版本 DeepSeek Harness 的 carrier、Session 和 Desktop 兼容范围。
历史资料
以下仅用于追溯,不作为当前任务指令、兼容承诺或验收基线:
- 原始需求。
阅读路径
- 项目介绍与快速开始:默认入口为English README,中文版见中文 README。
- 在终端中使用 Remote:当前版本只提供独立 CLI(
ds-harness-remote login|status|logout)与浏览器/Desktop Host;dsh-TUI 集成计划在后续版本单独提供。 - 安装或使用其他 Plugin 入口:先读根 README,再读插件包说明。
- 了解 Codex Remote 的实现边界:先读Codex Remote 技术说明,需要实现级字段时再查协议。
- 了解安全与网络边界:先读端到端加密和网络与传输,需要实现级字段时再查协议。
- 实现或审查 Plugin:读功能设计和Host 接入指南。
- 实现外部 Server:以协议为线协议权威,再参考Server 设计。
- 跟踪尚未完成的工作:读开发任务。
文档优先级:protocol.md 的线协议约束高于示例代码;Server 设计发生变化时必须同步检查协议兼容性和版本号。
2026-09-20 原生侧栏扩展:官方文件树/只读预览、默认开启且可在详细 Remote 设置中关闭的终端,以及受限 loopback HTTP/WebSocket 预览,配置与边界见根 README,线协议见 protocol.md。完整 Server 仍只转发密文,不代理预览 HTTP 明文。