dsh-session-bridge

DSH PLUGIN记忆与知识

仓库 Dax233/dsh-session-bridge · npm @local/dsh-session-bridge

记忆与知识 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

dsh-session-bridge 让 DSH 中的当前 Agent 直接创建、驱动并读取其他真实会话,支持跨工作区全文检索与任务监控。

一句话选型结论

按资料字段整理

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

分类记忆与知识 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-06 创建于 2026-10-25
README 27.1 KB 正文体量,越大说明说明书写得越细

安装

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

    Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求>=20来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/dsh-agent@>=0.2.2-rc.1、@deepseek-ai/dsh-agent-preset-registry@>=0.2.2-rc.1 等 10 个需要同时安装的同级依赖
npm 包名@local/dsh-session-bridge可用 npm view 查看包信息

能做什么

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

dsh-session-bridge:让 DeepSeek Harness 的 agent 直接驱动其他会话

  • 创建并驱动其他真实会话
  • 向任意会话发送消息并等待回复
  • 读取在线或离线会话记录
  • 跨工作区全文检索会话
  • 监控、纠偏并归档主任务

上游标签

ai-agentdeepseek-harnessdsh-plugin

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-bridge当前 未做沙盒验证 未标注 0 未标注 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

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

README 全文

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

dsh-session-bridge — 会话桥(Session bridge)

> Fork 说明。 本仓库是 heartmove/dsh-session-bridge
> 的修改版(MIT,fork 自提交 4a20e32)。新增跨工作区正文检索工具 session_search_global
> 与 readOnlyTools 只读开关;当前 bundle 行未开启只读模式(注册全部工具),
> 把 readOnlyTools 置 true 可只保留只读工具子集。
> 出处与完整改动清单见 NOTICE,MIT 全文见 LICENSE。
>
> 从 GitHub 安装(本地检出用 link:/绝对路径/dsh-session-bridge):
> dsh plugin --profile add github:Dax233/dsh-session-bridge。
>
> 全文索引(fork): 本 bundle 的 patch 同时把宿主的 session-query-sqlite 行
> 改为 path: dshHomePath('session-search.db') + openAt: first-search,因此
> session_search_global 走索引而不是有界降级扫描;删除该 DB 文件后会自动重建。
> 修改这一行必须完整重启 DSH:热切换「patch 触碰核心 sessionQuery 服务」的 bundle,
> 可能让宿主卡在卸载阶段(实测出现过一次,恢复方式是完整重启,配置与代码均无损)。

适配 DSH 0.2.2-rc.1 及之后的版本:peerDependencies 与 package.json 的 engines.dsh 都只声明
下限(>=0.2.2-rc.1),不设上限。DSH 0.2.1-rc.1 起 engines.dsh 单独裁决(声明了就忽略
peerDependencies),所以两者逐字一致,当前实测于 0.2.2-rc.1。详见兼容性变更与
AGENTS.md(版本策略是硬性规则,有 pnpm test 守卫)。

一个 DSH 插件:让当前 agent 能通过提示词驱动其它真实的 DSH 会话——
创建主会话、向任意会话发消息、等待并读取回复、恢复离线会话、跨工作区按名称或 id 查找会话。
在此之上,它还能监控并调度一个主任务(观察进度、卡住时催办、偏离时纠偏、必要时终止),
以及像 DSH 侧边栏的 Archive 一样归档会话。

> English docs: README.md.

