本地会话桥 zhz-viads/dsh-local-bridge

dsh-local-bridge

让 DeepSeek Harness、Claude Code 和 Codex 在同一台 Windows 电脑上互相传话。

几个助手分着做同一个任务时，经常要把任务复制到另一个聊天，再把回复搬回来。这个插件把收发变成了本地命令：Claude Code 或 Codex 可以向已经打开的 DSH 会话发消息、等待回复；DSH 也可以把任务和结果发到指定的 Claude Code 或 Codex 会话。

它复用现有聊天，保留各自的上下文。传输不占键鼠，也不用再开一个模型会话。具体任务仍由对应客户端执行，使用你自己的模型和账号额度。

能做什么

- 列出 DSH 中已有的会话，返回完整会话编号和运行状态。
- 把 UTF-8 正文文件发给指定 DSH 会话，按请求编号读取对应回复。
- DSH 会话忙时排队，同一会话里的桥接消息依次提交。
- 用相同请求编号重试同一条消息，避免重复投递；插件重载后恢复跟踪。
- 从 DSH 向已有的 Claude Code、Codex 聊天投递任务或结果。

它负责传话，不负责决定谁来做任务、替你批准权限，或让几个助手无限循环互发消息。

运行环境

当前验收环境是 Windows 11 + DSH Desktop 0.2.1-rc.2 + Node.js 24，源码要求 Node.js 22 或更高版本。

向 Codex 投递需要本机已安装 Codex 桌面版；向 Claude Code 投递需要正在运行的交互会话，以及 PowerShell 7。Claude 方向使用 Windows 命名管道，尚未验证 macOS、Linux 或其他 DSH 版本。

插件没有第三方生产依赖，也没有安装脚本。它在 DSH Host 内只调用 session/list、session/prompt 和 session/follow。

安装

先从 v0.2.0 Release 下载 dsh-local-bridge-v0.2.0-source.zip。下面的 PowerShell 示例把源码放到当前用户的 DSH 本地插件目录：

$pluginRoot = Join-Path $env:USERPROFILE '.dsh\local-plugins'
New-Item -ItemType Directory -Path $pluginRoot -Force | Out-Null
Expand-Archive -LiteralPath '.\dsh-local-bridge-v0.2.0-source.zip' -DestinationPath $pluginRoot
$plugin = Join-Path $pluginRoot 'dsh-local-bridge-v0.2.0'
dsh plugin --profile desktop add --ignore-scripts "file:$plugin"

这一步需要 DSH 命令行可用；如果 dsh 不在 PATH 中，使用你安装的 dsh.cmd 完整路径。安装后重载 DSH 桌面版，保留解压后的源码目录。插件的安装方式见 DSH 官方文档。

先列会话，再发消息

客户端可以直接用 Node 运行，不需要额外的快捷脚本：

$cli = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-local-bridge-v0.2.0\cli.mjs'
node $cli help
node $cli status
node $cli list

从 list 里复制完整的目标会话编号。下面两个编号只是示例，发送前换成实际编号；正文放在自己的 UTF-8 文件中：

$targetSession = 'session-11111111-1111-4111-8111-111111111111'
$senderSession = '22222222-2222-4222-8222-222222222222'
node $cli send --session $targetSession --from codex --source-session $senderSession --file '.\message.txt' --wait 60

从 Claude Code 发出时，把 --from codex 改为 --from claude。DSH 会话编号使用 list 返回的完整值，通常带 session- 前缀；Claude Code、Codex 的会话编号使用对应客户端的完整 UUID。不要用聊天标题代替编号。

等待时间到了也可以继续查询。把下方的 example-request 换成发送时返回的 requestId：

node $cli result 'example-request' --wait 60
node $cli result 'example-request' --wait 60 --format text # 只看状态和回复正文

重试同一条请求时加上 --id 原requestId，并保持目标、来源和正文一致。重复使用编号却更换内容，会被拒绝。

从 DSH 向外投递时，--source-session 使用当前 DSH 会话的完整编号：

$dshSession = 'session-11111111-1111-4111-8111-111111111111'
$peerSession = '22222222-2222-4222-8222-222222222222'
node $cli to-codex --thread $peerSession --source-session $dshSession --file '.\message.txt'
node $cli to-claude --session $peerSession --source-session $dshSession --file '.\message.txt'

按聊天名找会话

只知道聊天名时，先查出唯一的会话编号再发，不按相似名字猜：

node $cli find --codex '测试' # 查 Codex 聊天（读取本机 Codex 的会话索引，取每个聊天最新的名字）bash
node $cli find --dsh '测试' # 查 DSH 会话（读取插件心跳里的会话列表）

unique 有值才可以直接用；为空时 matches 会列出所有同名会话，或者为空表示没找到，这时请让用户指定。Codex 的会话索引是它的内部文件，客户端升级后格式可能变化。

协作回复

通过桥接收到消息后，DSH 直接在当前轮给出完整回复，发送方用 result 读取；除非明确要求，不再另发一遍。回复先给结论，任务卡里的条目逐项写全。篇幅是否转成文件由任务卡或发送方指定，没有固定的字数或要点数量限制。

主动发送正文最多 32 KiB，超出时先把全文写入双方约定的文件，再发送路径和摘要。读取回复时，outbox 单个 JSON 文件的上限是 1 MiB，包含封装字段。

