deepseekplugins

DeepSeek Harness 插件

dsh-api

Local HTTP API for DeepSeek Harness: expose DSH session control to other agents（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
kelemiao/dsh-api
最近更新
2026年8月19日
分类
工具与能力
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/kelemiao/dsh-api
插件名：dsh-api
作者：kelemiao

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-api

Local HTTP API for DeepSeek Harness (DSH). Other AI agents use it to control DSH through plain HTTP instead of the GUI.

Milestone one covers session control: list and create sessions, read history, send prompts, stream replies, and cancel turns. Everything else remains available through the raw /api/* passthrough.

Install

Install the plugin into a DSH web profile:

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

The package declares dsh.bundle.patch, so dsh plugin registers it in the profile's dsh.profile.bundles automatically. No manual cordis patch is needed. Once published, install from the registry with dsh plugin --profile web add @kelemiao/dsh-api.

Settings live in the GUI Settings page under dsh-api and apply immediately.

Settings

FieldTypeDefaultNotes
enabledbooltrueserver on/off
portint47771-65535, loopback only
tokensecretgenerated on first runfixed bearer token

Endpoints

MethodPathPurpose
GET/healthPublic health check.
GET/api/sessionsList sessions: { items: SessionSummary[] }.
POST/api/sessionsCreate session; body { cwd?, workspaceId?, agentPreset? }.
GET/api/sessions/:id/historyRead history; query beforeSeq?, maxMessages?.
POST/api/sessions/:id/promptSend prompt; body { content, mode? }.
POST/api/sessions/:id/cancelCancel the running turn.
GET/api/sessions/:id/streamSSE stream filtered to this session.
POST/api/*Raw official ApiProxy JSON RPC passthrough.
GET/api/events.muxRaw official aggregated SSE stream.

Convenience routes win over the passthrough; any other request whose path starts with /api/ is forwarded verbatim to the official ApiProxy transport.

Authentication

All routes except /health require Authorization: Bearer <token>. The server binds 127.0.0.1 only. Missing or wrong tokens get 401.

SSE

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

Frames are official MuxFrame objects, filtered by session id. A prompt whose single text block starts with / runs as a slash command, like the GUI.

Smoke test

With the plugin enabled in a running DSH:

DSH_API_TOKEN=<token> node scripts/smoke.mjs

DSH_API_URL defaults to http://127.0.0.1:4777.

Scope

Out of milestone one: ergonomic wrappers for approvals, subagents, goals, jobs, settings, credentials, and workspace mutation; TLS; remote bind; multi-user tokens.

返回搜索打开 GitHub 仓库

更多相关插件

查看分类