← 返回列表
未验证
用 HTTP 接口远程操控会话，供其他代理调用
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/19 · 已提供中文文档
DeepSeek Harness 的本地 HTTP API：让其他智能体通过官方 ApiProxy 路由控制 DSH 会话。
综合分
27.9
GitHub 分
27.9
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add kelemiao/dsh-api该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/16（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-host-apiproxy@deepseek-ai/dsh-settings@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
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；远程绑定；多用户令牌。同作者（kelemiao）的其他插件
扫码进群