用途
oracle-codex-memory 用于管理由 Oracle Agent Memory 支撑的仓库级与会话级记忆,通过本地 oracle-codex-memory FastMCP sidecar 工作。当 Codex 会话需要召回、写入、注入种子、查看或删除经过筛选的记忆时使用。
主要能力
- 召回上下文:在重大仓库工作前,当既有上下文可能相关时先执行召回。
- 写入记忆:仅写入经过筛选的事实,包括决策、仓库约定、命令修复、错误模式、总结以及 seed-pack 条目。
- 命令结果记录:对较长或敏感日志,优先使用 record_command_result,使输出在持久化前被压缩与脱敏。
- 删除:使用 delete_memory_capture 进行更正或保留期清理。
- 作用域控制:将 OCM_USER_ID 与 OCM_AGENT_ID 视为服务端作用域,不信任调用方提供的范围覆盖。
使用方式
常用流程:
- 调用 memory_health_check。
- 调用 start_coding_session,传入工作区路径与线程 id。
- 在改变持久性项目行为前调用 recall_context。
- 仅在决策明确且经过评审后调用 remember_decision。
- 对有用的失败、修复或验证证据调用 record_command_result。
- 在交接前,当总结值得保留时调用 summarize_session。
操作规则:
- 当先前上下文可能重要时,在重大仓库工作前先召回。
- 只写经过筛选的事实。
- 除非运行时明确允许,不要存储原始命令输出。
- 不信任调用方提供的范围覆盖。
- 优先使用 record_command_result 处理长或敏感日志。
- 使用 delete_memory_capture 进行更正或保留清理。
本地安装
- 插件安装与环境变量:参见 docs/user-guide/quickstart.md。
- 本地 Oracle AI Database Free Lite 配置:参见 docs/admin/local-oracle-free.md。
适用场景
适用于 Codex 会话中需要跨轮次保留经过筛选的项目记忆时,例如记录已评审的决策、仓库约定、命令修复、错误模式与交接总结。
限制
具体支持的平台、是否收费、价格与效果等资料暂未提供。除上述文档路径与环境变量名外,其他安装步骤细节资料暂未提供。