前言¶
在 DeepSeek Harness（DSH）里，会话归档是宿主自带能力：把暂时不用的对话收进 Archive，主列表更干净。归档多了之后，常见痛点是「找不着、管不动、删不敢」——仅靠原生侧栏很难按工作区或名称系统检索，批量取消归档和真正从磁盘清掉冷会话也缺少统一界面。社区里曾有侧重交互或永久删除研究的同类插件；@takboo/dsh-session-bin（仓库 takboo/dsh-session-bin）的定位是：直接管理 Harness 原生 Archive 集合，在一个面板里搜索、筛选、取消归档，并在严格条件下做单项、批量或清空式永久删除。维护者为 takboo，SkillHub 分类为「记忆」；当前 npm 版本 0.2.4，许可 MIT。
下面介绍插件能力、安装方式、典型用法，以及永久删除的边界——这些事实均来自项目 README 与 package.json 声明。
这是什么¶
DSH Session Bin 是 DSH 的原生归档管理插件（Native archived-session management）。它不另建一套「假归档」，而是读写宿主已有的 Archive；你在 Harness 里用原生「归档会话」产生的记录，安装插件后同样会出现在「会话回收站」（Session Bin）中。归档、取消归档的语义仍遵循宿主；插件补充的是集中 UI、搜索筛选、批量操作，以及带确认与进度日志的永久删除流程。
核心功能¶
浏览与筛选¶
- 默认按工作区分组。
- 支持按会话名称及工作区相关元数据搜索、筛选。
取消归档¶
- 单项或批量取消归档，会话回到原生会话列表。
永久删除（受控）¶
- 单项永久删除、对固定选择的批量永久删除，以及点击「清空」时对当时全部归档的永久删除。
- 删除前有简洁确认；可在设置里全局关闭「永久删除会话前进行确认」（默认开启）。关闭后，单项删除、删除所选、清空会直接开始永久删除。
- 批量操作显示进度和日志；完成后保留简短统计及失败项。中断或断线后可查结果并决定是否继续。
范围说明（README 原文要点）：
- 「清空全部归档」包含点击瞬间的全部归档；当时的搜索和工作区筛选不会缩小清空范围。
- 批量删除固定为开始时的对象；操作过程中新归档的会话不会被加入本次批量。
永久删除不可撤销。仅允许已归档、无活动且无未释放读写引用的冷会话；插件会释放由 API Session 激活且确认空闲的目标 Agent 后再复核。活动任务、其他所有者的 Agent、未释放读写引用仍会阻止删除。清除范围是会话日志及已声明的会话元数据、索引；共享附件、外部副本和独立 fork 会保留。插件不提供共享附件垃圾回收或安全擦除保证，也不支持自动定期清空、跨设备同步或多 Host 协调。可通过 Host 配置 permanentDeletion: false 关闭永久删除（细节见仓库 Host 生命周期）。
界面与语言¶
- 中英文界面，使用宿主控件，支持浅色与深色主题。
兼容性与版本¶
- 插件
0.2.4适配 DSH0.2.1-rc.2（package.json中engines.dsh同为该版本）；0.2.4修复 macOS ARM64 桌面版内置运行时拒绝永久删除的问题。 - 使用 DSH
0.2.1-rc.1时请保留插件0.2.1；旧宿主0.2.0-rc.2对应插件0.2.0。 - 永久删除仅在 README 表格列出的精确运行时、单 Host 与已验证的 JSONL raw/zstd 存储组合下启用；不满足条件时会明确拒绝。Windows ARM64、未验证的桌面架构/版本、普通 Node
24.21.0（非表格所列组合）等不在支持范围内。完整准入见 Host 生命周期。
Node 引擎：24.18.1 || 24.21.0。
安装与启用¶
发布包为预编译 bundle（含 Host 与 Client），安装时无需本地编译 TypeScript。
在已安装 DSH 0.2.1-rc.2 的前提下，向 web profile 安装：
dsh plugin --profile web add @takboo/dsh-session-bin@0.2.4
已验证的 macOS ARM64 桌面版：在 desktop profile 的插件管理页面安装同一 npm 包，并重新启动该 profile 的宿主。启动或重启后，从侧栏打开「会话回收站」（Session Bin）。
卸载同一 profile 中的插件：
dsh plugin --profile web remove @takboo/dsh-session-bin
也可从 v0.2.4 Release 下载附件，核对 SHA256SUMS 后本地安装：
dsh plugin --profile web add ./dsh-session-bin.tgz
若曾安装早期未加 scope 的开发包 dsh-session-bin，需先从同一 profile 卸载该包，再安装 @takboo/dsh-session-bin，避免重复注册；原生归档与已有操作记录会保留。
典型用法¶
- 在 Harness 中使用原生「归档会话」归档目标会话。
- 打开「会话回收站」，搜索或筛选已有归档；选择一项或多项执行取消归档。
- 需要永久删除时，核对确认窗口中的对象与可能的阻止原因，再确认执行。若设置中关闭了删除确认，点击后将直接开始永久删除。
- 批量操作期间查看进度与日志；完成后根据统计与失败项处理。若部分失败或连接中断，先检查操作状态，再决定是否继续。
适用场景与注意¶
适合谁： 长期在 DSH 中归档大量会话、需要按工作区/名称找回、批量恢复或谨慎清理冷会话的开发者；尤其在使用 0.2.1-rc.2 且环境落在 README 永久删除验收矩阵内时，可依赖插件提供的受控删除路径。
生态背景： DSH 强调「一切皆插件」；SkillHub 目录页 等社区站点独立于 DeepSeek / 幻方，并非官方应用商店。
安全与权限： 插件以当前 DSH 进程权限运行，永久删除会改动本地会话存储。安装前应阅读源码、MIT License 及 Host 配置说明，确认与自身合规要求一致。
结尾¶
DSH Session Bin 把 Harness 原生 Archive 收进单一面板：搜索筛选、取消归档、带确认与日志的永久删除，并明确不支持的范围（附件 GC、跨设备同步等）。若你的宿主版本与运行环境与 README 一致，可按上文命令安装并在侧栏使用 Session Bin。
