@kangyishuai/dsh-session-rewind 0.4.0 → 0.5.1

package/README.md

@@ -8,7 +8,7 @@
 
 Unofficial plugin for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness). Not affiliated with DeepSeek.
 
-> **Status: early.** Verified end to end on DSH 0.2.2-rc.1: 31 GUI assertions in a throwaway DSH home, 158 unit tests, and a CDP-driven desktop pass (conflict refusal, conversation + file rewind, created-file trash, modified-file restore, rescue restore, panel/audit/diagnostics). Young software — keep backups of anything you cannot lose.
+> **Status: early.** Verified end to end on DSH 0.2.2-rc.1: 185 unit tests, 34 GUI assertions in a throwaway DSH home, and **36 assertions against the real desktop app** (read-only surface plus file mode: created-file trash, modified-file restore, rescue restore, timeline). `pnpm gate:session-rewind` runs the whole release gate in one command. Young software — keep backups of anything you cannot lose.
 
 ## What it does
 
@@ -21,6 +21,7 @@ Long conversations drift. A few turns later you wish you had answered a prompt d
 - **Conversation.** The target message and everything after it are withdrawn from the model-visible context and from the transcript. The session id, title and earlier history are untouched. Nothing is deleted from the log — one marker event is appended.
 - **Files (optional).** Files changed by `write` / `edit` / `apply_patch` in the withdrawn turns are restored to their pre-change content. Files created after the target are moved to the plugin's trash instead of deleted. A rescue point of the current files is created before anything is written; failures roll back from it.
 - **Composer.** The target message's text (and images) is put back into the composer, ready to edit and send again. An existing draft is never overwritten. Tick **Send this message again right after rewinding** in the confirmation dialog to retry the turn in one click (conversation-only rewinds).
