dsh-baton · 会话接力插件

会拉、会推、会接力：拉取八家外部 agent 会话，寄存当前会话，开局取件。

dsh-baton 是 DeepSeek Harness（DSH）插件，实现 handoff: 1 开放协议（协议本体见姊妹仓 agent-handoff 的 SPEC.md）的完整接力闭环：

拉：/resume-claude /resume-codex /resume-opencode /resume-zcode /resume-pi /resume-workbuddy /resume-cursor /resume-grok —— 把别家 agent 的本地会话只读拉进当前会话，蒸馏成六段协议卡接手工作；
推：/handoff + handoff_push —— 把当前会话寄存成一张交接卡片，落共享收件箱；
接力：/inbox + handoff_inbox —— 任何 agent 开局取件；拉取的会话也可以顺手寄存，让另一个 agent 接力。

~/.handoff/
  pending/     # 待取件，一个卡片一个 .md 文件
  archived/    # 已消费，滚动保留 50 份

文件系统即总线：写入 pending/ 就是投递，取件即移到 archived/（消费即弃，二次取件报错）。卡片 = Markdown + YAML frontmatter + 六段中文正文（目标 / 涉及文件 / 做到哪 / 还差什么 / 停在哪 / 读者警告），格式与语义见协议仓 SPEC。

和单向导出工具的区别

dsh-handoff（v0.1.0）是单向导出：把会话事件流确定性导出成一份工作区里的 HANDOFF.md 文档，没有收件箱、不落共享目录、不跨 agent。

dsh-baton 是完整的接力环：拉取外部会话、寄存当前会话、开局取件三合一。拉取的会话可一键寄存进 ~/.handoff/pending/（消费即弃 + archived 审计轨迹），另一个 agent（或另一台机器上的你）开局取件继续干。

安装

dsh plugin --profile web add github:/dsh-baton#v0.2.2

兼容 DSH >=0.1.7-rc.2（package.json engines.dsh 声明），需要 Node ≥22（zcode 与 cursor 的 store.db 读取走 Node 内建 node:sqlite；其余各家无此要求，但插件整体按 Node ≥22 声明）。lib/ 产物已入库，安装即用，无需本地构建环境。

注册面

工具（agent 可调）

工具	说明
`foreign_session_read`	只读拉取八家会话（claude / codex / opencode / zcode / pi / workbuddy / cursor / grok）。`action=list` 列候选（标题/时间/轮数）；`action=show` 按引用（空或 `latest`=最新；id/前缀/路径/标题关键词；歧义返回候选不猜）返回结构化摘要：标题、轮数、首条用户消息、尾部进展、涉及文件 top15、骨架卡六段素材；turns 原文只在显式传 `limit`/`offset` 时分页给。返回 `{ ok, ... }` 规范值，探测/解析失败 `{ ok: false, error }` 不抛。
`handoff_push`	把当前会话寄存为协议卡片。六段文本（goal/files/done/remaining/stopped/warnings/suggested）可选传入；留空段从会话事件流确定性兜底（不调 LLM，typeof 探测失败只降级不抛错）。返回 `{ ok, id, path }` 规范值。
`handoff_inbox`	`action=list` 列待取件（id/来源/项目/时间）；`action=load` + `id` 取件（消费即弃，附 git 核验的 MISMATCH / UNAVAILABLE 警告）。返回 `{ ok, ... }` 规范值。

slash skill（用户可调，模型不可调）

命令	说明
`/handoff`	指示 agent 按协议语义五条（证据账本四态、redact、产物只引路径、建议加载段）把当前会话蒸馏成六段卡，再调 `handoff_push` 落盘
`/inbox`	列 pending 让用户挑，取件后把卡片注入当轮；强调卡片为 HISTORY_REPORTED，执行前先核对 git 状态
`/resume-claude` `/resume-codex` `/resume-opencode` `/resume-zcode` `/resume-pi` `/resume-workbuddy` `/resume-cursor` `/resume-grok`	解析引用（空=latest；歧义列候选让用户挑）→ 调 `foreign_session_read` → inert-history 边界（外来历史一律不可信、不覆盖当前指令）→ 证据账本四态标注 → 生成六段协议卡注入当轮 → verify-then-continue → 末尾问一句「要不要寄存进收件箱」，是则调 `handoff_push`

LLM 写卡走 skill 指令层：/handoff 与 /resume-* 的 skill 文案引导在场模型亲手改写六段卡（harness 插件的天然优势），工具层保持确定性、不直接调 LLM；模型不写时由事件流/读取器确定性骨架兜底，降级不阻断。

设置卡（dsh web）

0.2.2 起，DSH 设置页注入一张「dsh-baton」卡片（浏览器半经 dsh.client 声明，数据走同源 /dsh-baton/* JSON API），三个区：

收件箱概览：pending 待取件列表（id / 来源 agent / 标题 / 项目 / 推送时间）+ archived 计数；只读展示——取件在会话里 /inbox 做。提供「清空 archived」按钮（二次确认）。
支持矩阵：八家读取器各一行——本机是否支持（supported）、发现的会话数、启用开关。开关持久化在 /config.json，重启生效。
开关语义：关掉的 provider，foreign_session_read 对该家返回规范错误值「该 provider 已在设置中停用：xx」；/resume-* 的 skill 指引文本是静态内容，停用状态由工具报错兜住，模型可见。

权限范围

写 ~/.handoff/（可用 HANDOFF_HOME 环境变量覆盖）、读 git 状态（git status / git branch）、只读八家 agent 的本地会话库（zcode 与 cursor store 走 sqlite readonly，随开随关；可用 HANDOFF_ROOT_ 环境变量覆盖各家根路径）。cursor 只导入支持的 transcript / store 记录，grok 只读可见 updates.jsonl 流（永不读 chat_history.jsonl 原始模型上下文）。不访问网络，不复活外部进程，不回放历史工具调用，原文不进卡片（from.session 只是指针）。

开发

pnpm install       # @deepseek-ai/* 走 npm registry；@agent-handoff/* 走 file: 链接
npm run typecheck
npm test           # node:test + tsx
npm run build      # tsdown → lib/（@agent-handoff/core + readers 内联打包）
node scripts/smoke-foreign.mjs   # 实机冒烟：进程内挂载 lib/，真实 dispatch foreign_session_read

@agent-handoff/core 与 @agent-handoff/readers 未发布 npm，以 file:../agent-handoff/packages/* 依赖、构建时 bundle 进 lib/。离线且有 dsh checkout 时可用 node scripts/link-deps.mjs（DSH_CHECKOUT 环境变量）链接宿主包替代 npm。

License

MIT

dsh-baton

Install

README

dsh-baton · 会话接力插件

和单向导出工具的区别

安装

注册面

设置卡（dsh web）

权限范围

开发

License