npm - dsh-session-manager - Versions diffs - 0.4.0 → 0.4.4 - Mend

dsh-session-manager 0.4.0 → 0.4.4

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 (4) hide show

package/README.md CHANGED Viewed

@@ -1,59 +1,45 @@
-# dsh-session-manager — conversation manager for DeepSeek Harness
+# dsh-session-manager — session manager for DeepSeek Harness
 English | [中文](README.zh.md)
 [![npm version](https://img.shields.io/npm/v/dsh-session-manager)](https://www.npmjs.com/package/dsh-session-manager)
 [![GitHub](https://img.shields.io/badge/GitHub-repository-blue)](https://github.com/hkkz9522/dsh-session-manager)
 [![CI](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml)
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
-A DeepSeek Harness (DSH) plugin for managing conversations safely from the Web UI.
-It adds archive management, permanent deletion, cross-workspace moves, and
-**per-conversation Agent preset migration**.
+A DeepSeek Harness (DSH) Web plugin for session management: delete sessions, archive sessions, move sessions across workspaces, and migrate a session's Agent preset. Suggestions are welcome on GitHub.
 ## Features
-- **Archive and unarchive** conversations.
-- **Delete conversations** with an explicit irreversible-action confirmation.
-- **Move to workspace** while preserving conversation history, title, archive state,
-  and derived-session relationships. The session's working directory is updated to
-  the target workspace.
-- **Migrate Agent preset for one conversation at a time.** This repairs a conversation
-  when its original preset was renamed or removed.
-- **Session manager** in the sidebar for browsing active and archived conversations,
-  with per-row Open, Archive/Unarchive, Move, Delete, and Migrate preset actions.
-- Header actions for the current conversation: Archive/Unarchive, Move to workspace,
-  and a red Delete conversation action.
+- **Archive / unarchive** sessions.
+- **Delete sessions** with an explicit irreversible-action confirmation.
+- **Move to workspace**: preserves history, title, archive state, and derived-session relationships, and updates the session's working directory to the target workspace.
+- **Migrate Agent preset**: change the preset on demand. Typical use case: when the original preset was renamed or removed and the session can no longer resume, you can repair that session.
+- **Session manager**: browse active and archived sessions in the sidebar, and run Open, Archive / Unarchive, Move, Delete, or Migrate preset on each row.
+- The current session's title area offers Archive / Unarchive, Move to workspace, and a red Delete session button.
 ## Where to find the UI
-- **Conversation header:** archive/unarchive, move to workspace, and delete.
-- **Sidebar footer → Session manager:** browse all conversations, including archived
-  ones, and perform actions for an individual conversation.
-- **Session manager row → Migrate preset:** change the Agent preset for that one
-  conversation only. There is no bulk migration action.
+- **Session title area (right side):** archive/unarchive, move to workspace, delete session.
+- **Sidebar footer → Session manager:** browse all sessions (including archived ones) and operate on each one.
 ## Agent preset migration
-Use this when a conversation can no longer resume because its original preset no
-longer exists, for example after removing a custom preset such as
-`router-standard`.
+Use this when a session can no longer resume because its original preset no longer exists, for example after removing a custom preset such as `router-standard`.
 1. Open **Session manager**.
-2. Locate the conversation and select **Migrate preset**.
+2. Locate the session and select **Migrate preset**.
 3. Choose one of the currently available target presets and confirm.
-The plugin determines the conversation's effective preset from its latest
-`agent-preset/selected` event when present; otherwise it uses the session header.
-It safely updates the relevant stored value, releases any live persistence owner,
-and refreshes the session list. If the migrated conversation is open, reopen it
-before continuing the chat.
+The plugin determines the session's effective preset from its latest `agent-preset/selected` event when present; otherwise it uses the session header. It safely updates the relevant stored value, releases any live persistence owner, and refreshes the session list. If the migrated session is open, reopen it before continuing the chat.
-> A preset migration changes conversation metadata only. It does not alter message
-> history, files, or the selected workspace.
+> A preset migration changes session metadata only. It does not alter message history, files, or the selected workspace.
 ## Install
-### From npm
+The plugin is listed in [dsh-market](https://github.com/dsh-market/dsh-market) and [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin), and can be installed directly from the **Plugin Marketplace** inside DSH.
+### From dsh-market
 ```powershell
 dsh plugin --profile web add npm:dsh-session-manager
@@ -65,8 +51,7 @@ dsh plugin --profile web add npm:dsh-session-manager
 dsh plugin --profile web add github:hkkz9522/dsh-session-manager
 ```
-Restart DSH Web after installation. If a browser still has an older client bundle,
-perform a hard refresh (`Ctrl+Shift+R`).
+Restart DSH Web after installation. If the browser still holds an older client bundle, force refresh with `Ctrl+Shift+R`.
 ### Local development / runtime injection
@@ -76,8 +61,7 @@ dev_inject_plugin {"dir": "<absolute path to this repository>"}
 ## HTTP API
-The Web UI uses the following local endpoints. They are primarily useful for
-integration and diagnostics.
+The following local endpoints are used by the Web UI and are also useful for integration and diagnostics:
 ```text
 POST /session-manager/api/delete         { sessionId }
@@ -88,7 +72,7 @@ GET  /session-manager/api/preset-scan?sessionId=<sessionId>
 POST /session-manager/api/preset-migrate { sessionId, toPreset }
 ```
-Example: migrate one conversation to `standard`.
+Example: migrate a session to the `standard` preset.
 ```bash
 curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
@@ -98,22 +82,16 @@ curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
 ## Safety and behavior
-- **Deletion is permanent.** The confirmation dialog is intentional.
-- Moving a running conversation interrupts and closes it first, then refreshes the
-  sidebar automatically. Open it from the target workspace to continue.
-- Moving a conversation changes its stored `cwd`; subsequent tool calls run in the
-  target workspace.
-- Subagent and transient blank-session placeholders are excluded from destructive
-  or migration operations.
-- File rewrites use temporary files and atomic replacement where supported to avoid
-  partial session artifacts.
+- **Deletion is permanent**, so the UI always asks for confirmation.
+- Moving a running session first interrupts and closes it, then refreshes the sidebar; reopen the session from the target workspace to continue.
+- Move rewrites the session's stored `cwd`; subsequent tool calls run in the target workspace.
+- Subagent sessions and transient blank-session placeholders are excluded from delete, move, and preset migration.
+- File rewrites use temporary files and atomic replacement (when supported by the environment) to avoid partially written session artifacts.
 ## Compatibility and development
-- The plugin is a Cordis plugin and declares `cordis >=4.0.0-rc <5` as a peer
-  dependency.
-- `lib/index.js` is the host-side ESM plugin and `lib/client.js` is the Web client
-  bundle. There is no build step.
+- This is a Cordis plugin with peer dependency `cordis >=4.0.0-rc <5`.
+- `lib/index.js` is the host-side ESM plugin, `lib/client.js` is the Web client bundle; no build step is required.
 - Before submitting changes, run:
 ```powershell
@@ -124,8 +102,12 @@ node scripts/smoke-test.mjs
 npm pack --dry-run
 ```
-See [CHANGELOG.md](CHANGELOG.md) for release history.
+Release history is in [CHANGELOG.md](CHANGELOG.md).
+## Acknowledgments
+Thanks to everyone who installs and uses dsh-session-manager, and to the people who file issues and open pull requests to help improve it. This plugin is listed in [dsh-market](https://github.com/dsh-market/dsh-market) and [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin). Suggestions and feedback are welcome.
 ## License
-[MIT](LICENSE)
+[MIT](LICENSE)

package/README.zh.md CHANGED Viewed

@@ -1,117 +1,117 @@
-# dsh-session-manager — DeepSeek Harness 会话管理器
-[English](README.md) | 中文
-[![npm version](https://img.shields.io/npm/v/dsh-session-manager)](https://www.npmjs.com/package/dsh-session-manager)
-[![GitHub](https://img.shields.io/badge/GitHub-仓库-blue)](https://github.com/hkkz9522/dsh-session-manager)
+# dsh-session-manager — DeepSeek Harness 会话管理器
+[English](README.md) | 中文
+[![npm version](https://img.shields.io/npm/v/dsh-session-manager)](https://www.npmjs.com/package/dsh-session-manager)
+[![GitHub](https://img.shields.io/badge/GitHub-仓库-blue)](https://github.com/hkkz9522/dsh-session-manager)
 [![CI](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml)
-用于管理 DeepSeek Harness（DSH）Web 对话的插件。它提供归档管理、永久删除、
-跨工作区移动，以及**按单条对话迁移 Agent 预设**的能力。
-## 功能
-- **归档 / 移出归档**对话。
-- **删除会话**：带不可逆操作的二次确认。
-- **移动至工作区**：保留历史、标题、归档状态和派生会话关系，同时把会话的
-  工作目录更新为目标工作区。
-- **单条对话迁移 Agent 预设**：当原预设被改名或删除，导致会话无法恢复时，可
-  单独修复该对话。
-- **会话管理窗口**：在侧边栏中浏览未归档和已归档会话，并对每一行执行打开、
-  归档 / 移出归档、移动、删除、迁移预设。
-- 当前对话标题区域提供归档 / 移出归档、移动至工作区和红色的删除会话按钮。
-## UI 入口
-- **对话标题右侧**：归档 / 移出归档、移动至工作区、删除会话。
-- **侧边栏底部 → 会话管理**：查看全部会话（含归档会话）并操作每一条会话。
-- **会话管理的会话行 → 迁移预设**：只迁移当前这一条会话；不再提供批量迁移。
-## Agent 预设迁移
-当对话无法恢复，且报错表明原 Agent 预设不存在时（例如删掉了
-`router-standard`），可以使用单条迁移功能。
-1. 打开**会话管理**。
-2. 找到目标对话，点击**迁移预设**。
-3. 从当前可用的预设中选择目标预设并确认。
-插件会优先读取最后一条 `agent-preset/selected` 事件中的有效预设；若不存在该
-事件，则读取会话 header 中的预设。迁移时会安全改写对应的持久化记录、释放可能残留
-的 live persistence owner，并刷新会话列表。若该会话当前打开，请在迁移后重新打开
-再继续对话。
-> 迁移预设只会修改会话元数据，不会改写历史消息、文件或当前工作区。
-## 安装
-### 从 npm 安装
-```powershell
-dsh plugin --profile web add npm:dsh-session-manager
-```
-### 从 GitHub 安装
-```powershell
-dsh plugin --profile web add github:hkkz9522/dsh-session-manager
-```
-安装后重启 DSH Web。若浏览器仍加载旧的客户端代码，请使用 `Ctrl+Shift+R` 强制刷新。
-### 本地开发 / 运行时注入
-```text
-dev_inject_plugin {"dir": "<本仓库的绝对路径>"}
-```
-## HTTP API
-以下本地接口供 Web UI 使用，也可用于集成和排查：
-```text
-POST /session-manager/api/delete         { sessionId }
-POST /session-manager/api/unarchive      { sessionId }
-GET  /session-manager/api/workspaces
-POST /session-manager/api/move           { sessionId, targetWorkspaceId }
-GET  /session-manager/api/preset-scan?sessionId=<sessionId>
-POST /session-manager/api/preset-migrate { sessionId, toPreset }
-```
-示例：将一条对话迁移到 `standard` 预设。
-```bash
-curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
-  -H 'content-type: application/json' \
-  -d '{"sessionId":"session-...","toPreset":"standard"}'
-```
-## 安全与行为说明
-- **删除不可恢复**，因此界面始终要求确认。
-- 移动正在运行的对话时，插件会先中断并关闭该会话，然后自动刷新侧边栏；请在
-  目标工作区重新打开会话后继续。
-- 移动会改写会话保存的 `cwd`，之后的工具调用将在目标工作区执行。
-- subagent 会话和临时空白会话占位不会参与删除、移动或预设迁移。
-- 文件改写使用临时文件和原子替换（环境支持时），避免产生部分写入的会话工件。
-## 兼容性与开发
-- 本插件是 Cordis 插件，声明的 peer dependency 为 `cordis >=4.0.0-rc <5`。
-- `lib/index.js` 是 host 端 ESM 插件，`lib/client.js` 是 Web 客户端 bundle，
-  无需构建步骤。
-- 提交修改前请运行：
-```powershell
-node --check lib/client.js
-node --check lib/index.js
-git diff --check
-node scripts/smoke-test.mjs
-npm pack --dry-run
-```
-发布记录见 [CHANGELOG.md](CHANGELOG.md)。
-## 开源许可
-[MIT](LICENSE)
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+用于在 DeepSeek Harness（DSH）Web 中进行会话管理，包括：删除会话、归档会话、跨工作区移动会话、迁移会话的 Agent 预设。欢迎至 GitHub 提意见。
+## 功能
+- **归档 / 移出归档**会话。
+- **删除会话**：带不可逆操作的二次确认。
+- **移动至工作区**：保留历史、标题、归档状态和派生会话关系，同时把会话的工作目录更新为目标工作区。
+- **迁移 Agent 预设**：可按需修改。典型工况：当原预设被改名或删除，导致会话无法恢复时，可修复该会话。
+- **会话管理窗口**：在侧边栏中浏览未归档和已归档会话，并对每一行执行打开、归档 / 移出归档、移动、删除、迁移预设。
+- 当前会话标题区域提供归档 / 移出归档、移动至工作区和红色的删除会话按钮。
+## UI 入口
+- **会话标题右侧**：归档 / 移出归档、移动至工作区、删除会话。
+- **侧边栏底部 → 会话管理**：查看全部会话（含归档会话）并操作每一条会话。
+## Agent 预设迁移
+1. 打开**会话管理**。
+2. 找到目标会话，点击**迁移预设**。
+3. 从当前可用的预设中选择目标预设并确认。
+例如：当会话无法恢复，报错表明原 Agent 预设不存在时（例如删掉了 `router-standard`），可以使用迁移功能。
+插件会优先读取最后一条 `agent-preset/selected` 事件中的有效预设；若不存在该事件，则读取会话 header 中的预设。迁移时会安全改写对应的持久化记录、释放可能残留的 live persistence owner，并刷新会话列表。若该会话当前打开，请在迁移后重新打开再继续会话。
+> 迁移预设只会修改会话元数据，不会改写历史消息、文件或当前工作区。
+## 安装
+本插件已收录于 [dsh-market](https://github.com/dsh-market/dsh-market) 和 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)，可以通过 DSH 应用内的**插件市场**直接搜索安装。
+### 从 dsh-market 安装
+```powershell
+dsh plugin --profile web add npm:dsh-session-manager
+```
+### 从 GitHub 安装
+```powershell
+dsh plugin --profile web add github:hkkz9522/dsh-session-manager
+```
+安装后重启 DSH Web。若浏览器仍加载旧的客户端代码，请使用 `Ctrl+Shift+R` 强制刷新。
+### 本地开发 / 运行时注入
+```text
+dev_inject_plugin {"dir": "<本仓库的绝对路径>"}
+```
+## HTTP API
+以下本地接口供 Web UI 使用，也可用于集成和排查：
+```text
+POST /session-manager/api/delete         { sessionId }
+POST /session-manager/api/unarchive      { sessionId }
+GET  /session-manager/api/workspaces
+POST /session-manager/api/move           { sessionId, targetWorkspaceId }
+GET  /session-manager/api/preset-scan?sessionId=<sessionId>
+POST /session-manager/api/preset-migrate { sessionId, toPreset }
+```
+示例：将会话迁移到 `standard` 预设。
+```bash
+curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
+  -H 'content-type: application/json' \
+  -d '{"sessionId":"session-...","toPreset":"standard"}'
+```
+## 安全与行为说明
+- **删除不可恢复**，因此界面始终要求确认。
+- 移动正在运行的会话时，插件会先中断并关闭该会话，然后自动刷新侧边栏；请在目标工作区重新打开会话后继续。
+- 移动会改写会话保存的 `cwd`，之后的工具调用将在目标工作区执行。
+- subagent 会话和临时空白会话占位不会参与删除、移动或预设迁移。
+- 文件改写使用临时文件和原子替换（环境支持时），避免产生部分写入的会话工件。
+## 兼容性与开发
+- 本插件是 Cordis 插件，声明的 peer dependency 为 `cordis >=4.0.0-rc <5`。
+- `lib/index.js` 是 host 端 ESM 插件，`lib/client.js` 是 Web 客户端 bundle，无需构建步骤。
+- 提交修改前请运行：
+```powershell
+node --check lib/client.js
+node --check lib/index.js
+git diff --check
+node scripts/smoke-test.mjs
+npm pack --dry-run
+```
+发布记录见 [CHANGELOG.md](CHANGELOG.md)。
+## 致谢
+感谢每一位安装和使用 dsh-session-manager 的用户，也感谢提交 Issue 与 Pull Request 帮助改进本插件的朋友们。
+本插件已被 [dsh-market](https://github.com/dsh-market/dsh-market) 和 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 收录。
+欢迎提出修改意见。
+## 开源许可
+[MIT](LICENSE)