+- **Every view stays in sync.** Rewind in one tab or window and other open views of the same session hide the withdrawn rows immediately, without a reload (the notice travels through `localStorage`; the host's cuts remain the only source of truth).
 - **Rewind panel.** A new header action opens a panel with four tabs: **Withdrawn** (every message each rewind removed, searchable, copy or put back in the composer), **History** (a timeline of each rewind and each rescue-point file restore, newest first: scope, message count, tokens, file results), **Rescue points** (restore files from an earlier rescue), and **Settings** (default scope, page size, confirm-on-list, diagnostics).
 
 ## Read-only agent tool
@@ -34,6 +35,16 @@ The plugin also registers one **read-only** tool, `session_rewind_candidates`, s
 
 The tool never rewinds, never edits files and never appends to the session log — the rewind itself stays a user action (that is the point of the ADR 0006 design). Set `readOnlyTool: false` to unregister it; **Settings → Diagnostics** reports whether it registered.
 
+## What it looks like
+
+![The rewind confirmation dialog: target message, how many messages and tokens will be withdrawn, conversation-only vs conversation-and-files, and the resend option](https://raw.githubusercontent.com/kangyishuai/dsh-plugins/main/packages/session-rewind/assets/session-rewind-confirm.png)
+
+![The rewind panel: withdrawn messages, history timeline, rescue points and settings](https://raw.githubusercontent.com/kangyishuai/dsh-plugins/main/packages/session-rewind/assets/session-rewind-panel.png)
+
+Both screenshots come from a throwaway DSH home containing only a synthetic workspace and session (`pnpm shots:session-rewind` regenerates them), cropped to the dialog and the panel.
+
+> Image links are absolute (`raw.githubusercontent.com`) on purpose: npm does not ship `assets/` in the tarball, so a relative path would render as a broken image on npmjs.com.
+
 ## Install
 
 ```bash
@@ -105,9 +116,9 @@ On startup the plugin also removes data for sessions that no longer exist (they
 
 ## Compatibility
 
-| DSH version | Status                                                                                                                      |
-| ----------- | --------------------------------------------------------------------------------------------------------------------------- |
-| 0.2.2-rc.1  | Verified: `pnpm smoke:session-rewind` (31/31) + 158 unit tests + CDP-driven desktop pass (conversation-only and file modes) |
+| DSH version | Status                                                                                                 |
+| ----------- | ------------------------------------------------------------------------------------------------------ |
+| 0.2.2-rc.1  | Verified: 185 unit tests + `smoke:session-rewind` 34/34 + desktop 36/36 (`--deep`, file mode included) |
 
 The plugin declares no `engines.dsh` and no `@deepseek-ai/*` peer range: DSH is pre-release and semver ranges over prereleases are unreliable (see [ADR 0005](../../docs/adr/0005-dsh-version-compatibility.md)). Treat the table as the compatibility statement. After a DSH upgrade run `pnpm probe:runtime`, `pnpm smoke:session-rewind`, and check the plugin's diagnostics tab; if a private seam changed, the plugin degrades instead of breaking the session.
 
@@ -117,7 +128,7 @@ The plugin declares no `engines.dsh` and no `@deepseek-ai/*` peer range: DSH is
 pnpm test                     # unit tests (host engine, host RPC, client helpers)
 pnpm verify                   # repo-wide gates
 pnpm smoke:session-rewind           # temp DSH home + real GUI end-to-end (needs dsh & ego-browser)
-pnpm smoke:session-rewind-desktop   # read-only desktop check (needs --remote-debugging-port=9222)
+pnpm smoke:session-rewind-desktop   # desktop (Electron) check: 21 read-only + 12 with --deep --workspace <dir>
 ```
 
 Design notes: [ADR 0006](../../docs/adr/0006-session-rewind-architecture.md) and [ADR 0007](../../docs/adr/0007-session-rewind-file-restore.md) (Chinese; the repository docs are written in Chinese).

package/README.zh-CN.md

@@ -8,7 +8,7 @@
 
 非官方插件，与 DeepSeek 无关。面向 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness)。
 
-> **状态：早期。** 已在 DSH 0.2.2-rc.1 上端到端验证：一次性 DSH 目录里 31 项 GUI 断言 + 158 个单测 + CDP 驱动的桌面版实测（冲突拒绝、对话+文件回退、新建文件进回收站、修改文件还原、救援点恢复、面板/审计/诊断）。插件还年轻，重要数据请自行备份。
+> **状态：早期。** 已在 DSH 0.2.2-rc.1 上端到端验证：185 个单测、一次性 DSH 目录里 34 项 GUI 断言、以及**真实桌面版 36 项断言**（只读界面 + 文件模式：新建文件进回收站、修改文件还原、救援点恢复、时间线）。`pnpm gate:session-rewind` 一条命令跑完发版门禁。插件还年轻，重要数据请自行备份。
 
 ## 它做什么
 
@@ -21,6 +21,7 @@
 - **状态变更提示**：如果要撤回的区间里改过会话状态（plan 模式、goal、待办、模型选择、权限/沙箱预设、智能体预设、定时任务、工作目录），确认框会列出来并明确说明——回溯只撤回对话，**不会**回滚这些状态。
 - **运行中也能回退**：确认回退时如果这一轮正在跑，会先取消它（保留队列）、等它空闲，再对新历史重新求值。
 - **输入框**：目标消息文本（以及图片）放回输入框，改完可直接重发；已有草稿绝不覆盖。勾选「回退后立即重发」可一键重试这一轮（仅对话模式）。
+- **多视图自动同步**：在一个标签页/窗口里回溯后，其它已打开的同会话视图会立刻隐藏被撤回的行，无需刷新（通知走 `localStorage`，渲染只认宿主 cuts）。
 - **回溯面板**：会话头部新增一个入口，四个页签：**已撤回**（每次回溯撤回的全部消息，可搜索、复制、放回输入框）、**回溯记录**（时间线：每次回溯与每次救援点恢复，新在上；范围、条数、token、文件结果）、**救援点**（手动恢复文件）、**设置**（默认范围、每页数量、列表确认、诊断）。
 
 ## 只读 agent 工具
@@ -34,6 +35,16 @@
 
 这个工具不回溯、不碰文件、不写会话日志——真正的回退始终由用户在界面确认（这是 ADR 0006 的设计前提）。设 `readOnlyTool: false` 可关闭；**设置 → 诊断**里能看到它是否注册成功。
 
+## 长什么样
+
+![回溯确认框：目标消息、将撤回多少条消息与 token、仅对话 vs 对话+文件、以及重发选项](https://raw.githubusercontent.com/kangyishuai/dsh-plugins/main/packages/session-rewind/assets/session-rewind-confirm.png)
+
+![回溯面板：已撤回、回溯记录、救援点、设置](https://raw.githubusercontent.com/kangyishuai/dsh-plugins/main/packages/session-rewind/assets/session-rewind-panel.png)
+
+两张图都来自一个只含**合成工作区与合成会话**的临时 DSH 目录（`pnpm shots:session-rewind` 可重新生成），并且按 DOM 矩形裁剪到对话框/面板本身。
+
+> 图片用绝对地址（`raw.githubusercontent.com`）而不是相对路径：npm 的 tarball 不含 `assets/`，相对路径在 npmjs.com 上会是破图。
+
 ## 安装
 
 ```bash
@@ -105,9 +116,9 @@ dsh plugin --profile desktop add /tmp/kangyishuai-dsh-session-rewind-*.tgz
 
 ## 兼容性
 
-| DSH 版本   | 状态                                                                                              |
-| ---------- | ------------------------------------------------------------------------------------------------- |
-| 0.2.2-rc.1 | 已验证：`pnpm smoke:session-rewind` 31/31 + 158 个单测 + CDP 驱动的桌面版实测（仅对话与文件模式） |
+| DSH 版本   | 状态                                                                                     |
+| ---------- | ---------------------------------------------------------------------------------------- |
+| 0.2.2-rc.1 | 已验证：185 个单测 + `smoke:session-rewind` 34/34 + 桌面版 36/36（`--deep`，含文件模式） |
 
 插件不声明 `engines.dsh`，也不声明 `@deepseek-ai/*` 的 peer 范围：DSH 还在预发布阶段，预发布版本的 semver 范围不可靠（见 [ADR 0005](../../docs/adr/0005-dsh-version-compatibility.md)）。以这张表为准。DSH 升级后跑 `pnpm probe:runtime`、`pnpm smoke:session-rewind`，并看插件诊断页签；私有 seam 变了会降级而不是让会话出错。
 
@@ -117,7 +128,7 @@ dsh plugin --profile desktop add /tmp/kangyishuai-dsh-session-rewind-*.tgz
 pnpm test                     # 单测（宿主文件引擎、宿主 RPC、客户端 helper）
 pnpm verify                   # 仓库统一门禁
 pnpm smoke:session-rewind           # 临时 DSH 目录 + 真实 GUI 端到端（需要 dsh 与 ego-browser）
-pnpm smoke:session-rewind-desktop   # 只读桌面回归（需要以 --remote-debugging-port=9222 重启）
+pnpm smoke:session-rewind-desktop   # 桌面（Electron）回归：只读 21 项，加 --deep --workspace <dir> 再 +12 项
 ```
 
 设计记录：[ADR 0006](../../docs/adr/0006-session-rewind-architecture.md)、[ADR 0007](../../docs/adr/0007-session-rewind-file-restore.md)。

package/lib/client.js

@@ -574,6 +574,33 @@ window.__ModuleLoader__.load({
     /** localStorage 偏好键；版本化，方便未来迁移。 */
     let PREF_STORAGE_KEY = "dsh-session-rewind.prefs.v1";
 
+    /** 跨视图广播键：某个视图回溯成功后写入，其它视图据此重新拉宿主 cuts。 */
+    let CUT_BROADCAST_KEY = "dsh-session-rewind.cut-broadcast.v1";
+
+    /**
+     * 解析跨视图广播载荷（脏数据一律返回 null）。
+     * @param {any} raw localStorage 里的字符串
+     * @returns {{sessionId: string, targetSeq: number|null, markerSeq: number|null, at: number} | null}
+     */
+    function parseCutBroadcast(raw) {
+      if (typeof raw !== "string" || raw === "") return null;
+      let value;
+      try {
+        value = JSON.parse(raw);
+      } catch (_error) {
+        return null;
+      }
+      if (!value || typeof value !== "object") return null;
+      let sessionId = typeof value.sessionId === "string" ? value.sessionId : "";
+      if (sessionId === "") return null;
+      return {
+        sessionId: sessionId,
+        targetSeq: typeof value.targetSeq === "number" ? value.targetSeq : null,
+        markerSeq: typeof value.markerSeq === "number" ? value.markerSeq : null,
+        at: typeof value.at === "number" ? value.at : 0,
+      };
+    }
+
     /** 客户端偏好默认值：默认仅回退对话、每页 100 条、列表选择先确认。 */
     let PREF_DEFAULTS = Object.freeze({
       defaultMode: "chat",
@@ -3770,6 +3797,8 @@ window.__ModuleLoader__.load({
         });
         rebuildSessionById(sessionId);
         let outcome = fillComposer(sessionId, summary.text || target.text || "");
+        // 同源其它视图也要立刻隐藏这些行（它们不会被这次 append 唤醒）。
+        broadcastCut(sessionId, summary);
         let text = t("toast.rewound", {
           n: summary.removedCount,
           tokens: formatCount(summary.tokens),
@@ -4250,6 +4279,57 @@ window.__ModuleLoader__.load({
       }
 
       /** 拉一次宿主 cuts 作为可见性兜底（静默失败）。 */
+      /**
+       * 把「这个会话刚回溯过」广播给同源其它视图（多标签/多窗口一致性）。
+       * localStorage 的 storage 事件只在**其它** document 触发，不会回环到自己。
+       * @param {any} sessionId
+       * @param {any} summary
+       */
+      function broadcastCut(sessionId, summary) {
+        try {
+          if (!window.localStorage) return;
+          window.localStorage.setItem(
+            CUT_BROADCAST_KEY,
+            JSON.stringify({
+              sessionId: sessionId,
+              targetSeq:
+                summary && typeof summary.targetSeq === "number" ? summary.targetSeq : null,
+              markerSeq:
+                summary && typeof summary.markerSeq === "number" ? summary.markerSeq : null,
+              at: Date.now(),
+            }),
+          );
+        } catch (_error) {
+          /* 存储不可用时退化为「只有本视图知道」 */
+        }
+      }
+
+      /**
+       * 监听其它视图的广播：收到就按宿主 cuts 重新隐藏（宿主是权威来源，不信任广播内容）。
+       * @returns {() => void} disposer
+       */
+      function installCutBroadcast() {
+        /** @param {any} event */
+        function onStorage(event) {
+          if (!event || event.key !== CUT_BROADCAST_KEY) return;
+          let payload = parseCutBroadcast(event.newValue);
+          if (!payload) return;
+          seedCuts(payload.sessionId);
+        }
+        try {
+          window.addEventListener("storage", onStorage);
+        } catch (_error) {
+          return function noop() {};
+        }
+        return function dispose() {
+          try {
+            window.removeEventListener("storage", onStorage);
+          } catch (_error) {
+            /* ignore */
+          }
+        };
+      }
+
       function seedCuts(/** @type {any} */ sessionId) {
         return call("cuts", { sessionId: sessionId })
           .then((/** @type {any} */ value) => {
@@ -4303,6 +4383,9 @@ window.__ModuleLoader__.load({
 
       installChatVisibility(ctx, cutStore);
 
+      // 多视图一致性：别的标签页回溯后，本视图按宿主 cuts 重新隐藏。
+      ctx.effect(() => installCutBroadcast(), "session-rewind: cut broadcast");
+
       ctx.effect(
         () =>
           installRowAction(ctx.slots, {
@@ -4535,6 +4618,8 @@ window.__ModuleLoader__.load({
         normalizeFiles: normalizeFiles,
         normalizePreview: normalizePreview,
         normalizeStateChanges: normalizeStateChanges,
+        parseCutBroadcast: parseCutBroadcast,
+        CUT_BROADCAST_KEY: CUT_BROADCAST_KEY,
         fileModeState: fileModeState,
         effectiveMode: effectiveMode,
         conflictPathsOf: conflictPathsOf,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kangyishuai/dsh-session-rewind",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "In-place conversation rewind for DSH: withdraw a user message and everything after it, then refill the composer",
   "keywords": [
     "dsh",