dsh-archived
给 DeepSeek Harness 的 设置 → 已归档 页补上删除：逐条删、勾选批量删、清空； 删除默认先进回收站（30 天内可恢复），并显示每行的磁盘占用。
DSH 至今没有官方「删除会话」的接口——归档只能取消归档，日志和投影缓存会一直留在磁盘上。 这个插件就是补上那一块。
它做了什么
DSH 0.2.0-rc.2 里，一个已归档会话牵涉四处状态，少清一处列表就会骗人：
| # | 状态 | 位置 |
|---|---|---|
| 1 | 会话日志目录 | $DSH_HOME/sessions/<编码工作区>/session-<id>/（session.v4.jsonl.zstd + session.lock） |
| 2 | 投影缓存文档 | $DSH_HOME/storages/session_projcache/sessions/<id>.json |
| 3 | 归档索引 | workspace registry 的 archivedSessionIds |
| 4 | 回收站（本插件自建） | $DSH_HOME/.archived-sessions-quarantine/<id>/ |
删除有两条路径，界面上是两个分开的按钮：
- 删除（默认）：把 1、2 移动进 4，再清 3。面板顶部常显「回收站：N 个 · X MB」，可以逐条恢复或整体清空；30 天后自动清除。
- 永久删除：只出现在二次确认里，直接 unlink，不进回收站。
第 3 步走官方 ctx.workspaceRegistry.unarchiveSession()——它刻意不校验会话是否存在，正好能把「只剩索引」的残留一起清掉，
并借官方广播刷新所有已连接的客户端。
安全边界
- 只接受已归档的 id（
not-archived直接拒绝），不碰未归档会话； agent.status === "running"的会话拒绝删除（正在生成的回合不能丢日志），空闲但打开的会话可删；- 有正在运行的 subagent 后代时拒绝删除父会话（否则子会话的父会话会在它脚下消失）；
- 索引残留没有 payload 就不进回收站：一个只有索引、磁盘上什么都没有的 id，清掉即可，不该在回收站里留一个永远恢复不了的条目；
- 路由仅限回环地址 + 同源 + 自定义标头：
Origin存在时必须与 Host 匹配；浏览器对同源 GET 不发Origin， 该情形由sec-fetch-site: same-origin兜底，两个信号都没有则拒绝； - 宿主若失去
workspaceRegistry.unarchiveSession，破坏性路由直接拒绝（no-registry），不会「删了文件但留下索引」这种假成功。
删除后的残留清理
会话被归档时如果它的 agent 还开着（空闲未运行），DSH 的投影服务可能在删除后几秒把 <id>.json 缓存重新写回
（日志目录不会复活）。因此每次成功删除都会排三个定时清扫（+3s / +15s / +60s），再次清掉这类残留。
清扫只删缓存文档，且要求该会话既没回到归档集合、也没在跑、磁盘上也没有会话目录——目录回来了说明会话被恢复了，绝不碰。
定时器在插件卸载时统一取消。
界面
行的事实源是宿主（GET /state：归档集合 + 磁盘 + 投影缓存文档），浏览器的会话摘要只用来把标题和时间显示得更准。
这一点是有意的：索引里还留着、但浏览器没加载过的会话，必须照样成行显示，否则用户根本无从清理。
页面提供：搜索（标题 / 会话 ID / 工作区）、按工作区分组、逐行勾选与全选、每行展开详情 （占用空间、创建时间、缓存有无、父/子会话）、「打开文件夹」、行内二次确认、结果就地反馈， 以及顶部常显的回收站（恢复最近一个 / 清空）。
导航行与页面标题都是 Archived（英文）/ 已归档（中文）。
宿主路由
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/dsh-archived/state |
归档行 + 磁盘占用 + 血缘 + 回收站 + 旧聚合探测 |
| POST | /api/dsh-archived/delete |
{ sessionId, mode: "quarantine" | "forever" } |
| POST | /api/dsh-archived/delete-all |
{ mode, ids? }；ids 缺省表示清空全部 |
| POST | /api/dsh-archived/restore |
{ sessionId } 从回收站恢复并重新归档 |
| POST | /api/dsh-archived/empty-quarantine |
彻底清空回收站 |
| POST | /api/dsh-archived/reveal |
{ sessionId } 在系统文件管理器里打开该会话目录 |
拒绝码：invalid-session-id、not-archived、session-running、subagent-running、no-registry、
busy、not-quarantined、no-artifact、forbidden、internal。
安装
# 装进 profile（包自带的 bundle patch 会把它挂上）
dsh plugin --profile web add dsh-archived
# 重启 dsh web，然后 设置 → 已归档
不需要改 profile patch。 DSH 0.2.0-rc.2 已经没有官方的归档设置页，settings.section 的
archived-sessions id 是空的，本插件是它唯一的占用者。
从源码（开发用）
# 1) 让 profile 能解析到这个包（link: 指向本仓库根目录）
ln -s /path/to/repo ~/.dsh/profiles/web/node_modules/dsh-archived
# ~/.dsh/profiles/web/package.json
# "dependencies": { "dsh-archived": "link:/path/to/repo" }
# "dsh": { "profile": { "bundles": [ ..., "dsh-archived" ] } }
# 2) 开发时热重载宿主代码（默认 root: [] 只监听 profile 清单与 patch 文件）
# ~/.dsh/profiles/web/cordis.patch.yml
# - id: hmr
# config:
# root:
# - "/path/to/repo"
dsh-hmr 只监听 profile 清单与 patch 文件；改了 lib/index.js 想立即生效，需要把本仓库根目录加进 hmr.config.root。
客户端半边改动刷新浏览器即可。
兼容性
- 目标宿主：DSH 0.2.0-rc.2（
peerDependencies收敛到^0.2.0-rc.1）。 - 不支持 0.1.x：那时官方还有一个归档设置页，需要手动
disabled: true；0.2.0-rc.2 已经没有它了。 代码里的priority: -1只是对「还带官方页的宿主」的防御。 - DSH 升级后先跑契约检查，它直接读本机 app.asar，逐条确认插件依赖的接口还在：
node tools/compat-check.mjs。
测试
npm test # 宿主离线 + 客户端冒烟 + 宿主契约，都不需要 DSH
node tools/host-smoke.mjs # 宿主半边：临时 $DSH_HOME + 假 ctx，跑完删除/恢复/回收站全流程
node tools/client-smoke.mjs # 客户端半边：桩 React + 桩 fetch
node tools/compat-check.mjs # 宿主契约（读 app.asar）
python3 tools/e2e.py # 真宿主端到端；需要 dsh web 在跑且插件已加载
python3 tools/browser-acceptance.py # 真浏览器；先起无头 Chrome --remote-debugging-port=9333
tools/e2e.py 会建临时会话 → 归档 → 删除（进回收站）→ 恢复 → 永久删除，并核对
「其他归档会话与磁盘上的其他会话数量都没变」。
tools/browser-acceptance.py 是纯标准库的 CDP 客户端（自己实现 WebSocket 握手与帧）：用本机密钥签出浏览器会话 cookie
注入无头 Chrome，打开 设置 → 已归档，断言导航里只有一个「已归档」入口，然后真的点删除 → 确认 → 恢复最近一个。
tools/rpc.py 是本地 RPC 小工具：用 ~/.dsh/.credentials.yaml 里的浏览器会话密钥现场签 cookie，
从终端调用官方 RPC（session/create、workspace/archiveSession 等），测试因此不需要浏览器，也不会碰真实会话。
回滚
- 从
~/.dsh/profiles/web/package.json的bundles与dependencies里删掉dsh-archived； 或直接dsh plugin --profile web remove dsh-archived； - 删掉
~/.dsh/profiles/web/node_modules/dsh-archived软链（源码安装时）； ~/.dsh/.archived-sessions-quarantine/里可能还有待恢复的会话——确认不需要后手动删除即可。
插件删掉的会话不会回来（forever），或者还躺在回收站里等 30 天过期（默认路径）。
故障排查
dsh plugin add 报 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION（Lockfile failed supply-chain policy check）。
这不是本插件的问题：pnpm 11 默认给「24 小时内发布的版本」设了闸门，而 profile 的 pnpm-workspace.yaml
里 minimumReleaseAgeExclude 是按「包名@版本」逐条累加的——同一个包名出现两条时只有其中一条生效
（实测是列表里靠前的那条），于是新发布的那个版本永远过不了闸门。报错点名的包可能根本不是你要装的那个。
修法：让每个包名只留一条，把已接受的确切版本用 || 连起来：
minimumReleaseAgeExclude:
- dsh-notifications@1.0.0 || 2.0.0 # ✅ 一条顶两条
minimumReleaseAgeExclude:
- dsh-notifications@1.0.0 # ❌ 这两条同时存在时，
- dsh-notifications@2.0.0 # 2.0.0 那条不生效
⚠️ 只接受确切版本：写成 dsh-notifications@* 或 @^2.0.0 会被直接拒绝
（ERR_PNPM_INVALID_MINIMUM_RELEASE_AGE_EXCLUDE: Use exact versions only.）。
pnpm 每次成功安装后都会往这个列表追加一条「包名@版本」，所以升级几次之后又会出现同名两条——
发现同名时把它们合并成上面那种 || 形式即可。删掉重复行后重跑
dsh plugin --profile <name> add <包名> 就通了。
已知边界
$DSH_HOME/storages/schedule.json与message_feedback.json里可能残留指向已删会话的引用。 它们是宿主自己的 domain store，外部改写会被内存状态覆盖，本插件不动它们（见docs/decisions.md）。$DSH_HOME/storages/session_projcache.json是 per-record 布局之前的旧聚合，实测早已停止写入 （mtime 远早于session_projcache/sessions/）。插件只探测并在详情里标注，不写入。- 无头宿主没有文件管理器：设
DSH_ARCHIVED_OPENER=none，「打开文件夹」只回路径不启动程序。
No comments yet. Be the first to write one.