dsh2server
DeepSeek Harness 插件：通过固定的 HTTP + WebSocket API 将本地 dsh 实例向外连接到中央中继服务器，流式传输实时工作状态和工作区/会话状态，并接受远程控制操作。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:23J1633/dsh2server#7cfaedba5d7a55d552be650091e19fc16f1b6e772server 以 dsh2server 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把本机的 DeepSeek Harness（dsh） 连接到一台中转服务器：服务器上能看到这台机器的实时工作状态、全部工作目录和会话活动，并能对它下发操作（新命令、中断、暂停/恢复、审批应答、任务终止、会话管理）。
a2sk_ 设备 key；独立使用时仍可生成原有 dshk_ key。服务器可按设备整体配对和吊销。http:// 与 https:// 同等支持，并且可以同时连多个端点：例如内网一台 http:// 中转给本地控制台用，公网一台 https:// 供远程访问。每条连接互相独立，一个端点掉线不影响其它端点。fetch / WebSocket。docs/API.md。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（
<device-id>:claude/:codex/:dsh），服务器端会把它们聚合为同一台设备，同时仍能单独选择具体 Agent。
与 A2Switch、cc2server、codex2server 一起使用时，不需要为 DSH 单独复制 key 或重复填写服务器。插件会在 DSH profile 没有显式设置对应字段时读取 A2S 共享配置：
| 系统 | 默认共享配置 |
|---|---|
| Windows | %APPDATA%\A2S\config.json |
| macOS | ~/Library/Application Support/A2S/config.json |
| Linux | ${XDG_CONFIG_HOME:-~/.config}/a2s/config.json |
它从中继承：
device.key：与 Claude、Codex 共用的设备 key；device.id：统一设备 ID；device.name：默认显示名；server.endpoints：统一服务器端点；agents.dsh.instanceId：默认是 <device-id>:dsh。agents.dsh.locale：插件语言，默认 system，自动识别运行电脑的语言。推荐流程：
# 1. 先在 A2Switch 中填写服务器并完成设备配对
# 2. 安装 DSH 插件（A2Switch 的一键安装也会执行这一步）
dsh plugin --profile web add D:\Project\A2S\dsh2server
# 3. 启动原有 DSH profile
dsh web
共享配置只填补 DSH profile 中缺失的字段，不会覆盖已经显式写入的 DSH 专用配置。优先级为：
DSH2SERVER_* 环境变量 / profile 显式值
＞ A2S 共享配置
＞ dsh2server 自身默认值
可用 A2S_CONFIG_PATH 或 A2S_CONFIG_DIR 改变共享配置位置；也可以在 profile 中设置 a2sConfigFile，给该 profile 固定一个配置文件。后者也用于便携式安装与测试隔离。
新的统一服务器基路径为 /a2s-api。server-api 同时保留 /dsh-api 别名，因此旧配置无需立即迁移。
dsh2server 0.1.1 起，插件会在 A2S 共享配置旁维护一个不含密钥的本地运行状态与控制通道：
runtime/dsh.json：插件版本、Harness PID、连接/暂停状态及最近一次控制结果；runtime/dsh-control.json：A2Switch 写入的一次性 start、stop 或 restart 指令。A2Switch 的“停止”只关闭到服务器的桥接链路并发送正常 bye，不会结束 DeepSeek Harness、Web UI 或本地会话；“启动”会恢复链路；“重启”会在同一个 Harness 进程内重建全部链路。控制文件受本机配置目录权限保护，且不保存设备 key。
# ① 装进某个 dsh profile（本例用 web）
dsh plugin --profile web add /path/to/dsh2server
# ② 在该 profile 的 cordis.patch.yml 里把 endpoint 填成你的服务器地址
# （或者直接改 bundle 自带的那一行；也可以设置环境变量 DSH2SERVER_ENDPOINT）
# endpoint: 'https://example.com/dsh-api'
# ③ 启动，日志里会打印本机专属 key
dsh web
# [dsh2server] instance key: dshk_xxxxxxxxxxxxxxxxxxxx ← 复制它
# ④ 把这个 key 登记到你的服务器（示例用本仓库的参考实现）
curl -X POST https://example.com/dsh-api/keys \
-H 'content-type: application/json' \
-H 'x-admin-key: <管理密钥>' \
-d '{"key":"dshk_xxxxxxxxxxxxxxxxxxxx","label":"我的笔记本"}'
登记完成后（最多 60 秒内）机器就会上线。用本仓库的参考服务器可以立刻验证：
node examples/server.js --port 8787 --keys ./examples/keys.json
# 然后在插件里把 endpoint 填成 http://127.0.0.1:8787/dsh-api
curl http://127.0.0.1:8787/dsh-api/instances # 看在线机器
它是一个标准的 dsh bundle（package.json 里声明 dsh.bundle.patch），因此用 dsh 自带的插件管理安装即可：
# 从本地目录安装（开发时最方便；pnpm 会做 link）
dsh plugin --profile <name> add /path/to/dsh2server
# 从 GitHub 安装（需要 Node 侧允许该包的构建脚本；本包无需构建，因此不会被拦）
dsh plugin --profile <name> add github:<you>/dsh2server
# 从 tarball 安装
pnpm pack && dsh plugin --profile <name> add ./dsh2server-1.0.0.tgz
安装后：
dsh plugin --profile <name> list # 确认已加入 dsh.profile.bundles
dsh --profile <name> --dump-config # 能看到 "# == dsh2server" 这一层
卸载：
dsh plugin --profile <name> remove dsh2server
dsh plugin add）在 profile 目录（$DSH_HOME/profiles/<name>）里：
cordis.patch.yml 追加：
- insert:
- id: dsh2server
name: 'dsh2server'
config:
endpoint: 'https://example.com/dsh-api'
package.json 里加上依赖与 bundle 列表：
{
"dependencies": { "dsh2server": "link:/path/to/dsh2server" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "dsh2server"] } }
}
在 profile 目录执行 pnpm install。
endpoint: 'https://example.com/dsh-api'
endpoint 是服务器 API 的基地址。插件由它推导出 …/ws、…/events、…/inbox（规则见 docs/API.md §2.1）。
它接受单个 URL、URL 列表或逗号分隔字符串，并且每个 URL 的协议（http / https）可以任意混用：
# 单个端点（最常见）
endpoint: 'https://example.com/dsh-api'
# 多个端点：内网 + 公网同时在线
endpoint:
- 'https://example.com/dsh-api' # 公网可达
- 'http://10.0.0.5:8787/dsh-api' # 局域网内的中转，给本机控制台用
同一个实例对每个端点使用同一把 key，多个服务器看到的是同一个 instanceId 和同一套事件序号；每条连接各自独立重连、独立订阅，一个端点不可达或被吊销都不会影响其它端点。
空着不填时，插件保持加载但完全空闲，不会发任何网络请求，并在日志里提示如何配置。也可以用环境变量代替：
DSH2SERVER_ENDPOINT=https://example.com/dsh-api # 或用逗号分隔多个
DSH2SERVER_KEY=<可选：固定 key，不落盘>
http:// 时插件会在启动日志里明确告警（key 与全部会话流量都是明文），并在 instance.info 的 connection.insecure 中持续标记。NODE_EXTRA_CA_CERTS=/path/to/ca.pem（推荐做法）。NODE_TLS_REJECT_UNAUTHORIZED=0。transport 固定为 'http'。完整列表（含默认值）见 cordis.patch.yml。最常改的几个：
| 配置 | 默认 | 说明 |
|---|---|---|
key | '' | 留空 = 自动生成并保存在本机；填写 = 使用该 key 且不落盘 |
keyFile | '' | 身份文件路径，默认 <DSH_HOME>/dsh2server/identity.json |
a2sConfigFile | '' | 可选的 A2S 共享配置文件；留空使用系统默认位置 |
deviceId | '' | 设备聚合 ID；A2S 模式通常自动继承，不需要手填 |
authMode | hello | key 的传递方式：hello / header / query |
transport | auto | auto（先 WebSocket 再回退 HTTP）/ ws / http |
locale | system | 插件设置页与插件状态语言：system / zh-CN / en-US |
autoSubscribeSessions | running | 自动推送哪些会话的逐条事件：none / running / all |
forwardApprovals | false | 是否把工具调用审批转发到服务器等待远程批准 |
forwardQuestions | true | 是否把结构化提问转发到服务器；关闭后远程会话遇到提问只能回本机处理 |
allowRemotePrompt | true | 是否允许远程下发新命令 |
allowRemoteControl | true | 是否允许远程中断/暂停/切策略/轮换 key（同时管着权限预设的切换与插件配置的写入） |
allowRemoteCommand | true | 是否允许远程执行斜杠命令（如 /compact） |
allowedCwdPrefixes | [] | 非空时，只有工作目录匹配这些前缀的会话才可见/可控 |
logLevel | info | silent / error / warn / info / debug |
配置错误会在加载阶段直接失败，并给出精确到字段的错误信息（例如
transport: must be one of auto | ws | http）。
装好之后，dsh 的网页界面里会自动多出一个标签页：
设置 → 插件 → dsh2server
它提供：
| 区域 | 能做什么 |
|---|---|
| 服务器 API 端点 | 独立端点列表，每个 URL 可单独添加、编辑或移除（http / https 可混用）。保存后立即生效，无需重启 dsh |
| 传输方式 | auto / ws / http 下拉（PHP 后端选 http） |
| 插件语言 | 自动跟随系统 / 简体中文 / English；保存后立即生效，也可由 A2Switch 统一配置 |
| 本机实例 Key | 指纹展示、显示 完整 key、复制 Key 一键复制、复制登记命令（生成可直接执行的 curl）、轮换 Key |
| 连接状态 | 每条链路的实时状态（已连接 / 未连接 / 被拒绝）与拒绝原因 |
| 远程权限 | allowRemotePrompt / allowRemoteControl / forwardApprovals 开关 |
语言设置只影响 dsh2server 自己的配置页、提示和上报元数据，不会翻译 DSH 会话正文。显式选择会写入网页设置层；选择“自动跟随系统”时使用浏览器/运行电脑语言。网页层没有显式覆盖时，profile 中的 zh-CN / en-US 可固定语言；profile 为默认 system 时则继续采用 A2Switch 写入的 agents.dsh.locale。
标签页是这个包自带的前端半边，不是对 dsh 的改动：
package.json 里声明了 dsh.client（exports["./client"] → lib/client.js），dsh 的客户端模块系统会自动扫描已启用的 Loader 条目，把每个声明了 dsh.client 的包的浏览器产物送到页面；settings.plugins.tab 里注册一行（和内置的「插件配置」标签用的是同一个扩展点），并自带样式与数据获取；/api/dsh2server/* 路由取得——因此天然带有 dsh 的 Host/Origin 校验与浏览器会话认证。结论：任何人 dsh plugin add dsh2server 之后，打开网页就能看到这个标签页，不需要改 dsh、不需要额外步骤，也不需要作者本机有什么特殊配置。前端产物零外部依赖（只用 shell 平台表里的 react，所以连 dsh.client.external 都不用声明，不会因为别人组合里缺某个插件而失败）。
网页里改过的项写入 <DSH_HOME>/dsh2server/config.json，它逐键覆盖 cordis.yml 里的同名项：
schema 默认值 < cordis.yml 的 loader 行 < config.json（网页设置）
点「恢复配置文件的值」会把该键从网页层删掉，重新继承 cordis.yml 的值。标签页上带「·由网页设置」标记的字段就是被覆盖的项。
key、allowedCwdPrefixes这类部署级/安全级配置不在网页可编辑范围内，仍然只由cordis.yml决定。
首次启动时插件用 CSPRNG 生成 dshk_ + 43 字符（256 bit 熵）的唯一 key。
key 保存在本机 <DSH_HOME>/dsh2server/identity.json（0600），不会上传到服务器。
启动日志里会打印一次完整 key；也可以随时用脚本读取：
node scripts/show-key.js # 人读格式
node scripts/show-key.js --json # 机器可读
服务器维护"key → 机器"的映射（示例 examples/keys.json）：
{
"keys": [
{ "key": "dshk_AAAA…", "label": "办公室台式机" },
{ "key": "dshk_BBBB…", "label": "笔记本" }
]
}
语义：
instance.rotateKey，把返回的新 key 登记进白名单、删掉旧 key。dshk_AbCdEf…9xYz），不要把完整 key 回显到界面。① dsh 启动 → 日志打印 key（或 node scripts/show-key.js 读取）
② 把 key 登记进服务器白名单
③ 机器自动上线（GET /instances 可见）
机器离线后再上线不需要重新配对——key 是持久的。
后端需要实现的一切都在 docs/API.md：
session/event、session/status、session/assistant-stream …）本仓库还提供一个零依赖、可直接运行的参考实现（同时被测试用作真实服务端）：
# 只用 HTTP
node examples/server.js --port 8787 --keys ./examples/keys.json
# HTTP 与 HTTPS 同时监听（同一份 key 白名单、同一份实例表）
node examples/server.js --port 8787 --tls-port 8443 \
--tls-cert ./cert.pem --tls-key ./key.pem --keys ./examples/keys.json
它实现了 WebSocket + HTTP 长轮询两种载体、HTTP 与 HTTPS 双监听、多 key 白名单、内存事件环、以及一组管理接口：
GET /dsh-api/instances 在线机器
GET /dsh-api/instances/:id/events 最近事件（仅内存）
POST /dsh-api/instances/:id/request 下发任意操作
POST /dsh-api/instances/:id/subscribe 调整订阅
GET /dsh-api/keys / POST /dsh-api/keys 查看 / 登记 key
POST /dsh-api/keys/remove 吊销 key
不想装 Node 也可以直接用 PHP：php/dsh-relay.php 是一个单文件、零依赖的中转服务器，
并且自带一个完整的网页调试台——配对、看在线机器、拉会话与工作目录、下发命令、中断/暂停/恢复、
任务与目标、审批应答、事件流实时刷新，以及"一键自检"逐条验收整条链路。
php -S 127.0.0.1:8080 php/dsh-relay.php # Windows: D:\xampp\php\php.exe -S 127.0.0.1:8080 php/dsh-relay.php
# 然后浏览器打开 http://127.0.0.1:8080/
插件侧配置：
endpoint: 'http://127.0.0.1:8080/dsh-api'
transport: 'http' # PHP 无法升级 WebSocket；写 auto 也会自动回退到 HTTP 长轮询
PHP 的
php -S与 mod_php 都无法把 HTTP 请求升级为 WebSocket，因此该实现走协议允许的 HTTP 长轮询载体——功能与 WebSocket 完全一致，只是延迟略高。需要真正的 WebSocket 时用 Node 参考实现或 Workerman / Ratchet / Swoole。
细节见 php/README.md。
dsh-api/ 是本仓库自带的 DSH 专用控制台——它只认 DSH 一种 Agent。它既是协议的另一份中转实现（WebSocket + HTTP 长轮询，依赖 ws 与 marked），也自带一个复刻 dsh 本地界面的图形控制台：左侧机器与会话列表、中间对话流与工具调用、右侧状态栏，外加独立的轨迹页，并把本机 dsh 的扩展能力位一路透传到界面。想直接拿一个能用的"云端运维视角"界面、且只跑 DSH 时用它，不必自己从管理接口拼。
需要同时管 Claude Code、Codex 和 DSH，或用手机看，请改用通用控制台
server-api、A2Switch与a2s_app，见 A2S 生态。
cd dsh-api
npm install
npm start # 默认 :50443；证书路径在 dsh-api/lib/config.js，读不到则退回明文 HTTP
# 手边没有真实 dsh 时，用模拟器把每个面板的数据跑起来
npm run sim
npm run selftest # 端到端自检
运行期数据（key 白名单、管理密钥、归档索引、日志）落在 ~/.dsh-relay，可用 DSH_RELAY_DATA_DIR 改到别处；仓库里那份 .runtime-manual/ 就是这样一个手动指定的数据目录，已被 git 忽略。
本目录面向旧版单 Agent的独立部署与兼容性测试。A2S 正式部署请用
server-api——它支持 Claude / Codex / DSH 共用设备 key、统一设备聚合和多 Agent 控制台，并继续兼容/dsh-api路径。详见dsh-api/README.md。
session.list — 所有会话，带 cwd（工作目录）、running（是否在干活）、最后活动时间workspace.list — 这台机器上的全部工作目录及其会话session.get — 单个会话的详细状态：模型、待处理队列、待办清单（todos）、目标（goal）、审批策略、暂停状态session/status、session/activity、session/event、session/assistant-stream 事件流 —— 实时看到每一轮、每一步、每次工具调用和逐 token 输出job.list / job.read — 后台任务及其输出goal.get — 长期目标的阶段与轮次| 操作 | 方法 |
|---|---|
| 下发新命令 | session.prompt（mode: queue） |
| 给正在跑的那一轮追加指示 | session.prompt（mode: steer） |
| 中断当前执行（保留排队） | session.interrupt |
| 中止并丢弃排队 | session.cancel |
| 暂停运行 | session.pause |
| 恢复并放行暂停期间排队的命令 | session.resume |
| 新建会话（指定工作目录） | session.create |
| 读取历史 / 全文检索 | session.history / session.search |
| 改名 / 分叉 | session.rename / session.fork |
| 切换模型 | session.selectModel |
| 编辑/删除排队中的消息 | session.queueUpdate |
切换审批策略（ask / never） | session.approvalPolicy |
| 终止后台任务 | job.kill |
| 暂停/恢复/完成目标 | goal.pause / goal.resume / goal.complete |
| 执行斜杠命令 | command.run |
| 应答审批与提问 | approval.respond / question.answer |
| 读取/轮换本机 key | instance.key / instance.rotateKey |
"暂停运行"的实现语义（值得后端注意）：
session.prompt 被扣在插件内存里排队，返回 deferred: true；session.resume 时按顺序放行，并在 session/resumed 事件里报告 delivered 数量。排队上限由 pauseQueueLimit 控制；队满时返回 conflict（retryable: true），服务器应稍后重试。
在协议 v1 的方法之外，插件还实现了 PLUGIN-EXT 描述的八个扩展。
它们按能力位探测：实现了才出现在 hello.capabilities / instance.info.capabilities，
服务器据此点亮或隐藏对应界面。
| 能力位 | 方法 | 有什么用 |
|---|---|---|
sessionEvents | session.events | 原始事件窗口：真实日志序号与时间戳，够渲染轨迹视图、每轮用时、步数、tok/s、上下文环 |
messageFeedback | message.feedback | 助手消息的 👍 / 👎；读回时随 session.events 一起返回 |
permissionPresets | session.permission | 输入框左侧的「完全权限 / 工作区写 / 只读」三级预设 |
agentPresets | agentPreset.list / read / select / copy / delete | 与本地相同的 Agent 预设名单、会话选择及用户预设管理 |
attachments | attachment.put / attachment.get | 上传图片与文件，并在 session.prompt 的 content 里引用 |
workspaceMutation | workspace.create / rename / remove | 工作区的新建 / 改名 / 删除（只动登记关系，不碰磁盘） |
sessionArchive | session.archive | 通过 DSH 官方注册表归档会话（本地列表隐藏，日志保留） |
fileBrowser | workspace.fs.list / workspace.fs.read | 右侧栏「文件」面板，只读预览 |
pluginManagement | plugin.list / config / setConfig / setEnabled | 设置 → 插件：看清单、读配置表单、改配置、启停 |
还有两个不需要新方法的载荷增强：tool/call 事件带上模型写在参数里的意图描述
（data.description），turn/end 事件带上本轮文件改动（data.files）。
terminal 有意不实现。本 harness 的终端服务是按 Agent 拥有、面向行的交互模型，没有原始
字节流、没有 cols/rows 重排、也没有推送式输出，无法做成云端 xterm 需要的那种持久终端；
按扩展规范的说明，这种情况回退到现有 job.list + job.read 即可，服务器在缺少该能力位时会
自动改用 job 面板。
插件不强制依赖任何 dsh 服务：它用 ctx.get(...) 探测现有服务，并把真实可用的能力写进 hello.capabilities。因此最小组合也能连上并汇报状态，只是方法会少一些。
| 需要的能力 | 由谁提供 | 缺失时 |
|---|---|---|
| 会话/代理核心 | dsh-base（总是存在） | 插件仍会加载，但几乎无事可做 |
sessionController | dsh-web-app 组合（dsh web） | 会话列表退化为"仅活动会话"，且历史/搜索/改名/选模型不可用 |
sessionPersistence | dsh-base | 冷会话不可见 |
workspaceRegistry | web 组合 | workspace.list 退化为按 cwd 聚合 |
jobs / goals / commands | dsh-base | 对应方法返回 capability_unavailable |
approval | dsh-base | 审批策略不可远程切换 |
userQuestions | 通常由 UI 组合提供 | 远程回答提问不可用 |
日常使用 dsh web 时上述能力全部具备。
┌───────────────────────────── 本机 ─────────────────────────────┐
│ dsh 进程 │
│ ├─ agent / session / jobs / goal / approval / commands … │
│ └─ dsh2server 插件 │
│ ├─ lib/identity.js 本机唯一 key（本地持久化） │
│ ├─ lib/host.js 能力探测与宿主适配（可选服务降级） │
│ ├─ lib/forward.js dsh 事件 → 协议事件 │
│ ├─ lib/ops/* 入站方法 → dsh 操作 │
│ ├─ lib/gate.js 暂停/恢复的状态机与排队 │
│ ├─ lib/bridge.js 实例级共享状态（身份/序号/缓冲/方法） │
│ └─ lib/link.js + transport/* 每条端点一条独立链路 │
└───────┬──────────────────────────────────────┬─────────────────┘
│ 出站 wss:// (公网) │ 出站 ws:// (内网)
▼ ▼
https 中转服务器 http 中转服务器
（纯中转，可无状态） （纯中转，可无状态）
一条链路可以同时是 WebSocket 或 HTTP 长轮询，也可以是 TLS 或明文；每个端点各有一套，互不影响。
设计要点：
bufferSize 条事件，重连后按水位补发；补发窗口不够时会发 bridge/resync，服务器重新拉全量即可。dsh2server/
├── package.json # bundle 清单（dsh.bundle.patch）+ 浏览器半边声明（dsh.client）
├── cordis.patch.yml # 装载行 + 全部配置项与默认值
├── index.js # 插件入口（name / Config / apply）
├── lib/
│ ├── client.js # 浏览器半边：设置页里的 dsh2server 标签（手写 lazy-CJS 产物）
│ ├── host-ui.js # 网页控制台的宿主路由（/api/dsh2server/*，走 Connection 鉴权）
│ ├── settings-store.js # 配置分层与持久化（cordis.yml ← 网页设置）
│ ├── bridge.js # 实例级状态：身份、事件序号、环形缓冲、方法表
│ ├── link.js # 单端点连接：载体、订阅、心跳、退避（可多条并存）
│ ├── transport/ # WebSocket 与 HTTP 长轮询载体
│ ├── ops/ # 全部入站方法（含 session.events / attachment / permission / plugin）
│ ├── forward.js # 宿主事件转发（含审批/提问应答）
│ ├── host.js # 能力探测与宿主适配
│ ├── gate.js # 暂停/恢复状态机
│ ├── identity.js # 每机唯一 key
│ ├── protocol.js # 帧与错误码
│ ├── config.js # 配置校验（Standard Schema）
│ ├── buffer.js # 事件环形缓冲与补发
│ └── util.js / log.js / version.js
├── scripts/show-key.js # 打印本机 key
├── examples/ # 参考后端（Node，可运行）+ 极简 WebSocket 服务端
├── php/ # 参考后端（PHP 单文件）+ 内置网页测试台
├── dsh-api/ # DSH 专用控制台 + 中转实现（复刻 dsh 本地界面）
├── docs/API.md # ★ 服务器接口规范
└── test/ # 单元 + 端到端 + 多端点/双协议 + PHP + 真实 Cordis 集成测试
npm test # 全部测试（单元、扩展、端到端、多端点/双协议、PHP 后端、真实 Cordis 集成）
node --test test/unit.test.js
node --test test/extensions.test.js # PLUGIN-EXT 的八个扩展：方法契约、能力位、事件载荷
node --test test/e2e.test.js
node --test test/multi-endpoint.test.js
node --test test/php-relay.test.js # 找不到 PHP 时自动跳过（可用 PHP_BIN 指定）
测试覆盖：
Bridge 对真实参考服务器 —— key 握手、远程操作、事件流式转发、订阅/退订、HTTP 长轮询回退、断线重连、多机器多 key 管理、key 轮换与吊销/api/dsh2server/*——设置端点会真的把连接切到新服务器、非法写入被拒绝且不生效、重置回落到配置文件、轮换 key 会落盘；浏览器半边用带 Hook 调度器的最小 React 真实渲染并点击每个按钮php/dsh-relay.php —— 握手、管理接口请求/响应、下发命令、暂停闸门、事件转发、未知 key 的配对流程、内置测试台的 HTML 与前端脚本Context，验证 Standard Schema 配置在加载期生效、apply/ctx.effect 生命周期与卸载清理（找不到本机 dsh 安装时自动跳过）调试时把 logLevel 设为 debug，可以看到每次请求/响应的收发。
http:// 完整支持（内网/回环中转很常见），但会明文传输 key 与会话内容——插件启动时会告警，并在 connection.insecure 里持续标记，请自行确认网络可信。allowedCwdPrefixes 可以把远程操作限制在指定目录树内；allowRemotePrompt / allowRemoteCommand / allowRemoteControl 可以分级关闭。forwardApprovals 等于"服务器上的人可以批准本机的工具调用"，请确认服务器的可信边界后再开。Q：插件加载了但日志说 idle，怎么办？
没填 endpoint。填上服务器地址（或设置 DSH2SERVER_ENDPOINT）后重启 dsh。
Q：日志出现 "unknown instance key"，怎么修？
你的机器还没被服务器登记（或 key 被删了）。运行 node scripts/show-key.js 取 key，登记到服务器；插件会自己重连，不必重启 dsh。
Q：可以用 http 吗？公司内网没有证书。
可以。endpoint: 'http://10.0.0.5:8787/dsh-api' 直接就能用，插件只会在启动时告警一次。要更安全又不方便办证书，可以用 NODE_EXTRA_CA_CERTS 指定自建 CA，或直接去掉 TLS 而只在内网暴露。
Q：能同时连多个服务器吗？比如内网一个、公网一个。
能。endpoint 写成列表即可，http 和 https 可以混用。每条连接互相独立：断线、重连、订阅、补发都是分开的；而 instanceId、key 和事件序号是共享的，所以两台服务器看到的是同一台机器的同一份状态。
Q：key 文件丢了会怎样？
插件会生成新 key，服务器会把它当成一台新机器。用配置 key 显式固定 key（配合密钥管理系统）可以避免这种情况。
Q：怎么确认只连我自己的服务器？
插件只主动连出到你配置的 endpoint 列表，不监听任何端口，也不会连接其它地址。用 instance.info 可以看到 endpoints（配置值）、connections（每条链路的实时状态）与 transport。
Q：服务器需要开公网端口吗？ 需要，但那只是服务器自己的入站端口；你的电脑不需要任何入站端口，也不需要内网穿透。
Q：WebSocket 被公司代理拦了怎么办？
把 transport 固定为 'http'，插件会走 HTTP 长轮询，功能完全一致（延迟略高）。
Q：能同时管理多少台机器？ 没有上限——服务器侧就是一张 key 表，每台机器是独立的一条连接（或同时多条，如果它配了多个端点）。
代码采用 MIT License，见 LICENSE。DeepSeek 与 DeepSeek Harness 名称和相关图标属于各自权利人，本项目是独立的兼容插件。
dsh2server is a DeepSeek Harness plugin that connects a local DSH host to an A2S relay. The server can observe live status, workspaces, sessions, tools, approvals, questions, tasks, goals, and attachments, and can send prompts, interrupts, pause/resume, interaction responses, and other negotiated operations. DSH connects outbound, so the workstation needs no inbound port or tunnel.
dsh2server is one plugin in the A2S family. The family also ships a universal console and a mobile client. All of them share the same a2sk_ device key and the same protocol, so you can take any one of them on its own or together with this plugin:
| Repository | Role | Notes |
|---|---|---|
server-api | Universal console (web) | Unified server side — accepts Claude Code, Codex and DSH connections and serves a multi-Agent web console. Use this for a real deployment; the in-repo dsh-api/ is only for running DSH by itself |
A2Switch | Universal console (desktop) + plugin config routing | Electron desktop control center: one shared device config and key, local Agent detection, one-click install/update of all three plugins, and start/stop of the bridge processes |
a2s_app | Mobile client | Flutter Android client for checking machine status and sessions and sending remote operations from a phone |
cc2server | Claude Code bridge | Connects Claude Code to the A2S protocol |
codex2server | Codex bridge | Bridge built on the official Codex app-server |
dsh2server | This repository | The DeepSeek Harness plugin described here |
dsh-api/ (in this repo) | DSH-only console | Legacy single-Agent server plus console, kept for standalone DSH deployment and compatibility testing |
All three bridges share one device key but use distinct instance IDs (
<device-id>:claude/:codex/:dsh), so the server aggregates them into a single device while still letting you target a specific Agent.
The default registration target is web; set A2S_DSH_PROFILE before starting A2Switch to choose another profile. The equivalent manual command is:
dsh plugin --profile web add C:\path\to\dsh2server
dsh web
In unified mode the plugin reads missing endpoint, device key, device/instance identity, transport, and locale values from the shared A2Switch configuration. Explicit DSH environment/profile settings remain higher priority, so an existing specialized profile is not silently overwritten.
Install the local directory, GitHub source, or a tarball with dsh plugin --profile <name> add <source>. Configure at least an endpoint and instance/device key through the bundle patch, profile settings, or DSH2SERVER_* environment variables. For public service use HTTPS/WSS; the plugin can force HTTP long polling with transport: http when WebSocket upgrades are blocked.
The bundle contributes its own Harness settings page for endpoint(s), key, transport, language, reconnect/heartbeat behavior, approval forwarding, file limits, and optional capabilities. Simplified Chinese and English are available; system follows the browser/host locale. Saving settings redraws the page and reconnects when required.
Sensitive keys are masked in UI/log output. A2Switch shared settings only fill absent profile fields. Environment variables and explicit profile values win, followed by shared configuration and built-in defaults.
The plugin discovers the running Harness host and advertises only supported operations. Depending on host capabilities, the unified catalog includes:
The browser client bundle is injected through the DSH plugin extension points without modifying Harness core files. Missing host services produce an honest reduced capability catalog instead of fake success responses.
auto prefers WebSocket and falls back to HTTP long polling after retryable network/upgrade failures. Frames share protocol v1 across both carriers. Heartbeats, exponential reconnect with jitter, multiple endpoint failover, monotonic event sequences, bounded replay buffers, and runtime/control records allow A2Switch and the server to recover from transient loss without stopping Harness sessions.
A2Switch can stop/start/restart only the relay link through runtime/dsh-control.json; it does not kill the Harness host. Authentication and protocol errors are fatal until configuration changes, avoiding endless reconnect storms.
The device key authorizes this workstation and must not be committed. Approval forwarding is disabled by default because enabling it allows a remote server operator to approve local tool calls. Remote terminal is also disabled by default. File access remains within approved workspaces, payloads and terminal replay are bounded, and keys are excluded from runtime records and logs.
npm install
npm test
The suite covers bundle composition, configuration precedence, shared A2S settings, transports and multi-endpoint failover, replay, runtime control, host UI injection, sessions, workspaces, attachments, plugins, terminal behavior, archives, and end-to-end protocol flows. The zero-dependency Node reference relay lives in examples/; the PHP test backend lives in php/; dsh-api/ is the DSH-only console — a second relay implementation that also serves a graphical console mirroring the local dsh UI, kept for the legacy single-Agent standalone deployment and for compatibility testing.
MIT. DeepSeek and DeepSeek Harness names and marks remain owned by their respective rights holders. This is an independent compatibility plugin.