功能

  • 跨工作区全文检索会话正文。(本 fork 新增)session_search_global 直接查询宿主的
    sessionQuery 语料——该服务没有调用者工作区限制——因此可以找回写在其它项目会话里的
    决策与接口协议。默认每个会话返回一条最强命中(含 id / 标题 / cwd / live / 摘要);
    传 sessionId 则返回该会话内的命中事件。索引未开启时降级为有界日志扫描,结果标记
    degraded: true。
  • 创建真实 DSH 会话。 session_bridge_create 在当前工作区创建新的主会话(顶层 UI 会话),
    传 workspaceId / cwd 则跨工作区;可选发送首条 prompt 并阻塞等待首条回复。provider / model /
    reasoning effort 默认继承调用会话。异步创建(不带 waitForReply)会返回 sinceSeq 锚点,
    之后可用它精确地 session_bridge_wait 取回首条回复。
  • 向任意会话发消息。 session_bridge_send 追加一轮(mode=queue)或向运行中的步骤注入
    steering(mode=steer),可选等待下一条回复;异步发送同样返回 sinceSeq 锚点。
  • 等待回复或段落。 session_bridge_wait 阻塞直至 sinceSeq 之后出现新的 assistant 输出
    (默认 sinceSeq = 调用时刻的最新事件 seq):waitFor=reply(默认)在有新的文本回复可读时
    立即返回;waitFor=segment 在任意新已完成输出步骤出现时立即返回(一个 assistant/message
    ——文本、推理或工具调用段),无需等整个 turn 结束,从而可以按段落逐段观察输出。开
    requireTurnEnd 则同时等待回合收尾。超时 / 中止返回部分结果,而非抛错。
    回复早已落地也不会丢:预算内没等到新输出时,会返回预算前就存在的最新回复/段落并置
    stale: true(不会再出现 (no text))。要精确取回"某次发送之后的回复",把 session_bridge_send /
    session_bridge_create 异步返回的 sinceSeq 作为锚点传进来即可(与调用方延迟无关);
    sinceSeq: -1 表示"连既有事件也算",即新建会话的锚点。
  • 读取任意会话。 session_bridge_read 把会话事件日志折叠为可读行——live 或离线(持久化)均可;
    支持 sinceSeq 分页、role 过滤、limit(默认 20,最大 100)。
  • 按段落读取输出。 session_bridge_segments 返回会话的已完成输出段落——每个已完成的
    assistant 步骤(一个 assistant/message:其文本、推理与请求的工具调用)作为一行,用 sinceSeq
    增量翻页并返回下一游标。live 或离线均可用,无需等整个 turn 结束,因此可以逐步跟踪长 agentic
    任务(模型流式推理时,段落中一并包含思维链)。
  • 恢复离线会话。 session_bridge_resume 让持久化会话重新上线(幂等),可覆盖 provider / model。
  • 查找会话。 session_bridge_find 跨全部工作区按 标题 / id / workspace / 目录 匹配,返回
    live/running 状态、标题、工作目录;bridge 登记的标题作为别名参与匹配。
  • 监控并调度主任务。 session_bridge_status 读取会话实时进度(running/idle、是否 openTurn、
    距最近事件毫秒数做卡住检测、待处理消息、最新回复);只有 running 会话才会被标 [STALLED]
    (空闲会话没有进展是正常状态,与守护循环判定一致)。session_bridge_cancel 停止一个运行中的会话;
    session_bridge_monitor_start 运行一个后台守护循环,轮询任务、卡住时催办、偏离时纠偏、
    持续卡住则终止、完成即收尾;思维链陷入循环(如 写。好。Go。 反复)时自动中断原会话,
    并把任务(含子代理清单)转移到新会话继续做。
  • 归档 / 取消归档会话。 session_bridge_archive 把会话加入 DSH workspace 归档集合(从所有分组视图隐藏,
    历史与位置保留)——目标仍在跑时默认拒绝归档,传 stopActivity: true 则先归档再按官方路径停掉它的
    运行中工作(turn、子 agent、job、schedule);session_bridge_unarchive 把会话移出归档集合、回到原位
    置重新可见;session_bridge_archived 列出归档集合,可选解析标题——解析不出标题的会话
    只省略标题,不会让整个调用失败。归档集合会无限增长,因此 archive/unarchive 的结果只报
    受影响 id + 集合规模并摘要最新若干条,session_bridge_archived 支持可选 limit
    (默认 50、从最新往回取,total 始终是真实规模)。

监控守护循环

session_bridge_monitor_start 安装一个定时器驱动的循环。每轮对目标会话执行
「观察 → 判定 → 调度 → 落日志」:

