Repository navigation
Releases
Releases · areCodeOI/dsh-hippocampus-memory
v0.7.0 — 记忆中枢:本地自主决策 + WebUI 实时开关
0.7.0 — 2026-11-14
Added
- 记忆中枢(默认关闭,
memoryHub: true开启):纯本地、确定性、零外置 LLM 的决策层,
自主决定「该记什么 / 怎么记 / 什么时候读」。核心在lib/memory-hub.js,执行层在
lib/hub-runner.js,接口契约见docs/HUB-API.md,使用说明见docs/MEMORY-HUB.md。 - 12 个上下文信号 + 读写双阈值:
hubReadThreshold(默认 0.34)控制何时检索,
hubWriteThreshold(默认 0.55)控制是否写入;寒暄/命令/纯代码/PII/猜测/问句自动跳过。 - 自动分层:候选按健康禁忌、稳定偏好、显式约定、项目事实、带结果事件分入
persona / semantic / episodic / buffer四层并自动分配 importance / confidence。 - 自主生效:用户亲口说出且
confidence≥0.85的persona/semantic事实由中枢
自主批准(review: 'approved')并可在下一轮被召回;较弱或机器来源候选仍进审阅队列。
可用hubAutoApprove: false关闭该行为。 - WebUI 实时开关(免重启、免改文件):设置页新增「记忆中枢」卡片,
可开关中枢、自动写入、自主批准,并调读/写阈值、每轮上限、召回条数与空间;
保存写入数据库 metamemory_hub_settings,下一轮对话立即生效。
新增GET/PATCH /api/hub/settings(admin)。 - 设置优先级:数据库已保存值 > DSH 启动配置 >
HUB_DEFAULTS。
lib/index.js的 pre-step 每轮读取实时设置,因此界面改动无需重启。 - 新配置项:
memoryHub、hubReadThreshold、hubWriteThreshold、hubCapture、
hubAutoApprove、hubCaptureMaxPerTurn、hubRecallLimit、hubRecallMaxChars、
hubRecallMinScore、hubNamespace;cordis.patch.yml与docs/CONFIG.md同步。
DSH 设置页可直接编辑这些字段(作为启动默认值)。 - 中枢开启时向系统提示词追加一段「记忆中枢」说明;工具清单保持不变(仍为 10 个)。
writeCandidates新增可选decorate(candidate)钩子并导出;默认行为完全不变。- 新增
test/memory-hub.test.mjs(纯决策单测)与test/hub-runner.test.mjs(读写集成测试),
并注册进test/all.test.mjs。
Notes
- 中枢路径不读取
autoCaptureLlm*配置,不发起任何 HTTP 请求;旧 LLM 抽取选项保留为兼容。 - 自动捕获候选继续进入审阅队列(
review: 'pending'),批准前不参与自动召回。 - 数据库 schema 不变;中枢写入沿用既有 store 查重、冲突检测与跨进程
leases锁。
安装
npm i dsh-hippocampus-memory@0.7.0或作为 DSH bundle 安装:
plugin_manager(action="install_bundle", target="<绝对路径>/dsh-hippocampus-memory")
记忆中枢默认关闭,在 WebUI「设置 → 记忆中枢」一键开启(保存即生效,无需重启),
或 DSH 插件设置里打开 memoryHub。
文档:MEMORY-HUB.md ·
HUB-API.md ·
CONFIG.md
v0.6.1 — npm packaging fix
海马体长期记忆 v0.6.1
npm 发布
- 已发布到 npm:
dsh-hippocampus-memory@0.6.1 - 修复 npm 11 对
bin路径的规范化问题,CLI 入口正确安装:
hippocampus/hippocampus-mcp/hippocampus-http - 包内容 87 files / 696.6 kB;包含 WebUI 构建产物、文档和 dsh-go 界面。
验证
- 单元/集成:115/115。
- smoke:104/104。
- link 安装通过。
- WebUI Vitest:2/2;Playwright E2E:通过。
- GitHub Actions main/tag:11/11 jobs 成功(含真实 PostgreSQL)。
安装
npm install dsh-hippocampus-memory完整变更见 CHANGELOG.md。
v0.6.0 — LLM capture, review queue and live settings
海马体长期记忆 v0.6.0
自动记忆:从 lite 到可审阅
- 可选 LLM 抽取:
autoCaptureLlm+ OpenAI 兼容 endpoint/model;超时/失败自动回退本地规则。LLM 只接收用户消息,不发送整段对话。 - 助手/工具捕获:
autoCaptureAssistant/autoCaptureToolResults提取明确的助手结论和工具成功/失败行。 - 待审阅队列:候选以
episodic、confirmed:false、review:'pending'写入,未批准前不参与自动召回;WebUI「捕获审阅」可批准为语义/人格/情景,或忽略归档。 - WebUI 实时设置:开关、目标空间、每条上限、助手/工具捕获均可在线修改并持久化到 DB,无需重启。
- LLM 安全:API key 建议用
HIPPOCAMPUS_LLM_API_KEY;LLM 输出经过 JSON/内容/敏感词校验;不信任消息内指令。 - 更强 DLP:手机号、邮箱、身份证/护照、银行卡、住址等 PII 整条跳过。
- 多实例去重:捕获写入使用跨进程 lease,并发时只允许一个实例写入。
验收
- 单元/集成:115/115。
- smoke:104/104。
- link 安装通过。
- WebUI Vitest:2/2;Playwright E2E:通过。
- GitHub Actions main/tag:11/11 jobs 成功(含真实 PostgreSQL)。
完整变更见 CHANGELOG.md。
v0.5.1 — auto-capture polish and tag review
海马体长期记忆 v0.5.1
自动捕获打磨
- 只捕获真实用户消息:跳过 DSH 注入的 user-role 上下文(system-reminder 等),避免把框架内容写成记忆。
- 中文问句过滤增强:无问号但含“什么/怎么/为什么/如何/哪/谁/是否/能不能/多少”或句末“吗/呢”的内容不再捕获(除非含“记住/以后/不要”等明确指令)。
- 记忆库新增标签筛选,支持
auto-capture候选审阅;GET /api/memories?tags=...同步支持。 - 多个标签按 OR 匹配;自动捕获标签与人格候选标签可组合筛选。
- 新增来源过滤、问句过滤、命名空间写入与标签筛选回归测试。
验证
- 单元/集成:112/112。
- smoke:104/104。
- link 安装通过。
- WebUI Vitest:1/1;Playwright E2E:1/1。
- GitHub Actions 主分支与 tag 均 11/11 jobs 成功(含真实 PostgreSQL)。
完整变更见 CHANGELOG.md。
v0.5.0 — opt-in auto-capture
海马体长期记忆 v0.5.0
新增:opt-in 自动捕获
autoCapture: true时,在 DSHagent/pre-step用本地确定性规则从最新用户消息抽取少量明确事实。- 不调用模型、不保存整段对话;每条消息最多
autoCaptureMaxPerTurn条。 - 写入
episodic、confirmed:false,标签auto-capture;可按标签审阅、提升或删除。 - 跳过 slash 命令、代码块、问句和含密码/token/身份证/银行卡等敏感词的整条消息。
- 遵守 namespace 只读/归档策略;不自动写
persona。 - 新增
autoCaptureNamespace配置;默认关闭,开启前建议先观察捕获质量。 memory_stats与 WebUI 总览增加自动捕获计数。
其他
- DSH pre-step 合并为单监听器,自动召回/自动捕获可独立开关。
- 版本 0.5.0;WebUI 资产重建。
验证
- 单元/集成:112/112。
- 运行时 smoke:104/104。
- link 安装通过。
- WebUI Vitest:1/1;Playwright E2E:1/1。
- GitHub Actions:Linux/Windows/macOS × Node 22/24、真实 PostgreSQL、Webapp、E2E 全部通过。
完整变更见 CHANGELOG.md。
v0.4.0 — namespace v4, backups, async jobs
海马体长期记忆 v0.4.0
新增
- namespace v4 元数据与轻量策略:描述/颜色/只读/归档/保留天数/按空间自动召回;旧库从
meta.namespace_registry自动迁移。 - 逻辑备份/恢复:JSON 快照、原子写入、权限 600、保留份数;WebUI、CLI、HTTP 全入口。
- 危险空间操作自动备份;恢复默认 dry-run,执行前再备份当前状态。
- 异步 namespace rename/merge/delete job:进度、取消、事务回滚。
- 只读
memory_namespaceAI 工具(记忆工具 8 → 9)。 - 按空间自动召回开关。
安全与可靠性
- 备份/恢复仅限带
*白名单的 admin;受限 key 一律 403。 - 快照移入写事务并在事务内复核源/目标,避免备份后写入竞态。
- 恢复拒绝损坏/过新/非普通文件/符号链接备份;有 queued/running 任务时拒绝。
- 只读空间不再通过读取待删除记忆触发自动恢复。
- 删除 namespace 会同步回收 API key 的空间白名单。
验证
- GitHub Actions main CI:11/11 jobs 成功(Linux/Windows/macOS × Node 22/24、link、smoke、真实 PostgreSQL、Webapp、Playwright)。
- PostgreSQL 集成:6 项检查通过(create/write、read-only、backup/restore、rename/merge、delete、v3→v4 迁移)。
- 本地:107/107 单元集成、104/104 smoke、link 安装、Vitest、Playwright E2E。
升级
- 直接升级到 0.4.0;旧数据库首次启动自动迁移到 schemaVersion 4。
- 生产恢复前请先停止写入并等待/取消后台任务;备份文件含记忆明文,注意磁盘权限。
- 完整变更见 CHANGELOG.md。