AI Cloud Memory Community Edition

Ваша собственная общая память, проектная доска и долгосрочная дорожная карта для AI-клиентов, работающая в вашем аккаунте Cloudflare и принадлежащая вам через вашу личность GitHub.

AI Cloud Memory предоставляет Codex, Claude Code, OpenCode и совместимым веб-клиентам одну аутентифицированную конечную точку MCP для долговременной памяти и работы с жизненным циклом проекта. D1 является каноническим. По умолчанию поиск работает в лексическом и временном режимах, а Vectorize и Workers AI можно включить позже для семантического поиска и реранжирования.

Не требуется n8n, домашний сервер, аккаунт поставщика или сервис, управляемый этим проектом. Каждый пользователь разворачивает изолированную копию в своих собственных аккаунтах Cloudflare и GitHub.

Что вы получаете

• Только владелец: GitHub OAuth и ограниченный MCP OAuth

• Память и постоянные директивы с происхождением, метками, архивом, заменой и рецензированием

• Проекты, задачи Kanban, квитанции о завершении, архивированные работы и история Done

• Долгосрочные дорожные карты проектов с безопасным продвижением в задачи

• Обработка временных запросов, ограниченные повышения ранжирования и семантическая дедупликация

• Объяснимые результаты поиска и частный эталон релевантности

• Управляемая проекция Obsidian Markdown и переносимые зашифрованные экспорты

• Адаптивная панель управления для настольных и мобильных Safari

• 24 узконаправленных MCP-инструмента cloudmemory_*

• Необязательные коннекторы и учётные данные автоматизации, без превращения платформы автоматизации в зависимость

Архитектура

Codex · Claude · OpenCode · compatible web clients
                         │
                 OAuth-protected MCP
                         │
             Cloudflare Worker + dashboard
                ┌────────┼────────┐
                │        │        │
               D1       KV    Static assets
           canonical   OAuth      UI
                │
       optional derived services
       Vectorize · Workers AI
                │
       optional encrypted export
             your GitHub repo

Worker, база данных, состояние OAuth и необязательный AI-индекс принадлежат пользователю. Публичный проект не имеет центрального сервиса памяти и не имеет доступа к развёрнутым экземплярам. См. Архитектура и Конфиденциальность.

Развёртывание

1. Создайте свою копию

Используйте кнопку Deploy to Cloudflare выше. Cloudflare может создать копию GitHub и предоставить поддерживаемые привязки Worker из wrangler.jsonc.

Если автоматическое предоставление Vectorize недоступно в вашем аккаунте, создайте необязательный индекс перед включением семантического поиска:

npx wrangler vectorize create ai-cloud-memory --dimensions=768 --metric=cosine

Держите SEMANTIC_SEARCH_ENABLED=false, пока этот индекс не существует. Базовый продукт не вызывает Workers AI или Vectorize в этом режиме.

2. Выберите окончательный URL

Используйте сгенерированный источник workers.dev или прикрепите ваш окончательный пользовательский домен. Запишите точный источник HTTPS без завершающего слэша, например:

https://ai-cloud-memory.your-subdomain.workers.dev

Установите PUBLIC_ORIGIN на этот источник. auto полезен только при первоначальном развёртывании. Установка окончательного источника перед созданием GitHub OAuth позволяет избежать второй миграции обратного вызова OAuth.

3. Создайте приложение GitHub OAuth

В GitHub откройте Settings → Developer settings → OAuth Apps → New OAuth App.

Запишите идентификатор клиента и сгенерируйте секрет клиента. Никогда не коммитьте секрет.

4. Настройте блокировку владельца

Установите эти несекретные переменные Worker в wrangler.jsonc или на панели управления Cloudflare:

ALLOWED_GITHUB_USER_ID=your numeric GitHub user ID
ALLOWED_GITHUB_LOGIN=your GitHub login
PUBLIC_ORIGIN=https://your-final-origin.example
SEMANTIC_SEARCH_ENABLED=false

