dsh-session-bridge

DSH PLUGIN会话与消息

仓库 Stxr/dsh-session-bridge

会话与消息 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

DSH 会话跳转桥插件让本机应用通过本机 HTTP 协议精确打开 DeepSeek Harness 桌面应用中的指定会话,并在历史加载、主窗口选中目标后返回确认回执。

一句话选型结论

按资料字段整理

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

分类会话与消息 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 未标注
最近更新 2026-11-09 创建于 2026-11-06
README 8.1 KB 正文体量,越大说明说明书写得越细

安装

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

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-session-bridge:让 DeepSeek Harness 桌面应用精确跳转到指定会话

  • 本机应用精确跳转指定会话
  • 历史加载后返回 opened 回执
  • 独立令牌鉴权与实例发现
  • 状态查询与错误状态码
  • 仅 desktop profile 生效

适用场景

通知

上游标签

cordisdeepseek-harnessdesktop-integrationdsh-pluginhuantaisession-navigation

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(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 启动就绪 插件目录树加载失败
  • L5.3_HTTP_SERVED HTTP 服务响应

风险详情

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

选择建议

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

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-bridge当前 L4 · 沙盒安装通过 低风险 0 未标注 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

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

README 全文

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

DSH session bridge

让本机应用精确打开 DeepSeek Harness 桌面应用中的指定会话,并确认目标历史已加载、主窗口已选中目标。插件同时包含 Cordis Host 与 Client 两侧,兼容并已在 DSH 0.2.2-rc.1 验证。

A reusable local session navigation bridge for DeepSeek Harness. External desktop applications can request an exact conversation and receive a confirmed result after its history loads.

换台 Huantai 是一个调用方。其他本机应用可直接接入下面的 HTTP 协议,不需要安装换台,也无需修改 DSH 应用包或模拟鼠标点击。

让 AI 安装

在 DSH 桌面应用中,把这句话发给 AI:

请帮我安装 DSH 会话跳转桥:先阅读 https://github.com/Stxr/dsh-session-bridge 的 README,再用 plugin_manager 将推荐的 Git 版本安装到 desktop profile,按返回结果处理重启并检查桥接是否就绪。

当前推荐 v0.1.1,包名为 @stxr/dsh-session-bridge,仅兼容 0.2.2-rc.1。DSH Agent 可以安装 Git 标签:

{"action":"install_bundle","target":"git+https://github.com/Stxr/dsh-session-bridge.git#v0.1.1"}

开发时也可克隆本仓库,再将实际绝对目录传给 plugin_manager。目录安装会链接仓库中的运行产物,须保留该目录;修改 TypeScript 后先运行 pnpm build。不要在 profile 中手改依赖或配置来代替插件管理器。

插件只在 desktop profile 提供桥接;安装到 web profile 不会启用桌面跳转。根据插件管理器返回的 application、warnings 和 nextStep 判断是否立即生效,若提示重启则重启官方桌面应用,不绕过版本检查。升级已经加载的代码时也应按返回指引处理。

从最初换台仓库中的开发包迁移时,先通过插件管理器移除 @huantai/dsh-session-bridge,再安装本包,避免两个包同时注册同一桥接路由。v1 协议地址保持兼容,换台无须修改协议。

检查安装

安装后,DSH 数据根目录中会出现 huantai-bridge/desktop.json:发现目录权限为0700,文件权限为0600。使用该文件内的独立令牌请求其 endpoint 同源的 GET /huantai/session-bridge/v1/status,ready: true 表示桌面消费者已连接。

实际成功必须以单次打开请求的 opened 回执为准。使用换台时,DSH 数据根目录应与换台来源设置一致,默认 ~/.dsh;打开一个普通会话即可验收。其他应用可按下一节接入。

本插件不会自行启动 DSH 或把系统窗口置前。调用方应先唤起官方桌面应用,再在截止时间内重试发现和请求。

本机桥接协议 v1

发现记录为 /huantai-bridge/desktop.json,其目录名及 HTTP 路径保留早期换台集成的 v1 命名,任何本机客户端都能使用。数据根通过桌面启动器的 profileContext 获取;双方使用同一个规范化绝对路径。

每次插件启动生成新实例 ID 和独立随机令牌,通过临时文件原子替换发现记录,卸载时只移除本实例的记录。不读取 DSH Cookie 或账号凭据。

记录字段:protocolVersion:1、instanceId、pid、profile:"desktop"、dataDir、endpoint、token 和 Unix 毫秒时间戳 startedAt。endpoint 使用 DSH 自有 WebServer 的动态端口,固定路径为 /huantai/session-bridge/v1/open,只接受 http://127.0.0.1:<端口>。不要硬编码 DSH GUI 端口。

向 endpoint 发送 POST application/json,使用 Authorization: Bearer:

{
"protocolVersion": 1,
"instanceId": "发现记录中的实例 ID",
"requestId": "本次打开操作的 UUID",
"sessionId": "目标会话 ID",
"dataDir": "/Users/example/.dsh",
"expiresAt": 0
}

实际 expiresAt 应为不超过未来15秒的 Unix 毫秒时间戳,不能使用示例中的0。sessionId、requestId 仅允许1至128个字母、数字、下划线或连字符。重试保持原始全部字段和请求 ID。

响应包含 protocolVersion、requestId、sessionId 和 status。调用方应核对身份字段;仅 opened 表示成功。

状态 含义
opened 历史已加载,桌面主窗口已选中目标
not-ready 桌面页面尚未连接;截止时间前可重试
not-found 当前实例中不存在目标会话
archived 需要用户先在 DSH 中恢复
unsupported-target 初版不支持子会话
load-failed 历史无法打开或格式不兼容
instance-mismatch 实例 ID 或来源数据目录不匹配
superseded 请求被后来的跳转取代
timeout 已到期,后续不再导航
invalid-request 参数、协议或重复请求内容不合法

成功与业务失败一般返回 HTTP200;not-ready 返回503,invalid-request 返回400,instance-mismatch 返回409。缺少或不匹配的令牌返回401。

每个请求只有一个桌面消费者;普通浏览器页面和嵌入帧不参与。Client 加载历史后再次校验请求有效性和归档状态,取消尚未完成的工作区恢复,通过 uiWorkspace.openSession 导航,并核对 mainView 保留和目标 ID 后回执。队列只保留最新跳转,已完成结果短期保留供去重,重启不重放请求。

同样使用本机令牌请求 GET /huantai/session-bridge/v1/status 可查看就绪状态、消费者最近报告的选择及最后结果;诊断状态不能替代单次回执。外部路由限制来源 IP、Host、Origin、请求体和读取时限,不开放 CORS。

内部 Client 使用公开 connection.rpc.call 的 JSON 信封。针对0.2.2-rc.1的 Host connection.rpc.handle 注入问题,Host 在自有路由适配同一信封,通过 connection.admit 认证 DSH 页面;独立令牌只供外部本机入口使用。所有路由由 Cordis effect 管理。

被发现与安装

本仓库使用 GitHub dsh-plugin topic,并提供符合官方格式的插件索引。DSH 不内置公共索引源:用户可以在“插件 → 自定义插件索引 → 发现”中添加该 URL,再从卡片安装指定 Git 提交。无需发布到 npm。

第三方市场对 GitHub 话题的收录与 DSH 官方索引机制不同;部分市场默认安装到 web profile,本插件必须安装到 desktop profile。来源、规则和维护方式见发现规则。

开发与验证

维护源码为严格 TypeScript:Host 入口、Client 入口。协议、鉴权、桥接状态、发现文件、HTTP/RPC 和桌面导航分别位于独立模块,职责见架构说明。

开发使用 Node.js 24、pnpm 10.17.1;锁文件固定构建依赖。没有第三方运行依赖,也没有 prepare / postinstall 等安装脚本。仓库提交 lib/ 中的 JS 和类型声明,Git、目录和打包安装直接读取编译产物,安装方无需下载 TypeScript 或自行编译。

pnpm install --frozen-lockfile
pnpm typecheck  # strict、noEmit
pnpm build      # 编译 Host / ModuleLoader Client,并生成类型声明
pnpm check      # strict 检查,重新构建后运行全部测试
pnpm pack --out pack.tgz

20项自动测试保留原15项行为断言,并补充同伴身份/投递令牌绑定、替代实例发现记录、嵌入帧/欢迎页隔离、桌面 index.html 入口和安装产物检查。测试直接加载本次编译的 lib/,不以测试替身代替实际 ModuleLoader 包装;CI 同时检查重建后提交产物无差异。

本次 TS 迁移完成自动化验证,未在真实桌面重新安装验收。2026-11-07 的旧版桌面验证曾通过换台 CLI 打开并恢复普通会话;历史记录与本次范围分别列于验证记录。

图标为原创 SVG,包内提供中英文标题和说明。初版不支持子会话,归档会话需先恢复;冷启动、最小化和隐藏窗口恢复尚未逐项人工验收。普通 dsh://open 仅用于唤起应用,本插件不扩展桌面主进程的系统深链接分发。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:Stxr/dsh-session-bridge#v0.1.1` 即可。

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

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-session-bridge 安全吗?

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

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

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

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

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

dsh-session-bridge 有哪些功能?

本机应用精确跳转指定会话、历史加载后返回 opened 回执、独立令牌鉴权与实例发现、状态查询与错误状态码、仅 desktop profile 生效。

这条记录的数据可靠吗?

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

同名或近似条目

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

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

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

deeptide

deeptide

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

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

Stxr 的其它插件

2 个

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