Dsh2server — Development skill for Claude Code

[中文](#中文) | [English](#english)

dsh2server

中文

把本机的 **DeepSeek Harness（dsh）** 连接到一台中转服务器：服务器上能看到这台机器的**实时工作状态、全部工作目录和会话活动**，并能对它下发操作（**新命令、中断、暂停/恢复、审批应答、任务终止、会话管理**）。

• dsh 主动连出，服务器不需要访问你的电脑，不需要端口映射，不需要内网穿透。
• 服务器不保存会话正文：只持久化机器白名单和控制台归档索引；会话内容仍由已连接的 dsh 提供。
• 每台机器一个统一 key：在 A2S 模式下自动读取与 Claude/Codex 相同的 a2sk_ 设备 key；独立使用时仍可生成原有 dshk_ key。服务器可按设备整体配对和吊销。
• http:// 与 https:// 同等支持，并且可以同时连多个端点：例如内网一台 http:// 中转给本地控制台用，公网一台 https:// 供远程访问。每条连接互相独立，一个端点掉线不影响其它端点。
• 零运行时依赖：纯 ESM JavaScript，无需构建，使用 Node 内置的 fetch / WebSocket。
• 一套固定 API：WebSocket 与 HTTP 长轮询两种载体共享同一套 JSON 帧，后端用任何语言/框架实现都可以。完整规范见 `docs/API.md`。

---

A2S 生态（同系列开源仓库）

dsh2server 只是 **A2S** 体系中的一个插件。同体系还有**通用控制台**与**手机端**——它们与本插件共用同一个 `a2sk_` 设备 key、同一套协议，可以单独取用，也可以和本插件一起用：

仓库	定位	说明
`server-api`	通用控制台（Web）	统一服务器端，同时接收 Claude Code、Codex 与 DSH 的连接，自带多 Agent Web 控制台。正式部署用它；只有单独跑 DSH、不接其它两个 Agent 时才需要本仓库内的 dsh-api/
`A2Switch`	通用控制台（桌面）+ 插件配置路由	Electron 桌面控制中心：维护跨桥接器共享的设备配置与 key、检测本机 Agent 环境、一键安装/更新三个插件、启动与停止桥接进程
`a2s_app`	手机控制端	Flutter Android 客户端，在手机上查看机器状态与会话活动、下发远程操作
`cc2server`	Claude Code 桥接器	把 Claude Code 接入 A2S 协议
`codex2server`	Codex 桥接器	基于官方 Codex app-server 的桥接器
`dsh2server`	本仓库	DeepSeek Harness 插件，也就是你正在读的这个
dsh-api/（本仓库内）	DSH 专用控制台	旧版单 Agent 的服务器 + 控制台，保留给 DSH 独立部署与兼容性测试。见 DSH 专用控制台（dsh-api）

三个桥接器用**同一个**设备 key、各自独立的实例 ID（`:claude` / `:codex` / `:dsh`），服务器端会把它们聚合为同一台设备，同时仍能单独选择具体 Agent。

---

目录

• A2S 生态（同系列开源仓库）
• A2S 统一模式
• 快速开始
• 安装
• 配置
• 图形化配置（dsh Web GUI）
• [实例 Key 与配对](#实例-key-