@sunshaobei/dsh-session-manager 0.4.3-fork.1 → 0.6.0

package/README.md

@@ -1,8 +1,8 @@
-# dsh-session-recycle-bin
+# dsh-session-manager
 
 **Session recycle bin & permanent delete for DeepSeek Harness.**
 
-Move sessions into a recycle bin from the sidebar, restore or permanently delete them (single or batch), with live-session protection.
+Move the current session into a recycle bin from the conversation header, restore or permanently delete archived sessions (single or batch), with live-session protection.
 
 The interface automatically follows the browser language: Chinese locales use
 Chinese and all other locales use English.
@@ -13,26 +13,38 @@ Chinese and all other locales use English.
 
 ## ✨ Features
 
-- **Sidebar per-session delete icon** — hover a session row, a small trash icon appears; click to move it into the recycle bin instantly (no confirmation; always recoverable).
-- **Session-header delete button** — delete the current session from the conversation header.
+- **Conversation-header archive button** — move the current session into the recycle bin from the header (no confirmation; always recoverable).
+- **No duplicate of DSH's own affordance** — archiving from the sidebar uses DSH's built-in hover button; this plugin no longer injects a second, differently worded icon (0.4.4 removed the old row trash icon and the document-wide MutationObserver that drove it).
 - **Recycle-bin manager** (Settings → 🗑 会话回收站) — archived sessions with multi-select: batch restore, batch permanent delete; each item shows its ID and path.
 - **True permanent delete** — physically removes the session log from disk and the projection-cache record; ghost sessions (records without a log) are cleaned up so they vanish instead of lingering.
 - **Live-session protection** — sessions with an active agent are refused deletion.
+- **Sub-session aware** — each row can show how many sub-agent sessions it left behind (whole tree, any depth) and open them inline: title, size, time and running state, with a checkbox per sub-session. Permanent delete removes the whole tree; the ones you uncheck are kept and stay reachable as a "deleted main session · N sub-sessions kept" row instead of becoming invisible leftovers.
+- **Running sub-agents block the row** — a session is refused while any sub-session in its tree is still running, and the refusal names it.
 - **Batch fault tolerance** — batch operations delete per-session with error collection and reporting.
 - **Light/dark adaptive UI** — all colors are CSS custom properties in `client.css`; components follow the resolved DSH appearance (`data-ds-dark-theme`) with `prefers-color-scheme` as the OS-level fallback (no hardcoded palette). UI and code text follow the app font too (`--dsw-font-family` / `--ds-font-family-code`), so the Settings → 字体 choice applies here as well.
 
 ---
 
+## 📋 Requirements
+
+- **DSH 0.2.0-rc.2 or newer** (this release is tested on that version only; older hosts are untested).
+
+  The recycle-bin list no longer reads session logs: its titles and turn counts come from the Session projection cache (`SessionProjectionCache.cachedSnapshot`, plus `cachedPredecessorTitle` for checkpoints written by an older format generation) — the same zero-I/O face DSH's own session list uses. On a host without those two methods the plugin still mounts, archives and restores, but the list degrades to 「未命名会话」 with no turn counts.
+
+  The floor is declared as `dsh.engines.dsh`. Note that DSH 0.2.0-rc.2 does **not** read that field: it is documentation for users and marketplaces, not a runtime gate.
+
+---
+
 ## 📦 Install
 
 ### One-click from the plugin market (dsh-market)
 
