会话继承 MacilyDots/dsh-session-inherit

dsh-session-inherit（继承）

DSH Market

把一段跑了很久的会话，交接给一个干净的新会话。

在会话行的「…」菜单里多出一行 继承。点它 → 预览一份从源会话机械提取出来的交接单 → 确认 → 新建一个不带旧历史的会话，把这份交接单作为它的第一条消息发出，工作在新会话里继续。原会话原样保留。

置顶 ← DSH 原版（Pin）重命名 ← DSH 原版（Rename）分叉 ← DSH 原版（Fork）继承 ← 本插件（order 350）归档 ← DSH 原版（Archive）

除「继承」外的四行都是 DSH 原版自带的条目（sidebar.workspaces.session.menu.item slot 的官方内容）。如果装了别的会话菜单插件，你的列表里还会多出它们的条目——本插件只负责「继承」这一行。

为什么不是 /compact、也不是「分叉」

现在的 DSH 里已经有两条"继续干"的路，但这个需求是第三条：

| 做法 | 它搬过去的东西 | 对本场景的问题 |
| /compact | 把历史换成摘要，会话不变 | 实测把 541,227 token 压到 25,602 后 4 步内退化复发，且重复词从「做。」变成「好。」——长度不是因，上下文内容也不是因 |
| 官方分叉 | 复制源会话的整段历史前缀 | 等于把退化诱因一起带走，新会话一睁眼就是几十万 token 的历史 |
| 本插件的继承 | 只搬可核对的具体锚点，历史一律不带 | 新会话的上下文从几千字符起步 |

为什么不用 LLM 做摘要

/compact 那次的证据很直接：摘要保留下来的是"要做验收、要写报告"这类抽象意图，丢掉的恰恰是文件路径、下一步参数这类具体锚点。模型握着模糊意图在抽象层反复自我告诫，而它每次告诫用的句式几乎相同——这本身就是喂给重复退化的燃料。

所以本插件的交接单一次模型调用都不发，只做机械提取：任务原文、最近的用户指令（原话，不改写）、动过的文件、跑过的命令、最后一次待办状态、源会话最后一条回复。
每条都能追回源会话去核对。

交接单开头还写死三条执行规约：

不要复述本单，不要总结本单，不要回应"收到/了解了"。
读完直接做「下一步」。第一步只做一个具体动作，做完停下汇报；不要同时铺开多个方向。

交接单长什么样

📋 会话继承单

来源：session-xxx（标题） · 共 15 轮 · 最后活动 2026-10-08 19:37 执行规则：不要复述本单…

任务目标 ← 源会话第一条真实用户消息改过的文件（实际写入/修改过） ← 来自 edit/write 的 file_path，按最近改动排序最近失败 ← 源会话最后几次工具报错（含错误码）最近的用户指令（由旧到新） ← source.kind === 'user' 的原话读过的文件（只读取过，未修改）文中提到的路径 ← 工具参数正文里扫出来的，可能是噪音项目内相对引用 ← 基准目录未确定，需要时用文件搜索确认最近执行的命令待办（源会话最后一次 todo 状态）源会话最后一次回复下一步 ← 你在预览框里写

章节标题不带序号。序号是逐节写死的字面量，会随"某一节有没有内容"漂移——早先版本里客户端提示写死了「## 7. 下一步」而实际生成的是「## 8.」，用户照着找永远找不到。

「最近的用户指令」只认 source.kind === 'user'。实测某个真实会话的 42 条 user/message 里，有 27 条是 agent-instructions / runtime-context / skill-catalog / time-context / 记忆提示 / 模型选择 / 压缩检查点 这类运行时注入——全是噪音，现在被挡在门外。

两个高价值锚点

改过的文件只取 edit / write 这类写入工具的结构化 file_path。实测某真实会话：写入类 85 次、读取类 58 次，涉及文件 17 个（写）对 43 个（读）——两类混在一起时，读过的文件会把真正改过的挤出上限。write 的 content、edit 的 new_string 正文里出现的路径只算「文中提到」。

