deepseekplugins

DeepSeek Harness plugin

dsh-archive-vault

dsh 插件：在设置面板中查看、恢复与永久删除归档会话

Memory
Jump to install

Source facts

Repository
Britneycode/dsh-archive-vault
Latest update
Aug 16, 2026
Category
Memory
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Britneycode/dsh-archive-vault
Plugin: dsh-archive-vault
Author: Britneycode

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-archive-vault 归档对话

dsh 宿主只有"归档会话"（workspace.archiveSession：把会话从所有分组界面隐藏）， 没有查看、恢复或删除归档会话的入口。本插件补齐这一环：

  • 设置页 → 归档对话：列出所有归档会话（所属工作区、创建时间、最近一条

人类提问预览、cwd），支持关键词过滤；

  • 一键恢复：把会话从全局归档集合移除，立即回到原工作区会话列表的

原位置（归档不改变工作区记账，恢复自动还原位置）；

  • 永久删除：两步确认（点「删除」→ 变红「确认删除」），清除归档记录、

工作区记账并删除磁盘会话日志；删除成功后重新读取宿主会话清单，已删除 的缓存行不会短暂取消归档后残留在「未分组」；正在运行的会话会被拒绝；

  • 按归档时长清理：「清理 7 天以上」和「清理 30 天以上」按实际归档时间

批量永久删除；第一次点击进入 5 秒确认状态，第二次点击才执行。单项失败 不会中止其余清理，完成后分别报告成功数与失败数；

  • 实时刷新：恢复写入 workspace domain global，触发 domain/changed，

apiproxy 自动向所有已连接的 Web 客户端推送 host/archived-sessions-changed， 左侧列表实时更新，无需手动刷新页面；

  • agent 工具：list_archived_sessions / unarchive_session /

delete_archived_session，在会话里也能直接找回或清理旧对话。

恢复的写入路径（兼容性说明）

宿主 WorkspaceRegistry 只公开 archiveSession，没有 unarchive。本插件的 恢复走 registry 实例的串行写队列（enqueueOperation + setState，宿主里是 TS private、运行时可访问）：

  • 与 create/delete/reorder/archive 的所有写完全互斥，不会丢并发变更；
  • 归档集合在队列内重读，排队期间其他客户端的新归档不会丢失；
  • 写入的 state 形状与宿主 recoverPendingMutation 产出的三字段一致，

通过 apiproxy 的 workspaceDomainState zod 校验；

  • 宿主若改名这两个方法，插件显式报错（不会静默写坏状态）。

删除的写入路径

宿主全链路没有会话删除 API（持久化后端只有 create/append/read）。删除按 "失败偏向重新可见"的顺序组装：

1. live 会话拒绝（sessions.get(id) 有值时不动文件）； 2. 从归档集合移除（同恢复路径，幂等）； 3. 从所属工作区记账移除（entity.detachSession，公开方法、domain 写链、 幂等，自动推 host/workspace-changed 帧）； 4. persistence.locate() 定位日志文件，删除其父目录（sessions/<project>/ session-<uuid>）；目录名不含会话 id 时拒绝删文件（防后端布局变化误删）。

日志删除后 persistence.list() 立即不再列出该会话（客户端基线随之消失， 删除请求发起端会立即重读该基线，无需刷新页面或重启）；projection cache 行 与日志身份绑定，过期行自动作废，无需清理。 删除不要求会话仍在归档集合（幂等）：中途失败后重试不会卡在半完成状态。

归档时间与批量清理

插件从安装并启用本版本后开始记录新的归档动作。升级前已经处于归档状态的 对话没有可靠的实际归档时间，会显示为「归档时间未知」，不会进入 7 天或 30 天批量清理范围；取消归档后再次归档会重新开始计时。7 天清理包含所有 已归档满 7 天的对话，因此也包含已满 30 天的对话。

归档时间默认保存在 ~/.dsh/archive-vault/archive-times.json；设置了 DSH_HOME 时则保存在 $DSH_HOME/archive-vault/archive-times.json。状态文件 使用版本化 JSON 并以临时文件原子替换。文件损坏、版本不受支持或读取失败时， 列表和批量清理都会明确报错并停止，不会根据会话创建时间猜测归档时间。

安装

推荐用 dsh 官方 CLI 安装（自动完成 pnpm 安装与 dsh.profile.bundles 对账，无需手改任何配置）：

dsh plugin --profile web add dsh-archive-vault                      # npm 源
dsh plugin --profile web add github:Britneycode/dsh-archive-vault   # 或 GitHub 源
dsh plugin --profile web remove dsh-archive-vault                   # 卸载

安装后重启 dsh web，设置页会出现「归档对话」面板。注意 --profile 要跟在 plugin 子命令之后（放在前面会被参数解析器拒绝）。

也可以直接用包管理器安装，此时需手动把 dsh-archive-vault 加进 profile package.json 的 dsh.profile.bundles 列表再重启：

pnpm add dsh-archive-vault

开发

DSH_CHECKOUT=/d/App/dsh/deepseek-harness npm run typecheck
DSH_CHECKOUT=/d/App/dsh/deepseek-harness npm run build
npm test
Back to searchOpen GitHub repository

More related plugins

View category