判定 动作
回复命中 doneKeywords 且会话空闲 收尾并停止守护(日志 DONE)
空闲且无待处理 收尾(settled)——不无谓催办 / 取消
running 且距最近事件超过 stalledMs 记一次卡住 → steer 催办(开 useLlm 时先判 offtrack/stuck)
连续卡住 ≥ maxStuckCycles cancel 终止
正常推进 重置卡住计数(steady)
running 且思维链出现循环(默认开启) 创建新会话承接任务 → 中断原会话(转移,日志 LOOP-TRANSFER)
循环但转移预算用尽 / loopTransfer: false 只中断(日志 LOOP-CANCEL)
子代理思维链循环 取消该子代理 + steer 主会话重派(不转移)

守护只对 running 会话判定"卡住",因此已完成/空闲的任务会被收尾而非无限催办
(session_bridge_status 的 [STALLED] 标注同理,只对 running 会话显示)。日志写入
~/.dsh/super-injector/dsh-session-bridge-monitor.log(可用 logFile 覆盖)。

用 session_bridge_monitor_start / _stop / _list 控制。

思维链(CoT)监控与规则

会话桥可以实时监控另一个会话的思维链(chain-of-thought / reasoning),而不只等它的最终回复:

  • 实时观察:session_bridge_status 对运行中会话返回三块思维链字段——lastReasoning
    (最近一条已定型推理块)、liveReasoning(当前正在处理的 turn 的进行中推理,来自
    assistant/chunk 的 reasoning-delta 流)、reasoningTail(紧凑、受字符上限的合并预览)。
    用 reasoning 参数(none | last | live | tail)选择返回哪些字段,默认 tail 最省 token。
  • 按段落读取:session_bridge_segments 把每个已完成输出步骤(一个 assistant/message——文本、推理或工具调用段)当作一个段落返回,用 sinceSeq 增量翻页,无需等整个 turn。
  • 按消息读取:session_bridge_read 带 includeReasoning 可返回每条 assistant 消息的已定型推理。
  • 规则执行:session_bridge_monitor_start 接受 coRules(数组,元素为 { match:
    contains|not-contains, field: reasoning|text|both, value: string, action: steer|cancel,
    message?: string })与 cotMinHits。每次轮询守护用规则的匹配条件对照实时思维链/文本,
    连续命中 cotMinHits 次(默认 1)后触发动作:steer 注入引导性用户消息,cancel 终止会话。
    示例——"思维链一旦不再包含 I'm 就停止该会话":

coRules: [{ "match": "not-contains", "field": "reasoning", "value": "I'm", "action": "cancel" }]

注意:作用在 reasoning 上的 not-contains 规则在目标会话完全不产生推理时故意不触发
(如非推理模型或 reasoningEffort off),避免误 cancel 根本不流式思维链的会话。重复触发有冷却
节流,每次评估/触发都会写入监控日志。

思维链循环检测与任务转移

为什么不能靠「卡住」检测:循环会话每转一圈都产生新事件,「距最近事件毫秒数」始终很小,
stalledMs 永远到不了阈值——卡住判定对循环天然失明。所以循环必须由内容判定。

判定(src/loop-guard.ts,纯函数、无副作用、不依赖宿主):把思维链按 。!?;!?; 与换行切成
单元(标点保留在单元内,所以 写。 与 好。 是两个不同单元),在尾部窗口(1200 字符)
内找「同一小段周期重复」。实测判定:写。/好。/Go。 各 3 轮 → period=3 repeats=3 命中;
3 单元 × 2 轮 与 2 单元 × 2 轮 不命中(重复次数下限为 3);很长的正常推理不命中;
尾部循环不会被前面的长前缀掩盖;无标点的重复由字符 n-gram 兜底(kind=char)。

