dsh-easyrewrite（DSH-EasyRewrite）

English | 日本語

在 DeepSeek Harness Web 里内联编辑与撤回你自己的消息——惰性、无痕、零丢失。

单击自己的消息气泡即可原位编辑；点击复制键旁的撤回键可撤回该消息及其后的全部内容。一切修改都发生在你真正确认之后——在按下「确定」（编辑）或「发送」（撤回）之前，对话、模型上下文、会话日志纹丝不动。

兼容 DeepSeek Harness Web（rc.6+），纯官方扩展点实现，不改 DSH 源码。

---

已实现功能

撤回（Recall）——端到端完成

• 撤回键：每条用户消息的官方复制键旁。
• 行内确认胶囊（dsh 风格灰色胶囊：撤回这条消息及其后 x 条提问？ + 白底黑字「确定/取消」）。
• 惰性提交：确认只回填输入框，真正截断发生在你按「发送」时；中途关掉 dsh，对话零改动。
• 「正在修改」条：输入框内部（分割线 + 标签 + 圆形 ×）；× 取消撤回并恢复原草稿。
• 覆盖 / 合并回填模式：覆盖模式下原草稿在发送/取消后都会恢复——信息零丢失。
• 将删除数量实时统计（仅用户提问，可开关）；0 条时显示「是否撤回这条消息？」。
• 单会话单待定，草稿按会话持久化（切会话/刷新不丢）。
• 无痕替换：发送即执行撤回——原会话归档，同名新会话（截断到目标消息之前）顶替，修改后的文本自动发出。感知上就是"原对话被编辑了"，而不是"冒出一个新对话"。

内联编辑（Rewrite）——已实现（M2）

• 单击气泡 → 原位编辑（保留原始 Markdown 原文），Esc 取消 / Ctrl+Enter 确定。
• 三档编辑宽度（紧凑：气泡原宽起步上限 360px / 标准：固定 360px / 扩展：748px 顶满），自动增高 + 内部滚动。
• 编辑态保留撤回键（隐藏复制键）；「确定」= truncate 编辑重发：截断 → 归档原会话 → 同名新会话 → 自动发送编辑后的文本。
• 编辑草稿按会话持久化（切会话/刷新恢复）；附件保留重发在路线图中。

规划中（Roadmap）

• < X > 版本翻页器（回答底部，视口锚定不跳位）。
• 草稿超时自动备份到本地文件（处理完成即删）。
• 可自定义撤回快捷键。
• 设置页（统计口径、视觉模式、编辑宽度、覆盖/合并…）。
• 简单 / 信息视觉模式（撤回待定时气泡灰字而非完全隐藏）。

---

设计哲学

1. 简单易用，易上手，兼容性好（Simple & Compatible）

• 交互直观到不需要说明书：点击气泡就编辑，复制键旁就撤回——不引入任何新概念、新入口。
• 默认即合理：默认设置就是大多数场景的最优解，装完即用，无需配置。
• 兼容性是硬承诺：只使用官方扩展点（keyed 槽覆盖、官方 fork RPC、官方组件与设计令牌），不碰源码、不依赖易碎内部 API；DSH 升级换代时主动适配，绝不拿"改了你的安装"换功能。
• 卸载即还原：不留配置残留、不改动任何官方文件。

2. 还原原版体验，无痕、无感（Faithful, Seamless & Invisible）

• 界面语言完全沿用 dsh 原生风格（灰蓝配色、圆角、胶囊、官方图标），深/浅主题自适应——像官方功能，不是"又一个插件皮肤"。
• 原有交互原样保留：复制键、hover 发送时间、气泡外观——一个都不少。
• 无感：日常使用几乎感觉不到插件的存在——该有的功能都在它该在的位置，按下去的结果就是直觉预期；不弹窗打扰、不打断节奏。
• 惰性提交是还原体验的根基：进入编辑、确认撤回都只是本地草稿态，context 只在「确定」（rewrite）或「发送」（recall）时真正修改——关掉 dsh，一切纹丝不动。
• 无痕替换：撤回之后，感知上就是"原对话被编辑了"——原会话归档、同名新会话顶替、修改后的文本自动发出，没有"冒出一个新对话"的割裂感。
• 气泡框编辑（即将上线）：点击气泡即原位编辑、所见即所改——同一套无痕哲学的自然延伸。

3. 持久化保留，防手误零丢失（Persistent & Accident-proof）

• 编辑/撤回草稿按会话持久化：切对话、刷新页面、重启 dsh，进度原样接续，不存在"写一半没了"。
• 覆盖模式下，回填前的原草稿在发送/取消后都会恢复——任何操作路径都不丢数据。
• 待定草稿长时间未处理自动备份到本地文件（处理完成即删），极端情况也有兜底。
• 每一步关键操作都有确认与撤销路径：确认胶囊、× 取消、单待定约束——手误可撤回，数据不损失。

4. 完善日志体系（Log Everything, Diagnose Fast）

• 全链路打点：client 的每个关键步骤（加载、确认、pending、发送钩子、fork、resume）自动上报 host，统一写入 $DSH_HOME/dsh-easyrewrite.log。
• 统一格式（JSON 行：时间 / 级别 / 标签 / 消息 / 数据），一次复现即可定位，不用你反复描述问题。
• host 自身行为同样落盘（请求、拒绝原因、异常），前后端一条链路可对账。
• 日志只记录本地行为，不上传任何数据。

5. 持续更新，积极兼容（Keep Moving）

• 跟随 DSH 版本迭代（rc.x → 正式版），上游 API 变化第一时间适配。
• 语义化版本 + CHANGELOG，每次改动可追溯；破坏性变更提前声明。
• 社区驱动：issue / PR 积极响应，新点子、新场景持续并入路线图。

---

安装

# npm 已发布（推荐）
dsh plugin --profile web add dsh-easyrewrite
# 或从 GitHub
dsh plugin --profile web add github:Renzic-Stone/DSH-EasyRewrite

重启 dsh web，页面 Ctrl+Shift+R 硬刷新即可。

撤回时机说明：DSH 的 fork 只能在闭合回合边界截断，未结束回合内的消息暂时无法撤回——等回复完成后即可。（界面会提示「该消息所在回合尚未结束…」）

---

调试

client 每一步都会上报 host 并写入统一日志：

$DSH_HOME/dsh-easyrewrite.log   # 例如 ~/.dsh/dsh-easyrewrite.log

JSON 行格式：{ t, level, tag, message, data }。

---

项目结构

dsh-easyrewrite/
├── lib/index.js          # host half：边界解析 + /bubble/recall、/bubble/log
├── src/client.src.js     # client 模板（图标构建期内联）
├── assets/               # 撤回/编辑图标（PNG，深色模式 CSS invert 自适应）
├── build.mjs             # assets → data-URL → lib/client.js
├── DESIGN.md             # 完整交互设计（v0.4，20 项产品决策）
├── PROJECT_PLAN.md       # 路线图、架构、git 工作流
└── docs/                 # api-facts、m0-verify

---

License

MIT