Skip to content

README.ru.md

Latest commit

 

History

History
431 lines (316 loc) · 24.6 KB

README.ru.md

File metadata and controls

431 lines (316 loc) · 24.6 KB
Raw

🌐 Это автоматический перевод. Приветствуются исправления от сообщества!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Система сжатия постоянной памяти, созданная для Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Быстрый старт • Как это работает • Инструменты поиска • Документация • Конфигурация • Устранение неполадок • Лицензия

Claude-Mem бесшовно сохраняет контекст между сеансами, автоматически фиксируя наблюдения за использованием инструментов, генерируя семантические сводки и делая их доступными для будущих сеансов. Это позволяет Claude поддерживать непрерывность знаний о проектах даже после завершения или переподключения сеансов.

Быстрый старт

Установите одной командой:

npx claude-mem install

Или установите для OpenCode:

npx claude-mem install --ide opencode

Или установите для Antigravity CLI (руководство по настройке):

npx claude-mem install --ide antigravity

Или установите из маркетплейса плагинов внутри Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Перезапустите Claude Code. Контекст из предыдущих сеансов будет автоматически появляться в новых сеансах.

Примечание: Claude-Mem также опубликован на npm, но npm install -g claude-mem устанавливает только SDK/библиотеку — это не регистрирует хуки плагина и не настраивает сервис worker. Всегда устанавливайте через npx claude-mem install или команды /plugin, указанные выше.

🦞 OpenClaw Gateway

Установите claude-mem как плагин постоянной памяти на шлюзах OpenClaw одной командой:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Установщик берёт на себя зависимости, настройку плагина, конфигурацию AI-провайдера, запуск worker и опциональные потоки наблюдений в реальном времени в Telegram, Discord, Slack и другие сервисы. Подробности см. в Руководстве по интеграции OpenClaw.

Ключевые возможности:

  • 🧠 Постоянная память - Контекст сохраняется между сеансами
  • 📊 Прогрессивное раскрытие - Многоуровневое извлечение памяти с видимостью стоимости токенов
  • 🔍 Поиск на основе навыков - Запросы к истории проекта с помощью навыка mem-search
  • 🖥️ Веб-интерфейс просмотра - Поток памяти в реальном времени по URL worker, выводимому при запуске
  • 💻 Навык для Claude Desktop - Поиск в памяти из разговоров Claude Desktop
  • 🔒 Контроль конфиденциальности - Используйте теги <private> для исключения конфиденциального контента из хранилища
  • ⚙️ Настройка контекста - Детальный контроль того, какой контекст внедряется
  • 🤖 Автоматическая работа - Не требуется ручное вмешательство
  • 🔗 Цитирование - Ссылки на прошлые наблюдения по ID через API worker или просмотр всех в веб-интерфейсе

Документация

📚 Просмотреть полную документацию - Просмотр на официальном сайте

Начало работы

Лучшие практики

Архитектура

Конфигурация и разработка

Как это работает

Основные компоненты:

  1. 5 хуков жизненного цикла - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 скриптов хуков)
  2. Умная установка - Проверка кешированных зависимостей (скрипт предварительного хука, не является хуком жизненного цикла)
  3. Сервис Worker - Локальный HTTP API с веб-интерфейсом просмотра и конечными точками поиска, управляемый Bun
  4. База данных SQLite - Хранит сеансы, наблюдения, сводки
  5. Навык mem-search - Запросы на естественном языке с прогрессивным раскрытием
  6. Векторная база данных Chroma - Гибридный семантический + ключевой поиск для интеллектуального извлечения контекста

Подробности см. в Обзоре архитектуры.

Инструменты поиска MCP

Claude-Mem предоставляет интеллектуальный поиск памяти через 4 инструмента MCP, следуя экономичному по токенам паттерну 3-уровневого рабочего процесса:

3-уровневый рабочий процесс:

  1. search - Получить компактный индекс с ID (~50-100 токенов/результат)
  2. timeline - Получить хронологический контекст вокруг интересующих результатов
  3. get_observations - Получить полные детали ТОЛЬКО для отфильтрованных ID (~500-1000 токенов/результат)

Как это работает:

  • Claude использует инструменты MCP для поиска в вашей памяти
  • Начните с search, чтобы получить индекс результатов
  • Используйте timeline, чтобы увидеть, что происходило вокруг конкретных наблюдений
  • Используйте get_observations, чтобы получить полные детали для релевантных ID
  • Экономия токенов примерно в 10 раз благодаря фильтрации перед получением деталей