参数 默认 含义
loopGuard true 传 false 关闭循环检测
loopField reasoning 扫哪块:reasoning(实时思维链,优先 liveReasoning,无则回落 lastReasoning)/ text / both
loopMinCycles 2 至少重复几轮
loopMinRepeats 3 同一单元至少重复几次;生效下限是 max(loopMinCycles, loopMinRepeats)
loopMinConfidence 0.6 置信度阈值(按单元长度、覆盖轮数、周期长度加权)
loopMinHits 1 同一签名(字段+周期+单元)连续命中几次才动作
loopCooldownMs max(intervalMs*2, 30000) 同一签名的冷却,防抖动重复动作
loopMaxTransfers 3 最多转移几次(同时是转移深度上限)
loopTransfer true false = 只中断、不转移
loopAutoMonitor true 新会话是否自动纳入守护
loopDescendants report 子代理处置策略,见下表
loopHandoffPrompt 内置模板 自定义交接提示词,占位符 {{sessionId}} {{cwd}} {{reason}} {{task}} {{evidence}} {{descendants}}

命中后的动作(顺序不可颠倒):先在原工作目录创建新主会话并投递交接提示词,成功之后才中断原会话。
反过来(先停后建)一旦创建失败任务就没了;当前实现选择「创建失败 = 保持原监控、什么都不停」,
并按 max(intervalMs, 10s) 节流重试。交接提示词含原会话 id、任务指令、最近指令 / 最后回复 /
最后思维链摘要,以及子代理清单,并要求新会话用 session_bridge_read 自己读原会话日志
(不塞全文,省 token)。转移链会继承同一份转移记录,所以预算不会随新会话重置。

预算耗尽(loopMaxTransfers 或转移深度到顶)或 loopTransfer: false → 只中断(日志 LOOP-CANCEL)。
相关日志:LOOP-HIT / LOOP-TRANSFER / LOOP-TRANSFER-FAILED / LOOP-CANCEL /
LOOP-SUBAGENT-CANCEL / LOOP-SUBAGENT-NOTIFY。

子代理怎么处理

场景 处置 为什么
A. 主会话循环,子代理仍在正常跑 不取消,列进交接提示词(report,默认) 它们的活没白干;新会话被告知「不要重做」,可等结果或继续指挥
B. 主会话循环 + loopDescendants: 'stop' 转移之前逐个取消,并记入 stopped 你要的是干净交接、不留孤儿工作
C. 主会话循环 + loopDescendants: 'ignore' 不取消,也不写进交接 子代理与后续任务无关
D. 子代理循环(主会话正常) 取消该子代理 + steer 主会话重派,不转移 坏掉的是子任务不是主任务;主会话最清楚怎么重派
E. 子代理会话自己就是监控目标且循环 只取消,不转移 它的身份是子代理,另建顶层会话会打乱执行树;父会话收到通知

判定「谁是子代理」优先用宿主能力(agents.isOwnedBy / roots()),拿不到时回落到会话 header 的
origin === 'subagent' / parentSession,再拿不到就按顶层处理——只会少转移,不会乱转移。
转移链受 loopMaxTransfers 限制:转移过去又循环,最多再转移一次……直到预算用尽,之后只中断,
不会 A→B→C 无限接力。

开启与关闭(两种方式)

循环检测默认开启,总开关与全局默认值都放在插件配置里(profile patch 中本插件 entry 的 config),
所以下面两条路径改的是同一份值:

1. 斜杠命令 /cot-loop —— 在交互式 UI 里直接改,写回配置后立即生效(不需要重启或重载插件):

/cot-loop status                      # 当前开关、检测参数、设置页入口
/cot-loop off                         # 关闭思维链循环自动中断(全局)
/cot-loop on                          # 重新打开
/cot-loop field text                  # 只扫最终回复(默认扫思维链 reasoning)
/cot-loop descendants stop            # 转移前先停掉仍在运行的子代理
/cot-loop max-transfers 3             # 最多转移几次(0 = 只中断不转移)
/cot-loop help                        # 全部子命令

参数类改动从下一个 session_bridge_monitor_start 起生效;on / off 对已运行的守护立即生效
(守护每个 tick 都实时读 volatile 引用)。宿主没有 configEditor 服务(或写回失败)时,命令会退化成
本进程内存开关,并在回执里写明"仅本次运行有效"——不会假装持久化成功。

2. 设置页开关 —— 设置 → Plugins → dsh-session-bridge:表单由 Config 里标了 volatile 的字段自动渲染
(dsh-settings 只把 volatile 字段渲染成控件,所以这一半不需要任何客户端代码),loopGuard 就是总开关,
改完同样写回 profile patch 并立即生效。

