dsh-per-turn-isolation

> 一句话定位：它把一条越滚越长的对话，变成"每轮各自独立"的问答——历史自动折叠、规则每轮重注，给用 DSH 跑批量重复任务、又心疼上下文费用的人用。

适合谁 / 不适合谁

• 适合：如果你要在同一个会话里连续问几十轮、希望每一轮都严格遵守同一份规则（人设、代码规范、输出格式、回答语言）、在意上下文占用与费用不随轮数上涨，或者在"同一要求反复换输入"的批量任务（DSH 是什么，见安装的前置条件表）。
• 不适合：如果你需要模型记住整段对话（逐步排查 bug、多轮追问细节、边聊边改需求）——开着它模型会"失忆"，请保持关闭；如果你只是偶尔问一两句，本来也没有上下文堆积问题，建议不装。
• 本插件不做：不删除聊天记录（历史始终完整保留，只是对模型不可见）；不修改 DSH 源码；不替代 /compact；不做跨会话的记忆或摘要。

安装

前置条件

该选哪种方式

方式一：GitHub 直装（推荐，完整步骤）

dsh plugin --profile web add github:xinshang777/dsh-per-turn-isolation

安装成功后 dsh plugin 会把包登记进 profile 的 dsh.profile.bundles，不需要手动改配置。

方式二：link: 本地开发（改源码 / 提 PR 走这条）

git clone https://github.com/xinshang777/dsh-per-turn-isolation.git
cd dsh-per-turn-isolation
dsh plugin --profile web add link:.

用 link: 装的好处：改完源码不用重装，重启 dsh web 就生效，可以直接改 lib/index.js（宿主侧）与 client.js（浏览器侧）验证行为。

方式三：Download ZIP（离线 / 锁版本）

1. 打开仓库页面 → Code → Download ZIP，解压到任意目录；
2. 在该目录执行 dsh plugin --profile web add link:.（ZIP 解压出来就是源码，所以用 link: 挂上去）；
3. 重启 dsh web。

⚠️ 此方式不会自动更新，升级要重新下载。

重启说明

> 💡 装了 dsh-restart-button 的话，点界面上的重启按钮一步到位，不用回命令行。

三十秒验证成功

打开 dsh web → 看到输入框发送区「回退」按钮左边多了一个「独立」开关 = 装好了。

flowchart LR
A["输入框"] --> B["「独立」开关本插件注入"]
B --> C["「回退」"]
C --> D["发送"]

如果没看到按钮，按顺序查三步：① ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组里有没有 dsh-per-turn-isolation；② 是否完整重启了 dsh web（不是刷新页面）；③ 浏览器硬刷新。

使用教程

1. 找到开关 —— 它被注入在输入框发送区，位于「回退」按钮的左边。
2. 设置长期规则并开启 —— 点击「独立」→ 弹出对话框 → 在输入框里写你想让模型"永远记住"的那段话（可以留空）→ 点「保存并开启」。
3. 验证隔离生效 —— 连续问两轮：

第 1 轮：记住一个数字：42
第 2 轮：我刚才让你记的数字是多少？

开启时第 2 轮答不出来——因为第 1 轮已被折叠，这正是隔离生效的表现；而界面上你仍能往上翻到第 1 轮。

4. 关闭 —— 再点一次「独立」→ 对话框里点「关闭功能」。对话框再次打开时，若功能已在运行，里面会显示「关闭功能」按钮。
5. 长期规则可以这么写 —— 按会话保存，换会话互不影响。

flowchart TD
A["一轮开始"] --> B{"step === 1 ?"}
B -->|"是"| C["把之前所有可见节点折叠成一个占位节点"]
C --> D["写回会话树界面历史仍可见"]
C --> E["注入长期规则到系统提示"]
D --> F["模型只看到本轮 + 长期规则"]
E --> F
B -->|"否"| G["不干预"]

配置项

本插件在 bundle 层没有可配置项（cordis.patch.yml 里没有任何 config:），全部设置都来自界面上的对话框，并按会话落盘。状态文件里的字段如下：

> 没有记录 = 关闭 + 规则为空，所以新建会话默认是关闭状态。

常见问题 / 排障

1｜开启后模型"失忆"，答不上之前的内容

• 原因：这是设计目标，不是 bug。本轮之前的历史已被折叠成一个占位节点，模型确实看不到。
• 处理：需要模型记住上下文时，再点一次「独立」→「关闭功能」即可。

2｜输入框旁边没有「独立」开关

• 原因：三种可能——插件没被挂载进 profile、进程没完整重启、页面是旧缓存。
• 处理：① 打开 ~/.dsh/profiles/web/package.json，确认 dsh.profile.bundles 数组里有 dsh-per-turn-isolation；② 完整重启 dsh web（不是刷新页面）；③ 浏览器硬刷新 Ctrl + F5。

3｜关闭功能后，更早的轮次还是没有回到模型上下文

