dsh-session-archive-plugin

DSH 插件：上下文存档 + 历史检索。把 session-archive 技能打包成正式 DSH bundle 插件——安装插件即同时获得两个模型工具和打包技能，无需手动配置 ~/.agents/skills。

功能

• archive_session：把当前 DSH 会话的完整日志（~/.dsh/sessions/**/session.jsonl.zstd，多帧 zstd）解码为可读存档：明文 jsonl + Markdown 摘要，保存到工作空间 session_archives/；幂等（新增不足阈值自动跳过）；statusOnly 可只查上下文占用百分比。
• search_archive：历史全文检索——先搜各工作空间 session_archives/*.md，无命中自动解码最近会话日志直扫（DSH 日志永不清除，历史一定找得到）。多词 AND、limit、deep 参数。
• 打包技能：skills/session-archive 通过 skill-filesystem provider 注册，模型按技能描述在压缩后主动回退检索。

与 DSH 原生机制的关系

DSH 的 compaction-basic（liangshen preset）已原生实现 1M 上下文 80% 自动压缩（thresholdRatio: 0.8），无需配置。本插件补上"可读存档 + 事后检索"层，压缩前后信息永不丢失。

安装

一键安装

# 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

# npm（发布后可用）
dsh plugin --profile web add dsh-session-archive-plugin

注意：github: / gitee: 简写不被 pnpm 支持，必须用完整的 git+https://... URL。

其他方式

# 本地目录（开发）
dsh plugin --profile web add E:/path/to/dsh-session-archive-plugin

# 打包安装（.tgz）
pnpm pack
dsh plugin --profile web add ./dsh-session-archive-plugin-<version>.tgz

安装后重启 dsh web，模型即可调用 archive_session / search_archive，技能同时进入会话技能目录。

配置

插件行 config 支持（schemastery schema，src/config.ts）：

键	默认	说明
scriptsDir	打包内 skills/session-archive/scripts	脚本目录覆盖
pythonBin	python	Python 可执行名
timeoutMs	120000	单次脚本调用超时
reArchiveGapMb	1	距上次存档新增阈值（MB，幂等）

在 profile 的 cordis.patch.yml 中覆盖：

- id: session-archive
  config:
    pythonBin: py
    timeoutMs: 60000

开发

node scripts/link-deps.mjs   # 开发期类型链接（@deepseek-ai/* → profile 共享 node_modules）
npm run build                # tsc → lib/（含 .d.ts）
npm run pack                 # build + pnpm pack
python -m unittest skills/session-archive/scripts/test_session_archive.py -v   # 技能脚本冒烟测试

@deepseek-ai/* 为 optional peer 依赖，运行时从 DSH profile 的共享 node_modules 解析，不重复安装。

结构

src/index.ts        host 插件（Config + 工具注册）
src/config.ts       schemastery 配置 schema
scripts/link-deps.mjs  开发期类型链接脚本
skills/session-archive/   打包技能（SKILL.md + Python 脚本 + 冒烟测试）
lib/                构建产物（已入库，git 安装无需构建）
cordis.patch.yml    bundle 补丁（host 行 + skill-filesystem 行）
examples/           配置示例
docs/architecture.md    架构说明

lib/ 提交进仓库：dsh plugin add <git-url> 安装后开箱即用，无需在目标机器上构建。 完整开发与发布规范见 CONTRIBUTING.md。

许可

MIT