dsh-delete-message

简体中文 | English

DeepSeek Harness 消息级删除插件，用于避免用户误发或错误的消息污染模型上下文。在每条消息的操作区提供删除按钮：确认后，该消息经由宿主官方 surface-replace 契约从模型上下文移除（助手回复连同其思考、工具调用与注入上下文一并删除），并从可见转录中隐藏。原始日志字节不做任何改写，随时可恢复。

功能

• 全消息类型 — 助手回复挂载于官方 conversation.chat.assistant-actions 槽位；用户输入、机器注入的上下文行、工具调用卡片、思考（Think）卡片、模型重试提示与回合错误横幅经 DOM 增强（宿主无对应侧操作条扩展点）。chrome 行（非用户/助手操作条）的删除按钮默认隐藏、悬停该消息时显示并允许点击。
• 原生视觉一致 — 复用宿主图标与按钮几何、primitives Tooltip 及 Modal+Button 确认弹窗，明暗主题自动适配。
• 上下文级删除 — 确认后追加 surfaceOp: { op: 'replace' } 占位节点（与宿主 /compact 同一机制），被遮蔽的消息不再进入 deriveMessages()。
• 转录级隐藏 — 宿主可见转录按设计只增不减，因此插件在浏览器端维护每会话已删 seq 台账（localStorage 持久化），解析行包装器的 React fiber 身份隐藏命中行；加载时经 /status 预检治愈本浏览器未知的历史已删行。
• 失败回合可清理 — 请求失败或中断的回合（如模型 502 重试耗尽）往往没有助手消息，删除按钮无处安放、注入上下文永久滞留；点击任一“上下文注入”行、工具调用卡片或重试提示行的垃圾桶，即按用户输入窗口整单元替换（注入行、回复、工具调用、重试记录一并清除，真实用户输入永不受影响）。
• 步骤级删除 — 多步回合中，点击 Think 卡或工具调用卡的垃圾桶只删除该步骤的回复与工具调用（assistant/message + 配对的 tool/result），同窗口内其他步骤原样保留；弹窗标题与 tooltip 明确标注范围（"删除这一步" vs "删除整个回复尝试"）。
• 角色化确认弹窗 — 确认文案由挂载点的静态消息角色自动选定，无需用户判断：用户消息陈述单条删除范围；助手回复明确连同思考、工具调用与注入上下文一并移除；注入行陈述整单元清理范围。
• 删除前预检与置灰 — 悬停/点击时经 TTL 缓存的 /status 预检：不可删的目标图标置灰并直接给出本地化原因，不做注定失败的请求；已被删除的行静默治愈隐藏；预检不可达时保持中性可点击（服务端始终权威）。
• 删除过渡反馈 — 确认后弹窗进入"删除中…"pending 态（spinner、抑制重复点击与取消），失败原因内联显示并可原地重试；成功后受影响行以高度塌缩级联动画优雅退场（遵循系统 reduced-motion 设置）。
• 中英双语界面 — 全部 UI 文案（确认弹窗、失败原因、无障碍标签等）内置 zh/en 双语，跟随系统设置中的语言选择即时切换；未设置时按浏览器语言自动判定。

行为变化

点击不同位置的垃圾桶，删除范围、弹窗标题和 Tooltip 提示各不相同：

步骤级删除适用于多步回合：只移除目标步骤的 assistant/message 及配对的 tool/result，同窗口内其他步骤原样保留。整窗口清理适用于失败/中断回合的一次性清扫。

界面截图

截图文件存放于 docs/screenshots/，各图内容与拍摄要求见该目录说明。

安全边界

• 服务端删除前重跑完整校验：仅接受已闭合回合中的 user/message 与 assistant/message 表面节点（真实用户输入只做单节点替换；助手消息、机器注入行与非表面 chrome 锚点如 tool/call、llm/retry 按用户输入窗口整单元计划）；携带工具调用的消息不可单独删除、已被遮蔽的消息与进行中的回合一律拒绝，并返回机器原因码（UI 本地化展示）。
• HTTP 写路径双条件屏障：仅接受回环地址且 Host 为本机。
• 插件零配置、零运行时依赖；不删除文件、不改写日志。

安装（web profile）

dsh plugin --profile web add github:viplocco/dsh-delete-message#v0.2.2

安装后需完全重启 DSH Web 进程（宿主侧插件树仅在启动时读取）；客户端 bundle 由宿主按请求动态 serve，更新后硬刷新即生效。

安装（desktop profile）

DSH Desktop 外壳渲染的是同一套 web 前端（@deepseek-ai/dsh-web-app 组合 + 同一 WebServer 源），因此本插件天然兼容桌面端——唯一要求是把它装进桌面所属的 profile 并重启 DSH Desktop：

# 桌面端使用独立的 desktop profile，需单独安装
dsh plugin --profile desktop add github:viplocco/dsh-delete-message#v0.2.2
# 或从本地工作区：dsh plugin --profile desktop add link:E:/project/DSH/Delete-message

安装后完全重启 DSH Desktop，并在浏览器/渲染器硬刷新。核实是否生效：

dsh --profile desktop --dump-config   # 应出现 "# == dsh-delete-message" 段落
# 渲染器打开开发者工具，控制台应出现 "[delete-message] bundle script executing"

为何之前"web 能用、桌面不能用"：插件 host 半边曾读 session.events，被当前 harness（dsh-session ≥ 0.1.2-rc.1，DSH Desktop 打包）改名成 session.snapshotEvents()，导致桌面端 /status 抛 Cannot read properties of undefined (reading 'find')。v0.2.2 已改经 eventsOf() 兼容两代会话形状（优先 snapshotEvents()、容忍旧 .events、其余返回 not-found 而非崩溃）。

开发

pnpm test    # node --test

升级验证（DSH 核心升级后必跑）

插件依赖三处宿主私有耦合——React fiber 内省（__reactFiber$*）、CSS-modules 哈希类名（*_actions 令牌）、以及 data-chat-flow-key/data-context-source 等 data-* DOM 钩子。这些耦合在宿主升级后静默断裂（图标/按钮不挂载，不报错），所以每次升级 DSH 核心后须跑一键回归：

# 前置：已完成核心升级并重启 dsh web（见 docs/DESIGN.md § 升级流程）
node scripts/run-upgrade-check.mjs        # 全量：健康检查 + smoke + 三个深探针
node scripts/run-upgrade-check.mjs --only-smoke   # 仅 Node 冒烟（不启动浏览器）
node scripts/run-upgrade-check.mjs --probe preflight  # 单跑某个探针

脚本为每个探针启动一次性无头 Edge（独立 CDP 端口 + 独立临时 profile），结束后自动回收，遇已知的无头 Edge 导航崩溃会自动重试一次。环境变量覆盖：DSH_EDGE（Edge 可执行路径）、DSH_PROBE_GUI（默认 http://127.0.0.1:3080/）、DSH_PROBE_PROJECT / DSH_PROBE_SESSION（测试会话定位）、DSH_KEEP_EDGE=1（保留 Edge 便于调试）。

探针清单（tmp-probe/）：

架构、宿主契约与设计取舍详见 docs/DESIGN.md。联系方式：viplocco@qq.com

License

MIT