Hindsight 版本演进实录从 v0.1 到 v0.9 的 Agent 记忆引擎成长路线图【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight导读本文以 Hindsight 官方里程碑博文为主线系统梳理该项目从 2025 年 12 月首个开源提交到 v0.9.x 的完整版本演化——67 个版本、900 次跟踪变更覆盖嵌入式记忆、多租户、学习层、检索扩展、生产加固到知识页面与编码 Agent 接入的全过程。读完本文你将掌握每个版本阶段的核心能力、关键实现路径与仓库内对应的源码/配置位置可作为理解 Hindsight 架构演进与选型参考的速查图。为什么版本史本身就是技术史Hindsight 是一个定位为 Agent Memory That Learns 的开源 Agent 记忆引擎。与常见的提示词技巧型记忆方案不同它的核心是数据库、检索策略、学习层、写入retain、提取recall、反思reflect、鉴权与运维管线——一套可度量的、适合生产环境运行的工程基础设施。2025 年 12 月开源后项目在约 9 个月内完成了67 次版本发布、超过 900 项跟踪变更并于 2026 年 8 月跨过20,000 GitHub Star。仓库当前各子包的版本号已推进到0.9.2见 hindsight-api/pyproject.toml 与 hindsight-all-npm/package.json 中的version字段即本文所述的里程碑之后仍在持续迭代。版本时间线总览版本线时间发布数阶段主题0.1.x2025.1213地基嵌入式 Postgres、本地 MCP、hindsight-embed0.2.x2026.011多 Bank 记忆与跨 Bank MCP 工具0.4.x2026.02–0323学习层Observations、Mental Models、知识图谱0.5.x2026.047检索提速、Constellation 视图、模板中心0.6 – 0.7.x2026.056搜索层扩展、企业级后端0.8.x2026.06–087生产加固 一波编码工具集成0.9.x2026.082Knowledge Pages 与面向所有编码 Agent 的记忆2025 年 12 月 — v0.1.x把地基打稳首月 13 个版本确立了一个至今未变的核心在嵌入式 PostgreSQL 上完成 retain写入、recall提取、reflect反思无需单独运行外部向量数据库。本地化体验被放在首位目标是几分钟内即可上手。该阶段的关键能力本地 MCP 服务器任何 MCP 客户端无需独立服务即可连接同时提供hindsight-embed以进程内方式运行记忆。仓库中 hindsight-embed/README.md 展示了其守护进程架构首条命令自动拉起本地 daemon首次运行需下载依赖并加载 ML 模型约 1–3 分钟后续命令约 1–2 秒响应daemon 空闲 5 分钟后自动退出监听localhost:8888使用嵌入式 PostgreSQLpg0所有数据留在本机。扩展系统可插拔新操作首个基于图的检索器利用记忆之间的关系进行召回。Memory Banks、记忆标签、备份/恢复、多语言内容支持。模型与提供方广度LiteLLM、Cohere 嵌入/重排、可配置嵌入维度、Gemini 3 Pro / GPT-5.2 等。从仓库结构看这一阶段奠定的三件套沿用至今记忆引擎实现在 hindsight-api-slim/hindsight_api/engineretain、consolidation、recall、reflect 等子模块进程内/本地模式由 hindsight-embed 提供Control Plane 可视化则位于 hindsight-control-plane/src。2026 年 1 月 — v0.2.x多 Bank 记忆成为现实这是一个聚焦的发布多 Bank 访问加上跨 Bank 操作的 MCP 工具让按用户隔离按项目隔离从概念变成了默认能力。同时加入Anthropic Claude 与 LM Studio 提供方支持retain 时的自定义实体reflect的结构化输出Control Plane 中首个图谱可视化。多 Bank 的隔离语义此后贯穿所有版本CLI 层通过bank_id参数完成隔离所有 Bank 共享一个数据库见 hindsight-embed/README.md 的说明服务端则通过 hindsight-api-slim/hindsight_api/api 暴露 HTTP 与 MCP 双入口。2026 年 2–3 月 — v0.4.x学习层让记忆会学习这是项目史上最重的版本线23 个版本、约 300 项变更。如果说 0.1 给了记忆一个存放的位置0.4 则赋予 Hindsight 从记忆里学习的能力。Observations从事实到信念Observations是从原始事实中提炼、经合并去重后的信念支持可配置作用域scope、按作用域限额、历史追踪与批量合并batch consolidation。观察体提取与合并的调度逻辑集中在 hindsight-api-slim/hindsight_api/engine/consolidation/consolidator.py 及同目录的 prompts.py。Mental Models会自我刷新的常驻答案Mental models是会自我刷新的常驻答案提供完整的 MCP 增删改查、基于标签的触发tag-aware triggers、陈旧信号staleness signals与历史 diff 视图。测试侧可参见 hindsight-api-slim/tests/test_mental_models.py 及test_mental_model_*系列用例触发补丁、标签分组、最小刷新间隔、结构化输出等这些用例印证了 mental model 的触发与刷新语义。知识图谱真正的知识图谱落地实体解析entity resolution、更丰富的实体标签以及改进的**因果链接causal link**检测并配套时间排序。图谱相关实现可参考 hindsight-api-slim/hindsight_api/engine 下的实体与图谱维护模块test_graph_maintenance*.py、test_entity_resolver*.py等测试覆盖了实体合并、标签、共现聚类等细节。围绕学习层的规模化扩展万物皆可摄入PDF、图片、Office 文档Iris 解析器以及通过各 Provider Batch API 实现的异步批量 retain规模化检索每 Bank 独立的 HNSW 索引、pgvectorscaleDiskANN支持大型 Bank 上 observation recall 提速约40 倍多租户与鉴权Bearer Token MCP、分层配置作用域、Supabase 租户扩展以及consolidation.completed/retain.completedWebhook见 hindsight-api-slim/hindsight_api/webhooks集成浪潮开端Claude Code、Codex CLI、LangGraph、Vercel AI SDK、Chat SDK、CrewAI、PydanticAI、AG2、Agno、Strands、LlamaIndex以及 Go 与 AI SDK 客户端、原生 Windows 支持。2026 年 4 月 — v0.5.x检索长大成人7 个版本、约 137 项变更聚焦让召回更快、让记忆更可移植。图谱能力收敛为单一的LinkExpansion retriever3 阶段 retain 管线在并发下显著提升摄入吞吐。Constellation 视图实体图谱的可交互、可缩放画布带热度渐变色。前端组件位于 hindsight-control-plane/src/components/constellation.tsx。Delta mental-model 刷新只重读上次运行之后新增的记忆避免全量重算。Bank 模板导入/导出Template Hub把 Bank 的配置、mental models 与指令导出为可复用的 manifest。本地与开放推理内置llama.cpp提供方实现在 hindsight-api-slim/hindsight_api/engine/providers/llamacpp_llm.py本地模型对齐、服务生命周期、attempt context 等行为由test_llamacpp_*.py、test_local_model_alignment.py等用例覆盖另有 OpenRouter 与一等公民的 DeepSeek 支持。新集成OpenAI Agents SDK、AutoGen、Paperclip、OpenCode、Pipecat 语音。2026 年 5 月 — v0.6.x / v0.7.x把搜索层做大两条 minor 版本线、同一主题让检索在真实数据规模下既快又准并触达企业级后端。BM25 搜索后端ParadeDBpg_searchCitus 兼容与 PGroonga多语言搜索更佳并支持可配置的分词。相关脚本与编排见 docker/docker-compose/pg_search、docker/docker-compose/pgroonga 与 docker/docker-compose/pg_textsearch服务端开关逻辑见 hindsight-api-slim/hindsight_api/_pg_search.py。企业级存储AlloyDB ScaNN 索引编排见 docker/docker-compose/alloydb、Oracle Database后端以及面向召回流量的只读副本read-replica选项。更聪明的调度Bank 优先级合并bank-priority consolidation与按 observation scope 的定向合并。更多提供方与模型z.ai、Fireworks、带自动回退链的 litellm router、Qwen3 重排器。集成Dify、n8n、SmolAgents、AWS Bedrock AgentCore、Google ADK、Flowise、Roo Code、Vapi 语音、Gemini Spark。2026 年 6–8 月 — v0.8.x为生产而生项目史上第二大版本线7 个版本、230 项变更。这一阶段 Hindsight 在运维上变得认真起来集成清单也急剧膨胀。生产加固周期性后台维护自主对账合并状态并在多租户间强制执行保留策略可持久、可恢复的进度快照覆盖长时合并与批量 retain可逆的记忆策展curation编辑、作废、回滚记忆单元以及对近似重复观察的语义去重自诊断健康探针报告事件循环是否被阻塞、连接池是否耗尽整 Bank / 跨 Bank 导入导出无需重跑 LLM配合 prompt 前缀缓存与 Anthropic batch prompt caching 降本安全Memory DefenseSIEM 增强以及多 LLM 故障转移 / 轮询。Memory Defense 的实现细节值得展开扩展契约定义在 hindsight-api-slim/hindsight_api/extensions/memory_defense.py。它内置约 40 条高置信度的密钥/PII 脱敏正则覆盖 AI/LLM 提供方如sk-ant-、sk-proj-、AIza、hf_云厂商如AKIA、ASIA代码托管如github_pat_、glpat-支付类如sk_live/test_数据库连接串与 JWT、私钥块等支持allow/redact/block三种动作。值得注意的两个设计指纹化预览fingerprint_fingerprint_value()按值长度保留前缀/后缀如ghp_...AAAA原始密钥绝不出现在审计输出中供 SIEM 关联凭证清单ASCII token 边界为规避\b在 CJK 文本中失效的问题例如凭证为sk_test_ABC...中的密钥逃过检测使用(?![A-Za-z0-9_])/(?![A-Za-z0-9_])自定义边界并有测试test_redaction_patterns_do_not_use_unicode_word_classes强制约束防止回归。集成浪潮GitHub CopilotCLI 与 VS Code、Aider、Zed、OpenHands、Continue.dev、Cursor插件与 CLI、Cline、Windsurf、Composio、Zapier、Obsidian、Haystack、Microsoft Agent Framework等。这些集成在仓库中大多有独立子目录与配套锁文件见 hindsight-integrations。2026 年 8 月 — v0.9.xKnowledge Pages 与每个编码 Agent 的记忆最近的两个版本把前面所有基础设施向外打开。Knowledge Pages会自愈的 WikiKnowledge Pages把 Bank 变成一个自己写自己的自愈 Wiki由合并后的记忆综合而成的活文档living documents随 Bank 学习而持续刷新。从数据模型看它由迁移 hindsight-api-slim/hindsight_api/alembic/versions/a9b8c7d6e5f4_add_knowledge_pages.py 引入的knowledge_pages表承载树形层级kind区分folder纯容器mental_model_id为空与page引用承载内容的 mental model单一自引用parent_id允许任意嵌套删除文件夹行会级联删除整个子树内容仍留在mental_models本表只存元数据与树结构同文件夹内页名唯一部分唯一索引uq_kp_folder_pagename用COALESCE(parent_id, )lower(name)处理根级页面的 NULL 父级歧义managed标记客户端用于标注系统拥有 vs 手工撰写服务端不做行为处理同步提供 Oracle 方言实现因 CLOB 无法lower()建索引Oracle 侧不强制页名唯一。Hindsight Coding Agents一个包十个 AgentHindsight Coding Agents从单一包把长期记忆带给十个编码 Agent——Claude Code、Codex、Cursor CLI、opencode、Copilot CLI 等并提供每 Bank 开关用于在召回时调节时间搜索、图谱扩展与重排。仓库中的 hindsight-integrations/coding-agents/README.md 给出了完整实现图景零配置摄入无需安装命令仓库的 git 历史与会话在后台自动流入其记忆 Bank默认每个仓库一个 Bankcoding-agent::{gitProject}跨 Agent 共享安装即接线npx vectorize-io/hindsight-coding-agents install all一次接线全部检测到的 Agenthook 型宿主写 hooks插件型宿主写原生插件入口install agent只装单个uninstall精确移除update仅刷新运行时三种记忆驻留模式cloudHindsight Cloud默认需 API token、self-hosted自建服务需 URL、daemon本机hindsight-embed需uv与用于提取的 LLM 密钥——安装时选择一次重装不再询问每 Bank / 每 Agent 精细调节harnesses.name做按 Agent 覆盖banks.resolvedBankId做按仓库覆盖observationScopes: shared保证同一仓库的所有 Agent 构建同一套信念而非按 harness 分裂成互不可见的平行观测集per_source则可在提交说了什么与会话里定了什么之间拆分提问Knowledge Pages 刷新策略pageTriggerType: cron默认每小时错峰刷新H * * * *中H按 Bank id 与页名哈希为每页独立分钟、auto-refresh每次合并后刷新最贵或manual刷新本身是delta 式的——每轮编辑页面而非重建可观测性插件日志 结构化 diag 事件reflect_ok/reflect_failed/reflect_fallback_pages等hindsight_sync_status工具回答记忆就绪了吗synced: true即种子记忆可查询。0.9.1 与 0.9.20.9.1一周后跟进时间抽取约9 倍提速且结果一致整 Bank 迁移携带 Knowledge Pages 树xAI OAuth可用 SuperGrok 订阅运行 LLM数据库无关的存活探针仓库当前版本0.9.2表明该里程碑发布后迭代仍在继续见 hindsight-api/pyproject.toml 等。贯穿主线基础设施的胜利把时间线连起来读模式非常清晰这里没有任何提示词技巧。数据库、检索策略、学习层、合并、摄入、鉴权与运维管线——正是这些不性感的基础设施让记忆精确到可以被度量、无聊到可以跑在生产环境。900 项变更横跨 67 个版本架构形态变得越来越锐利。需要说明的是Hindsight 并非同类项目中最受 Star 的项目其团队更愿意在基准测试层面竞争。对于上手路径可选 Hindsight Cloud 免费试用或用单条命令自托管仓库内的 docker/standalonestart-all.sh、docker/docker-compose 与 helm/hindsight 提供了容器与 Kubernetes 两种自托管参考。若只想在本地进程内体验记忆可参考 hindsight-embed/README.md 的hindsight-embed configurememory retain/recall/reflect快速开始流程。延伸阅读仓库内hindsight-embed/README.md — 本地守护进程模式的完整命令与环境变量参考hindsight-integrations/coding-agents/README.md — Coding Agents 包的配置参考与迁移指南hindsight-api-slim/hindsight_api/alembic/versions/a9b8c7d6e5f4_add_knowledge_pages.py — Knowledge Pages 表结构迁移hindsight-api-slim/hindsight_api/extensions/memory_defense.py — Memory Defense 脱敏策略与指纹机制hindsight-control-plane/src/components/constellation.tsx — Constellation 图谱视图前端实现【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考