dsh-session-archive-plugin
Manifest validDSH Context Archiving and History Retrieval Plugin: Automatically archives the complete session before compression (zstd decoded into readable jsonl + summary), and performs full-text search of historical conversations on demand after compression. Includes built-in archive_session / search_archive tools and packaged skills, with one-click installation via `dsh plugin add`.
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-filesystemprovider 注册,模型按技能描述在压缩后主动回退检索。
与 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
Comments
Loading…
Similar plugins
by DreamStan
A DSH plugin for browsing archived sessions and safely deleting them.浏览归档会话,并安全地关闭、取消归档或删除会话。
★ 0
MIT
TypeScript
Aug 18, 2026
dsh plugin --profile web add @dsh-external/dsh-archive-sessionby keepermttl
DeepSeek Harness 归档会话管理插件:查看/恢复已归档会话(回到原工作区分组)+ 右上角一键关闭 dsh。MIT 许可,欢迎收录到任何插件合集,注明出处即可。
★ 4
MIT
TypeScript
Sep 26, 2026
dsh plugin --profile web add @dsh-external/dsh-archive-viewerby jh1016248
DSH(DeepSeek Harness)插件:会话标题栏一键导出当前会话 —— 「保存 MD」下载纯净 Markdown,「保存 HTML」下载带左侧目录、表格与代码块渲染的网页。自动过滤模型思考过程与工具调用记录,只保留用户与助手的正文,适合归档、分享与撰写报告。安装:dsh plugin --profile web add dsh-save-session
★ 0
↓ 690/wk
MIT
JavaScript
Sep 11, 2026
dsh plugin --profile web add dsh-save-sessionby chen1pengvincent
DSH (DeepSeek Harness) plugin: manage archived sessions — native unarchive, recoverable quarantine, permanent purge, search/filter/sort, retention. 归档会话管理插件。
★ 0
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-archived-managerby wall1234567
DSH 长期记忆插件:上下文超过阈值时把最早的一段对话归档到 memory/ 回忆文件夹,之后按关键词与重要度概率自动回忆。Host-only, zero-dependency memory engine for DeepSeek Harness.
★ 17
↓ 1.4k/wk
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-rofmby Momojie-S
DSH 插件: 归档会话定期清理 —— 物理归档堆与页面归档会话超保留期(页面可配天/小时,cron 调度)自动物理删除
★ 0
MIT
TypeScript
Nov 7, 2026
dsh plugin --profile web add @momojie-s/dsh-archive-retention