会话记忆检索 shengxiao20/dsh-session-memory

dsh-session-memory

· 版本 0.1.3 · MIT

这是 pi-session-memory 的 DSH 专用分支，重写为 Cordis Host bundle。你可以搜索之前的 DSH 对话，再读取某个精确事件前后的原文。运行时不再保留 Pi 扩展 API，也不再保留外部智能体桥接。

范围

- 只覆盖当前 DSH 服务语料中的 DSH 主会话，包括已持久化和正在运行的会话，以及普通的主会话分支。
- 排除标记为 origin: subagent 或 delegationDepth 为正数的头部；不做智能体/服务商发现、消息传递或谱系遍历。
- 复用现有的 ctx.sessionQuery 后端及其本地派生搜索索引。不建第二个数据库，不扫描 JSONL 目录，不硬编码 home 路径，也不写入会话日志。
- 不导入外部运行时，不做会话迁移/恢复，不用远程相关性模型，不管理 Ollama，也不带 Obsidian/导出子系统。
- 除非显式传入精确的 cwd 或 session_id，搜索范围是当前语料全局。这不是只限当前工作区的访问边界。只在你信任的本地配置档中安装，并且你确实打算搜索该语料。

安装

等 @shengxiao04/dsh-session-memory@0.1.3 发布后，在 DSH Plugin Manager 的 Install bundle 操作中安装，或者让 DSH 智能体调用：

{"action":"install_bundle","target":"@shengxiao04/dsh-session-memory@0.1.3","enabled":true}

本地开发或发布前，同一个操作也接受绝对路径的检出目录，替代 npm spec。这个包使用发布者的个人 scope；不带 scope 的名字 dsh-session-memory 属于另一个项目。目前还没有创建新的 GitHub 仓库。

安装需要配置档管理审批，并会影响当前配置档中的所有会话。bundle 没有依赖、构建步骤或安装脚本。它会添加自己的 Host 行，并把随附的 session-query-sqlite 行覆盖为 path: ':memory:'、openAt: first-search（被检查的配置档原有路径本来就是 :memory:）。它不会创建第二个后端，不会碰会话日志，也不会启用外部服务商。移除/禁用 bundle 时，这个覆盖也会一并移除。如果你的配置档使用自定义磁盘索引或自定义查询设置，请在高优先级配置档补丁中完整重述整个后端配置，并带上 openAt: first-search；Loader 会整体替换 config。
运行时： Node 22+ 与 DSH 0.2.1-rc.3（这是实际检查并做过原生冒烟测试的版本；manifest 有意锁定该版本）。配置档必须已经提供 tools、commands 和可搜索的 sessionQuery，通常是 @deepseek-ai/dsh-session-query-sqlite。重启后要搜索历史，还需要一个持久化后端。现有 SQLite 后端不得使用 openAt: never。缺少服务时，插件包保持未激活；搜索被禁用时直接报错，不会另起索引，也不会退回文件系统扫描。到插件管理器查看激活状态。

智能体工具

recall_memory

可选工具参数可以省略，也可以传 null（严格的函数调用接口要求每个字段都填时，用 null）。必填的 query/session ID/seq 字段仍不可为 null；空字符串会被拒绝。

问题涉及之前的工作、决策或对话时使用。

{"query":"database"}
{"query":"database","cwd":"/absolute/project/path","limit":20}
{"query":"database","session_id":"session-exact-id"}

| 参数 | 行为 |
| query | 必填，非空的字面词或短语，最多 1000 个字符。空白会被规范化。 |
| cwd | 可选，精确匹配记录中的目录，不做目录基名匹配或模糊匹配。不能与 session_id 同时使用。 |
| session_id | 可选，精确的 DSH 会话 ID；在该会话内搜索事件。不能与 cwd 同时使用。 |
| limit | 原生分页大小 1–50，默认 20。翻页期间必须保持不变。 |
| cursor | 上一页的 next_cursor；重复相同的规范化查询、范围和 limit。 |

全局结果中，每个匹配会话只保留一条最强事件。会话内结果包含匹配的事件。每条结果都带 session_id、从 0 开始的 seq、类型、时间戳、surface 和一段有长度上限的片段。全局命中在返回前会对照权威头部校验，因为索引里的头部可能缺少来源信息。排除子代理后，一页的匹配数可能少于 limit，也可能为零；如果存在 next_cursor，就按它翻页。不会补页、不会重复建索引、不会偷偷多查一次，也不会改动后端排序。