单个守护仍可单独关闭:session_bridge_monitor_start({ sessionId: '...', loopGuard: false })。

插件配置字段 默认 含义
loopGuard true 总开关:false 时任何守护都不做循环检测(设置页 / /cot-loop 改的就是它)
loopField reasoning 扫哪块:reasoning / text / both
loopMinCycles 2 至少重复几轮
loopMinRepeats 3 同一单元至少重复几次
loopMinConfidence 0.6 置信度阈值
loopMinHits 1 连续命中几次才动作
loopCooldownMs 60000 同一签名的冷却时间(毫秒)
loopMaxTransfers 3 最多转移几次(0 = 只中断不转移)
loopDescendants report 子代理处置策略,见下表

环境要求

  • Node.js ≥ 20
  • pnpm
  • DSH 0.2.2-rc.1 或更高(peerDependencies 与 engines.dsh 都是 >=0.2.2-rc.1;构建与实测基于
    0.2.2-rc.1)。

构建

# 安装锁定的 DSH 发布依赖,再类型检查并构建
pnpm install --frozen-lockfile
pnpm build

# 针对"实际安装的 dsh"做类型检查(不需要 checkout)
npm run check:compat

# peer 下限守卫、wait/卡住判定、循环判定与交接、守护循环端到端、archived handler、V3→V4 迁移
npm test

# 或经注入器工具链
dev_build_plugin dsh-session-bridge

