z953218350/dsh-archive-manager

DSH Archive Manager 插件 (Codex-style 归档管理)

中文 | English

为 DeepSeek Harness (DSH) Web 界面提供与 Codex 1:1 一致的会话归档管理功能，支持在设置页中直观查看、搜索/筛选、预览对话内容、一键取消归档以及彻底删除归档会话。

当前版本要求 DSH >=0.1.2-alpha.2，并支持通过 DSH_HOME 指定 DSH 数据目录。

🌟 核心特性

1. Codex 1:1 视觉与交互规范：
   • 卡片外观保持 DSH 官方卡片统一规范（深灰背景、12px 圆角、矢量箭头旋转动效），仅在设置 -> 插件选项中加载；
   • 展开后提供顶层搜索栏（搜索已归档聊天）、排序筛选（全部聊天 / 最早优先）与项目筛选（所有项目 / 各具体项目）。
2. 按项目分组与批量管理：
   • 会话按所属工作区/项目自动分组展示，带有项目文件夹图标及对话计数；
   • 每个项目组支持 ··· 更多操作菜单，可一键「删除项目中的全部内容」。
3. 真实内容解析、预览与还原：
   • 自动解析底层会话流，精确展示会话标题、创建时间、对话轮数与磁盘占用大小，日期格式与 Codex 一致（如 2026年8月15日, 1:34）；
   • 会话内容预览：点击「查看内容」按钮，无需恢复即可在弹窗中直接浏览该会话最近 50 条用户/助手消息记录（自动清理会话日志中的系统注入文本）；
   • 取消归档：点击「恢复会话」按钮，会话立即还原回原所属工作区列表，并通过 SSE 实时广播同步侧边栏；
   • 彻底删除：点击「物理删除」按钮彻底删除会话元数据及磁盘数据文件，释放存储空间。
4. 零外部依赖的解压引擎：
   • 内置基于 Node zlib 的 zstd 多帧解压引擎，可读取 session.jsonl.zstd 与未压缩的 session.jsonl，无需在系统中安装 zstd 命令行工具。
5. 实时双向同步（Live Sync）：
   • 卡片展开时自动监听侧边栏归档变动，在工作区侧边栏归档或恢复会话时，归档管理列表自动无感同步更新。

📦 如何安装与配置到 DSH

DSH 采用 Cordis 模块化微内核架构，你可以通过以下方式安装该插件：

环境要求

• DSH >=0.1.2-alpha.2
• Web Profile
• Node.js 内置 zlib（无需额外安装 zstd 命令行工具）

方法一：通过 NPM 线上源安装（推荐）

1. 使用 DSH 官方 CLI 命令一键安装

dsh plugin --profile web add -w @mlgbnb/dsh-archive-manager

如需固定当前版本，可执行：

dsh plugin --profile web add -w "@mlgbnb/dsh-archive-manager@1.0.10"

2. 或者在 Web Profile 目录下通过 npm/pnpm 安装

# 已设置 DSH_HOME 时
cd "$DSH_HOME/profiles/web"
# 未设置 DSH_HOME 时
cd ~/.dsh/profiles/web
npm i @mlgbnb/dsh-archive-manager
# 或使用 pnpm
pnpm add -w @mlgbnb/dsh-archive-manager

安装完成后，请确认 $DSH_HOME/profiles/web/package.json（未设置 DSH_HOME 时为 ~/.dsh/profiles/web/package.json）中的 dsh.profile.bundles 数组已包含 @mlgbnb/dsh-archive-manager：

{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {
    "@mlgbnb/dsh-archive-manager": "^1.0.10"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@mlgbnb/dsh-archive-manager"
      ]
    }
  }
}