pyh
dbf6138df2
publish / npm (push) Successful in 3s
Ships the rewritten README inside the package and pins the documented install specs to this version.
98 lines
4.7 KiB
Markdown
98 lines
4.7 KiB
Markdown
# 会话彻底删除
|
||
|
||
DeepSeek Harness（DSH）插件：给会话加上**真正不可逆的删除**，并清理已删除会话遗留的临时文件。
|
||
|
||
DSH 原本只能归档会话——归档只是把会话从列表里移开，日志仍然留在磁盘上。这个插件提供两处删除入口，以及设置页里的一次性孤儿文件清理。
|
||
|
||
## 功能
|
||
|
||
### 1. 删除会话
|
||
|
||
两个入口，行为一致，都会先弹出确认弹窗（复刻系统 Modal 的样式与键盘行为：Esc 关闭、Tab 焦点圈定、打开时焦点进入、关闭后焦点归位）：
|
||
|
||
- 会话行右侧 **⋯** 菜单 → **删除会话**
|
||
- 会话行悬停时的 🗑 快捷按钮（占用原「归档会话」的位置，归档改从菜单进入）
|
||
|
||
确认后一次性处理：
|
||
|
||
| 对象 | 处理方式 |
|
||
| --- | --- |
|
||
| 会话日志目录 | 整个删除，仅保留 `session.lock` |
|
||
| 子智能体会话 | 按 `parentSession` 递归收集，连同日志与溢出文件一并删除 |
|
||
| 工具输出溢出文件（spill） | 删除该会话（含子会话）对应的 spill 目录 |
|
||
| 工作区登记项 | 解除绑定、取消置顶、取消归档 |
|
||
| 客户端列表 | 广播 `api-session/removed`，列表行立即消失 |
|
||
|
||
有意**不**处理：
|
||
|
||
- **附件对象**（`$DSH_HOME/attachments/v1/objects`）：按内容 sha256 寻址，同一份内容可能被多个会话共享，而 DSH 没有引用计数，跟着一个会话删除会破坏别的会话；
|
||
- **投影缓存**（`$DSH_HOME/storages/session_projcache`）：由日志派生的缓存，读取时带生命周期身份校验，永远不会串到别的会话。
|
||
|
||
### 2. 清理临时文件
|
||
|
||
设置 → 通用设置 → **清理临时文件**，清理 spill 后端留下的**孤儿**目录。判定偏保守：
|
||
|
||
1. 目录名必须精确等于 `session-<sha256(会话 id) 前 12 位>`——这是 spill 后端唯一会生成的形状；
|
||
2. 该名字不属于任何已知会话（存量会话与内存中正在运行的会话都算）；
|
||
3. 只在 spill 的 root 内操作（后端当前 root + 系统临时目录下的 `dsh-spill*`）；
|
||
4. 符号链接一律跳过、不跟随；单项失败只记警告。
|
||
|
||
结果直接显示在该行（清理了几个目录、几个文件、释放多少空间），可反复点击。
|
||
|
||
## 行为与边界
|
||
|
||
- **仍在运行的会话**无法被插件从内存里移除：它会先被归档并停止，日志与溢出文件在**下次启动 DSH 时**删除（界面会明确提示）；在此之前取消归档就会取消这次删除。
|
||
- 删除**不可恢复**，但**不是安全擦除**：按普通文件删除处理，底层介质上可能有残留。
|
||
- 工作区里的代码文件不受影响。
|
||
- 溢出文件被删除后，fork 出来的会话日志里若仍保留指向它的路径文本，那些路径会失效。
|
||
|
||
## 安装
|
||
|
||
在 DSH 的 **插件 → 添加插件** 里三选一。
|
||
|
||
### 1. npm 包（推荐）
|
||
|
||
安装源选 **自定义地址**，填本插件的注册表：
|
||
|
||
```text
|
||
https://gitea.iwake.top/api/packages/dsh-plugin/npm/
|
||
```
|
||
|
||
包名填：
|
||
|
||
```text
|
||
@dsh-plugin/session-delete
|
||
```
|
||
|
||
包是公开的，不需要凭据。若你的环境需要认证，把令牌写进本机 `~/.npmrc`：
|
||
|
||
```bash
|
||
npm config set @dsh-plugin:registry=https://gitea.iwake.top/api/packages/dsh-plugin/npm/
|
||
npm config set //gitea.iwake.top/api/packages/dsh-plugin/npm/:_authToken=<token>
|
||
```
|
||
|
||
### 2. Git 仓库地址
|
||
|
||
```text
|
||
https://gitea.iwake.top/dsh-plugin/session-delete.git#v1.0.1
|
||
```
|
||
|
||
`#` 后面可以跟标签或提交，用来锁定版本。仓库是公开的，不需要凭据。
|
||
|
||
### 3. 本地 tgz
|
||
|
||
把 [session-delete-1.0.1.tgz](https://gitea.iwake.top/api/packages/dsh-plugin/npm/@dsh-plugin%2Fsession-delete/-/1.0.1/session-delete-1.0.1.tgz) 下载到运行 DSH 的机器上，在安装界面里填它的绝对路径。
|
||
|
||
安装或升级后：**宿主半变更需要重启 DSH**（完全退出再打开，仅关闭窗口不一定退出进程）；只改浏览器半时刷新页面即可。
|
||
|
||
## 兼容性
|
||
|
||
基于 **DeepSeek Harness 0.2.0-rc.2** 编写。DSH 仍在演进，其它版本与平台组合未逐一验证。
|
||
|
||
- 浏览器半不 import 任何 Harness 客户端包（上游规范如此要求：这些包随时可能变化，渲染抛错会让整个插槽条目变空白），而是复刻 `dsh-client-ui-primitives` 的 markup、CSS 声明、图标 path 数据与键盘行为，只保留 `--dsw-*` 主题 token 引用。上游若改动这些内部结构，界面细节可能失配（例如悬停气泡不再出现），但不会导致插件加载失败。
|
||
- 宿主半只依赖稳定的服务契约：`sessionPersistence`、`sessionQuery`、`workspaceRegistry`、`sessions`、`agents`、`connection.fetch`，以及 spill 后端的目录规则。
|
||
|
||
## License
|
||
|
||
[MIT](LICENSE)
|