🌐 Это автоматический перевод. Приветствуются исправления от сообщества!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Система сжатия постоянной памяти, созданная для Claude Code.
Быстрый старт • Как это работает • Инструменты поиска • Документация • Конфигурация • Устранение неполадок • Лицензия
Claude-Mem бесшовно сохраняет контекст между сеансами, автоматически фиксируя наблюдения за использованием инструментов, генерируя семантические сводки и делая их доступными для будущих сеансов. Это позволяет Claude поддерживать непрерывность знаний о проектах даже после завершения или переподключения сеансов.
Запустите новый сеанс Claude Code в терминале и введите следующие команды:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Перезапустите Claude Code. Контекст из предыдущих сеансов будет автоматически появляться в новых сеансах.
Ключевые возможности:
- 🧠 Постоянная память - Контекст сохраняется между сеансами
- 📊 Прогрессивное раскрытие - Многоуровневое извлечение памяти с видимостью стоимости токенов
- 🔍 Поиск на основе навыков - Запросы к истории проекта с помощью навыка mem-search
- 🖥️ Веб-интерфейс просмотра - Поток памяти в реальном времени на http://localhost:37777
- 💻 Навык для Claude Desktop - Поиск в памяти из разговоров Claude Desktop
- 🔒 Контроль конфиденциальности - Используйте теги
<private>для исключения конфиденциального контента из хранилища - ⚙️ Настройка контекста - Детальный контроль того, какой контекст внедряется
- 🤖 Автоматическая работа - Не требуется ручное вмешательство
- 🔗 Цитирование - Ссылки на прошлые наблюдения с помощью ID (доступ через http://localhost:37777/api/observation/{id} или просмотр всех в веб-интерфейсе на http://localhost:37777)
- 🧪 Бета-канал - Попробуйте экспериментальные функции, такие как режим Endless, переключая версии
📚 Просмотреть полную документацию - Просмотр на официальном сайте
- Руководство по установке - Быстрый старт и продвинутая установка
- Руководство по использованию - Как Claude-Mem работает автоматически
- Инструменты поиска - Запросы к истории проекта на естественном языке
- Бета-функции - Попробуйте экспериментальные функции, такие как режим Endless
- Инженерия контекста - Принципы оптимизации контекста для AI-агентов
- Прогрессивное раскрытие - Философия стратегии подготовки контекста в Claude-Mem
- Обзор - Компоненты системы и поток данных
- Эволюция архитектуры - Путь от v3 к v5
- Архитектура хуков - Как Claude-Mem использует хуки жизненного цикла
- Справочник по хукам - Объяснение 7 скриптов хуков
- Сервис Worker - HTTP API и управление Bun
- База данных - Схема SQLite и поиск FTS5
- Архитектура поиска - Гибридный поиск с векторной базой данных Chroma
- Конфигурация - Переменные окружения и настройки
- Разработка - Сборка, тестирование, участие в разработке
- Устранение неполадок - Распространенные проблемы и решения
Основные компоненты:
- 5 хуков жизненного цикла - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 скриптов хуков)
- Умная установка - Проверка кешированных зависимостей (скрипт предварительного хука, не является хуком жизненного цикла)
- Сервис Worker - HTTP API на порту 37777 с веб-интерфейсом просмотра и 10 конечными точками поиска, управляемый Bun
- База данных SQLite - Хранит сеансы, наблюдения, сводки
- Навык mem-search - Запросы на естественном языке с прогрессивным раскрытием
- Векторная база данных Chroma - Гибридный семантический + ключевой поиск для интеллектуального извлечения контекста
Подробности см. в Обзоре архитектуры.
Claude-Mem предоставляет интеллектуальный поиск через навык mem-search, который автоматически вызывается, когда вы спрашиваете о прошлой работе:
Как это работает:
- Просто спросите естественно: "Что мы делали в прошлом сеансе?" или "Мы исправляли этот баг раньше?"
- Claude автоматически вызывает навык mem-search для поиска релевантного контекста
Доступные операции поиска:
- Поиск наблюдений - Полнотекстовый поиск по наблюдениям
- Поиск сеансов - Полнотекстовый поиск по сводкам сеансов
- Поиск запросов - Поиск исходных пользовательских запросов
- По концепции - Поиск по тегам концепций (discovery, problem-solution, pattern и т.д.)
- По файлу - Поиск наблюдений, ссылающихся на конкретные файлы
- По типу - Поиск по типу (decision, bugfix, feature, refactor, discovery, change)
- Недавний контекст - Получение недавнего контекста сеанса для проекта
- Хронология - Получение единой хронологии контекста вокруг определенного момента времени
- Хронология по запросу - Поиск наблюдений и получение контекста хронологии вокруг наилучшего совпадения
- Справка по API - Получение документации по API поиска
Примеры запросов на естественном языке:
"Какие баги мы исправили в прошлом сеансе?" "Как мы реализовали аутентификацию?" "Какие изменения были внесены в worker-service.ts?" "Покажи недавнюю работу над этим проектом" "Что происходило, когда мы добавляли интерфейс просмотра?"
Подробные примеры см. в Руководстве по инструментам поиска.
Claude-Mem предлагает бета-канал с экспериментальными функциями, такими как режим Endless (биомиметическая архитектура памяти для расширенных сеансов). Переключайтесь между стабильной и бета-версиями из веб-интерфейса на http://localhost:37777 → Settings.
Подробности о режиме Endless и способах его опробовать см. в Документации по бета-функциям.
- Node.js: 18.0.0 или выше
- Claude Code: Последняя версия с поддержкой плагинов
- Bun: Среда выполнения JavaScript и менеджер процессов (автоматически устанавливается при отсутствии)
- uv: Менеджер пакетов Python для векторного поиска (автоматически устанавливается при отсутствии)
- SQLite 3: Для постоянного хранения (встроенный)
Настройки управляются в ~/.claude-mem/settings.json (автоматически создается с настройками по умолчанию при первом запуске). Настройте AI-модель, порт worker, директорию данных, уровень логирования и параметры внедрения контекста.
Все доступные настройки и примеры см. в Руководстве по конфигурации.
Инструкции по сборке, тестированию и процессу участия в разработке см. в Руководстве по разработке.
При возникновении проблем опишите проблему Claude, и навык устранения неполадок автоматически выполнит диагностику и предоставит исправления.
Распространенные проблемы и решения см. в Руководстве по устранению неполадок.
Создавайте подробные отчеты об ошибках с помощью автоматического генератора:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Приветствуются вклады! Пожалуйста:
- Форкните репозиторий
- Создайте ветку для функции
- Внесите изменения с тестами
- Обновите документацию
- Отправьте Pull Request
Процесс участия см. в Руководстве по разработке.
Этот проект лицензирован под GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Все права защищены.
Полные сведения см. в файле LICENSE.
Что это означает:
- Вы можете свободно использовать, модифицировать и распространять это программное обеспечение
- Если вы модифицируете и развертываете на сетевом сервере, вы должны сделать свой исходный код доступным
- Производные работы также должны быть лицензированы под AGPL-3.0
- Для этого программного обеспечения НЕТ ГАРАНТИЙ
Примечание о Ragtime: Директория ragtime/ лицензирована отдельно под PolyForm Noncommercial License 1.0.0. Подробности см. в ragtime/LICENSE.
- Документация: docs/
- Проблемы: GitHub Issues
- Репозиторий: github.com/thedotmack/claude-mem
- Автор: Alex Newman (@thedotmack)
Создано с помощью Claude Agent SDK | Работает на Claude Code | Сделано на TypeScript
