Hicortex — AI Fleet Memory

Hicortex — AI 机群记忆

为 AI Agent 提供共享记忆——它会在夜间自我修正，一个 Agent 学到的东西，整个机群都能知晓。 所有 Agent、项目和机器共享同一份记忆——它们不再凭空猜测，而是掌握实情。

• 一个大脑，适配所有框架 — Claude Code、Hermes、OpenClaw、Pi、OpenCode，以及任何兼容 MCP 的 Agent 都能共享同一份记忆。
• 主动推送，而非主动拉取 — 在每个受支持的编码 Agent 中，每次提示词都会注入精简的记忆索引，让 Agent 所需的决策、修正和上下文始终触手可及。无需反复解释，无需复制粘贴，也无需维护。每轮零大模型调用 — 记忆召回不会产生 API 费用或触发速率限制。
• 夜间整合 — 每晚读取当天的会话，提炼重要内容，并将其转化为学习成果、关联和知识图谱。
• 本地优先 — 原始会话不会离开机器；只有提炼后的记忆会被存储。

安装

npx @gamaze/hicortex init
Claude Desktop: one "yes" during init.

自动检测你的环境，配置一个大模型（Ollama、Claude CLI 或 API 密钥），安装本地守护进程（macOS 上使用 launchd，Linux 上使用 systemd），并为 Claude Code 注册 MCP 工具。

对于多机器配置，可将轻量客户端指向共享服务——客户端无需本地数据库或大模型：

npx @gamaze/hicortex init --server https://your-server.example.com

init 会自动检测其他框架并安装对应的客户端：Pi 扩展（~/.pi/agent/extensions/hicortex.ts — 推送式记忆召回、身份信息 + 经验教训以及十个工具；也可手动将 pi-extension/hicortex/index.ts 复制到该位置）、OpenCode 插件（~/.config/opencode/plugins/hicortex.ts — 同样包含这三项；也可手动将 opencode-plugin/hicortex/index.ts 复制到该位置）、Hermes 插件和 OpenClaw 插件。pi-mcp-adapter 仍可作为适用于任何框架的通用 MCP 备用方案（已通过 SSE 端点验证）——Pi 不再需要它。请参阅安装文档。

工作原理

CAPTURE (nightly)        CONSOLIDATE (nightly)             RECALL (every prompt)
sessions → denoise       score · reflect · link            a compact index of
→ POST /distill          decay · dedup · supersede         relevant memories is
                         (one model, all phases)           pushed into the prompt
                                                           → full text lazy-loaded

Agent 使用记忆时，记忆会加强；不再使用时，则会逐渐淡化，并自动与相关记忆建立关联。检索采用混合 BM25 + 向量搜索——查询时无需调用大模型。

首次运行夜间任务时，默认只会采集最近 7 天的会话（而非全部历史记录）——运行一次 hicortex nightly --recapture-window <days> 即可导入更多内容。

功能

• 逐提示词回忆推送 — 每轮都会将相关记忆放入上下文；只有在需要时，Agent 才会使用 hicortex_get 获取完整内容。
• /dashboard 中的记忆分析 — 查看记忆增长、回忆采纳情况，以及对所学内容的每夜摘要。
• /viz 中的知识图谱 — 按领域聚类记忆，并通过关系边连接。
• 领域与标签 — 使用可配置词汇进行多标签分类；类别会随数据变化而调整。
• 反思所得的经验 — 每夜反思会提取通用、可复用的经验，而不仅仅是经历日志。
• 自我纠正存储 — 每夜原地改写过时事实，并附上带日期的来源记录；将近似重复项合并为一条（逐字副本免费保留，合并内容可恢复）；降级被取代的决策，不再重新呈现。不会留下僵尸记忆。
• 设计上无需主动提示 — 编码 Agent 通过钩子获取注入的回忆；支持指令的客户端（Claude Desktop、Cursor 类客户端）会获得常驻指令，因此无需请求也会使用记忆。普通 MCP 客户端仍可使用完整搜索功能。
• 自我校准 — 回忆、衰减和合并边界会报告自身统计数据；调优依据测量，而非猜测。
• 常驻上下文层 — 可手动编辑的“你是谁／如何工作”Markdown，每次会话都会注入，且永不衰减。

MCP

九个 MCP 工具——hicortex_search、hicortex_get、hicortex_recent、hicortex_ingest、hicortex_lessons、hicortex_index、hicortex_graph、hicortex_update、hicortex_delete——以及用于保存明确经验的 /learn 技能。完整参考 →

技术栈

TypeScript · Node.js 20+ · SQLite + sqlite-vec + FTS5（在同一个 DB 中实现语义搜索与全文搜索）· ONNX 嵌入（bge-small-en，CPU）· 基于 HTTP/SSE 的 MCP · 一个可配置的 LLM（Ollama、Claude CLI 或任意 OpenAI 兼容端点）。

开发

git clone https://github.com/gamaze-labs/hicortex.git
cd hicortex

仓库根目录中的 AGENTS.md 定义了可通过机器检查的验证契约。“完成”意味着整条命令链以代码 0 退出。该契约与 CI 运行的内容一致。贡献者——无论是人还是 Agent——都应在宣布工作完成前运行它。

欢迎贡献——请参阅 CONTRIBUTING.md。

链接

• 网站： hicortex.gamaze.com
• 文档： hicortex.gamaze.com/docs
• 更新日志： CHANGELOG.md
• npm： @gamaze/hicortex
• 问题反馈： gamaze-labs/hicortex/issues
• 安全： SECURITY.md

许可证

根据 PolyForm Noncommercial License 1.0.0，个人和非商业用途免费。商业用途需要按席位购买许可证——请参阅 hicortex.gamaze.com。