dsh-session-bridge

DSH PLUGIN工具与能力

仓库 elfgzp/dsh-session-bridge · npm dsh-session-bridge

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 提供会话桥接工具,让 DSH 代理创建前台会话、发送提示、读取结果并取消运行中的回合,还能获取本地 Web 应用地址。

一句话选型结论

按资料字段整理

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

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-02 创建于 2026-11-02
README 4.4 KB 正文体量,越大说明说明书写得越细

安装

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

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-session-bridge:让 DeepSeek Harness 的 agent 打开并驱动前台会话

  • 创建前台会话
  • 向会话发送提示
  • 读取会话记录
  • 取消运行中的回合
  • 获取本地 Web 地址

适用场景

智能体编排

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

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

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

逐项检查结果

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 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-bridge当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方elfgzp仓库 dsh-session-bridge · 默认分支 main
分类工具与能力automation
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-02 · 2026-11-02最后推送 2026-11-02
本站收录2026-11-05首次进入本站目录的时间

README 全文

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

dsh-session-bridge

Let a DeepSeek Harness agent open
foreground sessions, drive them, and read the result back — and hand out the
authenticated URL of the local web app.

Why

The Host already has everything needed: ctx.sessionController can create, prompt,
inspect and cancel a session, and ctx.connection.authenticatedUrl() returns the
web app URL carrying a launch token. None of it is reachable from a model tool.

Without this plugin, an agent that wants to verify something in a real foreground
session has to:

  1. dig a dsh-auth-* cookie out of Chromium's cookie store — and guess which one
    matches the current port, because the token encodes authority: 127.0.0.1:;
  2. reverse-engineer the /api/* RPC envelope and its _request argument shape;
  3. poke the DOM to get text into the composer, then read the rendered transcript.

Each of those is one tool call here.

Tools

Tool What it does
dsh_web_url The local web GUI URL. Masks the launch token by default; pass includeToken: true to get a browser-usable URL (requires the danger-full-access preset).
dsh_session_create Create a foreground session. Returns its id.
dsh_session_prompt Send a prompt to a session (queue or steer).
dsh_session_read Read a session's transcript. waitMs waits for the current turn to finish.
dsh_session_cancel Cancel a session's running turn.

Token handling in dsh_web_url

The launch token minted by connection.authenticatedUrl() is a live credential:
any browser that opens the URL gets an authenticated session. A tool result also
lands in the conversation transcript, and from there into logs, exports and any
copy of the chat.

So the default is maskToken: the tool returns origin plus a URL whose token is
reduced to its first and last four characters. Pass includeToken: true only when
something actually needs to open a browser, and do not persist or paste the result.

includeToken: true is gated on the caller's permission preset. The tool asks
the permissionPresets service for the calling session's preset
(current(session)) and resolves it to { sandbox, approval }. The plain token is
only handed out when sandbox === "danger-full-access"; every other preset gets
insufficient-permission plus the masked URL instead.

The gate fails closed. If permissionPresets is missing (older or headless
deployments), if current() returns custom that resolve() cannot handle, if
either call throws, or if execution.agent.session is unavailable, the answer is
"no token" — never "allow".

Tests

npm test        # node --test test/*.test.mjs

lib/format.js holds the pure functions (maskToken, clip, reasonLabel,
transcribe, waitForTurn); it imports nothing from the Host, so the suite runs
on plain Node 20 with no dependencies. test/web-url.test.mjs wires a fake ctx
through apply() to cover the permission gate, including all the fail-closed
paths.

Foreground vs delegated

This is the part that matters. A foreground session is a root agent: it has
the userQuestions service, so a plugin that needs human consent can actually
ask. A delegated task (a subagent, a workflow agent) does not, and gets:

APP_APPROVAL_UNAVAILABLE: Application approval is unavailable in delegated tasks; ask the main task to perform this operation

So plugins like dsh-cua-macos can only
be exercised end to end from a foreground session — which is exactly what these
tools create.

Install

dsh plugin --profile  add github:elfgzp/dsh-session-bridge

Restart DSH afterwards. The plugin has no dependencies.

Example

你手上有一个只能在前台会话里验证的功能。请:
1. 用 dsh_session_create 建一个会话
2. 用 dsh_session_prompt 让它做那件事
3. 用 dsh_session_read(waitMs=120000)把结果读回来

Notes

  • dsh_session_read truncates long text and returns at most maxMessages
    messages (default 40). Read a long session in pieces.
  • The transcript includes tool calls and their results, so a session that used
    other tools is still auditable from here.
  • dsh_web_url needs the webApp service; a headless deployment has none and
    the tool says so instead of failing.

License

MIT — see LICENSE.

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:elfgzp/dsh-session-bridge` 即可。对应的 npm 包名是 `dsh-session-bridge`。

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

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

dsh-session-bridge 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

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

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

dsh-session-bridge 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-session-bridge 用的是什么许可证?

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

dsh-session-bridge 有哪些功能?

创建前台会话、向会话发送提示、读取会话记录、取消运行中的回合、获取本地 Web 地址。

这条记录的数据可靠吗?

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

同名或近似条目

7 条
不同作者的仓库分开列,请确认你要装的是哪一个
工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

elfgzp 的其它插件

6 个

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