dsh-api

DSH PLUGIN浏览器与联网

仓库 lilming123/dsh-api

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

dsh-api 是 DeepSeek Harness 的 HTTP 控制面插件,通过 /dsh-api/* JSON 路由暴露设置、语言、工作区注册表及主机伴侣桥接,供本机进程统一驱动 dsh。

一句话选型结论

按资料字段整理

dsh-api 是浏览器与联网类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-08-19 创建于 2026-08-17
README 7.3 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:lilming123/dsh-api#v0.1.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 11 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 11 个版本版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-api:DeepSeek Harness 的 HTTP 控制面插件,统一管理语言、工作区与事件流

  • 暴露 /dsh-api JSON 路由
  • 管理语言与工作区
  • SSE 事件流推送
  • 桥接宿主伴侣进程

适用场景

存储文件读写

上游标签

deepseek-harnessdsh-pluginhttp-apisse

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度稳定按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 11 个),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-api当前 L5 · 运行验证通过 低风险 1 0.2.0-rc.2 等 11 个 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方lilming123仓库 dsh-api · 默认分支 main
分类浏览器与联网network
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-08-17 · 2026-08-19最后推送 2026-08-19
本站收录2026-08-21首次进入本站目录的时间

README 全文

7.3 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-api — HTTP control-plane plugin for DeepSeek Harness


dsh-api is a first-party plugin for DeepSeek Harness (dsh) that
exposes dsh's own internal capabilities on the loopback HTTP socket dsh is
already listening on. Any process on the same machine — a desktop wrapper,
a browser extension, a CLI, an editor integration — can drive dsh through
one uniform entry point, instead of reaching into its in-process services
directly.

  • Route prefix (default): /dsh-api
  • Binds only where dsh already binds (127.0.0.1)
  • Zero runtime dependencies beyond Node itself

Install

# From GitHub (any dsh profile):
dsh plugin --profile web add github:lilming123/dsh-api

# From npm (once published):
dsh plugin --profile web add dsh-api

dsh plugin is a thin pnpm wrapper. Both forms drop the package into
$DSH_HOME/profiles//node_modules/ and register dsh-api in the
profile's bundle list — the next dsh web picks it up automatically, no
--patch flag needed.

The desktop app dsh-desktop detects an already-installed
dsh-api and skips its bundled fallback; you only need to install this
plugin manually if you drive dsh directly.

Endpoints

Two layers, mounted under the same /dsh-api prefix:

1. Native (always available once the plugin is loaded)

Method Path Purpose
GET /dsh-api/health Liveness + basic identity (dsh port, cwd, companion?)
GET /dsh-api/language Read locale.preference
POST /dsh-api/language Write locale.preference ({ "language": "zh"\|"en" })
GET /dsh-api/workspace/list List every workspace known to workspaceRegistry
GET /dsh-api/workspace/current Current cwd + companion snapshot (if registered)
POST /dsh-api/workspace/create { path, title? } — register a new workspace entry
GET /dsh-api/events Server-Sent Events stream (see below)

2. Companion-bridged (needs a registered companion process)

A "companion" is any local process that writes
$DSH_HOME/dsh-api-companion.json with { port, token, pid, ... } and
serves the /companion/* protocol. These routes are 503 when no companion
is registered; the native routes above keep working regardless.

Method Path Purpose
GET /dsh-api/companion/state Companion state snapshot
POST /dsh-api/workspace/open Switch dsh cwd (restarts dsh under the companion)
POST /dsh-api/input/paste { text } — inject text into the dsh UI
POST /dsh-api/window/show Focus the host window
POST /dsh-api/window/reload Reload the host window
POST /dsh-api/app/quit Quit the host app

/dsh-api/events (Server-Sent Events)

Long-lived HTTP GET producing named SSE frames:

event: ready
data: {"timestamp":1730000000000}

event: agent-idle
data: {"sessionId":"…","title":"…","previousStatus":"running","timestamp":…}

event: approval-needed
data: {"sessionId":"…","kind":"…","summary":"…","timestamp":…}

event: heartbeat
data: {"timestamp":…}
  • agent-idle fires when any agent/status event transitions running → idle.
  • approval-needed is a read-only bypass of dsh's approval/request
    waterfall — the plugin observes the request, broadcasts a summary, and
    passes control back to the real answerer chain unchanged.
  • heartbeat is emitted every 25 seconds so proxies don't idle-kill the
    connection.
  • On dsh shutdown, subscribers receive a server-stopping event before the
    socket closes.

Security

  • dsh binds 127.0.0.1 only; this plugin reuses that socket.
  • Mutating requests validate Origin: no Origin header (CLI) and
    loopback origins are allowed; anything else is 403.
  • Companion-bridged routes forward the discovery-file token in
    x-dsh-api-companion-token; the companion is expected to reject
    mismatches.

Configuration

The plugin exposes two knobs, both settable in the loader entry's
config: { ... }:

Key Default Purpose
basePath /dsh-api HTTP route prefix
companionFile $DSH_HOME/dsh-api-companion.json Companion discovery file to read on demand

Example ($DSH_HOME/profiles/web/cordis.patch.yml):

- id: dsh-api
config:
basePath: /control

Development

dsh-api is a plain-ESM plugin — no build step. Clone the repo, drop the
file into a dsh profile, and start dsh with --patch:

git clone https://github.com/lilming123/dsh-api.git
cd dsh-api

# One-time: expose to a profile as a live-edit checkout
mkdir -p "$DSH_HOME/profiles/web/dsh-api-dev"
ln -sf "$PWD/index.mjs" "$DSH_HOME/profiles/web/dsh-api-dev/index.mjs"
cat > /tmp/dsh-api-dev.patch.yml <<'YML'
- insert:
- id: dsh-api-dev
name: ./dsh-api-dev/index.mjs
YML

dsh web --patch /tmp/dsh-api-dev.patch.yml --port 3181

# In another shell:
curl http://127.0.0.1:3181/dsh-api/health
curl -N http://127.0.0.1:3181/dsh-api/events

More runnable snippets live under examples/: curl.sh
walks every endpoint, and events.mjs is a dependency-free Node SSE
subscriber.

Troubleshooting

/dsh-api/* returns 404. The plugin isn't loaded. Check that
~/.dsh/profiles/web/package.json lists dsh-api under
dsh.profile.bundles, and that ~/.dsh/profiles/web/node_modules/dsh-api
exists. Re-run dsh plugin --profile web add dsh-api if either is
missing.

/dsh-api/workspace/create returns 503. workspaceRegistry
isn't in the current dsh context — either your dsh predates the service
or a profile patch has stripped it. Upgrade dsh (npm i -g @deepseek-ai/dsh)
and try again.

*/dsh-api/*/companion routes return 503.** No companion is registered. This is expected when you run dsh directly rather than through a wrapper like [dsh-desktop][dsh-desktop]; the native routes (/health,/language,/workspace/,/events`) work regardless.

SSE stream disconnects every ~60 seconds. A reverse proxy is
idle-killing the stream despite our 25-second heartbeat frames. Bump
its idle timeout, or drop the proxy — dsh-api binds to 127.0.0.1
and doesn't need one.

License

MIT © 2026 lilming123

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-api 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:lilming123/dsh-api#v0.1.0` 即可。

dsh-api 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-api 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-api 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-api 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-alpha.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2、0.1.3-alpha.2。版本较多,只列出前 8 个。

dsh-api 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-api 有哪些功能?

暴露 /dsh-api JSON 路由、管理语言与工作区、SSE 事件流推送、桥接宿主伴侣进程。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。