概览

dsh-session-handoff

Hand your long DSH session over to a fresh one: /handoff summarizes the recent conversation with an LLM, creates a clean new session in the same workspace, injects the summary as its first message, and auto-opens it. The origin session is unchanged.

README / ZH

插件文档

DSH 会话接力插件

仓库名：dsh-session-handoff

English | 中文

聊到上下文快满了？一条 /handoff，把几十轮对话压成一页交接文档，开个干净的新会话接着干——旧会话一字不动。

DSH 的会话越聊越长：加载变慢、上下文吃紧、模型开始忘事。官方有"压缩"和"分叉"，但没有 "把该记的记住，然后换一个干净会话继续"。这个插件补的就是这一步。

它会在上下文或会话体积到点时先问你一句；你确认后，它把 用户需求 / 方案梗概 / 已完成 / 涉及文件与产物 / 接下来做什么 整理成交接文档，在同一工作区开一个新会话、把文档作为第一条消息注入，并自动打开。你回来时，新会话已经知道要做什么，不用从头解释。

和"压缩"、"分叉"有什么不一样

	`/compact` 压缩	fork 分叉	本插件
旧会话	原会话被压缩	原会话保留	原会话原样保留，标题留回链
新会话的负担	还是同一个会话	复制全量历史	只有一页交接文档
谁来接着干	还是自己	还是自己	全新会话 + 干净上下文
什么时候换	到阈值自动压	手动	到点先问你，也可全自动

一句话：压缩是"把旧包袱打包"，分叉是"把旧包袱复制一份"，这个插件是"把旧包袱写成一页交接单，轻装出发"。

特性

手动——/handoff [<N>|all]，想切就切；不填轮数就用配置里的 turns（默认 50 轮用户消息）
自动——按策略到点触发，三档模式：替代（抢在原生压缩前切）/ 混合（会话过重时切）/ 原生（不自动切）
先问你——默认弹窗确认，可改成「只提醒」或「全自动」；点过「先不接力」后，触发量再涨 50% 才会重问
健康度行——输入框上方常驻「上下文 xx% ｜会话 xxMB ｜还能撑约 N 轮」，点开看明细，心里有数
干净的接力——新会话继承原会话的工作区、模型路由与 agent preset（系统提示 / 工具 / 技能），不带旧上下文
结构化交接文档——并在磁盘留一份，设置页可翻历次记录、直接打开目录
自动打开——客户端等新会话就绪后自动跳过去（每个子会话只跳一次，历史回放不会反复跳）
决策留痕——每次判定都记一条决策日志（选了哪个动作、为什么），出问题能复盘
新会话可预设——新会话用哪个模型、多强推理、什么工作权限，三项都可选「跟随原会话」
零核心改动——只插入一行 dsh.bundle.patch，全部走宿主公开服务

安装

要求：DSH 桌面版或 CLI，Node ^22.19.0 || >=24。

插件是标准的 DSH bundle 包，核心只有两件事：放进你正在用的 profile 的 node_modules，并在该 profile 里登记。以桌面版（desktop profile）为例：

# 1) 把仓库放到任意目录（或直接解压 Release 里的 dsh-session-handoff-0.3.0.tgz）
git clone https://github.com/MountBatten718/dsh-session-handoff.git ~/dsh-session-handoff

# 2) 软链进 desktop profile 的 node_modules
ln -s ~/dsh-session-handoff ~/.dsh/profiles/desktop/node_modules/dsh-session-handoff

然后在 profile 的 package.json 里登记依赖：

{
  "dependencies": {
    "dsh-session-handoff": "link:/Users/you/dsh-session-handoff"
  }
}

并把 dsh-session-handoff 加进该 profile 的 dsh.profile.bundles。重启 DSH 后生效。

桌面版的 desktop profile 由 Electron 独占，CLI 会拒绝对它执行 plugin add / --dump-config；想只读验证组合结果，可以做一个换个名字的软链指向同一目录再 --dump-config。如果你用的是普通 CLI profile，也可以按该 profile 的常规插件安装方式装入本目录。

使用

在任意会话输入框敲：

/handoff          # 用配置里的轮数（默认 50 轮用户消息）
/handoff 20       # 总结最近 20 轮
/handoff all      # 总结全部用户消息

执行后：命令卡片显示"正在总结…" → LLM 生成交接文档 → 新会话自动打开，原会话原样保留并回链。

⚠️ 隐私提示：所选窗口内的对话文本（用户 + 助手消息）会发送给配置的模型用于生成摘要。

配置

大多数选项在 DSH 设置 → 插件 → 会话接力 里就能改（即时生效）。profile patch 里可写的完整键：

