dsh-crosstalk

DSH 跨会话消息。 机器上的任意会话都能列出并给其他会话发消息 —— 类 Claude Code 的水平消息机制，无需守护进程。

dsh-crosstalk 是一个 DeepSeek Harness bundle。每个运行该 bundle 的会话都会向本地注册表（~/.dsh/crosstalk/，文件 + 原子重命名，无守护进程 —— 只要两个会话能看到同一个 home 目录，它们就能互发消息）发布心跳。每个会话获得稳定名称（-，例如 dsh-cowork-amber）和一个持久 ref id；任何会话都可以列出在线会话，并向目标发送一条清晰标记的 turn —— [message from session dsh-cowork-amber (/Users/me/projects/dsh-cowork)]，发送者名称随消息携带，因此回复只需 send_message 回去。

工作原理

1. 身份：启动时根据工作目录派生出 - 名称，加上进程唯一的 ref（ct-…）。同一目录的两个会话会得到不同的形容词与名称；ref 用于消歧，也是收件箱路径。
2. 注册表：每个在线会话一个心跳 JSON 文件，位于 /registry/.json（name、ref、pid、cwd、status、startedAt、heartbeatAt、uid、inbox）。定时刷新；超过 2× 间隔没有心跳的条目视为死亡并被垃圾回收。
3. 工具 —— 扩展而非复制：
   • list_agents 新增 scope: peers（本机其他在线会话：名称、状态、cwd、最后活动）与 scope: all（后代 + peers）。原有 children/descendants 作用域委托给捕获的原始定义。
   • send_message 的 to 除子代理 id 外，还接受 peer 名称或 ref，并支持可选 summary（5–10 字摘要，显示在目标 UI 中）。
   • 原始工具保持注册；本 bundle 按 agent 作用域遮蔽它们（可逆的 Cordis 效果），卸载后精确恢复原行为。
4. 投递：消息是追加到目标收件箱（/inbox//）的一个 JSON 文件，原子写入（临时文件 + 重命名），崩溃中断不会产生半条消息。目标端的 watcher 轮询收件箱，并通过 followup 注入在线会话：空闲目标会被唤醒处理一个 turn；忙碌目标在下一个 turn 边界收到。投递是尽力而为 —— list_agents 状态不是投递承诺。
5. 注入：turn 带有 [message from session ()] 标签和 crosstalk 来源（form: relay），因此 append-only 日志天然记录来源，DSH UI 会渲染为带标签的 relay 卡片 —— 绝不会渲染成用户文本。系统提示会告知模型：这些是来自同级 agent 的请求，而非用户的指令。

安装

从仓库检出安装：

git clone https://github.com/Jesse-njx/dsh-crosstalk
cd dsh-crosstalk && pnpm install && pnpm build
dsh plugin --profile web add /path/to/dsh-crosstalk
dsh plugin --profile  add /path/to/dsh-crosstalk

（发布到 npm 后，dsh plugin add @dsh-crosstalk/bundle 同样可用。）

配置

添加 bundle 会自动挂载插件（其 cordis.patch.yml 会插入 crosstalk 条目）。如需覆盖字段，在 profile 的 cordis.patch.yml 中按 id 定位该条目 —— 不要再插入第二个 行（会报重复条目错误）：