递归隔离追问 sluminositys/dsh-nested-followups

dsh-nested-followups

从任意回答分叉，并在任意层级继续分叉。

这是一个 DeepSeek Harness 插件，专门处理可持续递归嵌套的隔离追问，而且插件不设层数上限：先从任意回答岔出一条侧线，再把侧线中任意层级的任意回答作为下一个隔离 fork 点；新回答仍可继续重复同一操作，需要多少级就分多少级。每一级只继承自己的祖先链，主任务始终是一条干净的线。

在真实 DeepSeek Harness 会话中从不同层级的回答持续创建多级隔离分支

_录制环境是未经修改的 DeepSeek Harness 0.1.1-rc.2 Web Profile。界面和 Session 都是真实的，后期只添加了说明字幕和鼠标指针。_

主任务 → 一级侧问 → 二级侧问 → 三级侧问 → ……

- 随时岔出一条侧线。 一级分支拿到的正好是所选回答当时已有的历史。
- 任意层级都能继续分叉。 每条侧线里的每个回答都能成为新的隔离 fork 点；到了下一级还可以重复同一操作，插件不设嵌套层数上限。
- 主任务保持干净。 分支里问过什么、答过什么，都不会流回主对话。

安装

请先按自己的 DeepSeek Harness 版本选择安装方式：

| DeepSeek Harness | 插件来源 | 状态 |
| 0.1.0-rc.7 至 0.1.1-rc.2 | npm dsh-nested-followups@0.2.3 | 保留旧版宿主兼容性 |
| 0.2.1-rc.5 Web / 官方桌面端 | npm dsh-nested-followups@0.2.3 | 当前开发目标 |
| 0.2.1-alpha.1、0.2.2-alpha.2 | 同一个包 | 另外验证的预发布版本 |

Web 安装

dsh plugin --profile web add dsh-nested-followups@0.2.3

如果 Web Profile 已经在运行，请重启一次。随后照常打开会话，点击顶栏的 Tree View。

从源码构建（可选，DSH 0.2 Web）

正常使用直接安装 npm 包即可。开发插件时，可以克隆仓库后在本地构建。下面显式调用对应版本的 CLI，避免电脑里旧的全局 dsh 把插件装进错误的 Profile 契约：

git clone --branch main --single-branch https://github.com/sluminositys/dsh-nested-followups.git
cd dsh-nested-followups
corepack pnpm install --frozen-lockfile
corepack pnpm run check
corepack pnpm dlx @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web add .
corepack pnpm dlx @deepseek-ai/dsh@0.2.1-rc.5 web

安装后，Profile 里记录的是指向当前源码目录的 link:。以后拉取更新，需要重新运行 corepack pnpm run check 并重启 Web Profile。

如果安装失败：直接安装 git+https://... 地址会执行本包的 prepare 构建脚本，
pnpm 要求用户先授权。可以直接安装 npm 0.2.3，或使用上面的“克隆、构建、安装本地目录”步骤；插件不会替你
修改脚本授权名单。若提示 npm 0.2.2 与 DSH 0.2.x 不兼容，指的是旧 npm 包，请明确安装 0.2.3。

官方桌面端

桌面端沿用 DSH 的 Web 界面，不需要重写画布或增加 Electron 扩展。但桌面端的插件安装在独立的 desktop Profile，装在 web 里的插件不会自动启用。

1. 先启动一次受支持版本的 DSH Desktop。在应用菜单的 Manage dsh Command… → Install 中安装桌面端自带的命令。
2. 完全退出桌面端，不要只关闭窗口。
3. 使用桌面端自带的 dsh 执行：

dsh plugin --profile desktop add dsh-nested-followups@0.2.3

4. 重新打开桌面端，在会话顶栏点击 Tree View。若安装本地源码，在构建后进入源码目录，将上面的包名换成 .。

不要用 npm 安装的 dsh 或 pnpm dlx 操作 desktop Profile，只有桌面端自带的命令能管理它。电脑上已有的全局命令可能抢先被找到，安装前请检查 dsh --version 及命令所在路径。桌面端安装 npm 包使用自带环境；只有编译源码才需要另外安装 Node 和 pnpm。
具体机制见 官方桌面端说明。

为什么不新开对话或做普通侧栏？

| 做法 | 保留此前相关上下文 | 不污染主任务 | 能否在任意层级继续分叉 | 侧线仍依附根会话 |
| 在主对话里继续问 | 是 | 否 | 否 | 不适用 |
| 新开一个对话 | 丢失，或手工复制 | 是 | 否 | 否 |
| 常见的临时侧栏问答 | 视实现而定 | 通常可以 | 通常仍是一条线 | 通常不会 |
| dsh-nested-followups | 精确继承祖先链 | 是 | 可以递归重复，不设固定深度 | 是 |

真正的区别不在画布本身，而在于：任意深度的一条回答都可以成为新的隔离 fork 点，它的后代仍然适用同一规则。树只是这套递归侧线的地图，让它们始终可见、依附于根会话，也不会把左侧会话列表塞满。

主任务旁可以从任意层级持续创建隔离侧线

_图中画出两层嵌套后以省略号继续：后续每一级的每条回答仍然可以执行相同的 fork 操作。_

使用方法

1. 照常聊天。DSH 原来的对话、侧边栏、输入框和消息渲染都不改变。
2. 打开 Tree View，选中一条早先的助手回答，点击 Ask follow-up。新问题会在右侧成为独立分支。
3. 在分支最新的回答上点击 Continue this branch，会沿当前分支向下追加一轮；再点 Ask follow-up，则会向右新建一层隔离分支。之后可以在任意后代回答上重复 Ask follow-up，继续生成更多层级。
4. 随时切回 Chat 继续主任务。主对话历史里不会出现任何分支消息。

