ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Hindsight 官方集成总览:为 Claude Code、Codex、LiteLLM 等主流 AI Agent 注入持久长期记忆

Hindsight 官方集成总览:为 Claude Code、Codex、LiteLLM 等主流 AI Agent 注入持久长期记忆 Hindsight 官方集成总览:为 Claude Code、Codex、LiteLLM 等主流 AI Agent 注入持久长期记忆【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight Integrations 是 Hindsight(“Agent Memory That Learns”)的一等公民集成套件,为数十种主流 AI 编码智能体、Agent 框架与工作流平台提供开箱即用的持久长期记忆。本篇基于仓库中的 集成目录总览 展开:先给出三大类集成的完整清单与安装方式,再深入剖析单个集成的目录结构与代码形态,最后结合 Claude Code 插件 实例与 发布脚本 源码,讲清楚集成的召回/留存机制与独立版本发布流程。读完本文,你可以快速为自己使用的 Agent 选定对应集成,并理解其底层 hook 调用链与发布约定。什么是 Hindsight IntegrationsHindsight Integrations 目录的定位是:为流行的 AI 智能体、框架和 CLI 提供“第一方(first-party)”持久长期记忆能力。其组织原则在 README 中表述得很明确——每个集成占据一个独立子目录,拥有自己的 README、配置和测试,使用者只需挑选与自己所用 Agent/框架匹配的那一个。从当前仓库快照看,hindsight-integrations/下共有 51 个集成子目录,规模远超 README 表格列出的条目,其中包括 coding-agents(一个覆盖十余种编码 CLI 的统一 Agent 插件运行时)、agno、cline、eliza、haystack、obsidian、zcode、zed 等 README 表格之外的集成。编码智能体与 CLI(Coding agents CLIs)README 将编码类 Agent 单列为第一大类,这是 Hindsight 集成最密集的领域:集成能力说明安装方式Claude Code基于 Hook 的记忆:自动留存每个会话,每次提示词时自动召回npx hindsight-ccOpenCodeTypeScript 插件:retain/recall/reflect 工具、空闲时自动留存、会话启动时记忆注入、压缩(compaction)保留在opencode.json中加入vectorize-io/opencode-hindsightCodex CLIPython hook 脚本:UserPromptSubmit时自动召回,Stop时自动留存curl -fsSL https://hindsight.vectorize.io/get-codex \| bashCursor CLIPython hook 脚本:beforeSubmitPrompt召回,stop留存,sessionEnd最终冲刷./scripts/install.shCopilot CLIPython hook 脚本:sessionStart/subagentStart召回,agentStop留存,sessionEnd冲刷pip install hindsight-copilot-cli hindsight-copilot-cli installContinue.devHTTP 上下文提供者,支持聊天中精确的hindsight召回,可选 MCP server rules 在 agent 模式下自动召回/留存pip install hindsight-continueGitHub Copilot (VS Code)MCP server 配置(.vscode/mcp.json) Copilot agent 模式的 recall/retain 规则pip install hindsight-copilotDevin Desktop原生 MCP server 配置 常驻 recall/retain 规则pip install hindsight-devin-desktopRoo Code面向 Roo Code VS Code 扩展的持久记忆见其 READMEHermes(OpenAI Agents SDK)OpenAI Agents SDK 的记忆层见其 READMEGrok BuildGrok Build(xAI)的 Hooks见其 READMEClaude Code SkillsClaude Code 智能体的 Skills 集成见其 README注意:Hermes、Grok Build、Right Agent 等条目在当前仓库快照中没有对应的独立子目录(其 README 链接已不解析),表格保留是为忠实反映官方 README 的规划清单;实际可用集成以hindsight-integrations/下真实存在的目录为准。Agent 框架(Agent frameworks)面向 Python/JS 生态的框架级记忆接入:集成能力说明LiteLLMProxy 回调——凡是经 LiteLLM 代理的模型请求都自动获得记忆,零代码改动CrewAI为 CrewAI Agent 提供长期记忆工具Pydantic AI依赖注入式记忆Vercel AI SDK面向 Vercel AI SDK 应用的持久记忆Vercel ChatVercel AI Chatbot 的即插即用记忆LangGraph / LangChainMemory Tools、Graph Nodes 与 BaseStore 适配器三种模式LlamaIndex双模式:Agent 驱动(BaseToolSpec)与自动(BaseMemory)Google ADKADK 的BaseMemoryService实现Strands Agentsretain/recall/reflect 三工具AG2跨会话记忆工具AutoGenretain/recall/reflect 的FunctionTool实例Aiderhindsight-aider包装aiderCLI:会话前召回项目记忆,会话后留存转录OpenAI Agents SDK基于FunctionTool的记忆OpenHands原生 MCP 配置 recall/retain 规则NemoClawNemoClaw 沙箱的一键安装PipecatPipecat 语音流水线的记忆节点AgentCoreAgentCore 记忆工具SmolagentsHuggingFace Smolagents 的 retain/recall/reflect 工具OpenClawOpenClaw 工作流记忆工作流与自动化平台(Workflow automation platforms)集成能力说明n8n社区节点——把 retain/recall/reflect 拖进任意 n8n 工作流ZapierZapier 应用:retain/recall/reflect 动作 记忆事件即时触发器DifyDify 应用的持久记忆FlowiseFlowise 流水线的记忆节点VapiVapi 语音智能体的持久记忆Gemini SparkGemini Spark 记忆Cloudflare OAuth ProxyOAuth 代理,支持把 Hindsight 运行在 Cloudflare Access 之后PaperclipPaperclip 工作流的记忆层单个集成的标准目录形态README 承诺“每个集成一个子目录”,从源码结构看,这一约定落地为高度统一的工程模板,大致分四种形态:Python 包型(CrewAI、Pydantic AI、OpenAI Agents SDK 等):hindsight-integrations/name/hindsight_snake/源码包 tests/测试目录 pyproject.toml。以 CrewAI 的 pyproject.toml 为例,包名hindsight-crewai,核心依赖是hindsight-client0.4.0,并显式约束框架版本区间(如crewai0.86.0,1.10,注释说明 1.10 因Storage - StorageBackend改名需要迁移)。这解释了为什么每个集成要独立发版——框架 API 的破坏性变更只影响单个集成。Hook 脚本型(Codex、Cursor、ZCode 等编码 CLI):hooks/目录存放事件钩子脚本 scripts/安装脚本 settings.json承载插件元信息(含版本号)。例如 Codex 集成的 settings.json 中声明version: 0.3.1,发布脚本直接读取该字段。npm 包型(OpenCode 等):标准 npm 工程,如 opencode 的 package.json 定义包名vectorize-io/opencode-hindsight,配合tsup.config.ts与vitest.config.ts构建测试。平台原生型(n8n、Zapier、Dify、Flowise):按宿主平台约定的目录组织,如 n8n 的nodes/credentials/、Zapier 的creates/searches/triggers/。无论哪种形态,集成最终都收敛到 Hindsight 客户端 SDK(hindsight-client)或 REST API 上的 retain/recall/reflect 三个核心操作。案例深析:Claude Code 插件的记忆注入链路Claude Code 集成是理解 Hindsight 集成范式的最佳样本,它通过 Claude Code 的 hook 事件体系实现“无感记忆”。快速上手# 1. 添加 Hindsight marketplace 并安装插件 claude plugin marketplace add vectorize-io/hindsight claude plugin install hindsight-memory # 2. 为记忆抽取配置 LLM 提供方 # 方案 A:OpenAI(自动检测) export OPENAI_API_KEYsk-your-key # 方案 B:Anthropic(自动检测) export ANTHROPIC_API_KEYyour-key # 方案 C:无需 API key,复用 Claude Code 自带模型(仅限个人/本地) export HINDSIGHT_LLM_PROVIDERclaude-code # 方案 D:连接外部 Hindsight 服务器而非本地运行 mkdir -p ~/.hindsight echo {hindsightApiUrl: https://your-hindsight-server.com} ~/.hindsight/claude-code.json # 3. 启动 Claude Code,插件自动激活 claude核心特性包括:每次用户提示词时自动召回并注入上下文、每次响应(或每 N 轮)自动留存、本地 MCP server 暴露agent_knowledge_*知识工具、支持带记忆的专用子智能体、动态 bank ID(按 agent/项目/会话隔离记忆)、hooks 纯 Python 标准库实现(零依赖,MCP server 除外)。Hook 事件架构组件事件/传输职责session_start.pySessionStarthook健康检查,确认 Hindsight 可达recall.pyUserPromptSubmithook自动召回——查询记忆并作为additionalContext注入retain.pyStophook(异步)自动留存——抽取转录并 POST 到 Hindsightsession_end.pySessionEndhook清理:停止自启动的 daemonmcp_server.pyMCP stdio server知识工具(页面增删改查、召回、文档摄取)召回流程的完整调用链为:用户提交 prompt →UserPromptSubmithook 触发 → 解析 API URL(外部/本地/自动启 daemon)→ 推导 bank ID(静态或按项目上下文动态)→ 用当前 prompt 加可选历史轮次组装 query → 调用 Hindsight recall API → 把记忆格式化进hindsight_memories块 → 通过hookSpecificOutput.additionalContext输出——Claude 看得见,用户聊天窗口看不见。留存流程则在Stop事件(异步非阻塞)中读取 Claude Code 的 JSONL 转录文件,执行分块留存逻辑,并剥除hindsight_memories标签以防止记忆自我引用的反馈循环。支撑这些行为的库模块:lib/client.py(纯标准库urllib的 REST 客户端)、lib/config.py(settings.json 环境变量覆盖)、lib/daemon.py(hindsight-embed守护进程生命周期)、lib/bank.py(bank ID 推导与 mission 管理)、lib/state.py(fcntl文件锁的状态持久化)。独立版本与发布机制README 强调“每个集成独立版本化、独立发布”,执行入口是:./scripts/release-integration.sh integration-name version # 例如 ./scripts/release-integration.sh cursor-cli patch阅读 release-integration.sh 源码,可以确认其完整行为远不止“打 tag”:白名单校验:集成名必须存在于脚本内的VALID_INTEGRATIONS数组(约 47 个条目);version 参数支持完整语义化版本(如0.2.0)或 bump 关键字patch/minor/major。版本来源探测:按pyproject.toml→package.json→.claude-plugin/plugin.json→plugin.json→settings.json的优先级读取当前版本,并回写到对应清单文件;npm 集成还会执行npm version --no-git-tag-version同步package-lock.json中重复出现的版本字段,避免锁文件停留在诞生时的旧版本。安全闸门:非main分支需交互确认;工作区必须干净;tag 已存在则直接失败。Changelog 生成:要求OPENAI_API_KEY(可来自.env),用 LLM 生成 changelog 条目,并以integrations/name/vversion格式打 tag。特殊联动:claude-code 插件通过 marketplace 清单分发(不走包仓库),发布时脚本会同步根目录 marketplace 清单的版本号,保证目录展示的即是新发布。配套的 check-integration-releases.sh 则用于审计:对每个集成取integrations/name/v*的最新 tag,比对目录中未包含在 tag 里的提交,输出“从未发布/有新提交未发布”等状态,保证版本与代码不漂移。新增集成清单(贡献者须知)README 将“添加新集成”指向根目录 CLAUDE.md 的 “Adding New Integrations” 章节,其四条硬性门槛为:测试必备——必须模拟或真实驱动外部系统(如 mock 框架接口,验证集成确实正确调用了 Hindsight),纯 helper 单元测试不够;CI 作业——在.github/workflows/test.yml中按现有模式(如test-crewai-integration)添加作业,构建、装依赖并运行uv run pytest tests -v;同时把集成加入detect-changes输出,使作业仅在其文件变更时触发;发布注册——把集成名加入scripts/release-integration.sh的VALID_INTEGRATIONS数组,才能走标准发布流程;代码规范——遵循 Python 风格与类型安全,结构化数据禁用裸 dict、禁用多元素元组返回值。缺任何一条,集成即视为不完整,不得合并。此外该文件还规定:changelog 条目由发布脚本在真正切版时写入,禁止手工添加 “Unreleased” 条目。如何为自己的 Agent 选型编码 CLI 重度用户:Claude Code / Codex CLI / Cursor / Copilot CLI 场景优先 Hook 型集成——无需改 Agent 代码,装完即自动召回与留存;自研 Agent 应用:按框架选 LiteLLM(代理层零改动)、CrewAI、LangGraph、Pydantic AI 等包型集成,在代码中注入工具或服务;平台工作流:n8n、Zapier、Dify、Flowise 的节点/动作型集成可直接拖入现有流程;需要统一覆盖多种 CLI:关注 coding-agents,它是覆盖十余种编码 CLI 的统一运行时;需要内网/访问控制:可组合 Cloudflare OAuth Proxy 把 Hindsight 置于 Cloudflare Access 之后。所有集成的记忆最终汇聚到同一 Hindsight 后端:同一 bank 下的记忆可跨集成共享(如 CLI 中留存的记忆可在框架 Agent 中召回),这正是“每个集成一个子目录、共享一个记忆底座”架构设计的价值所在。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表