build.sh 按本地 dsh 源码 checkout 做类型链接,仅用于本地开发。该 checkout 常常
落后于插件实际加载进的 harness,因此 build.sh 通过并不代表插件在运行中的
DSH 上可用——两者版本不一致时 build.sh 会给出警告。要验证运行版本请用
npm run check:compat:它按已安装 DSH 包内随附的 lib/types/*.d.ts(即插件真正
加载的 API 面)对 src/ 做类型检查,随后把产物内联的 DSH 版本与已安装 harness
比对——内联版本低于声明下限(>=0.2.2-rc.1)才判失败,其余漂移只给提示(传
--strict 可恢复"必须完全一致"的严格判定),因为本插件声明的是"下限及之后"。
内联的 cordis 单独成组,与已安装的 cordis 比对。

部署

DSH web 从活动 profile 加载外部插件。本包是一个 bundle:package.json 声明了
dsh.bundle.patch → cordis.patch.yml,其 insert 行挂载插件。
正是这一声明让 dsh plugin add 能一步安装并激活本包。

从 npm 安装

本包已发布到 npmjs.com。
发布由 publish.yml GitHub Actions 工作流在 v* 标签触发;发布前会把
package.json 与 dsh.plugin.json 的版本同步到该标签。

npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-session-bridge

预发布标签(v0.3.2-alpha.1)会发布到自己的 dist-tag(alpha/beta/rc),
而不会占用 latest,因此不会顶掉其他用户使用的稳定版。需要显式选用:

npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-session-bridge@alpha

pnpm 会安装发布的 tarball 并运行其 prepare 脚本(tsdown)以确保 lib/ 就绪,
随后 dsh 激活该 bundle。

> 新版本发布后约 24 小时内,@latest 会解析到旧版本。 pnpm 11 默认开启供应链保护
> (minimumReleaseAge 默认 1440 分钟),发布不满
> 24h 的版本不参与解析;minimumReleaseAgeStrict 默认为 false,所以 pnpm 会静默回退到
> 最新一个"够老"的版本,不报错也不提示。此时 pnpm view dsh-session-bridge dist-tags 仍显示
> latest 是新版,但实际装到的是旧版——而旧版的 peer 范围可能已被新的 DSH 拒绝,于是出现
> "指定了 latest 却说版本不兼容"。三种解法:
>
> 1. 在使用方 profile 的 pnpm-workspace.yaml 里排除本包,@latest 立刻生效:
> yaml > minimumReleaseAgeExclude: > - dsh-session-bridge >
> 2. 装本地 tarball(不经 registry 解析):dsh plugin --profile add <路径>/dsh-session-bridge-x.y.z.tgz;
> 3. 等满 24 小时。指定精确版本不能绕过该策略(会硬报 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION)。

从 GitHub 安装

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:heartmove/dsh-session-bridge

dsh plugin 在 ~/.dsh/profiles/web/ 内转发给 pnpm,然后把本 bundle 归并到 profile 的
dsh.profile.bundles 层列表。git 安装会拉取源码,因此 pnpm 会在 checkout 后运行本包的
prepare 脚本(tsdown)从 src/ 构建 lib/。

pnpm ≥ 10 默认拒绝运行 git 依赖的 prepare 脚本,首次 add 会报 "Ignored build scripts" 提示。
把 pnpm 打印出的包名复制到 profile 的 pnpm-workspace.yaml
(~/.dsh/profiles/web/pnpm-workspace.yaml):

allowBuilds:
dsh-session-bridge: true

然后重新运行 add。该放行表示"在安装时运行这个包的代码"——只放行源码可信的包,并锁定 commit
(github:heartmove/dsh-session-bridge#)以避免后续推送静默改变运行内容。

之后重启 dsh web,并强制刷新页面(Ctrl/Cmd+Shift+R)。

从本地 checkout 安装

在包含本 checkout 的目录下:

npx -p @deepseek-ai/dsh dsh plugin --profile web add ./dsh-session-bridge

pnpm 链接该 checkout,dsh 以同样的方式激活 bundle。

手动 link

想手动管理 profile 时,把本包链接并列入 ~/.dsh/profiles/web/package.json 的 bundles
(bundle 自带的 cordis.patch.yml 提供 loader 行,无需额外的 insert 条目):

{
"dependencies": {
"dsh-session-bridge": "link:D:\\path\\to\\dsh-session-bridge"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-session-bridge"]
}
}
}

(POSIX 系统用 link:/path/to/dsh-session-bridge。)然后在 profile 目录运行 pnpm install 并重启 dsh web。

直接注入(开发用)

开发调试阶段也可经注入器工具链直接加载(无需 bundle 条目):

dev_inject_plugin D:\code\dsh-session-bridge

卸载用 dev_uninject_plugin dsh-session-bridge(清除注入器注册与 junction;重启不再自动装配)。

工具清单

工具 作用
session_search_global 本 fork 新增。 跨所有工作区全文检索会话正文:每个会话一条最强命中(id/标题/cwd/live/摘要);传 sessionId 时返回单会话内的命中事件。只读。
session_bridge_create 创建主会话(当前或其它工作区,经 workspaceId / cwd);可选首条 prompt + waitForReply;异步时返回 sinceSeq 锚点。
session_bridge_send 发消息(mode=queue/steer);可选等待回复;异步时返回 sinceSeq 锚点。
session_bridge_wait 等待 sinceSeq 之后新输出(默认 = 调用时刻最新 seq,-1 = 从头发算):waitFor=reply(文本)或 waitFor=segment(任一已完成步骤即返回,无需等整个 turn);可选 requireTurnEnd;零新输出时回落既有回复并置 stale。
session_bridge_read 读取消息 —— live 或离线;sinceSeq 分页、role 过滤、limit。
session_bridge_segments 增量读取已完成输出段落(每个已完成的 assistant 步骤)—— live 或离线。
session_bridge_resume 让持久化会话重新上线(幂等)。
session_bridge_find 跨工作区按 标题 / id / workspace / 目录 查找会话。
session_bridge_status 读取会话实时进度(running、openTurn、卡住检测、待处理、最新回复)及实时/已定型思维链(reasoning 参数);[STALLED] 仅对 running 会话显示。
session_bridge_cancel 停止运行中的会话(中止活动 turn;keepInbox 保留排队/steering 输入)。
session_bridge_monitor_start 对一个主会话启动后台守护(轮询、催办、纠偏、终止、收尾);支持思维链 coRules(如 reasoning not-contains "I'm" → cancel),以及思维链循环检测(默认开启:命中即中断原会话并把任务转移到新会话,含子代理处置 loopDescendants)。
session_bridge_monitor_stop 停止守护(会话本身不终止)。
session_bridge_monitor_list 列出活动守护及其状态。
session_bridge_archive 归档会话(从分组隐藏;历史与位置保留);对运行中的会话需显式 stopActivity: true。返回受影响 id、集合规模与最新若干条。
session_bridge_unarchive 取消归档(回到原位置重新可见;未知/未归档 id 为幂等空操作)。
session_bridge_archived 列出归档集合(从最新往回,可选 limit,默认 50),可选为返回的 id 解析标题。

所有工具输出 lossless JSON;等待类工具超时不抛错,返回 timedOut / aborted / stale 标记。

项目结构

src/
index.ts    host 插件入口(注册工具;挂载监控)
core.ts     共享 host 逻辑(create/send/wait/read/find、status 快照、archive 记账)
tools.ts    工具注册(bridge + status/cancel + monitor + archive)
monitor.ts  后台守护循环(statusSnapshot + 规则 + 循环检测/转移 + 可选 LLM 判定)
loop-guard.ts  思维链循环判定(纯函数:切单元 + 尾部周期重复 + n-gram 兜底)
handoff.ts  交接提示词(任务/上下文提取 + 子代理分段 + 模板)
session-create.ts  建会话的唯一实现(create 工具与循环转移共用)
registry.ts 桥侧标题/workspace 登记表(~/.dsh/session-bridge-registry.json)
scripts/
build.sh    类型检查 + 链接 DSH checkout 类型
test-bridge-core.mjs  wait/卡住判定回归测试(npm test)
test-loop-guard.mjs  循环判定回归测试:写。/好。/Go。 等形态(npm test)
test-handoff.mjs  交接提示词回归测试:占位符 + 子代理分段(npm test)
test-monitor-loop.mjs  守护循环端到端回归:转移/子代理五场景/预算/失败保留(npm test)
test-tools-archived.mjs  归档 / 取消归档 + archived handler 回归测试(npm test)
check-dsh-compat.mjs  对已安装 DSH 做 src/ 类型检查 + 校验产物来源(npm run check:compat)
smoke-bundle.mjs  挂载构建产物 lib/index.js 并断言工具全部注册(npm run smoke)

生命周期与卸载

DSH ≥ 0.1.6 支持运行时挂载/卸载插件(设置 → 插件页开关、注入器热重载)。
本插件可干净卸载:不注册 loader 级状态,工具随插件 fiber 一并释放,监控定时器
经 ctx.effect 在卸载时清理。

该所有权模型带来一个后果:session_bridge_create 创建的会话归插件 fiber 所有
(agent 在插件上下文下创建),因此卸载/重载插件会停止这些会话的活动 agent。
会话本身已持久化并显示为离线,可用 session_bridge_resume 重新上线;守护循环
同样在卸载时停止。

License

MIT。上游 © heartmove(heartmove/dsh-session-bridge);
fork 修改 © Dax233。上游在被 fork 的提交上于 package.json / README 声明了 MIT,但未随仓库附带
LICENSE 文件;包含双方声明的 MIT 全文见 LICENSE,改动清单一见 NOTICE。

常见问题

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

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

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

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-session-bridge 安全吗?

未标注。

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

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

dsh-session-bridge 需要什么运行环境?

Node.js >=20;需要同时安装 @deepseek-ai/dsh-agent@>=0.2.2-rc.1、@deepseek-ai/dsh-agent-preset-registry@>=0.2.2-rc.1、@deepseek-ai/dsh-home-paths@>=0.2.2-rc.1、@deepseek-ai/dsh-llm@>=0.2.2-rc.1、@deepseek-ai/dsh-session@>=0.2.2-rc.1。环境不满足时安装会失败,建议先确认本机版本。

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

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

dsh-session-bridge 有哪些功能?

创建并驱动其他真实会话、向任意会话发送消息并等待回复、读取在线或离线会话记录、跨工作区全文检索会话、监控、纠偏并归档主任务。

这条记录的数据可靠吗?

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

同名或近似条目

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

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

Dax233 的其它插件

6 个

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