Skip to content

README.ru.md

Latest commit

 

History

History
227 lines (158 loc) · 8.67 KB

README.ru.md

File metadata and controls

227 lines (158 loc) · 8.67 KB

@rvboris/opencode-mempalace

Персистентная память для OpenCode — нулевая конфигурация, видимый результат.

Твой ИИ-ассистент забывает всё между сессиями. Этот плагин это исправляет. Он незаметно сохраняет важное и находит его, когда нужно — без лишних подсказок и ручной работы.

English version

Что он делает

Перед каждым ответом плагин ищет в памяти релевантный контекст. После каждой сессии — тихо сохраняет устойчивые знания. Тебе не нужно говорить «запомни это» — но если скажешь, плагин услышит.

Ты: "Какую систему сборки мы используем?"
ИИ:  [ищет в памяти] → "Bun. Это решение приняли 10 апреля."

Результат

  • Ответы, опирающиеся на прошлые решения, предпочтения и историю проекта
  • Не нужно повторять объяснения от сессии к сессии
  • Приватность: секреты и приватные блоки никогда не сохраняются
  • Работает полностью локально — без облака, API-ключей и MCP-сервера

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

Требования: OpenCode и Python 3.10+ с pip.

pip install mempalace
mempalace init ~/.mempalace/palace

Добавь в opencode.json:

{
  "plugin": ["@rvboris/opencode-mempalace"]
}

Готово. Поиск по памяти, автосохранение и оба инструмента активны сразу.

Возможности

Скрытый поиск

Перед каждым ответом плагин подставляет инструкцию «сначала проверь память». Модель видит релевантный контекст без лишнего шума в чате.

Фоновое автосохранение

При простое сессии, компактизации или завершении — плагин анализирует транскрипт, извлекает устойчивые факты и сохраняет их в нужную область памяти.

mempalace_memory — единый инструмент

Четыре режима, один интерфейс:

Режим Назначение
save Сохранить предпочтение, факт или решение
search Найти релевантную память по запросу
kg_add Добавить структурированный факт в граф знаний
diary_write Записать короткую рабочую заметку

Примеры:

mempalace_memory  mode: save  scope: user  room: preferences  content: Предпочитает краткие ответы.

mempalace_memory  mode: search  scope: project  room: decisions  query: система сборки

mempalace_memory  mode: kg_add  subject: my-repo  predicate: uses  object: bun

mempalace_status — видимое доказательство

Проверь, реально ли плагин помогает:

mempalace_status

Показывает процент попаданий при поиске, последний результат автосохранения, превью памяти и накопительные счётчики. Для полного отчёта — verbose: true.

TUI HUD — статистика памяти в строке промпта

Компактная строка статистики текущей сессии в области ввода OpenCode:

MEM hits 3 · saved 2 · failed 0 · writes 1

Цветовые индикаторы для SKIPPED и FAILED. Требует записи в tui.json (см. ниже).

Области памяти

Память пользователя — кросс-проектные предпочтения и привычки:

  • preferences — стиль кода, предпочтения общения
  • workflow — рабочие паттерны, выбор инструментов
  • communication — язык, формат ответов

Память проекта — знания, привязанные к репозиторию:

  • architecture — архитектурные решения, паттерны
  • workflow — команды сборки, CI-конфиг
  • decisions — ADR, компромиссы
  • bugs — известные баги, обходные пути
  • setup — настройка окружения, зависимости

Приватность

  • Блоки <private>...</private> уважаются и никогда не сохраняются
  • Типовые секреты (API-ключи, токены, пароли) скрываются перед записью
  • Полностью приватное содержимое пропускается целиком

Настройка

Необязательный файл конфигурации: ~/.config/opencode/mempalace.jsonc

{
  "autosaveEnabled": true,
  "retrievalEnabled": true,
  "keywordSaveEnabled": true,
  "maxInjectedItems": 6,
  "retrievalQueryLimit": 5,
  "privacyRedactionEnabled": true
}

Переменные окружения:

Переменная Назначение
MEMPALACE_AUTOSAVE_ENABLED Включить/выключить фоновое автосохранение
MEMPALACE_RETRIEVAL_ENABLED Включить/выключить скрытый поиск
MEMPALACE_KEYWORD_SAVE_ENABLED Включить/выключить сохранение по ключевым словам
MEMPALACE_PRIVACY_REDACTION_ENABLED Включить/выключить скрытие секретов
MEMPALACE_ADAPTER_PYTHON Путь к бинарнику Python
MEMPALACE_ADAPTER_TIMEOUT_MS Таймаут адаптера (по умолчанию 15000)

Настройка TUI HUD

Чтобы включить отображение статистики в строке промпта, добавь tui.json в каталог конфигурации OpenCode:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": [
    "file:///путь/до/mempalace-autosave/plugin/tui/index.tsx"
  ]
}

Или при установке из npm — используй пакетный вход:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["@rvboris/opencode-mempalace/tui"]
}

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

Сообщение пользователя
  → системный хук подставляет «сначала проверь память»
  → модель вызывает mempalace_memory [search]
  → результаты влияют на ответ

Сессия завершается / простаивает
  → хук событий анализирует транскрипт
  → Python-адаптер сохраняет устойчивые факты через MemPalace

Плагин использует локальную Python-прослойку (bridge/mempalace_adapter.py) для работы с MemPalace. Ему не нужен MCP-сервер MemPalace.

Совместимость

Требование Версия
OpenCode latest
Python 3.10+
MemPalace 3.3+
ОС macOS, Linux, Windows

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

  • Changelog — история изменений
  • Contributing — правила ведения changelog

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

git clone https://github.com/rvboris/opencode-mempalace.git
cd opencode-mempalace/mempalace-autosave
npm install
npm run build

Загрузка из исходников в opencode.json:

{
  "plugin": ["file:///ABSOLUTE/PATH/TO/mempalace-autosave/plugin/index.ts"]
}

Отладка: opencode --log-level DEBUG или файл ~/.mempalace/opencode_autosave.log.

Ссылки

Лицензия

MIT