ashuai/dsh-s2s

dsh-s2s — DeepSeek Harness 的 Session-to-Session 同宿主会话互联

一个 cordis 插件,让同一台宿主上的多个 DSH session 互相对话——按会话名(标题)点名即可,并支持拉起已结束(静止)的 session。

实现思路受 a2a 启发,但并非其 fork:a2a 是跨主机 mesh(hub + WebSocket + presence);而 s2s 是同宿主单进程路径,因此不继承其 hub/网络层,只借鉴了它的注入习语(空闲→followup、忙碌→inject)。s2s 用一个进程内 broker 直接投递,零 TCP 端口、零 WS、零重连。原 a2a 版实现归档在本仓库历史与 legacy-a2a 分支,作参照。(跨进程/跨机 mesh 请直接用 a2a;非 DSH 标准 A2A agent 需网关类插件。)

使用手册见 USAGE.md;场景与最佳实践见 docs/BEST_PRACTICES.md;设计证据稿见 docs/SOLUTION.md(v0.2 历史基线)。

它是什么 / 不是什么

| | s2s(本项目) | a2a |
|---|---|---|
| 拓扑 | 同宿主/单进程 | 跨进程/跨机(可信局域网) |
| 传输 | 进程内 broker 直投,零端口 | hub server + WebSocket |
| 寻址 | name(标题)主寻址,现读不缓存 | roster / presence |
| 静止会话 | ✅ 按名拉起(AgentRegistry.resume)(a2a 没有) | ❌ 仅在线接收方 |
| 防回环 | ✅ 发送侧 hop/限速 | ❌ |
| 浏览器 UI / 命令面 | ❌ 无(精简) | ✅ |

功能一览

- 进程内投递:S2sBroker.deliver(sessionId, {from,text}) → ctx.agents.get(...) → agent.followup(空闲)/inject(忙碌)。零网络、零序列化。
- name 主寻址:s2s_resume(name: "开发", ...) / s2s_message(name: "产品", ...);每次解析现读会话最新标题(日志 session/title 事件),改名即刻生效;同名→ambiguous(用 session_id 消歧),查无→not-found+候选。
- 拉起静止会话:入信箱 → autoResume=allow 时 AgentRegistry.resume 拉起 → 投递;拉起的会话保留 live-idle(不自动归眠)。
- 6 个模型工具:s2s_peers(本项目 live)/ s2s_sessions(本项目 标题+三态;all=true 全量)/ s2s_message(发/唤醒)/ s2s_resume(显式唤醒)/ s2s_history(进程作用域历史)/ s2s_schedule(会话内定时注入)。
- 持久信箱:~/.dsh/s2s/mailboxes//*.json,原子写、时序命名、损坏自愈。
- 按需加载:lifecycle/budget 配置块缺席即不挂载;broker/discovery/tools 恒挂(核心)。

详细用法见 USAGE.md。

挂载

装新插件必须用 - insert: 形式,且 name 指向可解析的 ESM 入口(不能是目录):

- insert:
- id: dsh-s2s
name: ./dsh-s2s/lib/index.js
config:
lifecycle:
autoResume: allow       # s2s_resume 用 name 点名即拉起投递
budget:
maxHops: 6
ratePerMinute: 10

零端口:无需配 hub/server(那已是跨机 a2a 的事)。

路线图

- ✅ 进程内重构(R1):去掉 hub/WS 网络层,S2sBroker 进程内直投;零端口。
- ✅ name 主寻址(R2):按会话标题点名,现读不缓存;同名/查无显式处理。
- ✅ 静态会话拉起(R2):AgentRegistry.resume 拉起 + 信箱 + drain + 防双开。
- ✅ 预算(R3 部分):发送侧 hop/限速。
- ✅ 会话内定时唤醒(R4):s2s_schedule(每 N / 定点拉起,到点 idle 才注入 / busy 推后 / dormant 交 s2s)。设计见 docs/SCHEDULE.md。
- 🔲 待做:s2s-etiquette skill(何时找谁、礼节与汇报规范)。
- 🔲 待做:历史/信箱持久化强度调优;真实 GUI 端到端体验。
- 🔲 可选项:与外部标准 A2A agent 互通(需独立网关,本包不做)。

开发

pnpm install
pnpm run typecheck     # 0 错
pnpm run test          # 24/24
pnpm run build         # 产出 lib/index.js (~28kB)

License

MIT。