DeepSeek HarnessHub
플러그인 제출

haotian-lu-prog/dsh-archived ↗★ 0

dsh-archived

Archived-sessions page for DeepSeek Harness: per-row and batch deletion that clears the session log, the projection cache and the archive index together, with a 30-day recycle bin, subagent-aware refusals and a per-row disk footprint. 适合需要彻底清理已归档会话、释放磁盘空间并提供回收站保障的用户。

Agent 협업생산성 도구
패키지
dsh-archived
호환성
미검증
Harness peer 범위
^0.2.0-rc.1
Cordis peer 범위
^4.0.4
버전
0.3.1
라이선스
MIT
최근 업데이트
2026. 10. 2.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:haotian-lu-prog/dsh-archived

문서

전체 README 읽기 ↗

dsh-archived

给 DeepSeek Harness 的 设置 → 已归档 页补上删除：逐条删、勾选批量删、清空； 删除默认先进回收站（30 天内可恢复），并显示每行的磁盘占用。

DSH 至今没有官方「删除会话」的接口——归档只能取消归档，日志和投影缓存会一直留在磁盘上。 这个插件就是补上那一块。

它做了什么

DSH 0.2.0-rc.2 里，一个已归档会话牵涉四处状态，少清一处列表就会骗人：

#状态位置
1会话日志目录$DSH_HOME/sessions//session-/（session.v4.jsonl.zstd + session.lock）
2投影缓存文档$DSH_HOME/storages/session_projcache/sessions/.json
3归档索引workspace registry 的 archivedSessionIds
4回收站（本插件自建）$DSH_HOME/.archived-sessions-quarantine//

删除有两条路径，界面上是两个分开的按钮：

  • 删除（默认）：把 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 的投影服务可能在删除后几秒把 .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 等），测试因此不需要浏览器，也不会碰真实会话。

回滚

  1. 从 ~/.dsh/profiles/web/package.json 的 bundles 与 dependencies 里删掉 dsh-archived； 或直接 dsh plugin --profile web remove dsh-archived；
  2. 删掉 ~/.dsh/profiles/web/node_modules/dsh-archived 软链（源码安装时）；
  3. ~/.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 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，「打开文件夹」只回路径不启动程序。