
agentmemory 12 个月技术路线图全解读从多模态记忆、连接器生态到 v1.0 的演进规划【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory本篇指南以 agentmemory 仓库的 ROADMAP.md 为骨架系统拆解该项目 2026 Q2 至 2027 Q1 的公开路线图四个季度的主题Depth、Breadth、Trust、v1.0、状态标记体系、已落地功能与规划中的架构演进并结合仓库内连接器、插件、治理与部署源码进行印证。读完你将掌握 agentmemory 的演进方向、每项规划背后的实现形态以及如何以贡献者身份参与路线图评审。路线图是什么一份可追溯的公开规划ROADMAP.md 是 agentmemory 的公开 12 个月路线图覆盖 2026 Q2 到 2027 Q1。它被定义为项目走向的事实来源source of truth凡是进入 main 分支的重要功能都应能追溯到路线图上的某个条目或一个被批准的 issue。路线图随证据变化而调整每个季度会随版本发布说明见 CHANGELOG.md附带一份简短回顾说明哪些落地、哪些延期及原因。这一治理姿态与仓库根目录的 GOVERNANCE.md 一脉相承——项目采用接近 Linux Foundation Minimum Viable GovernanceMVG的决策模型重大问题通过governance标签 issue 走正式投票破坏性 API 变更必须提前一个 minor 版本周期预告并提供弃用路径。路线图正是这一决策体系的输入与输出。状态标记体系路线图用四种状态标记每个条目理解它们是阅读全文的前提状态含义Shipped已合入 main 并打标签发布Active进行中有打开的 PR 或指定负责人Planned本季度已接受范围尚未启动Candidate正在考虑可能推迟未列入清单但贡献者想推进的工作同样欢迎在仓库开一个标注roadmap的 issue它会按季度主题参与 triage 排序。季度主题总览一年四个演进阶段路线图将 12 个月划分为四个各具侧重的阶段Q2 2026 — Depth纵深多模态记忆、更多连接器、收尾 v0.9 周期遗留 backlog。Q3 2026 — Breadth广度更多 Agent 的 Hook 对齐、社区扩张、对齐 OpenSSF 最佳实践。Q4 2026 — Trust信任企业级特性——SSO、审计导出、RBAC、长时运行部署方案。Q1 2027 — v1.0稳定稳定性、LTS 分支、REST MCP 接口的 semver 冻结。Q2 2026 — Depth已落地的纵深能力Shipped本季度已完成的七项iii console 文档与随仓库分发的截图#157agentmemory 基于 iii 运行时构建iii console提供引擎视角的可观测性Workers / Functions / Triggers / States / Streams / Queues / Traces / Logs 等页面。README 的 iii Console 一节随附了真实运行截图例如 workers.pngWorker 页与 traces-waterfall.pngOpenTelemetry 瀑布图二者同为assets/iii-console/目录下随仓库分发的资源。健康严重度按 RSS 阈值门控#158 / PR #160健康监控的严重级别不再一刀切而是与资源占用RSS阈值挂钩对应 src/health/ 下的 monitor 与 thresholds 实现。独立 MCP 代理Standalone MCP proxies#159 / PR #161agentmemory/mcp作为薄 shim仅当能连上运行中的 agentmemory 服务器时暴露完整 54 工具面代理模式否则回退到 7 工具本地集。实现见 packages/mcp/bin.mjs 与 src/mcp/。mem::forget审计覆盖与审计策略文档#125 / PR #162删除操作进入审计轨迹对应memory_governance_delete/memory_audit工具族src/functions/audit.ts。agentmemory/fs-watcher文件系统连接器#62 / PR #163见下文专门小节。Next.js 官网部署到 VercelPR #164即 website/ 目录含 Hero、Features、Compare、Testimonials 等组件。CI 在发布时发布全部三个 npm 包PR #166agentmemory/agentmemory、agentmemory/mcp及agentmemory/fs-watcher。Active进行中的两项多模态记忆Multimodal memory#64, PR #111内容寻址图片存储、视觉提示压缩、磁盘配额 驱逐时引用计数。仓库中已有 src/utils/image-store.ts 与 src/functions/image-quota-cleanup.ts 支撑图片存储与配额清理另有memory_vision_search工具src/functions/vision-search.ts支持对图片观测的检索以及 src/prompts/vision.ts 承载视觉提示模板。治理基线Governance baseline本路线图文件本身加上GOVERNANCE.md、CONTRIBUTING.md、MAINTAINERS.md、CODE_OF_CONDUCT.md、SECURITY.md五个文档共同构成治理套件均已在仓库根目录就位。Planned已接受范围的规划项GitHub 连接器agentmemory/github-watcher把 issues、PRs、discussions 同步为观测与文件系统连接器共用POST /agentmemory/observe线上格式。OpenCode Hook 总线#156已勾选落地22 个 Hook 覆盖全部 12 类 Claude Code Hook 类型——会话生命周期create/idle/status/compacted/update/diff/delete/error、消息与提示chat.message、message.updated userassistant、message.removed、工具捕获before message.part.updated 中丰富的 ToolPart 生命周期、记忆注入context system.transform 增强、part 追踪subtask、step-finish、reasoning、file、patch、compaction、agent、retry、文件增强流水线tool.execute.before file.edited file parts、权限updated replied、任务追踪带优先级的 todo.updated、命令command.executed、配置与模型追踪config chat.params外加 2 个斜杠命令recall/remember。实现见 plugin/opencode/含 plugin.json 与 agentmemory-capture.ts。实时查看器中的会话回放 UI在时间线上拖动、逐条检查每条观测的 payload。目前会话回放已具备基础能力——README 说明每个会话都可在查看器 Replay 标签页回放且import-jsonl可导入历史 Claude Code JSONL 转录底层路由到mem::replay::load等 iii 函数见 src/replay/规划项是在实时查看器中增强时间线 scrubbing 体验。CI 中的基准测试装置在每次 minor 版本打标签时重跑 LongMemEval-S保证95.2% R5这个数字在后续版本中保持诚实。基准测试装置已存在于 eval/README.mdadapter 可插拔的评测 harnessgrep / vector / agentmemory 三路对照与 benchmark/README.md含 load-100k 压测 harness产出 p50/p90/p99 百分位报告并落到 benchmark/results/。规划中的是把它接进 CI 门禁。深挖agentmemory/fs-watcher文件系统连接器#62这是已 Shipped 的连接器家族第一个成员其独立文档 integrations/filesystem-watcher/README.md 完整说明了用法# 安装全局 npm install -g agentmemory/fs-watcher # 或免安装直接运行 npx agentmemory/fs-watcher ~/work/my-repo # CLI 参数优先于环境变量 agentmemory-fs-watcher ~/work/my-repo ~/notes核心配置项变量默认值含义AGENTMEMORY_FS_WATCH_DIRS—逗号分隔的待监听目录列表AGENTMEMORY_FS_WATCH_IGNORE—逗号分隔的正则忽略模式作用于相对路径AGENTMEMORY_FS_WATCH_ALLOW_BINARY0设为1时预览读取也包含二进制文件AGENTMEMORY_URLhttp://localhost:3111agentmemory 服务器地址AGENTMEMORY_SECRET—Bearer 令牌服务器设置AGENTMEMORY_SECRET时需要AGENTMEMORY_PROJECT—可选附加到每条观测上的项目标签AGENTMEMORY_SESSION_ID—可选观测归属的会话 id机制要点目录内每次文件变化都变成一条post_tool_use观测data.changeKind取file_change或file_delete文本文件前 4 KB 作为data.content便于检索按子串命中更大文件以data.truncated: true截断写操作按路径 500ms 防抖编辑器连续保存会合并为单条观测。默认忽略.git/、node_modules/、dist/、build/、.next/、.turbo/、coverage/、.DS_Store、*.log、*.lock未知扩展名只记录路径不读内容。该连接器是单向的——只写观测、从不读记忆库。基于 Node 内置fs.watchrecursive: true无原生依赖要求 Node.js 20 LTS。深挖OpenCode 22-Hook 总线#156plugin/opencode/plugin.json 的 description 字段即完整描述了这一已落地能力full Claude Code hook parity……22 hooks, 2 slash commands。它在 Claude Code 12 类 Hook 之外为 OpenCode 补齐了消息、工具、part、文件、权限、任务、命令、配置等全生命周期捕获且项目归属按会话划分——一个 OpenCode 进程跨多个仓库时每个会话归档到各自项目下。这为后续 Q3 的Hook parity across more agents铺平了道路。Q3 2026 — Breadth连接器家族与社区扩张Planned五项规划新增维护者按 GOVERNANCE.md 的 Maintainer 接纳流程引入至少一位来自不同组织的 Maintainer——这是项目从基金会 Growth Stage 继续前进的前提。接纳流程本身已明确候选人需在过去 6 个月有跨子系统的高信号贡献由现任 Maintainer 以 PR 提名公开停留 7 个自然日征集异议后合并。Slack / Discord 连接器连接器家族的第三个数据源前两个是 fs-watcher 与规划中的 GitHub watcher。OpenSSF Scorecard报名并达到 Silver 等值评分在 README 中挂徽章。Hermes 集成加固与 OpenClaw 插件面会话生命周期 工具使用 Hook对齐。现状参考 integrations/hermes/README.md——Hermes 插件已提供 6 个生命周期 Hookprefetch()每次 LLM 调用前注入相关记忆、sync_turn()后台捕获每一轮对话、on_session_end()、on_pre_compress()、on_memory_write()MEMORY.md 镜像写入、system_prompt_block()会话开始时注入项目画像OpenClaw 侧则通过plugins.slots.memory agentmemory认领记忆槽见 integrations/openclaw/README.md。parity即指两边 Hook 面趋同。知识图谱查询语言在/agentmemory/graph之上的小型 DSL支持多跳问题。底层图谱能力已存在src/functions/graph.ts、src/functions/graph-query.ts、src/functions/graph-retrieval.ts 与memory_graph_query工具规划项是增加面向用户的查询语法。首次会议演讲投稿 KubeCon / LlamaCon 等。Candidate候选条目跨 Agent 共享记忆命名空间Cross-agent shared memory namespace目前每个 Agent 各自安装自己的实例该条目希望让 Claude Code 会话与 Cursor 会话通过共享 mesh 节点互相召回对方的观测。这与 README 中已存在的多 Agent 协调原语leases、signals、actions、routines对应 src/functions/leases.ts、src/functions/signals.ts、src/functions/actions.ts、src/functions/routines.ts属于同一方向但共享命名空间属于更进一步的架构变更因此标注为候选。Q4 2026 — Trust企业级信任特性Planned六项规划SSO 网关在 REST 表面之前接受 OIDC服务于团队部署。审计日志导出可流式 tail 到 S3 / Loki / stdout满足合规管线。审计能力已有单机基础memory_audit/memory_governance_deletesrc/functions/audit.ts规划项是把审计流导出到外部 sink。记忆作用域上的 RBACproject:read、project:write、governance:delete角色集。注意当前仓库已存在AGENTMEMORY_AGENT_SCOPEshared|isolated的按 Agent 隔离README.md 的 Multi-agent memory 一节RBAC 是在此之上的团队级权限模型。长时运行部署指南一等公民的 Docker、systemd unit 与 launchd plist。仓库已有 deploy/ 目录覆盖 fly.io / Railway / Render / Coolify 四个平台的部署模板——每个模板都挂载/data卷、首次启动时用openssl rand -hex 32生成 HMAC 密钥并持久化到卷中、只对外暴露 3111 端口查看器 3113 留在容器内 loopback详情见 deploy/README.md。性能 SLO发布 p50/p95 召回延迟目标并由基准测试装置强制。压测装置已具备测量能力benchmark/load-100k.ts 记录 p50/p90/p99 与吞吐SLO 是将其固化为发布门禁。安全审计对 REST 表面 mesh 同步路径的外部审查若季度末基金会接纳落地则通过 LF 资助。Candidate候选条目Agent 间记忆交接协议Agent-to-agent memory handoff protocol标准化一个 Agent 能从另一个 Agent 的记忆中继承什么作为 MCP 的补充。与现有memory_signal_*、session_handoffpromptREADME 中列出的 3 个 prompts 之一能力相关但更正式。Q1 2027 — v1.0稳定与接口冻结Planned四项规划REST MCP 表面冻结任何破坏性变更都需按 GOVERNANCE.md 走 major 版本号。这与 GOVERNANCE.md 的 Breaking changes 条款呼应——破坏性变更需提前一个 minor 周期开breaking追踪 issue、提供至少一个 minor 版本的弃用路径、并在 CHANGELOG 的 Breaking 小节登记。LTS 分支v1.x12 个月安全修复承诺。v1.0 发布完整文档梳理此前所有路线图条目要么落地要么正式延期。基金会成员升级若采纳度与维护者多样性指标支持从 Growth 申请 Impact 阶段。Candidate候选条目面向社区基准测试的托管参考实例。MCP 服务器的第二语言参考实现Rust 或 Go——扩大可托管 agentmemory 的运行时集合。Out of scope明确不做的边界为保证透明度路线图明确列出刻意不做的事项云托管的 agentmemory SaaS。计费、订阅分层、Apache-2.0 之外的商业授权。Agent 框架本身——agentmemory 是依赖dependency不是 Agent 运行时的替代品。这一定位与 GOVERNANCE.md 的 Mission 一致本地优先local-first、零外部数据库、兼容任何 MCP 客户端、默认数据留在用户机器上。如何参与反馈与贡献路径对路线图任何条目有异议或认为应调整优先级开一个标注roadmap的 issue 即可季度主题会随每次季度回顾重新审视。对于希望直接贡献代码的开发者CONTRIBUTING.md 说明了 PR 流程GOVERNANCE.md 定义了懒共识lazy consensus合并规则与 Maintainer 接纳路径——从提 issue到成为 Maintainer的完整上升通道都写在治理文档里。小结agentmemory 的 12 个月路线图是一条从纵深能力到生态广度再到企业信任最后收敛于v1.0 稳定的清晰路径。已落地的 fs-watcher 连接器、OpenCode 22-Hook 总线、独立 MCP 代理与 iii console 文档与规划中的 GitHub/Slack 连接器、知识图谱 DSL、SSO/RBAC、接口冻结一起勾勒出一个以 iii 运行时为底座、以 MCP/REST 为接口、强调本地优先与多 Agent 共享的记忆基础设施的完整演进图景。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考