dsh-nested-followups

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

dsh-nested-followups

[English](README.md) | 中文

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

这是一个 DeepSeek Harness

插件，专门处理可持续递归嵌套的隔离追问，而且插件不设层数上限：先从任意回答岔出

一条侧线，再把侧线中任意层级的任意回答作为下一个隔离 fork 点；新回答仍可继续重复

同一操作，需要多少级就分多少级。每一级只继承自己的祖先链，主任务始终是一条干净的线。





_录制环境是未经修改的 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 版本兼容说明](docs/dsh-version-compatibility.md)。

当前开发目标是 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 里续

…(truncated)