AgentMemory для Codex на Windows

Независимый, нативный для Windows форк AgentMemory для OpenAI Codex Desktop и Codex CLI.

English | 한국어 | 日本語

[!IMPORTANT] Это независимый технический предварительный просмотр только с исходным кодом. Он основан на AgentMemory v0.9.29, но это не официальный вышестоящий репозиторий, не npm-релиз @agentmemory/* и не обещание поддержки вышестоящего проекта. Не используйте вышестоящую команду npx или манифесты плагинов совместимости в качестве замены сборки и установщика для Windows, описанных здесь.

Примечание по разработке: этот форк создан с помощью ИИ и протестирован пользователями; прочтите полное раскрытие.

Что делает этот предварительный просмотр

AgentMemory сохраняет полезный контекст между задачами Codex, сохраняя при этом официальные хранилища памяти, уроков, графов, аудита и происхождения AgentMemory как единственные канонические хранилища.

• Захватывает обычные пользовательские подсказки главного агента и финальные ответы ассистента через четыре управляемых хука Codex: SessionStart, UserPromptSubmit, Stop и SessionEnd.

• Исключает из долговременного захвата фоновый UI, трафик заголовков/форков, известные внутренние подсказки хоста и трафик субагентов.

• Ограничивает запись, удаление, курирование и происхождение строго рамками текущего проекта.

• Поддерживает ограниченный федеративный поиск с метками источников между проектами без разрешения шаблонной записи.

• Может использовать локальный воркер Qwen без учетных данных, работающий только через loopback, для типизированного извлечения графов. Все остальные функции LLM в AgentMemory получают провайдер noop; внешние запасные варианты остаются отключенными.

• Использует аутентифицированную конечную точку MCP через loopback для Codex и сохраняет упакованный stdio-лаунчер только как путь совместимости.

Совместимая с вышестоящим проектом исходная поверхность содержит 56 MCP-инструментов. Его MCP-поверхность — это 56 инструментов, 6 ресурсов и 3 подсказки; также имеется 133 конечные точки на порту 3111, 12 переносимых хуков и 17 навыков. Поддерживаемый профиль Windows намеренно активирует только четыре управляемых хука, перечисленных выше.

Related MCP server: remem

Идентификаторы версий

Точный вышестоящий тег, коммит, дерево и оригинальный хеш пакета записаны в upstream-source.json.

Требования

• Windows с PowerShell 5.1 или новее; этот предварительный просмотр квалифицирован на 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

Обычный сборщик проверяет закрепленный нативный вход, восстанавливает замороженный lock-файл, проверяет сгенерированные навыки, выполняет проверку типов, собирает проект, запускает тесты пакета и адаптера Codex, создает производственное дерево зависимостей и записывает полный неизменяемый манифест файлов.

Установщик по умолчанию работает в режиме пробного запуска (dry-run). Он проверяет хеши релиза, права владения, пути и существующую установку перед внесением любых изменений. Внимательно изучите точный контракт сборки, пробного запуска, переключения, отката, хранения и аутентификации в packaging/windows-codex/README.md перед использованием -Execute.

[!WARNING] Установщик Windows предназначен для управляемой, поддерживаемой компоновки службы AgentMemoryCodex. Не указывайте ему на посторонний каталог и не относитесь к выходным данным сборки как к пользовательским данным. Канонические data, секреты, журналы, идентичность задач и состояние отката имеют независимые жизненные циклы.

Границы конфиденциальности и безопасности

• Трафик MCP и службы остается на аутентифицированных конечных точках loopback в поддерживаемом профиле.

• Необязательный провайдер Qwen принимает только HTTP без учетных данных через loopback и ограничен по возможностям извлечением графов.

• Дерево исходного кода не содержит базы данных памяти, стенограмм сессий, пользовательских экспортов, ключей API, сгенерированных установщиков или личной истории разработки.

• Сообщения об уязвимостях безопасности следует отправлять через приватный поток сообщений об уязвимостях GitHub; см. SECURITY.md.

Карта репозитория

Маркетинговый сайт вышестоящего проекта, примеры облачного развертывания, другие копии вышестоящего проекта на других языках, сгенерированные выходные данные сборки и приватная история монорепозитория намеренно исключены из первого публичного снимка репозитория. Исторические бенчмарк-материалы сохранены только для воспроизводимости и явно помечены как справочные материалы вышестоящего проекта; ни один показатель бенчмарка в этих каталогах не является заявлением для этого предварительного просмотра форка.

Проверки разработки

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.

Раскрытие информации о разработке с ИИ

Большинство изменений в форке были сгенерированы и доработаны OpenAI Codex на основе требований пользователя и итеративных запросов на принятие. Владелец репозитория не проверял исходный код вручную. Проверка основана на автоматизированных тестах и живом функциональном тестировании в среде Windows/Codex владельца. Независимый сторонний аудит кода или безопасности не проводился.

Кратко: сгенерировано ИИ, протестировано пользователем, не проверено вручную.

Атрибуция вышестоящему проекту и лицензия

Этот форк основан на AgentMemory от Рохита Гумаре и участников. См. NOTICE и upstream-source.json для атрибуции и точной идентичности исходного кода. Код предоставляется под лицензией Apache License 2.0.