收到回执，代表到了哪一步

| 状态 | 含义 |
| queued | 文件请求已进入队列 |
| submitting | 正在提交，是否已接收尚未确定 |
| accepted | DSH 已接收请求 |
| running | 请求对应的消息已进入具体轮次 |
| completed | 已观察到该请求对应轮次正常结束 |
| cancelled / failed | 对应轮次取消、失败，或桥接跟踪出错 |

DSH 方向会跟踪对应轮次的回复。从 DSH 发到 Claude Code、Codex 时，written 或 queued 只表示消息已交给传输通道，是否读到、是否做完，要看接收方的回复。

已知限制

- Codex 正忙时，消息进入它的待发送队列，可能在当前轮收到，也可能稍后处理；入队不保证处理时间。需要立即追加时，可由用户在界面上点击“引导”；插件不替你点击。
- 插件重载后，已接收或正在运行的请求恢复跟踪，不重新发出。恢复依赖最近 500 条消息的历史窗口，超长轮次尚未充分验证。
- 在界面里删除排队消息后，桥接跟踪最多等待 15 分钟再报告 reply_timeout，不会自动重发。
- DSH 中的权限确认需要用户处理；桥接等待不代表它能识别每一种权限弹窗。
- Claude Code 的命名管道协议和 DSH 的会话接口都可能随客户端升级变化。升级后先检查 status、list，再测试一条短消息。
- Windows 单元测试中的 Claude 适配器检查沿用 Codex 自带的 PowerShell 7 路径；其他 PowerShell 安装布局尚未验证。

本地记录与信任范围

通信文件放在 %USERPROFILE%\.dsh\bridge\ 下：inbox、work 保存请求，outbox 保存回复，status.json 保存心跳和会话元数据。完成的请求、回复最多保留 200 条或 7 天；ledger.jsonl 保留用于去重的编号、来源、会话、状态与长度，过大时明确报错。

正文最多 32 KiB，请求文件最多 64 KiB。读写会检查链接、目录联接和越界路径，写入采用临时文件原子替换。格式不合要求的请求进入 rejected；若隔离过程中退出，可能只留下原文件，没有附加说明。

这些文件沿用当前 Windows 用户的访问权限，同一用户下的其他程序仍可能读取它们。--from 是发送方声明的身份；同伴消息不等于用户授权。伪造跨会话消息包裹标签的正文会被拒绝。

插件自身不发 HTTP 请求、不监听端口，也不读取 DeepSeek 的登录凭据或 Cookie。向 Claude Code 投递时，会在一次性进程内读取其会话登记与密钥，并核对进程、启动时间、会话和管道归属；密钥不写入通信记录。

验证摘要

公开副本执行 npm test（三个测试文件），76 项测试通过，覆盖去重、排队、请求校验、重载恢复、启动与运行超时、健康检查、异常文件处理、会话索引损坏和交互会话限制。测试使用隔离目录及模拟接口，不向真实模型发送请求。

v0.1.0 发布前的本机安装版还完成了 6 条真实往返核对：每条在 DSH 原生日志中恰好出现一次用户消息和一次 inbox 插入；accepted 后停用、启用插件能够恢复；DSH 发往 Claude Code、Codex 的消息都由接收方确认收到。这些是既定 Windows 环境下的历史验收结果。这些真实往返不是 0.2.0 公开副本的再次实测；本次发布没有重复触发真实模型请求。

公开副本与本机安装版的差异

公开副本升为 0.2.0，安装版的版本号不在本次发布中修改。公开副本将注入说明和收发消息附带的个人规则引用改成通用文字，并相应调整两份文本断言；传输、重试、锁、会话校验及权限校验逻辑保留。不会附带本机验收记录、会话数据或配置。

卸载 powershell
dsh plugin --profile desktop remove dsh-local-bridge

卸载后重载桌面版。本地通信记录会保留；需要删除时，先确认其中没有还要用的任务和回复。

更新记录

- 0.2.0：启动遇到临时错误会重试；启动等待超过 20 秒会退出本次尝试，避免一直挂着。运行中失去锁或连接中断后，健康检查会尝试恢复，并保护其他实例的心跳和锁。
- 会话列表刷新失败后逐步延长重试间隔，恢复成功后清除旧错误；恢复期间只要心跳仍然新鲜，消息可以继续排队、等待对应回复。
- 按聊天名查找时，索引损坏或不完整会明确报错，避免把不完整结果误认成唯一会话；向 Claude Code 投递时明确要求交互会话。
- 协作回复先给结论、按任务卡逐项写全；同一已授权步骤只交一份完整回复。公开版使用通用协作说明，不依赖维护者本机的规则文件。

- 0.1.1：新增 find，按聊天名查唯一会话编号，跳过索引中格式错误的编号；result 和 send --wait 支持 --format text，只输出状态和回复正文；默认输出不再带内部跟踪字段；注入说明要求 DSH 通过桥接回复时简短、先给结论；本机安装与公开源码统一。
- 0.1.0：首个公开版本。

许可证

Copyright 2026 z-fdg。按 Apache License 2.0 发布，署名见 NOTICE。这是独立开发的社区插件。

源码目前通过 GitHub 仓库和 Release 提供，尚未发布到 npm；package.json 的 private: true 用于防止意外发布到 npm。