| 动作 | 生长方向 | 对 Session 的影响 |
| Ask follow-up | 向右 | 在所选回答处新建一个隔离的子 Session |
| Continue this branch | 向下 | 在当前分支 Session 中追加下一轮 |

Continue this branch 只会出现在分支最新的已完成回答上，主线节点永远不会提供这个动作，因此“续聊”和“新建分支”不会混在一起。

为什么每一级都是真分支

它不是靠提示词要求模型假装看不见后续消息，也不是把互不相关的聊天画一条连线。

- 每一级分支，包括从另一条分支里继续分出的下一级，都是有持久历史的真实 DeepSeek Harness Session；
- 相同的 fork 规则会递归应用于所有层级，插件不限制嵌套深度；
- 分支的 seed 是截至所选完整回答为止的精确祖先链，边界语义与 DSH 自带的 Session fork 路径一致；
- 主任务、父级侧线或同级分支里后来出现的消息，只要不在祖先链上，就不会进入新分支；
- 消息不会向上回流父 Session，也不会横向流入同级分支；
- 分支工具在真正执行时受只读限制，不会因为临时追问改坏共享工作区；
- 请求前缀与分叉点处的父 Session 逐字节兼容，模型服务可以继续复用 prefix cache。

Tree View 里有什么

- 用户消息和助手回答各自一张卡片，主线向下，隔离分支向右；
- 分支内可线性续聊，也可以不限层级地继续分叉；
- 搜索命中折叠内容时，会先展开祖先链再定位；
- Focus、拖动画布、缩放、适配画布和小地图；
- 点位 → 胶囊 → 卡片的渐进展开，以及一键全收；
- 级联删除，并在确认前准确显示分支数和消息数；
- 重启后恢复分支元数据和每个会话自己的视图状态；
- 分支不会出现在普通的左侧会话列表中。

渐进折叠

第一次打开时，树以最小形态出现：一条主线，加上每个分支锚点旁的一枚点位。点击 ⊕ 后显示每条分支各自的胶囊，再点击胶囊才恢复消息卡片。下一级锚点仍保持折叠，因此展开一层不会把所有后代一次性铺满画布。

按住 Alt 点击 ⊕ 或胶囊，可以深度展开全部后代。Collapse all 会把所有一级分支收回点位。蓝色脉冲表示折叠内容仍在生成，红色表示其中有失败；重启后会按会话恢复布局。

分支只读执行

分支与主对话共用工作目录，所以让一个临时问题拥有写权限并不安全。插件会在工具真正执行时进行检查：读取类操作放行，写入与未知工具默认拒绝。

允许的工具包括 read、read_image、glob、grep、lsp、session_* 查询工具、job_list、job_output、terminal_list、terminal_read、list_agents 和 get_goal。代码模式的 run_code 仍可使用，因为它调用的每个工具都会被逐个检查。

复用模型服务的 prefix cache

分支沿用父 Session 的配置组合，也不会改写工具定义、提示词段落或呈现格式。因此，分支请求的开头与父 Session 在分叉点处的请求保持相同。支持请求前缀缓存的模型服务可以直接复用这段上下文，不必重新读取继承来的整段会话。

环境要求

| 项目 | 版本 |
| DeepSeek Harness | 0.2.1-rc.5，以及上表中已验证的 alpha 和旧版宿主 |
| Node.js（编译源码 / Web） | ^22.19.0 或 >=24.0.0 |
| 包管理器（编译源码） | pnpm |

兼容性说明

当前源码适配旧版 RC 和新版 0.2 的会话快照、继承历史、持久化只读句柄、实时回答事件、工具结果、原生图标及消息渲染。它不修改 DSH，不改写会话日志。分叉仍以已完成回合为边界，不使用新版宿主允许从未完成回合分叉的能力。

自动化检查和运行验证的范围分别记录；桌面端使用相同的 Web 插件机制，但 Web 启动通过不等于已经完成桌面安装包的端到端测试。
具体契约映射与维护者验证流程见 DSH 版本兼容说明。

当前开发目标是 DSH 0.2.1-rc.5；同一份源码也检查了 0.2.1-alpha.1、 0.2.2-alpha.2 和旧版 0.1.1-rc.2。上述适配已包含在 npm 0.2.3 中。
DSH 0.2.2-alpha.2 要求 Node.js 24.9 及以上；桌面安装包自带运行环境。

分支目前不能在原生 Chat 里续聊。 DSH 会拒绝从普通对话界面向 subagent-origin Session 发送用户消息，因此分支的阅读和续聊都在 Tree View 中完成。插件已经预留对未来宿主能力的探测，但只有 DSH 明确保证消息可投递时才会启用原生续聊。

分支可能在 DSH 自带的 Subagent 菜单里显示为禁用的诊断行。 这些行无法选择，键盘导航会跳过，也不会计入活跃子代理数量。根会话和左侧栏不受影响，分支 Session 仍不会出现在普通会话列表里。

卸载

dsh plugin --profile web remove dsh-nested-followups

卸载会移除插件界面和服务，但不会修改主对话，也不会删除已经持久化的分支历史。

开发

pnpm install
pnpm run check

pnpm run check 会执行静态检查、宿主端与浏览器端类型检查、单元与集成测试、生产构建、冒烟测试和发布包校验。

| 命令 | 用途 |
| pnpm run lint | 静态检查 |
| pnpm run typecheck | 宿主端、浏览器端和测试类型检查 |
| pnpm test | 单元测试与集成测试 |
| pnpm run build | 生产构建 |
| pnpm run check | 完整发布门禁 |

参与贡献

欢迎提交 Issue 和 Pull Request。请先阅读 CONTRIBUTING.md，并在提交前运行 pnpm run check。

许可证

MIT