dsh-easyrewrite

Readme

<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Renzic-Stone/DSH-EasyRewrite/main/assets/logo-dark.png" />
<img src="https://raw.githubusercontent.com/Renzic-Stone/DSH-EasyRewrite/main/assets/logo.png" alt="dsh-easyrewrite" width="320" />
</picture>

# DSH-EasyRewrite

[English](README.en.md) | [日本語](README.ja.md)

<a href="https://www.npmjs.com/package/dsh-easyrewrite"><img src="https://img.shields.io/npm/v/dsh-easyrewrite?style=flat-square&label=npm&color=4d6bfe" alt="npm version"></a> <a href="https://github.com/Renzic-Stone/DSH-EasyRewrite/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Renzic-Stone/DSH-EasyRewrite?style=flat-square&label=license" alt="license"></a> <a href="https://github.com/Renzic-Stone/DSH-EasyRewrite/stargazers"><img src="https://img.shields.io/github/stars/Renzic-Stone/DSH-EasyRewrite?style=flat-square&label=stars&color=f1c40f" alt="stars"></a> <a href="https://www.npmjs.com/package/dsh-easyrewrite"><img src="https://img.shields.io/npm/dm/dsh-easyrewrite?style=flat-square&label=downloads&color=2ea44f" alt="downloads"></a> <a href="https://dshfind.com/zh/plugins/Renzic-Stone/DSH-EasyRewrite?ref=badge"><img src="https://dshfind.com/api/badge/Renzic-Stone/DSH-EasyRewrite?metric=downloads&lang=zh" alt="dshfind"></a>

`#dsh` `#deepseek-harness` `#撤回` `#气泡编辑` `#重编辑` `#版本翻页器` `#i18n` `#多语言`

</div>

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

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

> 兼容 DeepSeek Harness Web（**2.4.0 要求 dsh 0.1.2-rc.1+**；0.1.1-rc.2 及更早宿主用户请停留 **2.3.1**——该线最终版，功能完整可用，仅不再追加新功能）。纯官方扩展点实现，不改 DSH 源码。

---

## 快速开始

```sh
# npm一键安装

dsh plugin --profile web add dsh-easyrewrite

```

## 已实现功能

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

### 内联编辑（Rewrite）——已实现（M2）
- 单击气泡 → 原位编辑（保留原始 Markdown 原文），Esc 取消 / Ctrl+Enter 确定。
- **三档编辑宽度**（紧凑：气泡原宽起步上限 360px / 标准：固定 360px / 扩展：748px 顶满），自动增高 + 内部滚动。
- 编辑态保留撤回键（隐藏复制键）；「确定」= truncate 编辑重发：截断 → 归档原会话 → 同名新会话 → 自动发送编辑后的文本。
- 编辑草稿按会话持久化（切会话/刷新恢复）。
- **带图片消息 Rewrite 完整支持（撤回键 + 气泡框编辑双路径）**：确认后图片随修改文本一并发出；气泡框编辑中可 × 删除、可粘贴 / 拖入新增图片、可直接切换模型与推理等级，刷新后编辑进度原样恢复。目前市面竞品完全无同类功能。

### 设置（Settings）——已实现（M3）
- **设置 → 插件 → 插件配置**：官方同款可折叠卡片（点击标题展开/收起），界面语言自动切换（中文 / English / 日本語）。
- 全部选项即时生效：气泡框编辑开关、关闭编辑时显示撤回键、撤回确认胶囊、撤回视觉模式（简单 / 极简 / 信息）、统计口径（仅用户提问）、回填冲突模式（覆盖 / 合并）、编辑宽度（紧凑 / 标准 / 扩展 / 自定义）。

### 草稿自动备份（Auto-backup）——已实现（M3）
- 待定草稿超过 10 秒未处理自动备份到本地文件（之后每 5 秒刷新）；「确定 / 发送」处理完成即删除备份。
- 备份位置：`$DSH_HOME/dsh-easyrewrite/backups/<会话ID>.json`。
- 恢复兜底：仅当本地没有待定状态时才从备份恢复——绝不覆盖正在编辑的草稿。

### 版本翻页器（< X >）——已实现（M3）
- 每次撤回/编辑重发后，该次问询最后回答的操作区出现 **`‹ X/N ›`** 控件；点击（或键盘 ←/→）切换版本，**后续上下文跟随版本变动**。
- **归档交换**：切换 = 恢复目标版本 → 打开 → 归档家族其余全部——**工作区列表始终只有一个活动版本**，无缝切换。
- 切换时**视口锚定不跳位**（官方 `data-chat-anchor-key` 定位恢复）。
- 全归档后仍可在 **设置 → 插件配置 → 「版本」组** 逐版本「恢复并打开」。

### 撤回快捷键——已实现（M3，Beta）
- 设置内**总开关默认关闭**（避免与其他插件快捷键打架），开启后可**录制**任意组合键（至少一个修饰键）。
- 触发条件：输入框未聚焦且当前会话最近一条为用户消息——等效点击该消息的撤回键（确认胶囊照常出现）。

---

## 与同类插件的差异

| 能力 | dsh-easyrewrite | 其他撤回/编辑类插件 |
| :--- | :---: | :--- |
| 撤回（Recall） | ✅ | 基本功能 |
| **无痕替换**（做到“仿佛原生支持”的感觉，无感修改重发） | ✅ | 基本功能，但我们**做的更完善** |
| **惰性提交**（确认后才真正修改 context，中途退出零改动） | ✅ | 部分竞品直接改动，导致各种缓存命中/context问题 |
| **气泡原位编辑**（Rewrite） | ✅ | **目前市面竞品完全无同类功能** |
| **版本翻页器 < X >**（切换历史版本，无数Chatbox验证过的**黄金设计**） | ✅ | **目前市面竞品完全无同类功能** |
| **草稿持久化 + 超时自动备份 + 异常恢复**（完善的恢复逻辑，保护您的每一份思考结晶）| ✅ | **目前市面竞品完全无同类功能** |
| **编辑重发保留图片附件** | ✅ | 目前市面竞品完全无同类功能 |
| **纯官方扩展点**（零源码补丁，卸载即还原） | ✅ | 竞品依赖源码补丁，卸载困难，依赖复杂 |
| 三语界面与 i18n 支持 | ✅ | 几乎没有完善的i18n支持，我们原生支持多语言和预设三语 |
| **全部功能可按需开关** | ✅ | **目前市面竞品完全没有比我们做得好的** |

---

## 设计哲学

**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 积极响应，新点子、新场景持续并入路线图。

---

## 安装

```sh
# 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             # 完整交互设计（v1.0，20 项产品决策）
├── PROJECT_PLAN.md       # 路线图、架构、git 工作流
└── docs/                 # api-facts、m0-verify
```

---

## License

MIT