本地会话控制 API kelemiao/dsh-api

dsh-api

用于 DeepSeek Harness（DSH）的本地 HTTP API。其他 AI 代理通过它使用纯 HTTP 而非 GUI 来控制 DSH。

第一个里程碑涵盖会话控制：列出和创建会话、读取历史记录、发送提示词、流式接收回复以及取消回合。其他所有功能仍可通过原始的 /api/ 直通通道使用。

安装

将该插件安装到 DSH Web 配置文件中：

dsh plugin --profile web add link:C:/path/to/dsh-api

该包声明了 dsh.bundle.patch，因此 dsh plugin 会自动将其注册到配置文件的 dsh.profile.bundles 中。无需手动打 cordis 补丁。发布后，可使用 dsh plugin --profile web add @kelemiao/dsh-api 从注册表安装。

设置位于 GUI 设置页面的 dsh-api 下，并会立即生效。

设置

| 字段 | 类型 | 默认值 | 备注 |
| enabled | bool | true | 服务器开/关 |
| port | int | 4777 | 1-65535，仅限回环地址 |
| token | secret | 首次运行时生成 | 固定 bearer 令牌 |

端点

| 方法 | 路径 | 用途 |
| GET | /health | 公开健康检查。 |
| GET | /api/sessions | 列出会话：{ items: SessionSummary[] }。 |
| POST | /api/sessions | 创建会话；请求体 { cwd?, workspaceId?, agentPreset? }。 |
| GET | /api/sessions/:id/history | 读取历史记录；查询参数 beforeSeq?、maxMessages?。 |
| POST | /api/sessions/:id/prompt | 发送提示词；请求体 { content, mode? }。 |
| POST | /api/sessions/:id/cancel | 取消正在运行的回合。 |
| GET | /api/sessions/:id/stream | 过滤到该会话的 SSE 流。 |
| POST | /api/ | 原始官方 ApiProxy JSON RPC 直通。 |
| GET | /api/events.mux | 原始官方聚合 SSE 流。 |

便捷路由优先于直通通道；任何其他路径以 /api/ 开头的请求都会原样转发到官方 ApiProxy 传输层。

身份验证

除 /health 外的所有路由都需要 Authorization: Bearer 。服务器仅绑定 127.0.0.1。令牌缺失或错误会返回 401。

SSE

curl -N -H "Authorization: Bearer $DSH_API_TOKEN" \
http://127.0.0.1:4777/api/sessions//stream

帧是官方的 MuxFrame 对象，按会话 ID 过滤。单个文本块以 / 开头的提示词会作为斜杠命令运行，与 GUI 中一样。

冒烟测试

在运行中的 DSH 中启用该插件后：

DSH_API_TOKEN= node scripts/smoke.mjs

DSH_API_URL 默认为 http://127.0.0.1:4777。

范围里程碑一之外：用于审批、子代理、目标、作业、设置、凭据和工作区变更的人体工学封装；TLS；远程绑定；多用户令牌。