dsh-composer-rewind 0.0.0-stage → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,90 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # Composer Rewind · 输入框历史
2
+
3
+ Composer Rewind 是 DeepSeek Harness Web UI 的输入框状态历史插件。它在你输入时静默保存整个输入框——文字、图片和文件附件、@ 引用、/ 指令——以及当时的模型、思考程度、权限预设和使用模式;需要时一键还原成记录时的完整输入框。
4
+
5
+ 所有数据只保存在本机浏览器,不上传、不写日志、不进会话记录。
6
+
7
+ ## 功能
8
+
9
+ - **完整记录**:输入框里的文字、图片和文件附件、@ 引用、/ 指令,以及当时的 DSH 配置。
10
+ - **完整恢复**:把一条历史还原成记录时的输入框,包括附件缩略图、引用与指令。
11
+ - **不打断输入**:停顿约 450ms 才写入一次,连续打字只更新同一条草稿,不会堆出逐字记录。
12
+ - **快速找回**:搜索、方向键选择、回车还原;`Ctrl+Alt+Z` 连续回溯更早的输入内容。
13
+ - **原生外观**:复用 Harness 加号菜单的浮层外壳与主题 token,自动适配深色和浅色模式。
14
+
15
+ ## 记录内容
16
+
17
+ | 内容 | 说明 |
18
+ | --- | --- |
19
+ | 输入框文字 | 输入框中的完整文本 |
20
+ | 附件 | 图片缩略图、文件条目;附件字节单独缓存,恢复时重新挂回输入框 |
21
+ | @ 引用 | 文件引用及其在输入内容中的位置 |
22
+ | / 指令 | 输入框中的命令 token |
23
+ | DSH 配置 | 模型、思考程度、权限预设、使用模式(标准 / 精简 / PTC / 创造) |
24
+
25
+ ## 记录时机
26
+
27
+ - 停止输入约 **450ms** 后更新“当前草稿”;它始终只有一条,原地覆盖。
28
+ - **发送、清空输入框、切换会话、关闭或刷新页面**时,当前草稿进入历史。
29
+ - 10 分钟内同一草稿的前缀修改、回退会合并为一条,保留更完整的版本。
30
+ - 去空白后少于 3 个字符、且没有附件的内容会被忽略。
31
+ - 最多保留 **300 条**,超出后丢弃最旧的一条。
32
+
33
+ ## 使用
34
+
35
+ 点击输入框左侧工具栏的时钟按钮打开历史面板。
36
+
37
+ - 顶部搜索框可按文字、附件名或配置筛选。
38
+ - 记录按“当前草稿 / 今天 / 昨天 / 更早”分组。
39
+ - `↑` / `↓` 选择,`Enter` 还原,`Esc` 关闭。
40
+ - 鼠标悬停可查看完整文字、附件与当时的配置。
41
+ - 每条历史记录支持还原、复制、删除;“清空”会删除全部历史与附件缓存。
42
+ - 在输入框中按 `Ctrl+Alt+Z` 可直接回溯插入上一条,连续按下继续往前。
43
+
44
+ 还原只写入输入框,**不会自动发送**,可以继续修改后再提交。
45
+
46
+ ## 恢复范围
47
+
48
+ 还原一条记录时,插件按以下顺序恢复:
49
+
50
+ 1. 使用模式、模型与思考程度、权限预设。
51
+ 2. 附件:从本地缓存重建并重新上传到当前会话。
52
+ 3. 正文、@ 引用与 / 指令。
53
+
54
+ 使用模式只能在空白会话中切换;当前会话已经开始对话时,该配置会跳过并提示,其余内容仍会正常恢复。
55
+
56
+ ## 数据与隐私
57
+
58
+ | 存储 | 键 | 内容 |
59
+ | --- | --- | --- |
60
+ | `localStorage` | `dsh-composer-rewind:v3` | 历史条目(正文、引用、指令、配置、附件元数据) |
61
+ | `localStorage` | `dsh-composer-rewind:live:v3` | 当前草稿快照 |
62
+ | `IndexedDB` | `dsh-prompt-vault` / `blobs` | 附件字节(沿用旧库名,保证已记录附件仍可恢复) |
63
+
64
+ - 数据只存在当前浏览器配置中,按 Web GUI 的 origin 隔离;换端口或换浏览器不会共享。
65
+ - 清空历史会同时清理不再被引用的附件缓存。
66
+ - 旧版 `dsh-prompt-vault:v1` / `:v2` / `:v3` 的数据会在首次加载时自动迁移。
67
+
68
+ ## 安装
69
+
70
+ 从 npm 安装到当前 Harness profile:
71
+
72
+ ```bash
73
+ dsh plugin add dsh-composer-rewind
74
+ ```
75
+
76
+ 本地开发时也可以直接安装目录:
77
+
78
+ ```bash
79
+ dsh plugin add <本目录绝对路径>
80
+ ```
81
+
82
+ 安装后刷新 Web GUI 页面,输入框左侧会出现回溯按钮。
83
+
84
+ ## 已知限制
85
+
86
+ - 使用模式(agent preset)只能在空白会话中切换。
87
+ - 单个附件超过 32MB 时只记录元数据,不缓存字节,恢复时会标记为内容缺失。
88
+ - 浏览器存储配额不足时,部分附件可能只保留元数据。
89
+ - 只监听 Harness 的输入框,不记录页面中的其它输入框。
90
+ - 每条记录最多保留 20 个附件。