Доступные инструменты MCP:

  1. search - Поиск по индексу памяти с полнотекстовыми запросами, фильтрация по типу/дате/проекту
  2. timeline - Получение хронологического контекста вокруг конкретного наблюдения или запроса
  3. get_observations - Получение полных деталей наблюдений по ID (всегда группируйте несколько ID в один запрос)

Пример использования:

// Шаг 1: Поиск по индексу
search(query="authentication bug", type="bugfix", limit=10)

// Шаг 2: Просмотрите индекс, определите релевантные ID (например, #123, #456)

// Шаг 3: Получите полные детали
get_observations(ids=[123, 456])

Подробные примеры см. в Руководстве по инструментам поиска.

Ветки релизов

Стабильные релизы выпускаются из main и публикуются в npm. core-dev и community-edge — это ветки, запускаемые из исходного кода, для ранних исправлений надежности и интеграций сообщества. См. Ветки релизов для описания потока веток и инструкций по запуску нестабильных версий.

Системные требования

  • Node.js: 20.0.0 или выше
  • Claude Code: Последняя версия с поддержкой плагинов
  • Bun: Среда выполнения JavaScript и менеджер процессов (автоматически устанавливается при отсутствии)
  • uv: Менеджер пакетов Python для векторного поиска (автоматически устанавливается при отсутствии)
  • SQLite 3: Для постоянного хранения (встроенный)

Примечания по настройке для Windows

Если вы видите ошибку вида:

npm : The term 'npm' is not recognized as the name of a cmdlet

Убедитесь, что Node.js и npm установлены и добавлены в ваш PATH. Загрузите последнюю версию установщика Node.js с https://nodejs.org и перезапустите терминал после установки.

Конфигурация

Настройки управляются в ~/.claude-mem/settings.json (автоматически создается с настройками по умолчанию при первом запуске). Настройте AI-модель, порт worker, директорию данных, уровень логирования и параметры внедрения контекста.

Все доступные настройки и примеры см. в Руководстве по конфигурации.

Настройка режима и языка

Claude-Mem поддерживает несколько режимов рабочего процесса и языков через настройку CLAUDE_MEM_MODE.

Эта опция управляет одновременно:

  • Поведением рабочего процесса (например, code, chill, investigation)
  • Языком, используемым в сгенерированных наблюдениях

Как настроить

Отредактируйте файл настроек по адресу ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Режимы определены в plugin/modes/. Чтобы увидеть все доступные режимы локально:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Доступные режимы

Режим Описание
code Стандартный английский режим
code--zh Режим упрощенного китайского
code--ja Японский режим

Языковые режимы следуют шаблону code--[lang], где [lang] — это код языка ISO 639-1 (например, zh для китайского, ja для японского, es для испанского).

Примечание: code--zh (упрощенный китайский) уже встроен — дополнительная установка или обновление плагина не требуются.

После изменения режима

Перезапустите Claude Code, чтобы применить новую конфигурацию режима.

Разработка

Инструкции по сборке, тестированию и процессу участия в разработке см. в Руководстве по разработке.

Устранение неполадок

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

Распространенные проблемы и решения см. в Руководстве по устранению неполадок.

Отчеты об ошибках

Создавайте подробные отчеты об ошибках с помощью автоматического генератора:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Участие в разработке

Приветствуются вклады! Пожалуйста:

  1. Форкните репозиторий
  2. Создайте ветку для функции
  3. Внесите изменения с тестами
  4. Обновите документацию
  5. Отправьте Pull Request

Claude-Mem выпускается из трёх веток: main (стабильная), core-dev и community-edge. Только main публикуется в npm; остальные запускаются из исходного кода. См. Ветки релизов для описания стратегии и инструкций по локальному запуску.

Процесс участия см. в Руководстве по разработке.

Лицензия

Claude-Mem распространяется под лицензией Apache License 2.0.

Мы выбрали Apache-2.0, потому что устойчивая агентная память должна легко встраиваться в инструменты разработчиков, локальных агентов, серверы MCP, корпоративные системы, робототехнические стеки и производственные среды исполнения агентов.

Полные детали см. в файле LICENSE. См. также docs/license.md и docs/ip-boundary.md для описания области действия лицензии и границы между открытым и коммерческим использованием.

Примечание о Ragtime: Директория ragtime/ лицензирована под Apache License 2.0. Подробности см. в ragtime/LICENSE.

Поддержка

Создано с помощью Claude Agent SDK | Работает на Claude Code | Сделано на TypeScript

А что насчёт CMEM?

CMEM — это токен, созданный третьей стороной, но официально признанный создателем Claude-Mem (Alex Newman, @thedotmack). Токен выступает в роли катализатора роста сообщества и средства для доставки CMEM разработчикам и специалистам умственного труда, которым он нужен больше всего.

Официальный BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3