DSH Agent Enhancer：给 DeepSeek Harness 桌面端补上「写、改、回退」

一个 MIT 开源插件，让 DeepSeek Harness Desktop 更好写、更好改、更好回退 ：历史回顾・一键优化・下一条预测・对话与文件恢复，全部嵌在官方会话输入区，不用另开窗口。对齐的是主流 Agent（Claude Code / ChatGPT / Cursor）的 交互习惯 ，不是复刻整套产品能力。 GitHub： https://github.com/rebornace/dsh-agent-enhancer ｜ 国内镜像 Gitee： https://gitee.com/RebornAce/dsh-agent-enhancer ｜ npm 包 dsh-agent-enhancer （当前 0.2.0 ，界面名「智能体增强 / Agent Enhance」）｜ MIT 许可，收录于 awesome-dsh-plugin

一、为什么做

用过主流 Agent 产品的人，多半已经习惯：发出去的提示词能翻回来改一版再发；含糊草稿点一下就能改得更具体、可执行；回复结束后编辑器预判你下一句想说什么；改坏了代码或聊偏了，能回到之前某个节点。

DeepSeek Harness（DSH） 官方桌面端早期的会话输入区，这些能力基本缺位。dsh-agent-enhancer 的目标很明确：

• 不 fork、不魔改 DSH 核心、不依赖上游 PR，走官方插件机制（Cordis + Typert RPC）；

• 在官方桌面端内部把「写、改、回退」补齐。

二、功能亮点

全部挂在官方会话输入区与消息流上，不用另开窗口。默认四项全开，界面语言跟随桌面端（zh / en），可在 设置 → 内置插件 → 智能体增强 里单独开关。

1. 历史提示词：像终端一样翻

• 草稿首行 ↑、末行 ↓ 逐条翻本会话已发送提示词，Esc 退出；Alt+R 打开历史搜索（兼容 Ctrl+R），Enter 只填草稿、不发送；

• 只覆盖当前已加载会话；含 chip（引用块）的草稿不误触发。

2. 提示词优化：模糊稿补全，明确稿克制

• 输入区右侧点「优化」，有选区时只优化选区；不满意可「撤销」；

• 模糊 / 过短草稿补执行步骤、范围、限制与结构化输出要求；写清楚的只做最小改动；

• 用 __DSH_REF_n__ 占位符原样保留 chips / 引用及顺序，撤销也能还原引用结构；

• 可给优化单独指定更便宜的模型（见「模型药丸」）。

3. 下一条预测：回复结束后预判下一句

• 回复结束后出现灰色建议，Tab 填入草稿（不自动发送）；每轮最多一条，开始输入或切换会话自动清除；

• 系统提示词约束为「只预测下一条用户提示词」，不会去生成助手回答。

4. 对话与文件恢复：可预览、可撤销的「回到过去」

这是目前最重的一块，也是向 Claude Code /rewind、Cursor 检查点对齐的尝试：

• 每个 turn 结束在插件本地建立检查点（对话 + 已跟踪文件快照）；

• 消息旁点「恢复到这里」，先看预览（撤回范围、涉及文件、冲突），确认前不改任何状态；范围可选仅对话或对话 + 已跟踪文件，恢复后目标轮用户提示词进入可编辑草稿，不自动发送；

• 支持「撤销恢复」（恢复后通过输入框 + 或 / 菜单撤回最近一次恢复）；

• 明确边界：不恢复进程、终端、未跟踪文件、数据库与网络请求等；预览会列出缺口，不宣称「完整检查点」。

优化与预测旁各有一个模型药丸：默认「跟随会话」，也可单独指定提供商 / 模型 / 推理等级。插件本身 MIT 免费；这里省的是辅助调用的模型 API 费用—— 高频优化 / 预测走轻量模型，主对话继续用旗舰模型。

三、使用场景

• 长会话迷失：聊了 30 轮，想找回第 8 轮那条关键提示词 ——Alt+R 搜索，Enter 填入草稿改后重发。

• 草稿表达不清：需求想清楚了但组织不好 —— 点「优化」补执行步骤与约束；不满意「撤销」，chips 引用一个不少。

• 改坏想反悔：Agent 一次改了多个文件方向错了 ——「恢复到这里」预览确认后回退；恢复错了还能「撤销恢复」。

• 控制成本：优化 / 预测单独指定轻量模型，主对话仍用旗舰模型。

一句话：官方输入区从「发消息的框」，变成写（历史 + 预测）、改（优化 + 撤销）、回退（检查点 + 撤销恢复）闭环的工作台 —— 全在本地、全在官方 UI 内，不改变 DSH 核心的 append-only 会话日志。

四、技术实现

• 插件形态：@deepseek-ai/cordis 插件体系；dsh.bundle.patch 注入会话 UI 包；slots 注入按钮、浮层与消息节点；插件 ID agent-enhancer；

• 双端架构：src/host/ 管模型、RPC、检查点；src/client/ 管 UI 与状态机（Coordinator：编辑 / 历史 / 搜索 / 预测 / 优化）；请求带 owner 权限门禁；

• 模型路由：解析会话模型选择；优化 maxTokens=1200、预测 120；流式输出经 BlockAssembler 校验后写回；

• 检查点：turn 结束提交；阶段 preparing → session-flushed → workspace-captured → committed；≤20 个 / 会话、单文件 ≤2 MiB 纯文本；排除 .git、node_modules、.env / .env.*、构建目录、二进制、符号链接、工作区外路径；带 schemaVersion，格式不兼容拒绝恢复；v0.2.0 起旧包路径自动迁移；

• 事务回滚：恢复前做安全快照；先恢复文件、失败按 journal 补偿，不追加对话事件；崩溃后启动先处理未决 journal；冲突检测 —— 文件哈希与检查点 afterHash 不一致默认整次拒绝，不静默覆盖；

• 隐私：历史不请求模型；优化只发「原稿 / 选区 + 最近一轮」；预测只发「最近一轮」；缓存仅会话内存；审计事件 plugin:agent-enhancer/request 仅本地，无遥测上传；

• 质量：约 30 个 Vitest 文件覆盖检查点、回滚事务、RPC、结构化引用、组件与 locale。

五、快速上手

安装 / 升级 / 卸载前，请先退出所有 Desktop 窗口与托盘进程。本插件面向 Desktop / desktop profile（不要用 web profile 往桌面端装）。

corepack pnpm install –frozen-lockfile
corepack pnpm build
dsh plugin –profile desktop add ((Resolve-Path .).Path)

兼容性：DSH >=0.2.1-rc.5 <0.3.0-0（0.2.1-rc.3 无法加载）；Node ^22.19.0 || >=24.0.0。若曾安装旧包 dsh-composer-enhancer，请先卸载再装本包。

结语

DeepSeek Harness 在模型侧已经够用，dsh-agent-enhancer 补的是会话侧的「交互心智」：把写、改、回退通过官方插件机制嵌进桌面端。MIT 开源、无遥测、本地优先 —— 欢迎试用，也欢迎提 issue / PR。

• GitHub：https://github.com/rebornace/dsh-agent-enhancer

• Gitee：https://gitee.com/RebornAce/dsh-agent-enhancer

• 更新日志：仓库 CHANGELOG.md