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 進程的權限運行，安裝前應檢查源碼與許可證。