dsh-turn-eraser

Name: Nagiko0739/dsh-turn-eraser
Author: Nagiko0739

给 DeepSeek Harness（DSH）用的会话清理插件：删除某一轮对话。

删除 = 把内容从模型可见的上下文里遮蔽掉。原始会话日志一个字节都不改，随时可以读回来。

但使用删除后，模型在当轮会话中读取/占用的上下文是变小了的。

English summary ↓

为什么做这个

DSH 的会话记录是只追加的事件日志，本身不提供删除某一轮对话的入口。而实际使用中确实会遇到需要"擦掉"某段对话的场景：

上下文被污染：某几轮让对话跑偏了，之后每轮都受影响，越聊越歪
发错了话：提问打错、贴错文件
整理会话：把试错的过程清理掉，留下干净的结论
清理过长的上下文，防止模型上下文过重掉进loop/空回。

本插件的特点是：每一轮都能删（包括"空回"轮次），并且删除可回溯。

功能

能力	状态
删除某一轮（你的提问 + AI 的整轮输出）	✅ 已实现
删除此处及以后	✅ 已实现
每轮都有删除入口（含没有正式回答的"空回"轮次）	✅ 已实现
删除后把该轮从界面上隐藏	✅ 已实现
审计：读回被删除的原文	✅ 已实现（见下）
删除整个会话	❌ 未实现
彻底擦除（物理抹掉日志）	❌ 未实现，也不建议（见「已知限制」）

安装

推荐：从 npm 安装（最省事）

在 DSH 的 设置 → 插件 → 添加插件 里，填入包名：

dsh-turn-eraser

或者用命令行：

dsh plugin --profile <你的配置档名> add dsh-turn-eraser

💡 如果提示装不上：DSH 有一条「新版本冷却期」的安全策略，刚发布的版本可能被挡住。这时把版本号一起写上就行，例如 dsh-turn-eraser@0.1.0。

其他方式：同一个输入框也支持 GitHub 仓库地址或本地目录路径。（本插件的仓库在 Nagiko0739/dsh-turn-eraser。）

使用

每一轮的尾部有一个小垃圾桶图标：

点它 → 浮出两个按钮：删除本轮 / 删除此处及以后
选中哪个，哪个就变成 再点一次确认
再点一次，才真正删除（4 秒不操作自动收起，防误触）

删除后：

模型：从下一轮起再也看不到这段内容
界面：那一轮整体隐藏（含思考过程、工具调用的折叠块）
磁盘上的日志：原文完整保留

工作原理：墓碑（tombstone）

DSH 的会话日志是"只追加"的，历史无法就地改写。所以本插件的删除是这样实现的：

往日志尾部追加一条墓碑事件，声明「把第 X 到第 Y 条事件从可见上下文里替换掉」。

原始事件仍然躺在日志里，只是不再进入模型可见的 surface。

一条墓碑长这样：

{
  "type": "user/message",
  "data": {
    "content": [{ "type": "text", "text": "[已删除 3 轮]" }],
    "source": {
      "producer": "session-tools",
      "action": "delete",
      "removed": [1634, 1636, 1638],
      "turn": 20,
      "preview": "（被删内容的一小段预览）"
    }
  },
  "surfaceOp": { "op": "replace", "startSeq": 1634, "endSeq": 1654 },
  "sourceEventSeqs": [1634, 1636, 1638]
}

⚠️ 两个技术细节，踩过坑：

墓碑必须是 user/message，不能是 assistant/message（后者携带 sourceEventSeqs 会被 DSH 的写入校验拒绝）

墓碑内容不能为空（严格的第三方服务商会拒绝空 user 消息）

可追溯：把删除的内容读回来

这是本插件的一个设计：删除不等于销毁。

# 列出所有会话的删除记录
python3 tools/audit_deletions.py

# 筛选 + 展开被删原文
python3 tools/audit_deletions.py <关键词> --full

输出示例：

