Skip to content

Releases

v0.7.0 — 记忆中枢:本地自主决策 + WebUI 实时开关

Choose a tag to compare

@areCodeOI areCodeOI released this 16 Nov 18:47

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 实时开关(免重启、免改文件):设置页新增「记忆中枢」卡片,
    可开关中枢、自动写入、自主批准,并调读/写阈值、每轮上限、召回条数与空间;
    保存写入数据库 meta memory_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

Choose a tag to compare

@areCodeOI areCodeOI released this 09 Nov 17:40

海马体长期记忆 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

Choose a tag to compare

@areCodeOI areCodeOI released this 09 Nov 04:59

海马体长期记忆 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

Choose a tag to compare

@areCodeOI areCodeOI released this 09 Nov 04:40

海马体长期记忆 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

Choose a tag to compare

@areCodeOI areCodeOI released this 09 Nov 04:29

海马体长期记忆 v0.5.0

新增:opt-in 自动捕获

  • autoCapture: true 时,在 DSH agent/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

Choose a tag to compare

@areCodeOI areCodeOI released this 08 Nov 19:56

海马体长期记忆 v0.4.0

新增

  • namespace v4 元数据与轻量策略:描述/颜色/只读/归档/保留天数/按空间自动召回;旧库从 meta.namespace_registry 自动迁移。
  • 逻辑备份/恢复:JSON 快照、原子写入、权限 600、保留份数;WebUI、CLI、HTTP 全入口。
  • 危险空间操作自动备份;恢复默认 dry-run,执行前再备份当前状态。
  • 异步 namespace rename/merge/delete job:进度、取消、事务回滚。
  • 只读 memory_namespace AI 工具(记忆工具 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。