dsh-recall-unread

dsh-recall-unread DeepSeek Harness (DSH) 插件：撤回「已发送但尚未被模型读取」的文字消息。

在模型运行中发送文字（插话发送）时，消息会以“待处理”气泡的形式出现在对话尾部——在模型认领（读取）之前，你可以一键撤回，避免把还没想好的话发给模型。

当前版本 v1.2.1，兼容 DSH 0.2.1-rc.1 至 0.2.1-rc.5（desktop / web profile），并保留 0.1.x / 0.2.x 数据接口兼容。验证范围见兼容说明。 ✨ 功能特性 启用即生效：在插件市场（dsh-market）或插件管理页启用本插件后，「未读消息」条带立即生效；停用即整体不加载。不依赖任何启动器菜单。 未读消息条带：在输入框上方（conversation.input.dock 插槽）列出所有已发送但模型尚未读取的插话消息（0.2.x 取 inbox['next-step'] 的用户插话，0.1.x 取 placement === 'steering'）。 单条撤回：每条消息显示预览文本 + 「撤回」按钮，点击后消息从对话中移除，并提示“已撤回一条消息”。 全部撤回：存在多条未读消息时提供「全部撤回」一键操作；某条被模型抢先读取后，仍继续处理其他消息，并显示成功与失败条数。 只读语义：消息一旦被模型认领（开始读取）会自动离开条带，此时无法撤回——严格符合“仅未读取可撤回”。 优雅降级：撤回失败（消息已开始发送）时给出明确提示，不会破坏会话。 🔍 工作原理

DSH 中“已发送但未读取”的消息 = 仍停留在 Agent inbox（待处理队列）中的消息：0.2.x 是 inbox['next-turn'] / inbox['next-step'] 里的 pending 项，0.1.x 是会话快照 ConversationSnapshot.queue。它有两种 placement： 撤回实现分两个版本： 静态版（推荐）：Client 直接调用官方会话 RPC session.updateQueue(itemId, { kind: 'remove' })（与官方队列坞的「删除」同一实现）。 动态版：优先调用同一官方会话 RPC；仅在旧运行时没有 sessions 服务时，通过包内私有 RPC 回退：

🧩 运行时兼容 0.2.x 的 SessionSnapshot 已移除 queue 字段，本地回显改到 pendingSubmissions；插话被接纳后进入 inbox['next-step']，在模型下一步读取前仍可撤回。 官方队列坞只覆盖 next-turn（排队消息，已有删除按钮），next-step（插话）这一格由本插件补齐。 投影接口存在但尚未就绪时，不回退到旧快照，以免显示已被模型读取的陈旧消息。 与 RC 系列官方队列坞一致，只读子代理会话不显示撤回操作；可继续的子代理会话仍可操作。 RC1–RC5 已逐个官方 tag 核对相关源码契约，并用测试桩覆盖静态、动态客户端；尚未逐版本完成真实界面验收。详见兼容说明。

旧版 Host 回退直接调用 agent.inbox.remove；RC 系列使用官方 RPC，以保留会话检查和附件清理。 📁 目录结构

🚀 安装与激活 方式一：静态安装（推荐，随 DSH 加载，重启不丢失）

桌面版使用应用内的「插件 → 添加插件」安装或更新，填写包名 dsh-recall-unread。 网页版可使用 DSH 官方插件命令：

完全退出并重新启动对应的 DSH 应用。可在插件市场或插件管理页停用、启用插件。

上述包名命令安装的是 npm 当前已发布版本。GitHub 源码版本与 npm 发布进度可能不同；需要安装本次 v1.2.1 更新时，可克隆对应 tag：

桌面版在应用内添加克隆目录的绝对路径；网页版将包名替换为该路径：