Об этом проекте
# opencode-supermemory
**Постоянная память для OpenCode на базе [Supermemory](https://supermemory.ai)**
Этот плагин предоставляет агентам OpenCode постоянную память между сессиями и проектами. Он автоматически внедряет релевантный контекст, захватывает ходы разговора и предоставляет инструменты для хранения и извлечения воспоминаний.
## Установка
```bash
bunx opencode-supermemory@latest install
bunx opencode-supermemory@latest login # или установите SUPERMEMORY_API_KEY
bunx opencode-supermemory@latest status # проверьте соединение в любое время
```
Или вставьте это в OpenCode: `Install opencode-supermemory by following https://raw.githubusercontent.com/supermemoryai/opencode-supermemory/main/README.md`
Команды в чате: `/supermemory-init`, `/supermemory-login`, `/supermemory-logout`, `/supermemory-status`.
## Возможности
- **Внедрение контекста**: При первом сообщении сессии агент получает ваш профиль, знания о проекте и, при необходимости, семантический поиск по личным воспоминаниям.
- **Обоснованный поиск**: Каждый ход агент решает, поможет ли поиск воспоминаний перед ответом, выполняя поиск через инструмент `supermemory` только при необходимости.
- **Автоматический захват**: Завершенные ходы сохраняются каждые `captureEveryNTurns` ходов, остаток сбрасывается в конце сессии. Содержимое `<private>` редактируется.
- **Обнаружение ключевых слов**: Слова "запомни", "сохрани это", "не забудь" (или пользовательские шаблоны) побуждают агента сохранять в память.
- **Индексация кодовой базы**: `/supermemory-init` исследует и запоминает структуру кодовой базы, шаблоны и соглашения.
- **Упреждающее сжатие**: При 80% заполнении контекста запускает суммаризацию, внедряет проектные воспоминания в сводку и сохраняет сводку как воспоминание.
- **Конфиденциальность**: Содержимое, заключенное в `<private>...</private>`, никогда не сохраняется.
- **Уведомления об обновлениях**: Проверяет npm на наличие новых версий при запуске сессии.
## Использование инструмента
Инструмент `supermemory` поддерживает режимы: `add`, `search`, `profile`, `list`, `forget`, `help`. Области: `user` (личная) и `project` (по умолчанию). Типы включают `project-config`, `architecture`, `error-solution`, `preference`, `learned-pattern`, `conversation`.
## Область памяти
Воспоминания помечаются тегом `repo_{project-name}__{repository-hash}` и метаданными `sm_scope` (личная или проектная). Хэш получается из нормализованного Git origin remote, поэтому Claude Code, Codex, Cursor и OpenCode используют один контейнер для одного репозитория. Устаревшие контейнеры от старых версий остаются читаемыми.
## Конфигурация
Переменные окружения: `SUPERMEMORY_API_KEY`, `SUPERMEMORY_API_URL`/`SUPERMEMORY_BASE_URL`, `SUPERMEMORY_AUTH_URL`, `SUPERMEMORY_AUTH_TIMEOUT`, `SUPERMEMORY_REPO_TAG`, `SUPERMEMORY_ISOLATE_WORKTREES`, `SUPERMEMORY_DEBUG`.
Файл конфигурации `~/.config/opencode/supermemory.jsonc` поддерживает опции, такие как `similarityThreshold`, `maxMemories`, `injectProfile`, `autoRecallEveryPrompt`, `keywordPatterns`, `compactionThreshold`, `captureEveryNTurns`, `recallMode` (direct/advisory/off) и переопределения тегов контейнера.
## Использование с Oh My OpenCode
Отключите его хук авто-сжатия, чтобы избежать конфликтов: добавьте `{"disabled_hooks": ["anthropic-context-window-limit-recovery"]}` в `~/.config/opencode/oh-my-opencode.json`.
## Разработка
```bash
bun install
bun run build
bun run typecheck
```
Логи: `tail -f ~/.opencode-supermemory.log`
## Лицензия
MIT
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.