dsh-archive-manager

DeepSeek Harness 归档管理插件

_中文

---

为 DeepSeek Harness（DSH） Web UI 打造的归档管理插件：把已归档的会话重新变得可见、可管理。

归档后消失在侧栏的会话，在这里统一呈现——按项目分组、按更新时间倒序、支持搜索，并且每个归档都能一键还原或永久删除。

版本适配（自动切换，无需配置）

• DSH < 0.1.7：完整归档管理面板（侧栏底部"归档"按钮 → 分组列表 / 搜索 / 还原 / 删除）。
• DSH ≥ 0.1.7：DSH 自带归档管理（侧栏筛选"仅显示已归档"、行内取消归档），本插件只补上它缺少的删除功能——归档会话的 "…" 菜单里多一行"删除会话…"、行尾悬停多一个 🗑 按钮，点击弹出永久删除二次确认框；不再显示本插件自己的面板按钮。
• 识别方式是特性检测（0.1.7 新增的两个行操作槽位是否声明），不是版本号，因此任何中间版本都会落到正确的一侧。
• 支持 DSH 0.1.x 与 0.2.x。0.2.0 起 DSH 会校验插件声明的 @deepseek-ai/dsh* peer 版本范围，不匹配就整个 bundle 静默跳过（插件直接消失，控制台只多一行 skipping profile bundle ...）；v1.5.0 已放行 0.2.x 并同时保留 0.1.x。

功能

功能	说明
📂 按项目分组	归档会话按工作区（项目）分组，含"未分组"桶
⏱ 更新时间倒序	每个项目组内按最新更新时间从新到旧
🔍 搜索	按会话标题 / 项目名实时过滤
♻️ 还原	从归档集合移除，会话回到侧栏项目原位
🗑️ 删除	永久删除会话日志 + 移除归档记录；二次确认；运行中的智能体会拦截
🧹 无效记录清理	"日志已不存在"的残留归档记录单独分组，可一键清理
👻 已删会话提示	已删除但仍驻留内存的会话自动隐藏，提示重启后彻底清除
🌗 主题适配	全部使用 DSH 设计 token，明暗主题自动跟随
🖥 跨平台	Host 半只用 Node.js fs API，Windows / macOS / Linux 均可运行

安装

标准安装（推荐）

本插件是标准 DSH bundle：package.json 声明 dsh.bundle.patch，包内自带 cordis.patch.yml，用官方 dsh plugin 命令安装：

# 本地开发：pnpm 软链到本仓库，改代码即生效（无需重新复制）
dsh plugin --profile web add /path/to/dsh-archive-manager

# 正式发布：从 GitHub Release tarball 安装
dsh plugin --profile web add https://github.com/MoonlitDropOfBlood/dsh-archive-manager/releases/download/v1.3.0/dsh-archive-manager-1.3.0.tgz

重启 DSH 后生效：DSH < 0.1.7 会在侧栏底部（Cordis Plugin 下方、设置上方）出现"归档"按钮；DSH ≥ 0.1.7 则在归档会话行上出现删除入口（见"使用"）。

dsh plugin add 把插件装成 profile 的 npm 依赖并追加到 dsh.profile.bundles，启动时 DSH 自动应用包内的 cordis.patch.yml 挂载插件。卸载：dsh plugin --profile web remove dsh-archive-manager。

使用

DSH < 0.1.7：

1. 点侧栏底部的 🗂 归档 按钮（带归档数量）。
2. 面板按项目列出所有归档会话：
   • 还原：会话回到侧栏对应项目下。
   • 删除：点一下变"确认删除?"，再点一次才真正删除（永久，不可恢复）。
   • 无效的归档记录：日志已不存在的残留，点删除清理记录。
3. 顶部搜索框可实时过滤。

DSH ≥ 0.1.7（自带归档管理，本插件只加删除）：

1. 侧栏工作区筛选 仅显示已归档（DSH 自带功能）。
2. 归档会话行上任选其一发起删除：
   • 行尾悬停的 🗑 按钮；
   • "…" 菜单里的 删除会话…（危险红行，位于取消归档之后）。
3. 弹出确认框后点 永久删除；运行中的智能体会被拦截，失败原因显示在框内；已删除但驻留内存的会话会提示重启后清除。

工作原理

DSH Web UI
  └─ client.js (window.__ModuleLoader__.load bundle)
       └─ ctx.remote.archiveManager.{restore|delete|state}   ← Remote 调用
            └─ index.js (ArchiveManagerService, TypertRemoteService)
                 ├─ restore: workspaceRegistry.setState(移除归档) → 侧栏复原
                 ├─ delete : 拒绝 running agent → fs.rm 删日志（跨平台）→ 移除归档
                 └─ state  : 检测"live 但日志已删"的 ghost 会话

目录结构

dsh-archive-manager/
├── index.js            # Host 半：ArchiveManagerService（Remote 服务）
├── client.js           # Client 半：归档管理 UI bundle
├── typert.host.js      # Typert Host manifest（Remote 方法描述）
├── cordis.patch.yml    # dsh bundle patch（挂载行）
├── verify-*.mjs        # 四个验证脚本（构造 / typert 线上契约 / client apply / 真实安装）
├── scripts/            # check-profile-bundle.mjs：DSH 会不会跳过本插件的自检
├── .github/workflows/  # GitHub Actions 发布
├── AGENTS.md           # 面向 AI agent 的开发指南（含踩坑）
└── LICENSE             # MIT

开发

npm run check                    # node --check index.js client.js typert.host.js
npm run verify                   # 四个验证脚本：构造 / 双版本 typert 线上契约 / client apply 冒烟 / 真实 DSH 安装
node scripts/check-profile-bundle.mjs --sandbox   # 用真实 dsh-app-boot 确认本插件不会被跳过
dsh plugin --profile web add /path/to/dsh-archive-manager   # 安装/重装到本机 DSH profile

verify-typert-compat.mjs 会用真实 DSH 安装里的 validateTypertManifest 与 TypertRegistry 校验本插件的线格式（同时覆盖 0.1.5 与 0.1.7 两套规则）：默认探测本机 DSH 安装与 .tmppkg/v017/（npm 拉取的 0.1.7 包），也可用 DSH_INSTALL_015 / DSH_INSTALL_017 环境变量指定。

verify-real-install.mjs 补的是另一个洞——前三个脚本跑在仓库自带的旧版依赖上，在"根本不加载插件"的 DSH 上也会全绿。它直接拿本机 DSH 安装的 dsh-app-boot.evaluatePluginCompatibility 跑 0.2.0 的 peer 闸门、断言 0.1.5/0.1.7/当前运行时三条版本线都满足、把 index.js 重新绑定到该安装的 cordis/typert-protocol 上构造服务，并在 0.1.x 与 0.2.x 两种磁盘布局上各真删一次会话。

scripts/check-profile-bundle.mjs --sandbox 会建一个临时 profile、用软链把本工作树挂进去，再调用真实 dsh-app-boot 的 profile 加载器，直接回答"dsh 会不会跳过我"。它不碰任何 DSH home，所以随时可跑。

详见 AGENTS.md——记录了 DSH 正式插件（Host/Client/Typert 三件套）的完整机制和踩坑。

License

本项目遵循 MIT License。

本项目是基于 DeepSeek Harness 构建的社区插件，并非 DeepSeek 官方产品。