最近失败来自 tool/result 的 isError。实测某真实会话 374 条 tool/result 里 11 条失败，形如：

[edit] FS_STALE_VERSION：cannot write "…\inject-codex.ps1": file changed since it was read — re-read the file, then retry

这是"接着干什么"最直接的线索，而且纯机械可提取。成功的 363 条、以及用户主动打断（AbortError）和自动审查被中断这类噪音会被丢掉；同一条报错在多个工具上重复出现时按文本合并。

绝对路径锚点还会做一次存在性检查，已被删除或改名的会标上 （已不存在）——省掉新会话去翻一个不存在的文件。

用法

入口一：会话行菜单

1. 鼠标移到侧边栏任一会话，点行尾的「…」； 对哪个会话点都行，包括已经冷掉的会话（读取走 sessionQuery.readSession，不激活 agent）。
2. 点 继承。
3. 弹出预览：上面是源会话信息（标题 / 轮次 / 改过几个文件 / 失败几条 / 命令数 / 待办数），中间是可编辑的交接单全文，下面是一个勾选框。
4. 在 ## 下一步 下面写上你接下来要它做的事——越具体越好 （点名哪个文件、做哪一个动作），然后点「创建并继承」。

新会话会自动打开，标题是 继承: <源标题>，工作目录、模型路由、agent preset 都和源会话一致。

勾选框「创建后立即开始工作」默认勾上：交接单会经 sessionController.prompt 作为一条正常用户消息发出并立刻开始。
取消勾选时改为直接写入会话日志（session:append），只记录、不触发首轮，打开后你自己说要做什么。

降级会明说。 如果宿主没能自动开始（prompt 失败或不可用），对话框不会静默关掉，而是停在原地显示原因和新会话 id，并给一个「打开新会话」按钮——以前这里只写 console.warn，界面静默消失，用户会以为新会话已经在跑了。

入口二：/inherit 命令

/inherit 继承当前会话 /inherit <sessionId> 继承指定会话 /inherit --next 先跑一次 npm test 继承当前会话，并指定第一步 /inherit <sessionId> --next 换个文件继续 两者一起用

不带 --next 的裸文本只可能是会话 id，不合法就如实报错，不会被猜成"下一步"。

入口三：session_inherit 工具

注册给 agent 的同名工具，参数 sessionId（必填）、nextStep、start。
用途是让 agent 自己在上下文变长时提议换会话，或让用户通过 agent 表达意图。

三条入口最终走同一条链路：读源会话 → 机械提取 → 新建会话 → 挂工作区 → 注入交接单。

安装

本插件没有发布到 npm，从仓库直接装。改 profile 的 package.json，两处都要加：

{
"dependencies": {
"dsh-session-inherit": "link:/path/to/dsh-session-inherit"
},
"dsh": {
"profile": {
"bundles": [
"dsh-session-inherit"
]
}
}
}

bundles 才是加载权威——只写进 dependencies 不会挂载。装完重启 DSH。

桌面端的 profile 由 Electron 独占管理，全局 CLI 会拒绝操作它；那种情况直接改该 profile 的 package.json 再重启即可。

版本适配

在 DSH 0.2.0-rc.2（Windows）上验证通过。插件依赖若干 DSH 内部服务与菜单 slot 名，DSH 升级后可能失配。如果菜单项不出现、或插件页显示「异常」，先查 profile 的 compatibility.json——profile 启动时会校验插件对 @deepseek-ai/dsh 与 dsh- 的 peerDependencies，不满足的 bundle 会被整体跳过（日志里打印 skipping profile bundle）。把当前 DSH 版本加进 compatibility.json 的允许列表即可。

组件构成

- 宿主半 index.mjs：注册 POST /__session-inherit/preview 与 POST /__session-inherit/commit（同源校验，仅本机 loopback 使用）
- 客户端半 client.js：注册
sidebar.workspaces.session.menu.item(id session-inherit, order 350) 与
shell.overlay 上的预览对话框

