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
