@xrn1997/dsh-session-delete 0.3.1 → 0.4.0

package/README.md

@@ -1,8 +1,9 @@
 # @xrn1997/dsh-session-delete
 
+[![CI](https://github.com/xrn1997/dsh-session-delete/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/xrn1997/dsh-session-delete/actions/workflows/ci.yml)
 [![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 / 0.2.1-rc.3](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%20%7C%200.2.1--rc.3-brightgreen)
+[![Tested with DSH 0.2.0-rc.2 … 0.2.1-rc.3](https://img.shields.io/badge/DSH-0.2.0--rc.2%20%E2%80%A6%200.2.1--rc.3-brightgreen)](#安装)
 
 给 DeepSeek Harness（DSH）加一个**删除会话**的能力。DSH 官方有归档、没有删除——归档只是把会话从列表里挪走，文件还在。本插件补上删除，并且让删除可恢复：删除 = 移入回收站，另有一个显式的「彻底删除」。
 
@@ -10,7 +11,7 @@
 
 - 安装：`dsh plugin --profile <profile> add @xrn1997/dsh-session-delete`
 - 许可：[Apache-2.0](LICENSE)
-- 数据：回收站本体留在本机 `~/.dsh/session-trash/`，不联网、不上传
+- 数据：回收站本体留在本机 `$DSH_HOME/session-trash/`（默认 `~/.dsh/session-trash/`），不联网、不上传
 
 ## 目录
 
@@ -30,9 +31,10 @@
 - **按整组删**：父会话在盘上的子会话与更深后代一起走；任一成员在跑 ⇒ 整组拒绝、零副作用
 - **批量删除**：宿主会话列表「⋯」→「多选」，一次确认、一次执行；失败的留在框里可重试，成功的整批撤销
 - **回收站面板**：左清单右详情，按项目分组、可折叠、可拖分栏；看得见正文再决定恢复不恢复
+- **详情看得到附件**：消息里的图片内联、可点开放大，普通文件给下载 chip；图片加载失败换成占位，不把破图留在屏上（文件下载失败没有页面内提示，浏览器可能把错误响应存成文件）
 - **恢复**：单条即点即回，批量带确认；回到各自的原项目目录（删除前你自己归档过的仍保持归档）
 - **显式彻底删除**：单条「彻底删除…」与页脚「清空回收站…」共用同一个二次确认；不自动过期
-- **清理无主残留**：父会话已不存在的子会话宿主根本不显示，面板扫描到后由你决定清不清
+- **手动清理残留**：插件设置页有一张「维护」卡，随时检查两类残留——父会话已不在的子会话，和 `.dsh` 里已没有任何引用的图片副本；看过数量与体积再由你决定清不清，不自动检查、不自动清理
 - **失败不吞**：宿主读不到时把原文上屏并给「重试」；不可用时不注册任何入口
 - **文案随宿主语言**：中文 / English 挂在宿主 locale 服务上
 
@@ -43,13 +45,13 @@ dsh plugin --profile <profile> add @xrn1997/dsh-session-delete
 dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 ```
 
-装完**重启宿主**（Node 半不走 HMR）。卸载只移除插件，`~/.dsh/session-trash/` 下已有的目录不会被自动清理。
+装完**重启宿主**（Node 半不走 HMR）。卸载只移除插件，`$DSH_HOME/session-trash/`（默认 `~/.dsh/session-trash/`）下已有的目录不会被自动清理。
 
-也可以离线分发：`pnpm pack` 出 tarball 后 `dsh plugin add ./xrn1997-dsh-session-delete-<版本>.tgz`（scoped 包的文件名带作者段）。包里带预构建产物（`prepack` 会替你跑 `build`），这条路不需要为构建脚本授权。
+也可以离线分发：`pnpm pack` 出 tarball 后 `dsh plugin --profile <profile> add ./xrn1997-dsh-session-delete-<版本>.tgz`（scoped 包的文件名带作者段）。包里带预构建产物（`prepack` 会替你跑 `build`），这条路不需要为构建脚本授权。
 
 **兼容性分两层，别混**：
 
-- **装得上**由 `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` 起连会话行入口都没有。
+- **装得上**由 `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、0.2.1-rc.3**（均 `compatible`）。窗口内的其他代次装得上但没在桌面真机上验过；窗口外的一律拒装。
 
 ## 用法
@@ -69,21 +71,21 @@ dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 - **恢复**：单条不需要确认框，放回原项目目录（删除前你自己归档过的仍保持归档；旧版本留下的归档态条目会迁移式取消归档）。原工作区已被删掉也照常恢复（跳过账本挂接，归入「未分组」），清单行在点之前就说这句。
 - **批量恢复 / 批量彻底删除**：工具栏「多选」进入，页脚换成两颗动作按钮。组头那颗是**三态**勾选框，点它选上这个项目的全部会话（含折叠起来看不见的）。两者都先确认，逐条执行、失败不连坐，失败的原文留在它自己那行。
 - **彻底删除 / 清空**：共用同一个二次确认。单条那张卡片报的是**这一次会释放多少**（父 + 跟着进来的孩子 + 仍留在盘上的后代，与头部合计共用同一算式）。「清空回收站…」先把回收站目录与清单对账一遍再清，所以手工搬进 `session-trash/` 的**认得出**的目录也归它管；认不出的外人目录不动也不列。
-- **无主残留**：父会话已不在（既不在会话列表、也不在回收站清册）的子会话，宿主客户端整排不显示，回收站里也不会有。面板顶部只在扫描到时出现条件提示，预览后由你决定清不清；永久删除、不搬进回收站、**绝不自动跑**。
+- **残留维护在插件设置页**：父会话已不在（既不在会话列表、也不在回收站清册）的子会话宿主客户端整排不显示，回收站里也不会有；`.dsh` 附件库里也可能留下没有任何引用的图片副本。插件详情页的「维护」卡分「孤儿会话」「孤儿附件」两段，都是**手动**：点「检查」只读，看过数量、体积与图片缩略图再确认清理，清完自动重查；永久删除、不搬进回收站、**绝不自动跑**。回收站面板不再扫描残留，顶上只保留彻底删除 / 清空之后的附件清理提示。
 
 ## 回收站与数据
 
 | 东西 | 位置 |
 | --- | --- |
-| 回收站本体 | `~/.dsh/session-trash/<时间戳>-<原目录名>/` |
-| 回收站清单 | 本插件自己的 storage domain（介质在 `~/.dsh/storages/`） |
+| 回收站本体 | `$DSH_HOME/session-trash/<时间戳>-<原目录名>/`（默认 `~/.dsh/session-trash/…`） |
+| 回收站清单 | 本插件自己的 storage domain（介质在 `$DSH_HOME/storages/`，默认 `~/.dsh/storages/`） |
 
-- 回收站与 `~/.dsh/sessions/` **同卷**：搬进搬出靠整目录 `rename`，原子、瞬时。
+- 回收站与 `$DSH_HOME/sessions/`（默认 `~/.dsh/sessions/`）**同卷**：搬进搬出靠整目录 `rename`，原子、瞬时。
 - **一格目录 = 一个会话**：父会话与跟着它进来的子会话各占一格，面板上折成一行。手工翻回收站目录时看到比清单多的目录，那是子会话。
-- **清单丢了不致命**：会话文件自描述，解压后第一行即 header，含 `id` 与 `cwd`；读取回收站列表（以及清空、恢复、彻底删除与清理残留前）会先与回收站目录对账。
-- **不自动过期**：不设天数上限，清空是显式动作；界面显示条数与占用。
-- **附件不连坐**：附件是全局内容寻址的，与会话不是父子关系——删除不连带，也不会回收；被删会话独享的附件会留成垃圾（要回收得先有引用计数，属另一件事）。
-- **无主子会话不在回收站里**：它们的父会话已不存在；清理只清会话目录，不包含宿主投影缓存和附件。
+- **清单丢了不致命**：会话文件自描述，解压后第一行即 header，含 `id` 与 `cwd`；读取回收站列表（以及清空、恢复、彻底删除与清理无主子会话前）会先与回收站目录对账。
+- **不自动过期**：不设天数上限，清空是显式动作；界面显示条数与共可释放量（与彻底删除确认同一口径）。
+- **附件**：宿主把对话里的图片/文件副本存在 `$DSH_HOME/attachments/v1`。彻底删除会话时，只清理**只被这些会话引用**的图片副本；共享副本保留，你磁盘上的原图不受影响。普通文件附件目前只渲染、不代删。设置页「维护」卡的「孤儿附件」段可以手动清掉 `.dsh` 里已经没有任何引用的图片副本，同样只动这些副本、源文件不受影响、共享引用保留。
+- **无主子会话不在回收站里**：它们的父会话已不存在；清理只清会话目录与会话独占的图片副本（宿主投影缓存不包含在内，共享图片保留，你磁盘上的原图不受影响）。检查与清理都在插件设置页的「维护」卡里手动发起。
 - 回收站本体留在本机、不联网、不上传。
 
 ## 界面语言
@@ -116,6 +118,10 @@ dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
 
 回收站目录只负责文件；恢复还要挂回工作区账本（旧版本留下的归档态条目会迁移式取消归档）。手工搬回不是恢复，下一次读清单会把对应行对账掉。请在面板里点「恢复」。
 
+**把宿主绑到局域网地址后，操作报「需要宿主的 Web 身份」或「非受信来源」？**
+
+本插件的取数门槛与宿主自己的 `/api` 同一套口径：本机与桌面壳照旧，局域网 / 反向代理客户端则要求你已经用 `dsh web` 打印的那一行 URL 打开过页面（宿主签发的 Web 身份）——缺的就是这枚身份时，原文写「需要宿主的 Web 身份」。原文写「非受信来源」说的是另一件事：这条请求的归属不成立，`Host` 不被认为是本次部署的地址，或 `Origin` / `Referer` 与它对不上。常见成因有三种：用自定义域名（含 hosts 文件）访问，却没把它写进宿主 `client-connection` 的 `trustedHosts`——宿主自己的页面同样要求这一条；反向代理改写了 `Host`，它必须保留客户端的原始 `Host`，改写成回环地址时浏览器请求会因 `Origin` / `Referer` 对不上被拒，而不带这两个头的工具请求会被当成本机请求（那一支不要求 Web 身份）；或者当前宿主代次没有提供身份服务（`connection`），那时远程请求一律拒——升级宿主，或改从本机访问。绑定时另有一条前提：宿主只接受具体接口地址、拒绝 `0.0.0.0`，请绑到某个具体 IP（例如 `webserver.host: 192.168.50.199`）。
+
 ## 开发
 
 构建、本地调试、门控、真机验证与发版见 [`docs/development.md`](docs/development.md)；提交信息与 PR 约定见 [`CONTRIBUTING.md`](CONTRIBUTING.md)；架构地图与主人清单见 [`docs/architecture.md`](docs/architecture.md)；界面规格见 [`docs/ui-spec.md`](docs/ui-spec.md)；文档分层与放置见 [`docs/AGENTS.md`](docs/AGENTS.md)；裁决见 [`docs/adr/`](docs/adr/README.md)；发布历史见 [`CHANGELOG.md`](CHANGELOG.md)。历史取舍在 git 历史里，README 不复述。