dsh-echo-memory 架构与边界
September 3, 2026 · View on GitHub
核心定位
极简、纯本地、无向量、无数据库。
本插件是一个 DSH 专用跨会话记忆插件，坚持：
- 数据只落在本地
memory.json - 单表、人类可读、原子写入
- 不引入数据库、向量库、外部服务
- 不增加不必要的依赖
- 不扩大 DSH 兼容范围（当前基准：
DSH 0.1.2-rc.1）
半侧结构
- Host 半（Node）：
src/index.ts装配 MemoryService，提供 tools / HTTP routes / 召回 / AI 建议。 - Client 半（浏览器）：
src/client/index.ts注册设置卡片与全局 Dock。
存储
- 唯一存储：
$DSH_HOME/storages/memory.json - 领域版本：
v3 - 记录 schema：
src/domain.ts - 迁移：
src/migrate.ts，旧auto来源统一归一到agent，移除embedding/embeddingAt
对外接口
- Tools：
memory_save/memory_search/memory_forget/memory_restore/memory_suggest - HTTP Routes：
/api/dsh-echo-memory/* - 不提供公开 Service API（
ctx.memory不作为稳定对外契约）
禁止事项
- 禁止引入数据库客户端 / 向量库 / 外部服务依赖
- 禁止新增存储后端
- 禁止在 schema 中重新加入
embedding/ 向量字段 - 禁止扩大 DSH 兼容范围到未验证版本
- 禁止修改 DSH 源码