dsh-s2s
面向 DeepSeek Harness 的独立同主机会话间互联。支持进程内代理投递、按名称（标题）寻址、唤醒休眠会话、持久邮箱和防循环预算。灵感来自 @dpskh/a2a 注入惯用法；无 hub 或网络网格。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ashuai/dsh-s2s#1f44a93f7eeb592d338bca0aa1e3b160defb58c4S2s 以 dsh-s2s 发布，当前版本为 0.4.0-s2s.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 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(忙碌)。零网络、零序列化。s2s_resume(name: "开发", ...) / s2s_message(name: "产品", ...);每次解析现读会话最新标题(日志 session/title 事件),改名即刻生效;同名→ambiguous(用 session_id 消歧),查无→not-found+候选。autoResume=allow 时 AgentRegistry.resume 拉起 → 投递;拉起的会话保留 live-idle(不自动归眠)。s2s_peers(本项目 live)/ s2s_sessions(本项目 标题+三态;all=true 全量)/ s2s_message(发/唤醒)/ s2s_resume(显式唤醒)/ s2s_history(进程作用域历史)/ s2s_schedule(会话内定时注入)。~/.dsh/s2s/mailboxes/<sessionId>/*.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 的事)。
S2sBroker 进程内直投;零端口。AgentRegistry.resume 拉起 + 信箱 + drain + 防双开。s2s_schedule(每 N / 定点拉起,到点 idle 才注入 / busy 推后 / dormant 交 s2s)。设计见 docs/SCHEDULE.md。s2s-etiquette skill(何时找谁、礼节与汇报规范)。pnpm install
pnpm run typecheck # 0 错
pnpm run test # 24/24
pnpm run build # 产出 lib/index.js (~28kB)
MIT。