npm - dsh-plugin-message-edit - Versions diffs - 1.0.0 → 1.0.1 - Mend

dsh-plugin-message-edit 1.0.0 → 1.0.1

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.

Files changed (9) hide show

package/README.en.md CHANGED Viewed

@@ -2,8 +2,10 @@
 English | [简体中文](README.md)
+[![npm](https://img.shields.io/npm/v/dsh-plugin-message-edit?color=cb3837&logo=npm)](https://www.npmjs.com/package/dsh-plugin-message-edit)
+[![CI](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.7-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
+[![dsh](https://img.shields.io/badge/dsh-0.1.2--rc.1-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
 [![stars](https://img.shields.io/github/stars/SpookySandwich/dsh-plugin-message-edit?style=flat&label=stars)](https://github.com/SpookySandwich/dsh-plugin-message-edit/stargazers)
 Edit a message you already sent and the conversation **rewinds and branches** from that point, the way ChatGPT, Claude and DeepSeek all do it. The old version is not overwritten — a `‹ 2/4 ›` counter appears under the bubble, and a Versions tab draws the whole tree.
@@ -70,9 +72,16 @@ For technical details and developer guides, see:
 ## Compatibility
+Version `1.0.1` has been verified in an isolated DSH `0.1.2-rc.1` Web environment:
+plugin loading, images, edit/retry, nested branches, and restored sessions. Model
+responses use a local test adapter; remote model services were not exercised.
+The compatibility layer retains the older `events` / `seedLength` interfaces,
+covered by automated tests. Later DSH releases need separate verification.
+Restart DSH after updating the plugin.
 Coexists with [dsh-plugin-smooth-stream](https://github.com/SpookySandwich/dsh-plugin-smooth-stream) and [dsh-plugin-rollout-scout](https://github.com/SpookySandwich/dsh-plugin-rollout-scout).
 ## License
 MIT © SpookySandwich. Portions of the host half derive from dsh-message-edit (MIT © Moeblack).

package/README.md CHANGED Viewed

@@ -2,8 +2,10 @@
 [English](README.en.md) | 简体中文
+[![npm](https://img.shields.io/npm/v/dsh-plugin-message-edit?color=cb3837&logo=npm)](https://www.npmjs.com/package/dsh-plugin-message-edit)
+[![CI](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.7-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
+[![dsh](https://img.shields.io/badge/dsh-0.1.2--rc.1-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
 [![stars](https://img.shields.io/github/stars/SpookySandwich/dsh-plugin-message-edit?style=flat&label=stars)](https://github.com/SpookySandwich/dsh-plugin-message-edit/stargazers)
 编辑一条已经发出的消息，对话会从那一刻 **真正回溯并分叉**——和 ChatGPT、Claude、DeepSeek 的做法一致。旧版本不会被覆盖：气泡下方出现 `‹ 2/4 ›` 计数，「版本」标签页则画出整棵树。
@@ -70,9 +72,12 @@ DSH 的会话是仅追加的事件日志，本身不支持会话内分支，因
 ## 兼容性
+`1.0.1` 已在 DSH `0.1.2-rc.1` 的隔离 Web 环境验证：插件加载、图片显示、编辑与重试、深层分支，以及持久会话的恢复读取。模型回复使用本地测试实现，未调用远程模型服务。
+兼容层保留了旧版 `events` / `seedLength` 接口支持，并由自动测试覆盖。DSH 仍在快速迭代，尚未验证的后续版本不在此保证范围内。更新插件后请重启 DSH。
 可与 [dsh-plugin-smooth-stream](https://github.com/SpookySandwich/dsh-plugin-smooth-stream)、[dsh-plugin-rollout-scout](https://github.com/SpookySandwich/dsh-plugin-rollout-scout) 共存。
 ## 许可
 MIT © SpookySandwich。宿主端部分逻辑源自 dsh-message-edit（MIT © Moeblack）。

package/docs/ARCHITECTURE.md CHANGED Viewed

@@ -1,156 +1,164 @@
-# Architecture Overview
-`dsh-plugin-message-edit` provides ChatGPT/Claude-style conversation branching and message editing for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness).
-Because DSH session event logs are append-only without native in-session branching, this plugin splits responsibilities across a **Node.js Host Service** and a **Browser/Web Client**.
----
-## 1. System Components
-```
-┌─────────────────────────────────────────────────────────────┐
-│                      DSH Desktop / Web                      │
-│                                                             │
-│  ┌──────────────────────┐         ┌──────────────────────┐  │
-│  │     Client Half      │  HTTP   │      Host Half       │  │
-│  │  (plugin.client.js)  │<───────>│    (lib/index.js)    │  │
-│  └──────────┬───────────┘         └──────────┬───────────┘  │
-│             │                                │              │
-│    Shadow User Message              Cordis Services:        │
-│    Versions Tab (Graph)             - sessions              │
-│    Settings UI                      - agents                │
-│                                     - webServer             │
-│                                     - sessionPersistence    │
-└─────────────────────────────────────────────────────────────┘
-```
-### 1.1 Host Half (`lib/index.js`)
-- Runs in the Node.js backend process via Cordis lifecycle injection.
-- Registers the `/message-tree` HTTP route on `ctx.webServer`.
-- Owns branch creation transactions (`POST /message-tree`):
-  1. Truncates parent events up to the target turn.
-  2. Seeds a new DSH session with the prefix events.
-  3. Appends a durable `message-tree/version` marker with `ignorable: true`.
-  4. Submits the edited prompt into the new session.
-- Owns graph queries (`GET /message-tree?sessionId=...`):
-  - Traverses the session family DAG.
-  - Recovers deleted/ghost ancestors from surviving descendants' event logs.
-  - Extracts turn event boundaries for turn-level rendering.
-### 1.2 Client Half (`plugin.client.js`)
-- Runs in the browser / renderer process.
-- Injects a shadowed `user` message renderer at priority `-1` to add the edit/copy/retry toolbar and `‹ n/m ›` version ring without modifying agent responses, tool calls, or reasoning blocks.
-- Adds the **Versions** tab (`VIEW_ORDER: 16`) providing an interactive pan/zoom graph with spring physics.
-- Adds settings options in **Settings → Message Edit** with live layout switching (ChatGPT, DeepSeek, Claude styles).
----
-## 2. Durable Storage Model
-DSH sessions are immutable append-only logs. When branching:
-1. **Seed Inheritance**: A new session is initialized whose log begins with an exact clone of the parent's event log up to the start of the edited turn (`seedLength`).
-2. **Durable Marker**: The host appends a custom event:
-   ```json
-   {
-     "type": "message-tree/version",
-     "data": {
-       "schemaVersion": 1,
-       "effect": {
-         "operation": "edit",
-         "targetTurn": 1,
-         "targetEventSeq": 5,
-         "before": "Original message text",
-         "after": "Edited message text"
-       },
-       "inverse": {
-         "kind": "restore-version",
-         "sessionId": "parent-session-id"
-       }
-     }
-   }
-   ```
-3. **`ignorable` Flag**: Custom plugin event types fall outside DSH's core schema. The event envelope must set `ignorable: true`; otherwise, DSH's built-in event reader will reject the entire session log.
----
-## 3. HTTP API
-### `GET /message-tree?sessionId={id}`
-Returns the entire conversation family surrounding the requested session.
-**Response Schema:**
-```json
-{
-  "sessionId": "current-session-id",
-  "versions": [
-    {
-      "sessionId": "session-a",
-      "createdAt": 1724334000000,
-      "depth": 0,
-      "current": false,
-      "onCurrentPath": true,
-      "turns": [
-        { "turn": 1, "text": "Hello", "time": 1724334001000 },
-        { "turn": 2, "text": "Tell me more", "time": 1724334005000 }
-      ]
-    },
-    {
-      "sessionId": "session-b",
-      "parentSessionId": "session-a",
-      "createdAt": 1724334020000,
-      "depth": 1,
-      "current": true,
-      "onCurrentPath": true,
-      "operation": "edit",
-      "targetTurn": 1,
-      "before": "Hello",
-      "after": "Hello world",
-      "turns": [
-        { "turn": 1, "text": "Hello world", "time": 1724334021000 },
-        { "turn": 2, "text": "What is next?", "time": 1724334025000 }
-      ]
-    }
-  ]
-}
-```
-### `POST /message-tree`
-Performs branch creation or reactivation.
-- **`edit`**: Rewinds to before the specified user turn, creates a new branched session, appends a durable `message-tree/version` marker, and submits the replacement prompt.
-- **`retry`**: Rewinds to before the target turn, creates a child session, and replays the original user prompt.
-- **`activate`**: Unarchives an archived version session via the host registry queue so the client can navigate to it.
----
-## 4. Performance & In-Memory Caching
-1. **Host-Side Parsed Session Cache (`sessionParsedCache`)**:
-   - Parses turn boundaries (`extractTurns`) and version headers once per immutable event sequence.
-   - Bounded to 500 session entries with key invalidation on live event count / disk mtime changes.
-   - Subsequent `tree()` queries across siblings in the family hit in-memory cache in sub-millisecond time.
-2. **Client-Side Family SWR Store (`treeStore`)**:
-   - Maps every non-deleted branch in a tree to the shared family structure upon fetch.
-   - Switching between sibling branches (`‹ n/m ›` or Versions view) is 100% synchronous (0ms lag, zero indicator flicker).
-   - Uses monotonic request timestamps to prevent race-condition overwrites from out-of-order responses.
-   - Optimistically seeds newly created edit/retry branches before navigation.
----
-## 5. Security and Error Resilience
-- **Ignorable Event Envelope**: `ignorable: true` ensures foreign event markers do not crash the core DSH log parser.
-- **Fail-Safe Mutation Recovery**: Transaction reversals (`child.dispose()`) on failures prevent dangling session artifacts.
-- **Memory Bounded Stores**: LRU bounds (500 sessions) prevent unbounded memory growth in long-running processes.
-## 6. Naming & Namespaces
-- **NPM Package**: `dsh-plugin-message-edit`
-- **Cordis Service Name**: `message-tree`
-- **HTTP Path**: `/message-tree`
-- **Durable Event Type**: `message-tree/version`
-> The package uses `dsh-plugin-message-edit` for discovery, but retains `message-tree` in routes, cordis IDs, and event types to prevent collisions with prior third-party plugins (such as `dsh-message-edit`) and ensure seamless side-by-side operation.
+# Architecture Overview
+`dsh-plugin-message-edit` provides ChatGPT/Claude-style conversation branching and message editing for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness).
+Because DSH session event logs are append-only without native in-session branching, this plugin splits responsibilities across a **Node.js Host Service** and a **Browser/Web Client**.
+---
+## 1. System Components
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      DSH Desktop / Web                      │
+│                                                             │
+│  ┌──────────────────────┐         ┌──────────────────────┐  │
+│  │     Client Half      │  HTTP   │      Host Half       │  │
+│  │  (plugin.client.js)  │<───────>│    (lib/index.js)    │  │
+│  └──────────┬───────────┘         └──────────┬───────────┘  │
+│             │                                │              │
+│    Shadow User Message              Cordis Services:        │
+│    Versions Tab (Graph)             - sessions              │
+│    Settings UI                      - agents                │
+│                                     - webServer             │
+│                                     - sessionPersistence    │
+└─────────────────────────────────────────────────────────────┘
+```
+### 1.1 Host Half (`lib/index.js`)
+- Runs in the Node.js backend process via Cordis lifecycle injection.
+- Normalizes DSH sessions through `lib/session-record.js`: current live sessions
+  expose `snapshotEvents()`, query snapshots carry their header in `session`,
+  and older records expose `events` / `header`. Invalid logs fail explicitly.
+- Current DSH branches use `meta.isSeeded` plus `inheritedEventCount`; older
+  hosts use `meta.seedLength`. The normalized inherited cut prevents a nested
+  branch from mistaking an inherited version marker for its own marker.
+- Registers the `/message-tree` HTTP route on `ctx.webServer`.
+- Owns branch creation transactions (`POST /message-tree`):
+  1. Truncates parent events up to the target turn.
+  2. Seeds a new DSH session with the prefix events.
+  3. Appends a durable `message-tree/version` marker with `ignorable: true`.
+  4. Submits the edited prompt into the new session.
+- Owns graph queries (`GET /message-tree?sessionId=...`):
+  - Traverses the session family DAG.
+  - Recovers deleted/ghost ancestors from surviving descendants' event logs.
+  - Extracts turn event boundaries for turn-level rendering.
+### 1.2 Client Half (`plugin.client.js`)
+- Runs in the browser / renderer process.
+- Injects a shadowed `user` message renderer at priority `-1` to add the edit/copy/retry toolbar and `‹ n/m ›` version ring without modifying agent responses, tool calls, or reasoning blocks.
+- Adds the **Versions** tab (`VIEW_ORDER: 16`) providing an interactive pan/zoom graph with spring physics.
+- Adds settings options in **Settings → Message Edit** with live layout switching (ChatGPT, DeepSeek, Claude styles).
+---
+## 2. Durable Storage Model
+DSH sessions are immutable append-only logs. When branching:
+1. **Seed Inheritance**: A new session is initialized whose log begins with an exact clone of the parent's event log up to the start of the edited turn (`seedLength`).
+2. **Durable Marker**: The host appends a custom event:
+   ```json
+   {
+     "type": "message-tree/version",
+     "data": {
+       "schemaVersion": 1,
+       "effect": {
+         "operation": "edit",
+         "targetTurn": 1,
+         "targetEventSeq": 5,
+         "before": "Original message text",
+         "after": "Edited message text"
+       },
+       "inverse": {
+         "kind": "restore-version",
+         "sessionId": "parent-session-id"
+       }
+     }
+   }
+   ```
+3. **`ignorable` Flag**: Custom plugin event types fall outside DSH's core schema. The event envelope must set `ignorable: true`; otherwise, DSH's built-in event reader will reject the entire session log.
+---
+## 3. HTTP API
+### `GET /message-tree?sessionId={id}`
+Returns the entire conversation family surrounding the requested session.
+**Response Schema:**
+```json
+{
+  "sessionId": "current-session-id",
+  "versions": [
+    {
+      "sessionId": "session-a",
+      "createdAt": 1724334000000,
+      "depth": 0,
+      "current": false,
+      "onCurrentPath": true,
+      "turns": [
+        { "turn": 1, "text": "Hello", "time": 1724334001000 },
+        { "turn": 2, "text": "Tell me more", "time": 1724334005000 }
+      ]
+    },
+    {
+      "sessionId": "session-b",
+      "parentSessionId": "session-a",
+      "createdAt": 1724334020000,
+      "depth": 1,
+      "current": true,
+      "onCurrentPath": true,
+      "operation": "edit",
+      "targetTurn": 1,
+      "before": "Hello",
+      "after": "Hello world",
+      "turns": [
+        { "turn": 1, "text": "Hello world", "time": 1724334021000 },
+        { "turn": 2, "text": "What is next?", "time": 1724334025000 }
+      ]
+    }
+  ]
+}
+```
+### `POST /message-tree`
+Performs branch creation or reactivation.
+- **`edit`**: Rewinds to before the specified user turn, creates a new branched session, appends a durable `message-tree/version` marker, and submits the replacement prompt.
+- **`retry`**: Rewinds to before the target turn, creates a child session, and replays the original user prompt.
+- **`activate`**: Unarchives an archived version session via the host registry queue so the client can navigate to it.
+---
+## 4. Performance & In-Memory Caching
+1. **Host-Side Parsed Session Cache (`sessionParsedCache`)**:
+   - Parses turn boundaries (`extractTurns`) and version headers once per immutable event sequence.
+   - Bounded to 500 entries per plugin context. Live keys use session identity
+     and event count; unchanged modern logs do not need a new snapshot.
+   - Cold logs are read before comparing their event count. Creation timestamps
+     cannot invalidate append-only history and must not be used as revisions.
+2. **Client-Side Family SWR Store (`treeStore`)**:
+   - Maps every non-deleted branch in a tree to the shared family structure upon fetch.
+   - Switching between sibling branches (`‹ n/m ›` or Versions view) is 100% synchronous (0ms lag, zero indicator flicker).
+   - Uses monotonic request timestamps to prevent race-condition overwrites from out-of-order responses.
+   - Optimistically seeds newly created edit/retry branches before navigation.
+---
+## 5. Security and Error Resilience
+- **Ignorable Event Envelope**: `ignorable: true` ensures foreign event markers do not crash the core DSH log parser.
+- **Fail-Safe Mutation Recovery**: Transaction reversals (`child.dispose()`) on failures prevent dangling session artifacts.
+- **Memory Bounded Stores**: LRU bounds (500 sessions) prevent unbounded memory growth in long-running processes.
+## 6. Naming & Namespaces
+- **NPM Package**: `dsh-plugin-message-edit`
+- **Cordis Service Name**: `message-tree`
+- **HTTP Path**: `/message-tree`
+- **Durable Event Type**: `message-tree/version`
+> The package uses `dsh-plugin-message-edit` for discovery, but retains `message-tree` in routes, cordis IDs, and event types to prevent collisions with prior third-party plugins (such as `dsh-message-edit`) and ensure seamless side-by-side operation.

package/docs/DEVELOPMENT.md CHANGED Viewed

@@ -1,75 +1,135 @@
-# Development & Testing Guide
-This guide covers building, testing, packaging, and installing `dsh-plugin-message-edit`.
----
-## 1. Repository Structure
-```
-dsh-plugin-message-edit/
-├── lib/
-│   ├── index.js          # Host-side Cordis plugin (routes, session log processing)
-│   ├── tree-logic.js     # Pure tree algorithms (shared with client and tests)
-│   └── client.js         # Generated client bundle (wrapped from plugin.client.js)
-├── plugin.client.js      # Source client-side UI and React components
-├── scripts/
-│   └── build-client.mjs  # Build script wrapping plugin.client.js into lib/client.js
-├── test/
-│   └── tree.test.mjs     # Automated test suite (36+ unit tests)
-├── cordis.patch.yml      # Service dependencies and injection metadata
-├── docs/                 # Technical architecture and data model documentation
-└── package.json
-```
----
-## 2. Build Pipeline
-The client component [`plugin.client.js`](file:///D:/dsh-plugin-message-edit/plugin.client.js) is written in browser-compatible JavaScript. Before distribution or testing, it is wrapped with a Cordis module preamble into [`lib/client.js`](file:///D:/dsh-plugin-message-edit/lib/client.js).
-### Build Client
-```bash
-npm run build
-```
-Executes `node scripts/build-client.mjs` to regenerate `lib/client.js`.
-### Check Build Integrity
-```bash
-node scripts/build-client.mjs --check
-```
-Exits with code 1 if `lib/client.js` is out of date relative to `plugin.client.js`.
----
-## 3. Testing
-The project includes an automated test suite verifying tree construction, sibling fan-out, ghost recovery, active path calculation, and ring index calculation.
-```bash
-npm test
-```
-Runs the build check and executes `test/tree.test.mjs`.
-To add new tests, edit [`test/tree.test.mjs`](file:///D:/dsh-plugin-message-edit/test/tree.test.mjs).
----
-## 4. Local Installation into DSH Desktop
-### Step 1: Build and Package
-```bash
-npm run build
-npm pack
-```
-This produces a tarball: `dsh-plugin-message-edit-0.1.0.tgz`.
-### Step 2: Install into DSH Profile
-To install into the DSH Desktop profile:
-```bash
-dsh plugin --profile desktop add file:/path/to/dsh-plugin-message-edit-0.1.0.tgz
-```
-Or sync files directly into `~/.dsh/profiles/desktop/node_modules/dsh-plugin-message-edit/`.
-### Step 3: Restart DSH Desktop
-Restart DSH Desktop to reload the host-side plugin in the server process and mount the updated client interface.
+# Development & Testing Guide
+This guide covers building, testing, packaging, and installing `dsh-plugin-message-edit`.
+---
+## 1. Repository Structure
+```
+dsh-plugin-message-edit/
+├── lib/
+│   ├── index.js          # Host-side Cordis plugin (routes, session log processing)
+│   ├── tree-logic.js     # Pure tree algorithms (shared with client and tests)
+│   └── client.js         # Generated client bundle (wrapped from plugin.client.js)
+├── plugin.client.js      # Source client-side UI and React components
+├── scripts/
+│   └── build-client.mjs  # Build script wrapping plugin.client.js into lib/client.js
+├── test/
+│   └── tree.test.mjs     # Automated test suite (36+ unit tests)
+├── cordis.patch.yml      # Service dependencies and injection metadata
+├── docs/                 # Technical architecture and data model documentation
+└── package.json
+```
+---
+## 2. Build Pipeline
+The client component [`plugin.client.js`](file:///D:/dsh-plugin-message-edit/plugin.client.js) is written in browser-compatible JavaScript. Before distribution or testing, it is wrapped with a Cordis module preamble into [`lib/client.js`](file:///D:/dsh-plugin-message-edit/lib/client.js).
+### Build Client
+```bash
+npm run build
+```
+Executes `node scripts/build-client.mjs` to regenerate `lib/client.js`.
+### Check Build Integrity
+```bash
+node scripts/build-client.mjs --check
+```
+Exits with code 1 if `lib/client.js` is out of date relative to `plugin.client.js`.
+---
+## 3. Testing
+The project includes an automated test suite verifying tree construction, sibling fan-out, ghost recovery, active path calculation, and ring index calculation.
+```bash
+npm test
+```
+Automatically builds the client first, checks that it matches the source, then
+runs the Node test runner. Install development dependencies with `npm ci` on a
+fresh checkout before running tests (Node 22.19+ or Node 24).
+- `test/tree.test.mjs`: 36 assertions covering branch and version-tree behavior.
+- `test/client-images.test.mjs`: loads the generated client through its module
+  loader, mounts its registered user-message component using React and jsdom,
+  and checks image delegation, multiple/image-only messages, old-host fallback,
+  text-only messages, and entering/cancelling an edit. Host services and the image
+  gallery are test doubles; these are not full DSH integration tests.
+- `test/client-registration.test.mjs`: checks module dependencies and visible
+  failures when services or registrations are unavailable.
+- `test/session-record.test.mjs` and `test/host-compatibility.test.mjs`: cover
+  legacy/current session shapes, live/resumed edit requests, retained images,
+  retry ancestry, nested version markers, and cache invalidation.
+GitHub Actions runs these checks for pull requests and branch pushes, on
+Linux (Node 22 and 24) and Windows (Node 22). It also runs:
+```bash
+npm run check:package
+```
+This creates a real npm archive in a temporary directory, verifies that runtime
+entry points are present and development-only directories are absent, checks
+the host entry's syntax, and removes the temporary archive. `npm pack` and
+`npm publish` now build the client automatically through `prepack`, preventing
+an old or missing generated client from being shipped.
+The workflow needs to be pushed to GitHub to run there. Making its checks
+mandatory before merging is a separate repository ruleset/branch-protection
+setting; adding the workflow alone does not block the Merge button.
+Before accepting an image-rendering change, also check it in a running DSH:
+send text with one/multiple images and an image-only message, open an image in
+the native viewer, enter/cancel an edit, then verify the original attachments
+survive an edit submission. CI's gallery double cannot verify native image
+loading, lightbox behavior, or compatibility with DSH's module injection.
+To add new tests, edit [`test/tree.test.mjs`](file:///D:/dsh-plugin-message-edit/test/tree.test.mjs).
+### Optional real DSH acceptance
+`test/fixtures/dsh-acceptance.mjs` is an offline model adapter and live/cold
+session fixture for an installed official DSH `0.1.2-rc.1` runtime. Mount it
+only in a new temporary home whose name contains `message-edit-dsh-qa-`.
+Set `DSH_HOME` to that home and `DSH_QA_MODULES` to the official runtime's
+`node_modules` directory. Use a separate Web profile with the base/Web bundles,
+a built copy of this plugin, and a loader entry for the fixture. Never point
+this fixture at an existing user's DSH home.
+Once the isolated server prints its URL, run:
+```bash
+node scripts/verify-dsh-acceptance.mjs http://127.0.0.1:61587
+```
+The verifier exercises real HTTP edit/retry operations, local model execution,
+image retention, unchanged source messages, and nested branch markers. Restart
+the same isolated server and repeat to exercise persisted branches. The fixture
+adds `/qa/state` and `/qa/followup` endpoints solely for this disposable test.
+Browser acceptance additionally checks the settings entry, version switcher,
+thumbnails, and native original-image viewer. No remote API key is needed.
+---
+## 4. Local Installation into DSH Desktop
+### Step 1: Build and Package
+```bash
+npm run build
+npm pack
+```
+This produces a tarball: `dsh-plugin-message-edit-0.1.0.tgz`.
+### Step 2: Install into DSH Profile
+To install into the DSH Desktop profile:
+```bash
+dsh plugin --profile desktop add file:/path/to/dsh-plugin-message-edit-0.1.0.tgz
+```
+Or sync files directly into `~/.dsh/profiles/desktop/node_modules/dsh-plugin-message-edit/`.
+### Step 3: Restart DSH Desktop
+Restart DSH Desktop to reload the host-side plugin in the server process and mount the updated client interface.