只消费公开服务：agents（硬依赖）、sessionQuery、sessionController、 workspaceRegistry、sessionTitle、agentPresets、agentDefaultModel、webServer。
除 agents 外全部按需查找，缺一个就降级一项，不会让整个插件失活。

配置

profile 的 cordis.patch.yml 里可以覆盖（全部可选）：

- id: session-inherit
config:
enabled: true # false = 完全不注册 recentUsers: 6 # 交接单里带多少条最近的用户指令（1–50） startByDefault: true # 预览框里那个勾选框的默认值 cacheTtlMs: 120000 # preview → commit 之间复用一次日志读；0 = 不缓存

已知限制（如实说）

- 它不修复解码退化。 退化发生在"生成当前这一步"，是解码层的问题；本插件做的是换一个不带旧上下文的干净会话接着干，把"长历史 + 抽象意图"这两个诱因去掉。
新会话第一步照样有可能退化——那属于解码层的问题，由在生成侧做重复检测并中止的独立插件（如 dsh-degen-guard）处理，本插件不碰。
- 交接单是机械提取，不会替你想"下一步"。空着的话模型会先问你一句，这也是故意的。
- 源会话的第一条用户消息如果是很短的寒暄/引言，它就会以原样出现在「任务目标」里。
- "最后一段含空格"的路径要靠边界识别。 路径解析分三条路，按可靠性排序： ① 工具的结构化参数（read / grep 的 path）整串就是路径，最可靠； ② 被引号/反引号包起来的整段，边界明确；③ 剩下的靠正则扫，而正则的末段不允许含空白（否则会把后面的句子一起吞掉）。所以路径直接嵌在中文句子里、后面紧跟说明文字时（X:\work\My Project Name 这个项目），会被截断成 X:\work\My Project。实测某真实会话里这类残留约 4 处，都在「文中提到的路径」这一节（标题已注明"可能是噪音"）。
- 同一行里用空格相连的两个路径会被当成一个——已用"中间段不允许出现盘符冒号" 挡住 copy X:\p\a.cs X:\p\b.cs 这种；中文标点（，。；：、！？（）【】《》）也作为分隔符处理。
- 交接单上限 14,000 字符。超长时按优先级整节丢弃（先丢「文中提到的路径」→ 「读过的文件」→「项目内相对引用」→「命令」→「最后一次回复」→「待办」→ 「最近的用户指令」→「改过的文件」），「下一步 / 任务目标 / 改过的文件 / 最近失败」永不丢弃。真实的长会话实测约 4,000–6,500 字符，远没到上限。
- 源会话做过上下文压缩（compaction/）时，交接单会标注一句——压缩之后更早的原文已经不在日志里，机械提取自然也就取不到。

测试

node test/extract.test.mjs # 提取器纯函数（25）
node test/host.test.mjs # 宿主半：假 ctx 跑通端点注册、preview/commit 全链路、/inherit 参数解析（12）
node test/client.test.mjs # 客户端半：模块协议、slot 注册、降级菜单行，以及菜单→preview→确认→commit 全链路（5）

与已有插件的关系

写之前查过现成的方案，没有完全重合的：

- WeiYe6/dsh-session-handoff（dsh-session-handoff）最接近：/handoff 命令，同工作区新建会话 + 注入交接文档 + 自动打开。差别是它用 LLM 总结最近 N 轮，而且只能在当前会话里敲命令；本插件的入口在会话行菜单，对任意（含冷）会话可用，且不调模型、只搬具体锚点。
- ZhijiangTang/dsh-handoff：确定性地导出一份 HANDOFF.md，但不建新会话。
- liangmianya/dsh-synapse：可视化会话地图，按 DSH 原生 fork 关系连线——走的是"带上全部历史"的那条路。
- @michengai/dsh-archive-manager：它还往同一个菜单里注册了 delete-session （order 500）。本插件用 order 350，两者不冲突。

License

MIT