# @chushiz/dsh-archive-manager 中文文档

规范地址：https://npmcn.com/package/%40chushiz/dsh-archive-manager/

版本：0\.11\.1
npm 元数据更新时间：2026-11-05T02:06:07.545Z
中文译文更新时间：2026-11-09T15:43:49.353Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chushiz/dsh-archive-manager
原文对照：https://npmcn.com/package/%40chushiz/dsh-archive-manager/?lang=original
项目主页：https://github.com/ChuShiZ/dsh-archive-manager#readme
源码仓库：https://github.com/ChuShiZ/dsh-archive-manager

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：611 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：^22\.19\.0 \|\| \>=24\.0\.0
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.4，@deepseek-ai/schemastery ^3\.18\.2，@deepseek-ai/dsh-client-locale ^0\.2\.0-rc\.2，@deepseek-ai/dsh-client-ui-renderer ^0\.2\.0-rc\.2，@deepseek-ai/dsh-cordis-client-runner ^0\.2\.0-rc\.2
- 首次发布：2026-08-20T12:34:59.962Z
- 最新版本发布：2026-11-05T02:06:07.109Z
- 近 30 天下载量：3669（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

DSH插件:浏览存档会话,恢复会话继续对话,硬删除会话,可选自动存档闲会. 设置在插件页面上运行 .

## 安装

```sh
npm install @chushiz/dsh-archive-manager
```

也可以使用：`pnpm add @chushiz/dsh-archive-manager`、`yarn add @chushiz/dsh-archive-manager`、`bun add @chushiz/dsh-archive-manager`

## README

# dsh-archive-manager

[English](https://npmcn.com/package/%40chushiz/dsh-archive-manager/README.en.md) · **中文**

[![npm package](https://img.shields.io/npm/v/@chushiz/dsh-archive-manager.svg?label=npm)](https://www.npmjs.com/package/@chushiz/dsh-archive-manager) [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://npmcn.com/package/%40chushiz/dsh-archive-manager/LICENSE)

DSH 的「归档」只能把会话藏起来，没法取消。这个插件在 **设置 > 归档会话** 里补齐浏览、搜索、恢复和删除，还能自动归档不再用的旧会话。

## 功能

-   **浏览** —— 按项目分组列出已归档会话，分组可折叠；列表打开很快，不会等每个会话日志加载完。
-   **搜索** —— 搜聊天内容、标题、目录；命中处高亮，可按用户消息 / AI 回复 / 工具调用筛选。
-   **预览** —— 点标题展开最近几条用户 / AI 消息，不用恢复就能判断是不是要找的会话。
-   **恢复并打开** —— 取消归档并打开，看历史、接着聊。
-   **批量删除** —— 勾选多个一起删。删除会真正移除会话，**不可逆**。
-   **自动归档** —— 按闲置天数或每个项目保留的数量，自动把旧会话收进归档。置顶和正在使用的会话不会被归档；刚恢复的会话也有一段时间不会被再次归档。
-   **在插件页直接配置** —— 打开 **插件 → dsh-archive-manager** 就能改自动归档设置，保存后立即生效，不用编辑配置文件。

![搜索：类型筛选 + 关键词高亮](https://npmcn.com/package/%40chushiz/dsh-archive-manager/assets/screenshots/search-highlight.png)

![预览：点击标题展开最近 4 条用户 / AI 消息](https://npmcn.com/package/%40chushiz/dsh-archive-manager/assets/screenshots/preview-dialog.png)

## 安装

在 DSH 的插件市场搜索 **dsh-archive-manager** 安装，或在命令行执行：

```sh
dsh plugin --profile web add @chushiz/dsh-archive-manager
```

安装后刷新页面；如果没出现，重启一次 DSH。

## 使用

打开 **设置 > 归档会话**：可以浏览、搜索、预览、恢复或删除归档会话。

## 自动归档

打开 **插件 → dsh-archive-manager**，在「归档管理配置」里打开「启用自动归档」即可。默认关闭。

可以设置：

| 设置 | 默认 | 说明 |
| --- | --- | --- |
| 闲置天数 | 5 天 | 超过这么多天没用过的会话自动归档；填 0 表示不按时间归档 |
| 每个项目保留 | 0 | 每个项目最多保留多少个未归档会话，超出的归档最旧的；填 0 表示不限制 |
| 保护期（天） | 1 天 | 最近这段时间用过的会话不会被归档 |
| 扫描间隔（分钟） | 60 | 多久检查一次 |
| 启动后首次延迟（毫秒） | 60000 | 启动后多久开始第一次检查 |

满足上面任一条件就会归档，随时可以在 **设置 > 归档会话** 里恢复。不想等定时检查时，可以点「立即扫描」手动执行一次（会先确认）。

## 兼容性

| DSH 版本 | 状态 |
| --- | --- |
| 0.2.2-rc.1 | ✅ 本机实测 |
| 0.2.1-rc.5 | ✅ 实测过 |
| 0.2.1-rc.3 | ✅ 实测过 |
| 0.2.0-rc.2 | ✅ 实测过 |
| 其他 0.2.x | 大致可用，建议用上面的版本 |

## License

MIT

## 常见问题

### @chushiz/dsh-archive-manager 是什么？

DSH插件:浏览存档会话,恢复会话继续对话,硬删除会话,可选自动存档闲会\. 设置在插件页面上运行 \.

### 如何安装 @chushiz/dsh-archive-manager？

在项目目录运行 npm install @chushiz/dsh-archive-manager，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.4）、@deepseek-ai/schemastery（^3\.18\.2）、@deepseek-ai/dsh-client-locale（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-client-ui-renderer（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-cordis-client-runner（^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @chushiz/dsh-archive-manager 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chushiz\_\_dsh-archive-manager 是否存在。

### @chushiz/dsh-archive-manager 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chushiz/dsh-archive-manager 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.19\.0 \|\| \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chushiz/dsh-archive-manager 可以商用吗？

@chushiz/dsh-archive-manager 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chushiz/dsh-archive-manager 的下载量有多少？

根据 npm 官方下载统计，@chushiz/dsh-archive-manager 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,669 次，日均约 122 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chushiz/dsh-archive-manager 还在维护吗？

最新版本 0\.11\.1 发布于 2026/11/05（4 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/08/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。