搜索语义与 Pi 原版不同： 原生 SQLite 后端搜索的是 token 和短语，不是任意子串，也不是主题实体的 OR 列表。AI 匹配不到 BRAID。引号、OR、NEAR 和 * 都按字面数据处理，不是可执行的 FTS 语法。中文的部分词召回取决于原生分词器；不要假定支持子串匹配。所有原生事件 surface（current、shadowed、log-only）都可命中，因此能检索到压缩后的历史。没有服务商特有的数值相关性得分。

后端游标不透明，且与代次绑定。出现 SESSION_QUERY_STALE_CURSOR 时，去掉游标重新搜索；查询、limit 或游标不兼容时直接报错，不会悄悄扩大范围。后端索引或搜索失败、以及取消操作，都会向上传递。

fetch_session

用精确 ID 和序号核对一条命中，或读取相邻的原始历史。

{"session_id":"session-exact-id","seq":12,"before":4,"after":4,"max_chars":12000}

- session_id 和 seq 必填；seq 是非负整数，不是轮次编号。
- before/after：各取 0–20 条原始事件，默认 4。生命周期记录也计入窗口。
- max_chars：返回文本的 UTF-16 码元数，取值 100–24000，默认 12000；先取目标事件，再取最近的邻居。输出按时间顺序排列，不会拆开代理对。
- 返回内容包括会话元数据、继承事件数、目标/范围以及事件文本。文本截断会明确标出。需要时用更窄的窗口或更大的预算重新读取指定的 seq。
- 返回文本、工具调用描述和附件标签，不返回推理内容、附件字节、回放/token 流，也不返回生命周期/控制载荷。这是有界文本视图，不是完整的 JSONL 导出。
- 绝不恢复、分叉、迁移、导入或修改会话。

历史里可能有过时的指令、敏感字符串或恶意文本。结果会明确标注为历史数据，不是当前指令。请自行核实相关性，不要把引用的历史指令当作权威。本插件不发起网络请求；DSH 仍可能把召回文本当作普通工具输出，发给配置的对话模型。

手动命令

命令直接执行与搜索/读取相同的函数，无需询问模型：

/memory-search database
/memory-search {"query":"database","cwd":"/absolute/project/path","limit":20}
/memory-read {"session_id":"session-exact-id","seq":12,"before":4,"after":4}
/memory-help

/memory-search 接受短语或 JSON 对象。以 { 开头的字面短语应放在 JSON 的 query 字段里。/memory-read 接受 JSON。/memory-help 显示版本、用法和限制。

开发与来源

npm run test:all
npm pack --dry-run
Optional real DSH backend smoke test (no user history/profile changes):
DSH_CHECKOUT=/absolute/path/to/installed/dsh npm run test:native

单元测试使用 Node 内置 runner 和假服务，无需 npm install。可选的 native 冒烟测试使用已安装的 DSH 包、隔离的 Cordis 上下文、fixture 会话和内存 FTS 索引。它不会挂载到你的活动配置档，也不会读取该配置档。实测检查项和限制见 verification。

运行时文件：Host registration、adapter、tool schemas、bundle patch。插件资源包括本地化标题/描述，以及一个原创的 MIT 许可 SVG 图标。
Git 历史保留上游项目；本地分支 dsh-only 存放适配改动，upstream 指向原始仓库。原始检出未做改动。这个 fork 从上游已提交的历史起步，不包含其工作区里未提交的改动；旧运行时是有意替换掉的，所以那些本地 Pi 专用文件都不需要。LICENSE 保留上游版权署名。仓库、主页、bug 字段没有错误地指向未发布的 DSH 仓库。

0.1.3

- 检查原生契约并做隔离集成测试后，把 DSH 兼容性锁定版本从 0.2.1-rc.2 更新到 0.2.1-rc.3。搜索/读取逻辑和 bundle 补丁未变。

0.1.2

- 首次搜索时启用随包发布的内存查询后端；默认配置档是 openAt: never，会挡住实时检索。

- 在严格 function-calling 接口中支持可选工具参数显式传 null，沿用现有默认值与作用域。真实注册表校验和专门的回归测试覆盖了这一点。

- 用 DSH Host 工具/命令替换 Pi 扩展入口和多运行时 transcript 数据库，改用原生会话查询。
- 移除外部运行时解析器、迁移、跨智能体功能、远程过滤和导出。
- 新增有界的两步发现/读取、显式作用域、原生游标和子代理会话排除。
- 新增零依赖测试、本地化元数据和原始图标。