-Once listed in the [awesome-dsh-plugin](https://awesome-dsh-plugin.com) registry: open **Settings → Plugin Market** → search **dsh-session-recycle-bin** → install.
+Once listed in the [awesome-dsh-plugin](https://awesome-dsh-plugin.com) registry: open **Settings → Plugin Market** → search **dsh-session-manager** → install.
 
 ### Manual
 
 ```bash
-dsh plugin --profile web add dsh-session-recycle-bin
+dsh plugin --profile web add dsh-session-manager
 ```
 
 Then restart the web app (stop the `dsh web` process and run `dsh web` again).
@@ -46,14 +58,14 @@ dsh plugin --profile web add link:/absolute/path/to/harness-session-delete
 ### Uninstall
 
 ```bash
-dsh plugin --profile web remove dsh-session-recycle-bin
+dsh plugin --profile web remove dsh-session-manager
 ```
 
 ---
 
 ## 🚀 Usage
 
-1. **Sidebar delete** — hover a session in the left sidebar, click the trash icon: the session moves into the recycle bin and the row disappears immediately.
+1. **Move to the recycle bin** — click the 「移入回收站」 icon in the conversation header: the session is archived and an undo toast appears. Whether an archived session keeps showing in the left sidebar is decided by DSH's own **View options → Filter sessions** setting (Hide archived / All conversations / Archived only); this plugin does not touch it, exactly like DSH's built-in archive button.
 2. **Settings recycle bin** — open **Settings ⚙️ → 🗑 会话回收站**:
    - Checkbox multi-select → **Restore** (batch unarchive) or **Permanent delete** (batch purge).
    - Each entry shows the session name, ID and working path (hover for full details).
@@ -75,12 +87,21 @@ harness-session-delete/
 ├── package.json            # single bundle manifest (dsh.bundle.patch + dsh.client)
 ├── cordis.patch.yml        # bundle patch: one insert mounting the host row
 ├── index.js                # node half: host entry (inject + apply)
-├── client.js               # browser half: sidebar icons + settings recycle bin
+├── client.js               # browser half: conversation-header action + settings recycle bin
 ├── client.css              # plugin stylesheet: design tokens + light/dark adaptive components
 └── packages/
     └── session-trash-host/ # host implementation (persistence/workspace/cache patches, HTTP routes)
 ```
 
+### Changelog convention
+
+`CHANGELOG.md` and `CHANGELOG.zh.md` mirror each other. Every entry follows:
+
+- Version section `## [version] - YYYY-MM-DD`, with only the `### Added` / `### Changed` / `### Fixed` / `### Performance` / `### Removed` headings it actually uses.
+- One topic per bullet: **a short bold lead stating the outcome**, then 1-2 sentences on what changed and why it matters.
+- No implementation detail, no code, no test or verification results — those belong in the commit or the PR.
+- Write only user-visible or breaking changes; skip internal refactors with no visible effect.
+
 ---
 
 ## 🔌 How it works

package/README.zh.md

@@ -1,8 +1,8 @@
-# dsh-session-recycle-bin
+# dsh-session-manager
 
 **DSH 会话回收站与彻底删除插件（DeepSeek Harness）。**
 
-侧边栏一键移入回收站，设置页多选还原/彻底删除，活跃会话安全拦截。
+会话详情头部一键移入回收站，设置页多选还原/彻底删除，活跃会话安全拦截。
 
 界面会自动跟随浏览器语言：中文区域显示中文，其他区域显示英文。
 
@@ -12,26 +12,38 @@
 
 ## ✨ 功能特性
 
-- **侧边栏会话行删除图标** — 悬停会话行出现小垃圾桶图标，点击即移入回收站（免确认，随时可找回）。
-- **会话头部删除按钮** — 从会话页顶部删除当前会话。
+- **会话详情头部归档按钮** — 会话页顶部一键把当前会话移入回收站（免确认，随时可找回）。
+- **不与 DSH 自带入口重复** — 侧边栏会话行的归档入口统一使用 DSH 自带的悬浮归档按钮；本插件不再注入第二个、措辞不同的图标（0.4.4 起移除了旧的行内垃圾桶，并去掉了驱动它的全文档 MutationObserver）。
 - **回收站管理器**（设置 → 🗑 会话回收站）— 已归档会话多选：批量还原、批量彻底删除；条目显示 ID 与路径。
 - **真正的彻底删除** — 物理清除磁盘日志与投影缓存；无日志的幽灵会话被彻底清理，不会残留。
 - **活跃会话保护** — 正在运行（有活跃 agent）的会话拒绝删除。
+- **子会话可见可控** — 每行可显示该会话留下的子代理会话数量（任意层级全树），并可就地展开：标题、大小、时间、运行状态，逐个勾选。彻底删除会一并清除整棵子树；未勾选的会保留，并以「已删除的主会话 · 保留 N 个子会话」的形式继续可见，而不是变成看不见、够不着的残留。
+- **运行中的子代理会拦住删除** — 只要该会话的子树里还有子会话在运行就拒绝删除，并点名是哪一个。
 - **批量容错** — 批量操作逐条执行，收集并汇报失败项。
 - **浅色/深色自适应界面** — 所有颜色以 CSS 变量（设计令牌）收敛在 `client.css`，组件优先跟随 DSH 应用外观（`data-ds-dark-theme`），并以 `prefers-color-scheme` 作为系统级兜底，无硬编码色板。界面与代码文字同样跟随 DSH 全局字体（`--dsw-font-family` / `--ds-font-family-code`），「设置 → 字体」对本插件同样生效。
 
 ---
 
+## 📋 环境要求
+
+- **DSH 0.2.0-rc.2 及以上**（本版仅在该版本上测试通过；更低版本未测试）。
+
+  回收站列表的标题与轮数不再读取会话日志，而是取自会话投影缓存（`SessionProjectionCache.cachedSnapshot`，以及为跨格式代际准备的 `cachedPredecessorTitle`）——这正是 DSH 自身会话列表使用的零 I/O 门面。缺少这两个方法的旧宿主上，插件仍能挂载、归档与还原，但列表会退化为「未命名会话」且不显示轮数。
+
+  该下限以 `dsh.engines.dsh` 声明。注意：DSH 0.2.0-rc.2 **并不读取**该字段，因此它是给用户与插件市场看的文档性声明，不是运行时强校验。
+
+---
+
 ## 📦 安装
 
 ### 从插件市场一键安装（dsh-market）
 
-收录进 [awesome-dsh-plugin](https://awesome-dsh-plugin.com) 注册表后：打开 **设置 → 插件市场** → 搜索 **dsh-session-recycle-bin** → 安装。
+收录进 [awesome-dsh-plugin](https://awesome-dsh-plugin.com) 注册表后：打开 **设置 → 插件市场** → 搜索 **dsh-session-manager** → 安装。
 
 ### 手动安装
 
 ```bash
-dsh plugin --profile web add dsh-session-recycle-bin
+dsh plugin --profile web add dsh-session-manager
 ```
 
 安装完成后重启 Web 服务（停止 `dsh web` 进程后重新启动）。
@@ -45,14 +57,14 @@ dsh plugin --profile web add link:/绝对路径/harness-session-delete
 ### 卸载
 
 ```bash
-dsh plugin --profile web remove dsh-session-recycle-bin
+dsh plugin --profile web remove dsh-session-manager
 ```
 
 ---
 
 ## 🚀 使用说明
 
-1. **侧边栏删除** — 悬停左侧会话列表中的会话，点击垃圾桶图标：会话移入回收站，行即时消失。
+1. **移入回收站** — 在会话页顶部点「移入回收站」图标：会话进入回收站，并弹出可撤销提示。归档后的会话是否仍显示在左侧列表，由 DSH 侧边栏「视图选项 → 筛选会话」的档位决定（隐藏已归档 / 全部对话 / 仅显示已归档），本插件不做干预，与 DSH 自带按钮行为一致。
 2. **设置页回收站** — 打开「设置 ⚙️ → 🗑 会话回收站」：
    - 复选框多选 → **还原**（批量解除归档）或 **彻底删除**（批量清除）。
    - 每个条目显示会话名、ID 与工作路径（悬浮查看完整信息）。
@@ -74,12 +86,21 @@ harness-session-delete/
 ├── package.json            # 单包 bundle 声明（dsh.bundle.patch + dsh.client）
 ├── cordis.patch.yml        # bundle patch：一行 insert 挂载 host 行
 ├── index.js                # node 半边：host 入口（inject + apply）
-├── client.js               # browser 半边：侧边栏图标 + 设置页回收站
+├── client.js               # browser 半边：会话头部动作 + 设置页回收站
 ├── client.css              # 插件样式表：设计令牌 + 浅色/深色自适应组件
 └── packages/
     └── session-trash-host/ # host 实现（persistence/workspace/cache 补丁、HTTP 路由）
 ```
 
+### 更新日志规范
+
+`CHANGELOG.md` 与 `CHANGELOG.zh.md` 一一对应。每条按下面写：
+
+- 版本段用 `## [版本] - YYYY-MM-DD`，其下只列实际涉及的 `### Added` / `### Changed` / `### Fixed` / `### Performance` / `### Removed`。
+- 每条一个主题：**加粗短句点明结论**，随后 1–2 句说明「改了什么 + 为什么、对用户有什么影响」。
+- 不写实现细节、不贴代码、不写测试或验证过程 —— 那些属于 commit / PR。
+- 只写用户可感知或破坏性的变化；纯内部重构若无可见影响则不写。
+
 ---
 
 ## 🔌 工作原理