会话 session-xxxxxxxx
  共 1 条墓碑

  墓碑 seq=1891  动作=delete  遮蔽 8 个事件
  被删内容预览：'行，咱们试试新上手的 pypdf 工具…'
  ---- 以下为原始内容（模型已看不到，日志里仍在）----
    seq=1634 [user/message]      （你的原话，完整）
    seq=1636 [assistant/message] （AI 回复正文）
    seq=1638 [tool/result]       （工具执行结果）

能做与不能做，说清楚：

能	不能
查出"删了什么、什么时候删的、属于哪一轮"	❌ 查不出"谁删的"（日志里没有操作者身份）
读回被删的原文（含思考过程、工具结果）	❌ 防不了篡改（日志是明文，改了就查不出来）
只取你要的部分（比如只要正文、跳过思考）	❌ 提供"一键撤销删除"

已知限制

诚实列表（都是实际撞过的）：

不能一键撤销。DSH 的 surface 只有 append 和 replace 两种操作，replace 一旦执行，被替换的节点就从可见列表里消失了，后续事件无法把它放回去。要"恢复"，正确做法是用上面的审计工具把原文读出来，而不是改日志。
审计防不了篡改。日志是明文 JSON，谁能读就能改。如果需要防篡改，得引入哈希链或外部存证——本插件没有。
依赖 DSH 的界面结构。删除入口挂在官方插槽 conversation.chat.turnTail 上。这是官方支持的做法，但如果 DSH 大改界面结构，插件可能需要跟进。代码里做了"读 DOM 兜底"以防万一。
引用了一个官方组件库（@deepseek-ai/dsh-client-ui-primitives）。官方文档并不推荐插件引用它。代码里做了自绘兜底：拿不到这个库时按钮依然可用，只是外观退化。
"删除整个会话"尚未实现，目前也没有实现这个功能的计划。
不做物理擦除。本插件永远不会去重写会话日志文件——那是高风险操作（日志有连续编号，重排出错会导致整个会话打不开）。

开发与测试

零运行时依赖，纯 JavaScript（宿主侧）/ 浏览器端（界面侧）。

node --check index.js client.js

node tests/01-tombstone-shape.mjs      # 墓碑形状是否符合 DSH 的全部约束
node tests/02-tool-params.mjs          # 工具参数解析
node tests/03-tool-execute.mjs         # 工具执行路径（含防死锁）
node tests/04-http-entry.mjs           # 界面按钮走的 HTTP 入口
node tests/05-real-log-regression.mjs  # 真实日志回归（无日志时自动跳过）
node tests/06-client-load.mjs          # 客户端 bundle 加载
node tests/07-truncate-span.mjs        # 截断的区间计算
node tests/08-tombstone-text.mjs       # 墓碑文案的轮数统计

致谢

dsh-turn-delete（MIT，作者 hanshenmesen）—— 「整轮删除」的思路、以及"用 DOM 兄弟遍历隐藏整轮"的做法借鉴自它。
dsh-message-recall（MIT）—— 墓碑写入的方式（user/message + surfaceOp: replace）参考了它，包括"占位文本不能为空"这个踩坑经验。
开发过程：本项目由 Nagiko0739（需求、产品决策、测试、验收）与 AI 助手协作完成。代码主要由 AI 编写，方向与判断由人把关。

依照多数司法辖区的规则，AI 生成内容不享有著作权，因此版权行只署名人类作者；AI 的贡献记在这里。

License

English summary

dsh-turn-eraser — a plugin for DeepSeek Harness (DSH) that deletes a conversation turn.

Install from npm: dsh-turn-eraser (or add the GitHub repo / local path in the DSH Plugins page).

Deletion works by appending a tombstone event that hides the target range from the model-visible context. The underlying session log is never rewritten, so the original text can always be read back with tools/audit_deletions.py.

✅ Delete one turn (your prompt + the whole assistant reply), including turns with no visible answer
✅ Delete from this turn onward
✅ Every turn has a delete entry point (official conversation.chat.turnTail slot)
✅ Traceable by design — deleted content is hidden, not erased
❌ No "undo"; to recover content, read it back from the log
❌ Not tamper-proof (the log is plaintext)

Licensed under MIT. Built by Nagiko0739 in collaboration with an AI assistant.

Nagiko0739/dsh-turn-eraser