SuperAPI AI 工具集

oracle-codex-memory

编程与开发

查看项目

更新于 10-15 08:17

技能介绍

用途

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 视为服务端作用域,不信任调用方提供的范围覆盖。

使用方式

常用流程:

  1. 调用 memory_health_check。
  2. 调用 start_coding_session,传入工作区路径与线程 id。
  3. 在改变持久性项目行为前调用 recall_context。
  4. 仅在决策明确且经过评审后调用 remember_decision。
  5. 对有用的失败、修复或验证证据调用 record_command_result。
  6. 在交接前,当总结值得保留时调用 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 会话中需要跨轮次保留经过筛选的项目记忆时,例如记录已评审的决策、仓库约定、命令修复、错误模式与交接总结。

限制

具体支持的平台、是否收费、价格与效果等资料暂未提供。除上述文档路径与环境变量名外,其他安装步骤细节资料暂未提供。