dsh-session-curator 0.1.2 → 0.3.0

package/README.md

@@ -4,18 +4,19 @@
 
 A DSH (DeepSeek Harness) plugin that adds **session deletion** and **archive management**.
 
-DSH can archive and pin a session but offers no API to delete one. This plugin does the file-level work itself, and designs deletion as a **recoverable soft delete**: the session directory is moved to a trash folder together with its metadata, and restoring it puts the session back into its original workspace.
+DSH can archive and pin a session but offers no API to delete one. This plugin does the file-level work itself, and deletion is **permanent**: the session directory and its projection cache are removed from disk. If you want to be able to bring a session back later, **archive it instead** — archiving also hides it from the sidebar and is fully reversible.
 
 ## Features
 
 | Where | What |
 | --- | --- |
-| Session row `⋯` menu | **Delete session** — moves it to the trash after a confirmation |
-| Settings → **Session manager** | Three tabs — **archived / pinned / trash** — grouped by the session's original workspace folder, with per-row and bulk actions |
+| Session row `⋯` menu | **Delete session** — permanently removes it from disk after a confirmation |
+| Settings → **Session manager** | Two tabs — **archived / pinned** — grouped by the session's original workspace folder, with per-row and bulk actions |
 | Settings → **Session manager** → **Settings** | Basics (default tab, grouping, **sidebar archived visibility**, row details, order), the installed version, and an upgrade hint with the exact command when npm has a newer release |
-| Confirmation dialog | Delete and permanent delete (permanent delete needs an explicit "I cannot undo this" tick) |
+| Confirmation dialog | Permanent deletion; it warns that this cannot be undone and hints to use **Archive** instead, and needs an explicit "I cannot undo this" tick |
+| Disk usage tab | Read-only totals plus largest / least-recently-opened sessions, each archivable in place |
 
-Deleting is always reversible: every trashed entry keeps its original workspace folder, title and deletion time, and running sessions are never touched.
+Deletion is permanent and never touches a running session (or the session currently in use). Anything you want to keep should be archived instead.
 
 ## Install
 
@@ -33,9 +34,9 @@ From GitHub instead of npm:
 dsh plugin --profile desktop add github:Motues/dsh-session-curator
 ```
 
-The command runs pnpm inside that profile and records the package in both `dependencies` and `dsh.profile.bundles`. Restart DSH to pick up the host half; the client half only needs a page efresh.
+The command runs pnpm inside that profile and records the package in both `dependencies` and `dsh.profile.bundles`. Restart DSH to pick up the host half; the client half only needs a page refresh.
 
-The published package is dependency-free and needs no build: `lib/` is plain ESM JavaScript(`lib/index.js` for the host half, `lib/client.js` for the client bundle). Sources live in `src/` as TypeScript; contributors run `npm install` once and `npm run build` (tsc for the host half, esbuild for the client bundle) to regenerate `lib/`.
+The published package is dependency-free and needs no build: `lib/` is plain ESM JavaScript(`lib/index.js` for the host half, `lib/client.js` for the client bundle). Sources live in `src/` as TypeScript; contributors run `pnpm install` once and `pnpm run build` (tsc for the host half, esbuild for the client bundle) to regenerate `lib/`.
 
 ## License
 

package/README.zh-CN.md

@@ -4,18 +4,19 @@
 
 给 DSH（DeepSeek Harness）补上**删除会话**与**归档会话管理**的插件。
 
-DSH 能归档和置顶会话，却没有删除会话的 API。这个插件自己做文件级操作，并把"删除"做成**可完整恢复的软删除**：会话目录连同元数据一起移入回收站，恢复时能回到原来的工作区。
+DSH 能归档和置顶会话，却没有删除会话的 API。这个插件自己做文件级操作，删除是**真正的物理删除**：会话目录连同投影缓存一起从磁盘移除。如果想以后还能找回，请改用**归档** —— 归档同样能让会话从侧边栏消失，而且随时可以恢复。
 
 ## 能力
 
 | 位置 | 内容 |
 | --- | --- |
-| 会话行 `⋯` 菜单 | **删除会话** —— 确认后移入回收站 |
-| 设置 → **会话管理** | 三个页签：**已归档 / 已置顶 / 回收站**，按会话原来的工作区文件夹分组，支持逐行与批量操作 |
+| 会话行 `⋯` 菜单 | **删除会话** —— 确认后从磁盘永久删除 |
+| 设置 → **会话管理** | 两个页签：**已归档 / 已置顶**，按会话原来的工作区文件夹分组，支持逐行与批量操作 |
 | 设置 → **会话管理** → **配置** | 基础设置（默认页签 / 分组 / **侧边栏是否显示已归档** / 行内信息 / 排序）、当前版本号，以及 npm 上有新版本时的升级提示与命令 |
-| 确认弹窗 | 删除与永久删除（永久删除需要勾选"我明白这无法撤销"） |
+| 确认弹窗 | 物理删除：写明"不可恢复"并提示改用「归档」，需要勾选"我明白这无法撤销" |
+| 磁盘占用页签 | 只读的占用合计 + 最占地方 / 最久没打开的榜单，榜单每行可直接归档 |
 
-删除始终可逆：回收站里的每条记录都保留原来的工作区文件夹、标题和删除时间；正在运行的会话不会被删除。
+删除不可逆，且绝不会碰正在运行、或当前正在使用的会话。想留退路就用归档。
 
 ## 安装
 
@@ -35,7 +36,7 @@ dsh plugin --profile desktop add github:Motues/dsh-session-curator
 
 这条命令在那个 profile 目录里跑 pnpm，并把这个包同时记进 `dependencies` 和 `dsh.profile.bundles`。宿主半区需要重启 DSH 生效，客户端半区刷新页面即可。
 
-发布出去的包零运行时依赖、安装方无需构建：`lib/` 就是普通 ESM JavaScript（`lib/index.js` 宿主半区，`lib/client.js` 客户端束）。源码是 `src/` 下的 TypeScript：贡献者 `npm install` 一次，再用`npm run build`（宿主半区走 tsc、客户端束走 esbuild）重新生成 `lib/`。
+发布出去的包零运行时依赖、安装方无需构建：`lib/` 就是普通 ESM JavaScript（`lib/index.js` 宿主半区，`lib/client.js` 客户端束）。源码是 `src/` 下的 TypeScript：贡献者 `pnpm install` 一次，再用`pnpm run build`（宿主半区走 tsc、客户端束走 esbuild）重新生成 `lib/`。
 
 ## 许可