dsh-plugin-bridge
Đã xác minhdsh-plugin-bridge · v0.3.0 · MIT · Giao diện web
Previewable cross-preset session migration for DeepSeek Harness with bounded, fixed-schema handoffs
Cài đặt
dsh plugin add dsh-plugin-bridge Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.
Mã nguồn
Thẻ
Tác giả
Readme
dsh-plugin-bridge
English | 中文
在 Web preset 做到一半，想换 Code preset 继续？直接切换会让旧工具组的调用历史留在新组合里。Bridge 先生成一份有界、可编辑的五段交接，再建立干净目标会话；原会话始终不动。
快速开始 · 为什么是-bridge · 实测证据 · 迁移决策 · 兼容性
快速开始
从 npm 安装：
dsh plugin --profile web add dsh-plugin-bridge
# 重启一次 dsh web
GitHub 固定版本备用路径：
dsh plugin --profile web add github:Totoro-qaq/dsh-plugin-bridge#v0.3.0
然后在官方 WebUI 输入：
/bridge 列出目标 preset
/bridge --doctor DSH 升级后检查 host 契约
/bridge code 只预览交接，什么都不改
/bridge code --go 迁移、复述，然后等待
/bridge code --go --continue 在同一次目标请求里复述并开始工作
DSH rc.7 及以上会在官方 WebUI 原生卡片中渲染 /bridge。「文本编辑」把固定五段变成普通文本框和逐条列表；「Markdown」保留完整源码自由；「预览」渲染 Markdown 或完整 JSON 树。长内容只在卡片正文内滚动，操作按钮保持可达；点「确认迁移」后自动打开目标会话。
实现官方 conversation.chat.commandview slot 的第三方 UI 会自动得到同一张卡片。其他自定义 UI 仍保留完整服务端结果、摘要文件流程和目标标题/session ID 回退；UI 作者还可以复用无 React 的 dsh-plugin-bridge/client-contract 导出，而无需重写协议。旧客户端可修改输出里打印的摘要文件，再执行：
/bridge code --go --file <路径>
卸载：dsh plugin --profile web remove dsh-plugin-bridge，然后重启 dsh web。
为什么是 Bridge
| 承诺 | 具体含义 |
|---|---|
| 执行前预览 | /bridge <preset> 不创建目标、不改源会话；先检查或修改固定五段交接。 |
| 迁状态，不迁工具痕迹 | 决策、路径、当前状态和下一步进入干净 preset；旧工具组的不兼容调用不会跟过去。 |
| 失败时关闭迁移 | kickoff 前暂停目标；无法保证时清除/取消目标，不发送模型请求。 |
只安装、不调用时，普通会话增加 0 Bridge prompt token。它是 host slash command，不是模型工具或 skill。
实测证据
这是小样本、可复现的回归门禁，不是总体准确率保证。
| Gate | 结果 |
|---|---|
| 五段摘要事实 | 30/30 |
| 目标复述 / 首次有效工作事实 | 60/60 · 60/60 |
| 关键事实 / 旧值复活 | 90/90 · 0 |
| 已有图片证据 / 未解析原图路径 | 5/5 · 5/5 |
Confirm / --continue 到首次有效工作的目标请求数 |
2 · 1 |
Confirm 相对 --continue 的 nominal 配对中位额外成本 |
+8.1% |
| 摘要 worker 在干净验收组件中的 nominal 占比 | 20.74% |
| 原生 WebUI 重复门禁（预览 / 目标事实） | 3/3 · 3/3，每次五项 |
token 百分比会随 preset、回复长度和缓存状态大幅波动；worker 占比是组成，不是相对“无 Bridge”的因果开销。稳定结论是默认确认多一个请求。边界和原始证据见设计与证据说明、完整 release report和视觉迁移报告。
工作原理
折叠历史 -> 五段交接 -> 预览/编辑 -> 干净目标会话
-> 暂停存储目标 -> 注入 -> 复述 -> 等待或同轮继续
图片历史 -> 原样搬运助手证据；未解析原图走附件网关
五段分别是：目标、当前状态、关键决策与约定、关键文件、下一步。原会话不会被改写；接得不好时归档目标，直接回源会话。
迁移决策
| 场景 | Bridge 行为 | 成本 / 保真影响 |
|---|---|---|
只安装，不调用 /bridge |
不注入提示，不注册模型工具 | 0 Bridge prompt token |
/bridge code |
起一个有界摘要 worker，只输出预览 | 不创建目标会话 |
默认 --go |
目标先复述再等待 | 首次有效工作前多一个显式确认请求 |
--go --continue |
同一次目标请求里复述并开工 | 请求数更低，没有后台 goal 轮次 |
| 图片已有助手分析 | 逐字搬运对应回答 | 默认不重发原图 |
| 图片未解析，目标可接图 | 搬原附件并保留源 VLM | 视觉费用由所选 provider 计算 |
| 图片未解析，目标是纯文本模型 | prompt 准入拒图，Bridge 显式发送文字降级 | 不暗启本地 VLM，也不假装看懂图片 |
兼容性
| DSH 基线 | 服务端交接 | 原生卡片 | 验证边界 |
|---|---|---|---|
| 0.1.0-rc.6 | 支持 | 不支持 | 窄 RPC 契约与文本兼容测试 |
| 0.1.0-rc.7 / rc.8 | 支持 | 契约核对 | client module / command slot 契约与服务端回退 |
| 0.1.1-rc.2 | 支持 | 支持 | 官方 WebUI 实装：doctor 13/13、编辑/确认/自动跳转、三次重复门禁 |
CI 覆盖 Node.js 22/24。每次升级 Harness 后先跑 /bridge --doctor；缺哪个必要网关方法会被直接点名。
当前边界：
- 安装后需要重启一次 WebUI；
- 原生卡片通过官方 Session runtime 自动打开目标；旧客户端仍回退为标题和 ID；
- worker 运行时立即显示进度；本次三次固定样本的 worker 用时为 7.4–12.8 秒，
previewTimeoutMs仍是硬上限； - 纯文本模型无法读取未解析原图；
- 原生卡片重复门禁也只有三次固定输入，是发布证据，不是统计保证。
服务端命令仍是兼容核心。同一个包现在附带可选的官方 WebUI client half，负责渲染、编辑和跳转；即使 prerelease 客户端契约加载失败，/bridge 的完整服务端结果仍在。详见实现边界。
文档
开发验证
npm ci
npm run verify
verify 会构建并类型检查插件两端、运行 160 项测试、核对 lib/ 与数据集，再把真实 npm tarball 打包、安装并导入。测试不消耗模型 token。prepublishOnly 使用同一个 gate；GitHub Release 还会先检查 tag 与 package.json 版本一致，再走可信 npm 发布。
社区收录：Awesome DSH Plugin · Awesome DeepSeek Harness
生态发现入口：dsh-TUI。Bridge 仍按标准 DSH 插件安装；TUI/std 一致性适配另行跟踪。
License
MIT