- id: handoff
  name: dsh-session-handoff
  config:
    # —— 自动接力 ——
    autoMode: hybrid            # replace（替代）/ hybrid（混合，默认）/ native（原生，不自动切）
    autoPromptLevel: confirm    # confirm（弹窗确认，默认）/ notify（只提醒）/ auto（全自动）
    sessionVolumeBytes: 8388608 # 会话体积阈值（默认 8 MB）
    compactionCountTrigger: null # 每压缩 N 次就切；null/留空 = 不启用
    confirmTimeoutMs: 120000    # 确认弹窗超时（自有硬兜底，不依赖宿主）
    # —— 新会话形态（留空 = 跟随原会话；设置页里可直接选）——
    provider: ''                # 新会话固定用的供应商
    model: ''                   # 新会话固定用的模型（与 provider 成对）
    childReasoningEffort: ''    # 新会话的推理强度（与摘要调用的 reasoningEffort 不是同一个键）
    childPermissionPreset: ''   # 新会话的工作权限：read-only / workspace-write / danger-full-access
    childPlanFirst: true        # 新会话读完交接文档先给计划、等确认再动手（默认开）
    subagentDrainTimeoutMin: 10 # 换会话前等子代理交卷的最长时间（分钟，1–60）
    askRearmPercent: 50         # 点过「先不接力」后，触发量再涨这么多百分点才重问（10~500）
    decisionLogEnabled: true    # 决策日志开关
    # —— 交接文档落盘 ——
    handoffDocPersist: true     # 默认开；落盘目录 = DSH 数据目录
    handoffDocDir: ''           # 留空用默认；只接受绝对路径
    # —— 摘要调用 ——
    turns: 50                   # 取多少轮（1–200）
    maxInputChars: 200000       # 输入字节上限（超限保留头 + 尾）
    maxTokens: 8000             # 输出 token 上限（推理模型会先把预算花在思考上）
    reasoningEffort: inherit    # inherit（默认，跟随会话）| off | high | max
                                # ⚠️ 别默认写 off：部分模型会直接拒绝该参数
    timeoutMs: 120000           # 摘要调用超时

未配 provider / model 时，自动使用当前会话最近一次请求的模型路由。

原理

宿主侧（index.mjs + lib/*.mjs，纯 ESM）：只消费宿主公开服务——commands（/handoff）、llm、 agents（会话与 agent 一起建，经 agentPresets.mount 继承 cwd / 模型路由 / preset）、 workspaceRegistry.attachSession、sessionTitle.rename、userQuestions（原生问答弹窗）。自动接力挂 agent/pre-step 瀑布（步骤边界 = 安全点）；客户端经 Typert RPC 读健康度、改配置、手工换会话。
客户端侧（src/client/ → scripts/build-client.mjs → lib/client.js）：健康度行 + 设置面板 + 会话接力卡片；命中成功事件后自动打开子会话（轮询等待可寻址，localStorage 去重）。
黑匣子：每次接力把阶段与结果写进 <DSH_HOME>/session-handoff-docs/handoff-trace.jsonl，长文本脱敏成 [omitted N chars]，文件超 5 MiB 自动轮转。

构建

客户端半区产物 lib/client.js 已随仓库提供；改了 src/client/** 之后需要重建：

node scripts/build-client.mjs           # 重建 lib/client.js
node scripts/build-client.mjs --check   # 校验产物与源码逐字节一致

构建脚本只依赖 Node 内建的 TypeScript 类型剥离，不需要安装任何依赖。

已知限制

支持 DSH 0.1.0-rc.5 至 rc.8、0.1.1-rc.2 以及桌面版内核 0.2.0-rc.2； 0.1.2-alpha.1 拆分了会话 UI / 服务，需要单独迁移客户端半区。
session.snapshotEvents() 已被宿主标注 @deprecated（宿主内部仍在使用）；未来内核换入口时需要跟改。
链路状态（第几棒 / 已交接）只存内存：重启后靠旧会话标题上的标记恢复"已交接"，链序号会退化为 1（仅影响展示）。
自动接力失败后不会自动重试（避免重复创建会话），可在会话里手工「换会话」。
自动跳转依赖客户端轮询时序，真实浏览器下的极端时序仍需按你的 DSH 版本自测。

致谢

本项目基于 WeiYe6/dsh-session-handoff（MIT）扩展而来。上游提供了 /handoff 命令与交接文档的基础实现；本仓库在此基础上增加了自动接力、健康度行、设置面板、交接文档落盘、决策日志与子代理收尾等待等能力。

License

MIT

dsh-session-handoff

dsh-session-handoff

插件文档

DSH 会话接力插件

和"压缩"、"分叉"有什么不一样

特性

安装

使用

配置

原理

构建

已知限制

致谢

License

按能力继续看