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 三件套）的完整机制和踩坑。

License

本项目遵循 MIT License。

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