Числовой идентификатор пользователя является неизменяемой границей безопасности; логин — это отображаемые метаданные. Установите секреты из доверенного терминала:

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET
openssl rand -hex 32 | npx wrangler secret put COOKIE_ENCRYPTION_KEY

5. Миграция и развёртывание

npm ci
npm run check
npm run deploy

Команда развёртывания намеренно публикуется дважды на новом аккаунте: первый проход позволяет Cloudflare автоматически предоставить объявленные ресурсы, затем миграции инициализируют D1, а финальный проход становится проверенным релизом приложения. Заглушка блокировки владельца делает начальное развёртывание недоступным, пока вы не замените её.

Затем откройте /setup.html на вашем развёрнутом источнике для локального чек-листа, доступного только в браузере. Полные инструкции находятся в Развёртывание и Онбординг.

Подключение AI-клиента

Ваша удалённая конечная точка MCP:

https://your-final-origin.example/mcp

Обычные нативные клиенты:

# Codex
codex mcp add cloud-memory --url https://your-final-origin.example/mcp

# Claude Code
claude mcp add --transport http cloud-memory https://your-final-origin.example/mcp

OpenCode может использовать удалённую запись MCP в opencode.json:

{
  "mcp": {
    "cloud-memory": {
      "type": "remote",
      "url": "https://your-final-origin.example/mcp",
      "enabled": true
    }
  }
}

Завершите OAuth отдельно в каждом клиенте. Проверьте cloudmemory_health, cloudmemory_board, безвредный поиск и одну явно одобренную запись. Возможности веб-клиентов и ограничения планов различаются. См. Настройка клиента.

Обязательные и необязательные сервисы

Лимиты и цены Cloudflare могут меняться. Проверьте текущие цены Workers, цены D1, цены Vectorize и цены Workers AI перед включением необязательных сервисов. Этот проект не включает платное использование или выставление счетов от вашего имени.

Семантический поиск

Безопасный вариант по умолчанию — только лексический:

SEMANTIC_SEARCH_ENABLED=false

Новые воспоминания остаются каноническими в D1 с состоянием ожидающего вектора. Когда вы установите переменную в true, разверните, затем выберите Repair index в настройках, Cloud Memory заполнит векторы ограниченными пакетами. Настроенная модель BGE использует 768-мерный косинусный индекс. См. Семантический поиск.

Резервное копирование и восстановление

Панель управления может создать зашифрованную загрузку без токена GitHub. Для необязательной доставки GitHub требуется:

• EXPORT_ENCRYPTION_KEY, хранящийся в безопасном месте вне репозитория

• GITHUB_EXPORT_TOKEN, детализированный токен с доступом к Contents в одном резервном репозитории

• GITHUB_EXPORT_REPOSITORY, в форме owner/repository

Потеря ключа шифрования делает существующие зашифрованные экспорты невосстановимыми. D1 остаётся каноническим; выходные данные Obsidian и GitHub являются проекциями и артефактами восстановления, а не параллельными писателями.

Локальная разработка

Требуется Node.js 22.12 или новее.

npm ci
npm run dev
npm run check

Полная проверка запускает проверку безопасности репозитория, проверку шаблона развёртывания, линтер, проверку типов, модульные тесты, тесты Worker/D1 и производственную сборку.

Управление проектом

• Политика безопасности

• Внесение вклада

• Поддержка

• Кодекс поведения

• Журнал изменений

Автоматическое рецензирование Codex Cloud не является частью AI Cloud Memory. Сопровождающие могут подключить этот репозиторий GitHub к среде Codex Cloud как внешнее администрирование репозитория; никакой агент рецензирования, токен или функция не поставляются в продукте.

Лицензия

MIT. Cloudflare, GitHub, Claude, ChatGPT, Codex, OpenCode, Obsidian и n8n являются товарными знаками их соответствующих владельцев и не связаны с этим проектом.