AgentMemory for Codex on Windows 是一个独立的、Windows 原生的 AgentMemory 下游项目，面向 OpenAI Codex Desktop 和 Codex CLI。它基于 AgentMemory v0.9.30，但并非官方上游仓库、@agentmemory/* npm 发布版本，也不代表上游支持承诺。项目定位为技术预览，由 AI 生成并经用户测试，相关披露文档可供查阅。
用途方面，该项目旨在为 Codex 任务保留有用的上下文，同时将官方 AgentMemory 的记忆、课程、图、审计和溯源存储作为唯一权威存储。它通过四个受管理的 Codex 钩子（SessionStart、UserPromptSubmit、Stop、SessionEnd）捕获正常的主代理用户提示和最终助手回复，并排除环境 UI、标题/分叉流量、已知内部宿主提示和子代理流量，避免持久捕获无关内容。写入、删除、策展和溯源均严格限定在精确项目范围内。
主要能力包括：支持经过审计的、目标范围内的实时图溯源修正，并提供干运行预览；支持通过现有 REST forget 端点对已证实为空的观察记录进行审计恢复，保留精确 ID、版本检查和图游标；支持跨项目的有界、带来源标签的联邦召回，但不允许通配符写入；可使用无凭据、仅限回环的本地 Qwen 工作器进行类型化图提取，其他 AgentMemory LLM 功能则接收 noop 提供者，外部回退保持禁用；使用经过认证的回环 MCP 端点供 Codex 使用，并保留打包的 stdio 启动器作为兼容路径。上游兼容的源表面包含 58 个 MCP 工具、6 个资源、3 个提示、端口 3111 上的 143 个端点、12 个可移植钩子和 17 项技能，但受支持的 Windows 配置文件有意只激活上述四个受管理钩子。
使用方式上，用户无需先安装上游。安装前需检查 Windows x64、Node.js 24+、Windows PowerShell 5.1 和 Codex 桌面版，然后按照固定的安装指南操作。发布的版本包含预构建运行时，源码构建为可选项。安装器默认执行干运行，会验证发布哈希、所有权、路径和现有安装，确认无误后再使用 --execute 执行。对于空目标，默认路径会准备、激活并验证服务；--fresh 和 --activate-prepared 可用于分离阶段。服务验证通过后，再连接 Codex MCP。如果某一步骤失败，可参考支持与恢复指南，报告发布版本和失败阶段，并附上简短脱敏错误，但不要附加记忆数据库或凭据。
适用场景主要是需要在 Windows 上为 Codex 提供项目级持久记忆和跨项目有界召回的开发者。搜索与过滤方面，正常召回会搜索存储的观察记录和可复用课程，关键词检索使用 BM25 并处理韩语词形变化和字面标识符；在可用时，向量和图存储候选会加入同一排序结果集。图搜索读取现有节点、边和来源引用，不会要求本地 Qwen 回答查询；Qwen 仅用于后台图提取。搜索候选会对照其权威观察和会话进行检查，项目、说话者、归档和环境来源资格在确定返回结果数量前应用。字面代码和引用的源文本会被保留。
限制方面，该预览版为未签名的技术预览，二进制文件未进行 Authenticode 签名，SHA-256 校验仅验证工件完整性而非发布者签名。AdGuard/重定向驱动互操作性尚未合格。在一个 Windows/Codex 主机上的验证并不代表所有主机配置或所有上游兼容操作。已知存在间歇性约六秒的调用方响应延迟，原生 MCP 完成约需 1.4 秒，之后约 4.5 秒调用脚本才恢复，确切原因未知。图排名修复是另一个已确认缺陷，并非该延迟的修复。验证范围覆盖包行为、受管理钩子、捕获/过滤、认证 MCP/REST、图溯源、安装器/恢复和打包 CLI/MCP 入口点，但精确发布结果需查阅发布说明。
