READMESource: main@f5f13dc2
dsh-session-media
DeepSeek Harness 的会话档案层:让模型在任意新会话里,知道这个项目之前发生过什么——包括那些会话里带的图片和文档。
它解决什么
新会话默认是失忆的。这个插件补三件事:
| 能力 | 说明 |
|---|---|
| 自动记忆 | 每个工作区一份 Markdown,每轮注入系统提示。改文件下一轮就生效,不用重启 |
| 历史检索 | 跨所有会话搜你和我双方的正文、会话标题和工具调用参数(命令、路径、URL),支持多关键词 AND、时间范围与工作区过滤。返回的片段以命中处为中心 |
| 附件取出 | 按会话或按主题找历史附件,给出本地原始路径,可批量导出。主题模式列出命中会话的全部附件 |
与已有插件的关系
不是竞争品,是补位。
| 插件 | 覆盖 | 本插件 |
|---|---|---|
dsh-memory |
事实记忆(SQLite FTS5) | ❌ 不做 |
dsh-session-recall |
会话检索(官方 ctx.sessionQuery + FTS5,毫秒级) |
❌ 不追 |
| 本插件 | 附件检索 + 记忆自动注入 | ✅ 独占 |
检索引擎是本插件最弱的一环(关键词线性扫描,冷启 15 秒左右,热查约 30 ms)。如果你要的是高性能检索,装 dsh-session-recall;如果你要的是"把会话里的图捞出来",用这个。
工具
| 工具 | 作用 |
|---|---|
session_search(keyword, limit?, sinceDays?, workspace?) |
跨会话检索。空格分隔多个词表示 AND;返回 matches(命中消息数)与该会话附件清单 |
session_read(sessionId, offset?, limit?, maxChars?, around?, span?, msgChars?) |
读会话,支持分页(total/hasMore/nextOffset)与跳到命中位置(around = session_search 返回的 at,span 前后各几条)。单条消息默认截断 2000 字,around 模式默认 16000 |
session_media(sessionId?, query?, kind?, sinceDays?, limit?, extractTo?) |
列出附件;query 可按主题跨会话找("跟 BUCK 有关的图都在哪");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 拼接)。遇到未知版本会跳过并告警,但不会自动适配。 - 不处理图片内容——只给路径,理解靠模型自己看。
- 索引写入前会脱敏:疑似凭据(
sk-、ghp_、npm_、AKIA等前缀,以及token=/password:形式)会打码。但这是尽力而为,不能替代你自己确认工作区里没有敏感信息。 - 中文优先。界面文案与提示为中文。
测试
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
No comments yet. Be the first to write one.