dsh-session-media
ok541151/dsh-session-media
Session-archive layer for DSH. It injects one per-workspace Markdown file into the system prompt on every turn, searches past session transcripts with AND keywords, an optional time window and a workspace filter, and recovers the images and documents those past sessions carried by returning their original local paths or copying them to a chosen directory. It also reports index health: version, entry count, cache usage, frequent sessions and sessions stored in an archive format it does not recognise. Keyword search only, no embedding service.
설치
dsh plugin --profile web add github:ok541151/dsh-session-mediaREADME
dsh-session-media
DeepSeek Harness 的会话档案层：让模型在任意新会话里，知道这个项目之前发生过什么——包括那些会话里带的图片和文档。
它解决什么
新会话默认是失忆的。这个插件补三件事：
| 能力 | 说明 |
|---|---|
| 自动记忆 | 每个工作区一份 Markdown，每轮注入系统提示。改文件下一轮就生效，不用重启 |
| 历史检索 | 跨所有会话搜你和我双方说过的话，支持多关键词 AND 与时间范围 |
| 附件取出 | 列出某个会话里的图片/文档，给出本地原始路径，可批量导出 |
与已有插件的关系
不是竞争品，是补位。
| 插件 | 覆盖 | 本插件 |
|---|---|---|
dsh-memory | 事实记忆（SQLite FTS5） | ❌ 不做 |
dsh-session-recall | 会话检索（官方 ctx.sessionQuery + FTS5，毫秒级） | ❌ 不追 |
| 本插件 | 附件检索 + 记忆自动注入 | ✅ 独占 |
检索引擎是本插件最弱的一环（关键词线性扫描，冷启约 12 秒）。如果你要的是高性能检索，装 dsh-session-recall；如果你要的是"把会话里的图捞出来"，用这个。
工具
| 工具 | 作用 |
|---|---|
session_search(keyword, limit?, sinceDays?) | 跨会话检索。空格分隔多个词表示 AND |
session_read(sessionId, maxChars?) | 读某会话全文 |
session_media(sessionId?, kind?, sinceDays?, limit?, extractTo?) | 列出附件；extractTo 可复制原始文件到目录 |
memory_doctor(top?, fix?) | 体检：索引版本/条数/体积/高频会话/附件统计/告警；fix 可清理并重建 |
外加一个系统提示段 plugin:memory（order 210）。
安装
本插件没有走市场，手工接入（与 dsh-agent-picker 同法）：
- 放进任意目录，例如
C:\AgentTools\plugins\dsh-session-media - 在
profiles/web/package.json的dependencies加"dsh-session-media": "file:C:/AgentTools/plugins/dsh-session-media" - 同一个文件的
dsh.profile.bundles末尾加"dsh-session-media" - 在
profiles/web下跑pnpm install - 重启 DSH Desktop
file:依赖是拷贝不是软链：改完源码要重新 install，或直接覆盖profiles/web/node_modules/<包名>/index.js。 HMR 不换已加载模块，改代码必须重启。
配置
全部可选，默认零配置可用。
| 键 | 默认 | 含义 |
|---|---|---|
memoryDir | 自动探测 | 记忆文件所在目录 |
files | [] | 显式指定记忆文件；空则用 candidateFiles |
candidateFiles | ['环境笔记.md','MEMORY.md','CLAUDE.md'] | 依次尝试 |
order | 210 | 提示段顺序 |
maxChars | 12000 | 注入上限，超出按「保头 60% + 保尾 40%」截断 |
cacheMaxEntries | 5000 | 索引缓存条数上限 |
cacheMaxChars | 50000000 | 索引缓存字符上限 |
evictMinAgeDays | 90 | 淘汰起始年龄门槛 |
evictFloorDays | 14 | 门槛下限（降到这还无解就不淘汰） |
saveIntervalMs | 60000 | 索引落盘节流 |
限制（请先读这段）
- 只用关键词检索，没有语义/向量能力。
- 依赖会话存档格式（
session.v3/v4.jsonl.zstd，多帧 zstd 拼接）。遇到未知版本会跳过并告警，但不会自动适配。 - 不处理图片内容——只给路径，理解靠模型自己看。
- 不做脱敏。索引里存的是会话原文，请自行确认工作区里没有敏感信息。
- 中文优先。界面文案与提示为中文。
测试
node cismoke.mjs # CI 冒烟：不依赖真实会话，8 项
node selftest.mjs # 本机完整：17 项，含淘汰策略与媒体路径校验
node selftest.mjs --no-evict # 跳过会临时改写索引的淘汰用例
selftest.mjs 需要本机已有会话存档，适合开发时跑；cismoke.mjs 适合 CI。
发布说明
npm 上 dsh-memory 与 dsh-session-recall 都已被占用。公开发布请改名为 dsh-session-media（已确认可用），需同步修改三处：
package.json的namecordis.patch.yml的id/nameprofiles/web/package.json的依赖键与dsh.profile.bundles
许可
MIT