概览
dsh-memory-refine
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **命令通道是兜底,不是主路。** 面板默认走插件自己的本地 HTTP 路由(`POST /memory-refine/ui`),**不经过命令总线**,所以正常使用时对话视图里不会出现 `memory-refine · {...}` 记录。只有在路由不可用时才回退到 `/memory-refine` 斜杠命令,留下一对 `command/run` / `command/done` —— 这时面板顶部会挂一条红色警告,告诉你发生了降级。这组事件**不进模型历史、不烧 token、不污染取料素材**。 - 面板在「一个会话都没打开过」时无法确定会话 id,会提示先打开一个会话。 - **`memory_history` 的耗时只有一次实测,不是基准。** 本机冷扫 29 场 / 2967 条索引 / 2557ms(2026-10-27,一次观测)。分词 + 倒排 + 打分在 62 万字规模是 0.1 秒量级(CPU 侧微基准),瓶颈在 `readSurface` 背后的全量读盘 + 回放校验,而那条路径在插件进程外没有入口、测不了。所以工具描述里不承诺任何耗时,返回里的 `elapsed_ms` 才是每次自己的实测值;同一份 README 也不写「1 秒内」这种话。 - **`memory_history` 看不到被压缩掉的历史。** 这是设计如此,不是缺陷:它只读当前表层。要旧原文得走宿主的 `readEvent`。也因此它说「没搜到」比记忆文件说「没记过」更弱 —— 别把它的沉默当成「没聊过」。 - **注入事件在两条路上都会被检查,但计数没去重。** `user/message` 与 `agent/inbox/spliced` 的 `inserted[]` 各查一次。2026-10-27 实测 497/497 条 `inserted` 都带 source、且没有注入 kind,所以统计是对的;**若宿主将来把注入事件放进 `inserted`,会出现重复计数**。 - **`goal` / `tool-goal` 进不进,取决于用途。** 取素材时保留(要知道这场在忙什么),查原话时排除(那是宿主替用户写的,不是用户的话)。所以对同一段会话,两个工具看到的"用户消息"条数本来就可以不同,这不是计数错。整条保留意味着素材里会出现宿主口吻的段落,是已知代价。 - **陌生来源只留痕,不拦。** 名单外的 `kind` 一律放行,名字记进统计的 `unknownKinds`。宿主将来新增注入类时,第一次会漏进来——那行统计是唯一的预警,看到陌生名字就把它加进名单。 - 只在 **Windows** 上验证过。
