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：
- 点侧栏底部的 🗂 归档 按钮（带归档数量）。
- 面板按项目列出所有归档会话：
- 还原：会话回到侧栏对应项目下。
- 删除：点一下变"确认删除?"，再点一次才真正删除（永久，不可恢复）。
- 无效的归档记录：日志已不存在的残留，点删除清理记录。
- 顶部搜索框可实时过滤。
DSH ≥ 0.1.7（自带归档管理，本插件只加删除）：
- 侧栏工作区筛选 仅显示已归档（DSH 自带功能）。
- 归档会话行上任选其一发起删除：
- 行尾悬停的 🗑 按钮；
- "…" 菜单里的 删除会话…（危险红行，位于取消归档之后）。
- 弹出确认框后点 永久删除；运行中的智能体会被拦截，失败原因显示在框内；已删除但驻留内存的会话会提示重启后清除。
工作原理
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 官方产品。