• 原因：预期行为。已折叠的更早轮次不会回溯恢复——折叠是写入会话树的动作，不是临时开关。
• 处理：想恢复完整上下文，开一个新会话，或依赖 DSH 自身的 /compact / 会话管理。上一轮会正常保留。

完整排障表

兼容性与已知限制

• 宿主最低版本：Node.js ≥ 18；peerDependency @deepseek-ai/cordis ^4.0.1；需要能跑起 dsh web 的 DSH。
• 平台差异：无。插件不含平台特有代码，Windows / macOS / Linux 行为一致。
• 冲突插件：未发现硬冲突。但需要留意——任何依赖"本轮之前的完整历史"的功能，与本插件同开时行为会受影响，因为历史确实已被折叠。若你已经装了上下文压缩 / 摘要类插件，建议先单独验证两者叠加后的表现。
• 已知限制：只做"折叠 + 注规则"，不理解语义；折叠不可回溯；规则文本会随系统提示发给模型服务商（见隐私）。

升级、卸载与数据

• 配置存放位置：$DSH_HOME/.dsh-per-turn-isolation.json（默认 ~/.dsh/.dsh-per-turn-isolation.json），按 sessionId 保存 enabled 与 rule。除此之外不在任何位置落盘。
• 升级：
• github: 方式：重跑一次 dsh plugin --profile web add github:xinshang777/dsh-per-turn-isolation，或指定版本 ...add github:xinshang777/dsh-per-turn-isolation#v0.1.0；
• link: 方式：git pull 后重启 dsh web。
• 干净卸载：

dsh plugin --profile web remove dsh-per-turn-isolation

然后（可选）删除状态文件 ~/.dsh/.dsh-per-turn-isolation.json。插件不写注册表、不写系统目录，删完无残留。
- 回滚：link: 方式 git checkout <上一个 tag 或 commit> 后重启；github: 方式把版本号换成旧 tag 重装。状态文件与版本无关，不受影响。

隐私

• 数据是否出本机：不出。插件不发起任何外部网络请求，与页面之间只走回环 HTTP 接口（/dsh-per-turn/*）。
• 是否联网：不联网。除 DSH 自身与模型的通信外，本插件没有任何外部连接。
• 是否读取账号：不读。它既不看你的账号，也不读客户端的登录态文件；只读写 $DSH_HOME 下的那一个 JSON。
• 需要知情的一点：你填写的长期规则会被注入系统提示，因此会随每一轮请求发送给模型服务商。请不要在规则里写密码、密钥或其他敏感信息。

实现原理（贡献者向）

挂钩点 · 数据流 · 接口表 · 目录结构

挂钩点：agent/pre-step

插件实现 DSH 的 agent/pre-step 事件，在一轮的第一个步骤（step === 1）拦截：

ctx.on("agent/pre-step", async (payload, next) => {
const { agent, messages, turn, step } = payload ?? {};
const isTurnStart = step === 1 && Array.isArray(messages) && messages.length > 0;
// …
});

折叠：把历史压成一个占位节点

在该轮开始前，插件把「本轮之前的所有可见节点」合成一个 user/message 占位节点，并用 session.append("user/message", placeholder, …) 写回会话树。

• 写回会话树 → 所以界面上历史依然完整可见；
• 折叠成单节点 → 所以模型看不到更早的内容。

长期规则：走系统提示

通过 ctx.inject(["systemPrompt"], host => contribute(host)) 把长期规则贡献进系统提示，使它在每一轮稳定生效，而不是"靠历史里残留的一句指令"。

接口表

数据流

一轮开始（step === 1）
├─ 读取状态文件：该会话 enabled？rule？
├─ enabled=true → 折叠历史为占位节点 → session.append 写回会话树
└─ rule 非空    → ctx.inject(["systemPrompt"]) 注入
→ 模型只收到 [长期规则] + [本轮输入]

状态存储

// %USERPROFILE%\.dsh\.dsh-per-turn-isolation.json
{
"sessions": {
"": { "enabled": true, "rule": "…" }
}
}

目录结构

dsh-per-turn-isolation/
├── lib/index.js            # 宿主侧：pre-step 折叠 + 长期规则注入 + HTTP 接口
├── client.js               # 浏览器侧：注入「独立」开关按钮与设置对话框
├── cordis.patch.yml        # bundle 挂载声明（把插件插进 profile 配置树）
├── icon.svg                # 插件图标
├── locale/zh.json, en.json # 中英文文案
└── package.json

前端通过 @deepseek-ai/dsh-client-ui-slots 把按钮插进输入框发送区的插槽，并依赖 @deepseek-ai/dsh-client-connection 等客户端包与宿主通信。

详见 docs/architecture.md

贡献与反馈

CONTRIBUTING.md · CHANGELOG.md · Issue 模板

本地开发：把仓库 link: 进 profile 后改代码，重启 dsh web 即生效。

许可证

作者在 package.json 中声明为 MIT；但仓库目前没有 LICENSE 文件，GitHub 页面因此显示为"未指定"。建议补一个 LICENSE 文件以消除歧义。在此之前，如需使用请自行评估。