dsh-session-archive-plugin：DSH 上下文存档与历史检索插件

前言¶

DeepSeek Harness (DSH) 在处理长对话时面临上下文空间限制。默认的压缩机制会在达到阈值后清除未压缩的上下文，导致历史对话丢失。dsh-session-archive-plugin 提供了一个补充层，在压缩前自动存档会话，并在压缩后支持对历史记录的全文检索。

插件概述¶

这是一个由 honyKing 维护的 DSH 插件，类别为“记忆”。它将 session-archive 技能打包为正式的 DSH bundle 插件，安装后同时提供两个模型工具和一个打包技能，无需手动配置 ~/.agents/skills 目录。

安装与启用¶

安装后必须重启 dsh web 才能使工具生效。

# GitHub（推荐）
dsh plugin --profile web add git+https://github.com/honyKing/dsh-session-archive-plugin.git

# Gitee（国内镜像）
dsh plugin --profile web add git+https://gitee.com/xiyoudada/dsh-session-archive-plugin.git

核心功能¶

archive_session 工具¶

该工具将当前 DSH 会话的完整日志（zstd 格式）解码为可读存档。它会生成明文 jsonl 和 Markdown 摘要，保存到工作空间的 session_archives/ 目录中。

1、支持幂等操作：当新增数据不足阈值（默认 1MB）时自动跳过。
2、支持 statusOnly 参数：仅查询当前上下文占用百分比。

search_archive 工具¶

该工具对历史对话进行全文检索。

1、优先搜索 session_archives/*.md 文件。
2、未命中时自动解码最近会话的日志进行直扫。
3、支持多词 AND 逻辑、limit 限制结果数量以及 deep 参数。

技能集成¶

插件通过 skill-filesystem provider 注册了 session-archive 技能。模型在压缩后可以主动回退检索该技能，以获取历史信息。

配置与依赖¶

配置项¶

插件支持在 profile 的 cordis.patch.yml 中覆盖默认配置：

- id: session-archive
  config:
    scriptsDir: skills/session-archive/scripts
    pythonBin: python
    timeoutMs: 120000
    reArchiveGapMb: 1

环境依赖¶

1、依赖 Python 环境。
2、Node.js 版本要求为 ^22.19.0 或 >=24.0.0。
3、Peer dependencies 为 @deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery。

注意事项¶

1、安装后必须重启 dsh web。
2、插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。