MoonlitDropOfBlood/dsh-archive-manager

DeepSeek Harness 归档管理插件

中文

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

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

功能

| 功能 | 说明 |
|---|---|
| 📂 按项目分组 | 归档会话按工作区（项目）分组，含"未分组"桶 |
| ⏱ 更新时间倒序 | 每个项目组内按最新更新时间从新到旧 |
| 🔍 搜索 | 按会话标题 / 项目名实时过滤 |
| ♻️ 还原 | 从归档集合移除，会话回到侧栏项目原位 |
| 🗑️ 删除 | 永久删除会话日志 + 移除归档记录；二次确认；运行中的智能体会拦截 |
| 🧹 无效记录清理 | "日志已不存在"的残留归档记录单独分组，可一键清理 |
| 👻 已删会话提示 | 已删除但仍驻留内存的会话自动隐藏，提示重启后彻底清除 |
| 🌗 主题适配 | 全部使用 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 后，侧栏底部（Cordis Plugin 下方、设置上方）会出现"归档"按钮。

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

使用

1. 点侧栏底部的 🗂 归档 按钮（带归档数量）。
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（挂载行）
├── .github/workflows/  # GitHub Actions 发布
├── AGENTS.md           # 面向 AI agent 的开发指南（含踩坑）
└── LICENSE             # MIT

开发

npm run check                    # node --check index.js client.js typert.host.js
dsh plugin --profile web add /path/to/dsh-archive-manager   # 安装/重装到本机 DSH profile

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

许可证

本项目遵循 MIT License。

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