@xrn1997/dsh-session-delete 0.2.0 → 0.2.2

package/README.md

@@ -1,9 +1,12 @@
 # @xrn1997/dsh-session-delete
 
+[![npm version](https://img.shields.io/npm/v/@xrn1997/dsh-session-delete.svg)](https://www.npmjs.com/package/@xrn1997/dsh-session-delete)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+![Tested with DSH Desktop 0.2.0-rc.2 / 0.2.1-rc.1 / 0.2.1-rc.2](https://img.shields.io/badge/DSH%20Desktop-0.2.0--rc.2%20%7C%200.2.1--rc.1%20%7C%200.2.1--rc.2-brightgreen)
+
 给 DeepSeek Harness（DSH）加一个**删除会话**的能力。DSH 官方有归档、没有删除——归档只是把会话从列表里挪走，文件还在。本插件补上删除，并且让删除可恢复：删除 = 移入回收站，另有一个显式的「彻底删除」。
 
-![回收站面板：左边一列是按项目分组的会话清单，右边是选中那条的详情（元信息与正文），页脚是整页唯一的实心红按钮「清空回收站…」](https://raw.githubusercontent.com/xrn1997/dsh-session-delete/main/docs/screenshots/screenshot-01.png)
-<!-- 首图待换：这张还是 2026-10-01 的"一列卡片 + 行内两颗按钮"。改版后的形态要一张真机截图（本环境没有可视浏览器，画不出可信的图）；alt 已按现状写，图换掉之前请先看文字。 -->
+![回收站面板：左列是按项目分组的会话清单，右栏是选中那条的元信息与正文，页脚是整页唯一的实心红按钮「清空回收站…」](https://raw.githubusercontent.com/xrn1997/dsh-session-delete/main/docs/screenshots/screenshot-01.png)
 
 - 安装：`dsh plugin --profile <profile> add @xrn1997/dsh-session-delete`
 - 许可：[Apache-2.0](LICENSE)
@@ -23,55 +26,50 @@
 
 ## 功能特性
 
-- **删除 = 移入回收站**：会话条目「…」菜单里的「删除」把会话搬进回收站（**连同它在盘上的子会话与更深的后代一起**——那些行宿主的列表里本来就不显示，不说会像是消失了没找回来），**点之前确认框就说出「含 N 个子会话，将一起移入回收站。」**（没有子会话时那半句一个字都不出现），可随时恢复；删完有一条停留 6 秒的撤销提示
-- **显式彻底删除**：单条「彻底删除…」或页脚「清空回收站…」，两者共用同一个二次确认；单条那张卡片报的是**这一次会释放多少**（父加跟着进来的孩子，与页脚合计同一个数）
-- **回收站面板**：清单在左、详情在右——左栏是按项目分组的会话列表（每条两行：标题 / 删除时间 · 大小，「恢复」与「彻底删除…」在行右侧），右栏是选中那条的详情（**时间／体量／计数／位置**四组元信息，加人与助手的文字；逐格名单以 `src/client/trash-detail.tsx` 与现状稿 §7 为准，这份不列——列成清单就是一条会漂的东西）；中央列不够宽（<900px）时改成下钻：点一条看详情，「← 返回清单」回来。清单为空或读不到时也只一列——那时右栏既没得选也没得点
-- **那一列自己可以收**：组头可折叠（也可以一键全部折叠）、两栏之间那根线可拖（也能用键盘 ←→／Home／End 调）；宽度夹在「元信息那一行读得完」与「详情还读得开」之间
-- **多选挑着彻底删**：那一排的「多选」进入，勾选若干条后页脚那颗从「清空回收站…」换成「彻底删除 N 条」，一次确认后逐条执行，没删掉的把原因留在它自己那一行；组头那颗可以一次把整个项目的会话全选上（包括折叠起来看不见的）
-- **运行中的会话拒绝删除**：菜单项置灰并说明原因——不替用户终止正在进行的活
-- **不自动过期**：不设天数上限，清空是显式动作
-- **失败不吞**：回收站读不到时把宿主原文上屏，并给一个「重试」
-- **不可用时不出现**：取数通道探测不过就一个入口都不注册——页面上看不出本插件，但也不会因此把宿主拖死
-- **文案随宿主语言**：中文 / English 挂在宿主 locale 服务上，跟随设置的界面语言
+- **删除 = 移入回收站**：会话行「⋯」→「删除」，可随时恢复；删完有一条停 6 秒的撤销提示
+- **按整组删**：父会话在盘上的子会话与更深后代一起走；任一成员在跑 ⇒ 整组拒绝、零副作用
+- **批量删除**：宿主会话列表「⋯」→「多选」，一次确认、一次执行；失败的留在框里可重试，成功的整批撤销
+- **回收站面板**：左清单右详情，按项目分组、可折叠、可拖分栏；看得见正文再决定恢复不恢复
+- **恢复**：单条即点即回，批量带确认；回到各自的原项目目录并还原删除前的归档可见性
+- **显式彻底删除**：单条「彻底删除…」与页脚「清空回收站…」共用同一个二次确认；不自动过期
+- **清理无主残留**：父会话已不存在的子会话宿主根本不显示，面板扫描到后由你决定清不清
+- **失败不吞**：宿主读不到时把原文上屏并给「重试」；不可用时不注册任何入口
+- **文案随宿主语言**：中文 / English 挂在宿主 locale 服务上
 
 ## 安装
 
 ```bash
 dsh plugin --profile <profile> add @xrn1997/dsh-session-delete
-```
-
-装完**重启宿主**（Node 半不走 HMR）。卸载：
-
-```bash
 dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 ```
 
-卸载只是移除插件；`~/.dsh/session-trash/` 下已有的目录仍留在原处，不会被自动清理。
+装完**重启宿主**（Node 半不走 HMR）。卸载只移除插件，`~/.dsh/session-trash/` 下已有的目录不会被自动清理。
 
-也可以离线分发：`pnpm pack` 出 tarball 后 `dsh plugin add ./dsh-session-delete-<版本>.tgz`。包里带的是**预构建产物**（`prepack` 在打包时替你跑 `build`），所以这条路上用户不需要为构建脚本授权。
+也可以离线分发：`pnpm pack` 出 tarball 后 `dsh plugin add ./dsh-session-delete-<版本>.tgz`。包里带预构建产物（`prepack` 会替你跑 `build`），这条路不需要为构建脚本授权。
 
 **兼容性分两层，别混**：
 
-- **装得上**由 `package.json` 的 `peerDependencies` 决定——宿主 `dsh plugin add` 会拿运行中的宿主版本逐项比对插件的 `@deepseek-ai/dsh*` peer 区间，不满足即拒绝并回滚。本插件**一条 `dsh-*` peer 都没有**（界面用的控件与图标已固化成 `src/client/ui/*`，浏览器半只 require React 家族这三个冻结平台模块），所以这道闸不限制它装在哪些代上。
-- **真跑过**由 `dsh.compatibility.dshReleases` 记录，只列实测过的宿主：**DSH Desktop 0.2.0-rc.2**（`compatible`）。别的 rc 装得上，但没验过。
+- **装得上**由 `package.json` 的 `engines.dsh` 决定：宿主拿运行中的版本比这个区间，不满足即拒绝并回滚。窗口是 **`>=0.1.7-rc.2 <0.3.0-0`**（预发布版本参与匹配）。地板是**完整功能**的最低代次：`0.1.7-rc.2` 在 CLI 台架上验过四个槽位齐全、激活零错误；更低的 `0.1.7-rc.1` 缺行首勾选槽位，`0.1.5` 起连会话行入口都没有。
+- **真跑过**由 `dsh.compatibility.dshReleases` 记录，只列桌面真机实测过的宿主：**DSH Desktop 0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2**（均 `compatible`）。窗口内的其他代次装得上但没在桌面真机上验过；窗口外的一律拒装。
 
 ## 用法
 
-两个入口。
+**删一条**：会话行「⋯」→「删除」→ 确认框。确认框在点之前就说明**这一组**的规模（「含 N 个子会话，将一起移入回收站」，N>0 才出现），删完那条提示点「撤销」即恢复。
+
+![会话行的「⋯」菜单：宿主原有动作之后，本插件加了「多选」与红色的「删除」两行](https://raw.githubusercontent.com/xrn1997/dsh-session-delete/main/docs/screenshots/screenshot-02.png)
 
-**删除**：会话条目右边的「…」菜单 → 「删除」→ 确认框（「移入回收站」）→ 会话进回收站。正在运行的会话这一行是**置灰**的，悬停给出「会话正在运行，先停止再删除」——本插件不替用户终止正在进行的活。
+删除按**整组**走：父会话在盘上的子会话与更深后代一起移走（传递闭包，一层层取到底）——那些行宿主本来就不显示。任一成员在跑（**包括列表里看不见的子会话**）⇒ 整组拒绝、零副作用，报的是那个运行中的 id；本插件不替用户终止正在进行的活。
 
-**回收站**：侧栏面板列表里常驻的「回收站」一行（与「插件」「小说」同层）。打开后是中央面板：
+**删一批**：会话行「⋯」→「多选」进入显式模式。模式内点整行勾选/取消且**不切换会话**，行首出勾选框，浮条常驻（0 条也给退出入口），同一位置在「全选 / 取消全选」之间切换。确认框逐条列出这批会话，执行是一次批量请求：部分失败不关框、原文落在失败那一行，按钮变成「重试这 N 条」，成功的 6 秒内可整批撤销。
 
-- 清单按项目分组，每条两行——标题 / 「刚刚删除 · 24KB」或「删除于 7分钟前 · 350KB」（带子会话的那行还会说「含 N 个子会话」；级联落地前删掉的存量说「盘上还剩 M 个子会话」——两个数各说各的）；「恢复」与「彻底删除…」在行右侧（前者描边、后者安静的红），点行本身是选中并在右边看详情
-- 头部是条数与合计占用（「2 个会话 · 共 49KB」）；页脚是「清空回收站…」——**整页唯一一块实心红**
-- 头部下面那一排（不随清单滚走）：**全部折叠 / 全部展开**、**多选**（「刷新」已删——每次读清单都会先与回收站目录对账，不再需要手动刷）
-- 组头可以单独折叠（也可以一键全部折叠），折叠起来的组条目直接收掉、计数还留在组头上；多选态下组头多出一颗**三态**勾选框——点它就是把这个项目的**全部**会话选上（包括折叠起来看不见的），只勾了几条时显示半选
-- 两栏之间那根线可以左右拖（也能聚焦后用 ←→ 调，Home 回默认 420）：最窄 330（再窄「删除于 … · 大小」那一行就被截断了），最右拖到「详情还读得开」为止
-- 多选态下：行右侧两颗按钮退场、标题左侧出勾选框，点行就是切换勾选；页脚那颗换成「彻底删除 N 条」（一条没勾时置灰并说明原因），确认后按清单顺序逐条执行，失败的那条把原文留在自己身上。退出多选即清空勾选，不留看不见的勾选
-- 面板四态：读数中 / 空（「回收站是空的」，此时底部**不出现**「清空回收站…」）/ 读数失败（宿主原文 + 「重试」）/ 有条目
-- 详情四态：未选中（一句引导）/ 读数中 / 读数失败（原文 + 重试，**只坏详情这一块**，清单照常选、动作照常点）/ 有内容。正文读的是回收站目录里那条会话自己的日志：只列你真实发的提问与助手的文字，宿主注入的上下文与工具调用不进正文（条数会在页面上说明）。**助手的文字按 Markdown 排版**（与宿主会话区同一套字号与 token），**你的提问保持原话**（不解析，换行与反引号照原样）
-- 「恢复」按记录的原目录名放回原项目目录，并还原它原本的可见性：删除前未归档的，恢复后仍未归档；删除前已归档的，恢复后仍在归档态
+![批量删除模式：两行已勾选，浮条显示「已选 2 条」与展开的已选清单，动作是「移入回收站 2 条」与「退出多选」](https://raw.githubusercontent.com/xrn1997/dsh-session-delete/main/docs/screenshots/screenshot-03.png)
+
+**管回收站**：侧栏面板里的「回收站」一行（与「插件」同层）。左清单右详情（中央列更窄时改成下钻，「← 返回清单」回来），按项目分组、组头可折叠、两栏之间那根线可拖。详情只列你真实发的提问与助手的文字，宿主注入的上下文与工具调用不进正文；助手文字按 Markdown 排版，你的提问保持原话。
+
+- **恢复**：单条不需要确认框，放回原项目目录并还原删除前的归档可见性。原工作区已被删掉也照常恢复（跳过账本挂接，归入「未分组」），清单行在点之前就说这句。
+- **批量恢复 / 批量彻底删除**：工具栏「多选」进入，页脚换成两颗动作按钮。组头那颗是**三态**勾选框，点它选上这个项目的全部会话（含折叠起来看不见的）。两者都先确认，逐条执行、失败不连坐，失败的原文留在它自己那行。
+- **彻底删除 / 清空**：共用同一个二次确认。单条那张卡片报的是**这一次会释放多少**（父 + 跟着进来的孩子 + 仍留在盘上的后代，与头部合计共用同一算式）。「清空回收站…」先把回收站目录与清单对账一遍再清，所以手工搬进 `session-trash/` 的**认得出**的目录也归它管；认不出的外人目录不动也不列。
+- **无主残留**：父会话已不在（既不在会话列表、也不在回收站清册）的子会话，宿主客户端整排不显示，回收站里也不会有。面板顶部只在扫描到时出现条件提示，预览后由你决定清不清；永久删除、不搬进回收站、**绝不自动跑**。
 
 ## 回收站与数据
 
@@ -80,11 +78,13 @@ dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 | 回收站本体 | `~/.dsh/session-trash/<时间戳>-<原目录名>/` |
 | 回收站清单 | 本插件自己的 storage domain（介质在 `~/.dsh/storages/`） |
 
-- 回收站与 `~/.dsh/sessions/` **同卷**：搬进搬出靠整目录 `rename`，原子、瞬时
-- **一格目录 = 一个会话**：一条父会话与跟着它进来的子会话**各占一格**，面板上折成一行显示——手工翻回收站目录时看到比清单多的目录，那是子会话
-- **清单丢了不致命**：会话文件自描述，解压后第一行即 header，含 `id` 与 `cwd`
-- **不自动过期**：不设天数上限，清空是显式动作；界面显示条数与占用
-- **附件不连坐**：附件是全局内容寻址的，与会话不是父子关系——删除不连带，也不会回收；被删会话独享的附件会留成垃圾（要回收得先有引用计数，属另一件事）
+- 回收站与 `~/.dsh/sessions/` **同卷**：搬进搬出靠整目录 `rename`，原子、瞬时。
+- **一格目录 = 一个会话**：父会话与跟着它进来的子会话各占一格，面板上折成一行。手工翻回收站目录时看到比清单多的目录，那是子会话。
+- **清单丢了不致命**：会话文件自描述，解压后第一行即 header，含 `id` 与 `cwd`；每次读清单都会与回收站目录对账。
+- **不自动过期**：不设天数上限，清空是显式动作；界面显示条数与占用。
+- **附件不连坐**：附件是全局内容寻址的，与会话不是父子关系——删除不连带，也不会回收；被删会话独享的附件会留成垃圾（要回收得先有引用计数，属另一件事）。
+- **无主子会话不在回收站里**：它们的父会话已不存在；清理只清会话目录，不包含宿主投影缓存和附件。
+- 回收站本体留在本机、不联网、不上传。
 
 ## 界面语言
 
@@ -94,19 +94,27 @@ dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 
 **装完侧栏没有「回收站」，会话菜单里也没有「删除」？**
 
-先重启宿主。若仍没有，确认这一代宿主上本插件激活过——取数通道探测不过时，本插件**一个入口都不注册**：页面上看不出它的存在，但它也不会因此把宿主拖死。这是有意用「入口不出现」表达不可用，不是禁用态。
+先重启宿主。若仍没有，确认这一代宿主上本插件激活过——取数通道探测不过时，本插件一个入口都不注册：页面上看不出它的存在，但也不会因此把宿主拖死。这是有意用「入口不出现」表达不可用，不是禁用态。
 
 **删完之后侧栏那一行怎么还在？**
 
-本插件只在**宿主确实不再列它**时才通告客户端把那一行去掉；拿不准时宁可沉默（那时说「已移除」是假话）。刚巧遇上就刷新页面，那一行会自己消失。本机运行期没打开过的**冷会话**走的是正常路径，删完即走。
+本插件只在**宿主确实不再列它**时才通告客户端把那一行去掉；拿不准时宁可沉默（那时说「已移除」是假话）。刚巧遇上就刷新页面，那一行会自己消失。本机运行期没打开过的**冷会话**走正常路径，删完即走。
 
 **正在运行的会话为什么删不掉？**
 
-判据用的是宿主自己的活跃检查（与官方归档的准入同源）。首版一律拒绝，不替用户终止正在进行的活——先停下这个会话再删。**它正在跑的子会话也算**：一条父会话的子会话在跑时，整条删除会被拒绝，报的是那个子会话的 id（那一行宿主的列表里不显示，所以别看列表没在跑就以为删得掉）。
+判据用的是宿主自己的活跃检查（与官方归档的准入同源）。一律拒绝，不替用户终止正在进行的活——先停下这个会话再删。**它正在跑的子会话也算**：报告的是那个子会话的 id，而那一行宿主的列表里不显示，所以别看列表就以为删得掉。
+
+**批量删除/恢复为什么只成功了一部分？**
+
+执行是逐条的，失败不会连坐。批量删除的确认框不关，原文留在失败那一行，按钮变成「重试这 N 条」；批量恢复失败的条目留在清单自己那行，多选态保持，成功的已经消失。重试只处理失败名单。
+
+**把工作区删了，回收站里的会话还能恢复吗？**
+
+能。宿主的「删除工作区」只删注册、保留目录和每个会话日志；恢复照常回盘，只是跳过账本挂接，会话落在「未分组」。清单行和批量恢复确认框都会在点之前说明。
 
-**能恢复多久？**
+**我把会话目录从回收站手工搬回 `sessions/` 了，为什么列表里没有？**
 
-不存在时间上限。不自动过期，只有你显式清空或彻底删除才会真的丢字节。
+回收站目录只负责文件；恢复还要挂回工作区账本并按删除前的归档态还原可见性。手工搬回不是恢复，下一次读清单会把对应行对账掉。请在面板里点「恢复」。
 
 ## 开发
 
@@ -128,7 +136,7 @@ dsh plugin --profile <profile> add "link:<本仓绝对路径>"
 
 改动生效分两半：**浏览器半**（`src/client/`）由宿主 HMR 推到浏览器，无需重启；**Node 半**不在热重载链路内，必须重启宿主。
 
-设计（五个触点、边界、错误形状、验证门、界面规格）住在 [`docs/design/2026-09-30-session-delete-design.md`](docs/design/2026-09-30-session-delete-design.md)，README 不复述。
+架构地图见 [`docs/architecture.md`](docs/architecture.md)（唯一主人清单、双半形态、数据与生命周期），裁决见 [`docs/adr/`](docs/adr/README.md)；回收站两栏、详情与批量动作的判据账在 [`docs/design/2026-09-30-session-delete-design.md`](docs/design/2026-09-30-session-delete-design.md)（界面规格在其 §7）与 [`docs/design/2026-10-15-trash-detail-design.md`](docs/design/2026-10-15-trash-detail-design.md)；构建、门控与发版流程见 [`docs/developing.md`](docs/developing.md)。README 不复述。
 
 ## 贡献