适用于 Windows 上 Codex 的 AgentMemory

面向 OpenAI Codex Desktop 和 Codex CLI 的独立、Windows 原生 AgentMemory 下游分支。

英文 | 한국어 | 日本語

[!IMPORTANT] 这是一个仅提供源代码的独立技术预览。它基于 AgentMemory v0.9.29，但它 不是官方上游仓库，不是 @agentmemory/* 的 npm 发布版，也不是对上游支持的 承诺。请勿使用上游 npx 命令或兼容性插件清单来代替本文介绍的 Windows 构建与安装程序。

开发说明：本下游分支由 AI 生成并经过用户测试；阅读完整披露。

此预览的功能

AgentMemory 在 Codex 任务之间保留有用的上下文，同时把官方 AgentMemory 的 memory（记忆）、lesson（经验）、graph（图谱）、audit（审计）和 provenance（来源）存储作为唯一权威存储。

• 通过四个受管理的 Codex 钩子捕获正常的主代理用户提示和最终助手响应：SessionStart、UserPromptSubmit、Stop 和 SessionEnd。

• 将环境 UI、标题/分支流量、已知的内部主机提示和子代理流量排除在持久捕获之外。

• 将写入、删除、整理（curation）和 provenance（来源）严格限定在精确的项目作用域内。

• 支持跨项目的受限的、带来源标签的联邦召回（federated recall），同时不允许通配符写入。

• 可以使用无需凭据、仅限回环（loopback）的本地 Qwen 工作进程进行类型化图谱提取。AgentMemory 的所有其他 LLM 功能都会使用 noop 提供程序；外部回退保持禁用。

• 为 Codex 使用经过身份验证的回环 MCP 端点，并且仅保留打包的 stdio 启动器作为兼容路径。

与上游兼容的源码接口面包含 56 个 MCP 工具。其 MCP 接口面为 56 个工具、6 个资源和 3 个提示词；此外还有 3111 端口上的 133 个端点、12 个可移植钩子和 17 项技能。受支持的 Windows 配置有意只激活上面列出的四个受管理钩子。

Related MCP server: remem

版本标识

精确的上游标签、提交、目录树和原始包哈希记录在 upstream-source.json 中。

系统要求

• 装有 PowerShell 5.1 或更高版本的 Windows；本预览已在 Windows 11 上通过验证

• Node.js 20 或更高版本

• 通过仓库固定的包管理器声明使用 pnpm 11.19.0

• 官方 iii 引擎 0.11.2 的 Windows 可执行文件，其 SHA-256 与 packaging/windows-codex/config/third-party-inputs.json 匹配

第一个源码预览未附带任何预构建或已签名的安装程序。

从源码构建与评估

在 Windows 上克隆仓库，然后在 PowerShell 中运行发布构建器。输出目录必须尚不存在。

git clone https://github.com/M-T-D-N/agentmemory-codex-windows.git
Set-Location agentmemory-codex-windows

& .\packaging\windows-codex\Build-WindowsCodex.ps1 `
  -OutputDirectory D:\staging\agentmemory-codex `
  -IiiEnginePath D:\inputs\iii-0.11.2.exe

常规构建器会验证固定的原生输入、还原冻结的锁文件、检查生成的技能、进行类型检查、执行构建、运行包测试与 Codex 适配器测试、创建生产依赖树，并写入完整的不可变文件清单。

安装程序默认进行试运行。在更改任何内容之前，它会验证发布哈希、所有权、路径和现有安装。在使用 -Execute 之前，请阅读 packaging/windows-codex/README.md 中关于构建、试运行、切换、回滚、保留和身份验证的确切约定。

[!WARNING] Windows 安装程序是为自有、受管理的 AgentMemoryCodex 服务布局设计的。请勿 将其指向不相关的目录，也不要把构建输出当作用户数据。权威的 data、机密、 日志、任务标识和回滚状态具有独立的生命周期。

隐私与安全边界

• 在受支持的配置中，MCP 和服务流量始终位于经过身份验证的回环端点上。

• 可选的 Qwen 提供程序只接受无需凭据的回环 HTTP，且其能力范围仅限于图谱提取。

• 源码树中不包含记忆数据库、会话记录、用户导出、API 密钥、生成的安装程序或私有开发历史。

• 安全报告应使用 GitHub 的私有漏洞报告流程；请参阅 SECURITY.md。

仓库结构

上游营销网站、云部署示例、上游的其他语言版本、生成的构建输出和私有 monorepo 历史都被有意排除在首个公共仓库快照之外。历史基准资料仅出于可复现性而保留，并明确标注为上游参考；这些目录中的任何基准数字都不构成对本下游预览的声明。

开发检查

pnpm install --frozen-lockfile
pnpm run skills:check
pnpm run typecheck
pnpm run build
pnpm test
node packaging/windows-codex/tests/codex-turn.test.mjs

仓库在包清单中被标记为 private，以防止在 @agentmemory/* 上游包名下被意外发布。贡献请遵循 CONTRIBUTING.md，下游发布历史见 CHANGELOG.md。

AI 开发披露

大多数下游修改由 OpenAI Codex 根据用户提供的需求和迭代验收请求生成并修订。仓库所有者没有人工审查源代码。验证基于自动化测试以及在所有者 Windows/Codex 环境中进行的实际功能测试。尚未进行独立的第三方代码或安全审计。

简而言之： AI 生成、用户测试、未经人工代码审查。

上游署名与许可证

本下游分支基于 Rohit Ghumare 及其贡献者开发的 AgentMemory。署名与精确的源码身份请参见 NOTICE 和 upstream-source.json。代码依据 Apache License 2.0 提供。