流程定时启动全解析：触发原理、配置要点与运维实践
2026/9/10 17:38:50
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 Governance（MVG）的决策模型，重大问题通过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 文档与随仓库分发的截图（#157）：agentmemory 基于 iii 运行时构建，
iii console提供引擎视角的可观测性（Workers / Functions / Triggers / States / Streams / Queues / Traces / Logs 等页面）。README 的 "iii Console" 一节随附了真实运行截图，例如 workers.png（Worker 页）与 traces-waterfall.png（OpenTelemetry 瀑布图），二者同为assets/iii-console/目录下随仓库分发的资源。 - 健康严重度按 RSS 阈值门控（#158 / PR #160）：健康监控的严重级别不再一刀切，而是与资源占用（RSS）阈值挂钩，对应 src/health/ 下的 monitor 与 thresholds 实现。
- 独立 MCP 代理（Standalone MCP proxies）（#159 / PR #161）：
@agentmemory/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 官网部署到 Vercel（PR #164）：即 website/ 目录，含 Hero、Features、Compare、Testimonials 等组件。
- CI 在发布时发布全部三个 npm 包（PR #166）：
@agentmemory/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 user+assistant、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% R@5这个数字在后续版本中保持诚实。基准测试装置已存在于 eval/README.md（adapter 可插拔的评测 harness，grep / 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_BINARY | 0 | 设为1时预览读取也包含二进制文件 |
AGENTMEMORY_URL | http://localhost:3111 | agentmemory 服务器地址 |
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.watch（recursive: true），无原生依赖，要求 Node.js >= 20 LTS。
深挖：OpenCode 22-Hook 总线（#156）
plugin/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 个生命周期 Hook：
prefetch()（每次 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_delete，src/functions/audit.ts），规划项是把审计流导出到外部 sink。 - 记忆作用域上的 RBAC：
project:read、project:write、governance:delete角色集。注意当前仓库已存在AGENTMEMORY_AGENT_SCOPE=shared|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_handoffprompt（README 中列出的 3 个 prompts 之一）能力相关但更正式。
Q1 2027 — v1.0：稳定与接口冻结
Planned：四项规划
- REST + MCP 表面冻结：任何破坏性变更都需按 GOVERNANCE.md 走 major 版本号。这与 GOVERNANCE.md 的 Breaking changes 条款呼应——破坏性变更需提前一个 minor 周期开
breaking追踪 issue、提供至少一个 minor 版本的弃用路径、并在 CHANGELOG 的 Breaking 小节登记。 - LTS 分支
v1.x：12 个月安全修复承诺。 - 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），仅供参考