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

中文 | English

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

🌟 核心特性

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 模块化微内核架构，你可以通过以下方式安装该插件：

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

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

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

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

cd ~/.dsh/profiles/web
npm i @mlgbnb/dsh-archive-manager
# 或使用 pnpm
pnpm add -w @mlgbnb/dsh-archive-manager

安装完成后，请确认 ~/.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.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@mlgbnb/dsh-archive-manager"
      ]
    }
  }
}

方法二：通过本地源码目录（Link 方式）安装

如果你在本地开发该插件，可以使用本地链接方式安装：

# 将本地插件目录以 link 方式添加至 web profile 的依赖中
dsh plugin --profile web add -w "link:/path/to/dsh/plugin/dsh-archive-manager"

注意：如果执行 add 后启动报错提示子包重复声明，请检查 ~/.dsh/profiles/web/package.json 中的 dsh.profile.bundles 数组，确保其中仅包含根包（如 @mlgbnb/dsh-archive-manager、@linxin666/dsh-web-ui-all 等），避免包含子组件包。

🚀 启动与体验

启动 DSH Web 服务：

dsh --profile web
# 或者
dsh web

打开浏览器访问 http://127.0.0.1:3080/，点击侧边栏底部的齿轮图标进入设置 -> 插件，即可看到「归档管理」卡片。

📂 项目结构

dsh-archive-manager/
├── cordis.patch.yml   # Cordis 插件 Profile 声明补丁
├── package.json       # 模块清单与依赖声明
├── README.md          # 中文说明文档
├── README.en.md       # English documentation
├── docs/
│   └── images/        # 说明文档截图与预览图
├── lib/
│   ├── index.js       # Host 端（提供 /api/dsh-archive-manager/* 接口与 workspaceRegistry 交互）
│   └── client.js      # Client 端（Codex 风格卡片交互、项目分组、搜索筛选、预览弹窗、删除与还原逻辑）
└── src/
    └── index.ts       # TypeScript 伴生源文件（类型声明与 Host 入口说明）