dsh-engram-memory
Verified@app-apopov/dsh-engram-memory · v0.3.1 · MIT · Web UI
Project-scoped memory for DSH backed by Engram: memory_save, memory_search, memory_context and memory_delete keep each project's memory inside its own folder, and the plugin page lets you browse, edit and delete it.
Install
dsh plugin add @app-apopov/dsh-engram-memory Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
@app-apopov/dsh-engram-memory
Память для DSH поверх локального Engram: четыре инструмента, которые сами находят проект по рабочей папке сессии и держат общий слой для всех проектов.
Зачем плагин, если есть MCP
MCP-сервер памяти DSH запускает в каталоге профиля (~/.dsh/profiles/<profile>), а не в папке проекта, и не знает, какая папка выбрана в сессии. Поэтому проект приходилось указывать руками в каждом вызове, а забытый вызов сваливал записи в общий бакет.
Плагин берёт проект из agent.session.header.cwd — рабочей папки конкретной сессии — и не требует ни инициализации, ни имени проекта в аргументах.
Инструменты
| Инструмент | Что делает |
|---|---|
memory_save |
Сохраняет запись в проект текущей сессии. scope: "global" — в общий проект global. Типы: manual, decision, architecture, bugfix, pattern, config, discovery, learning. |
memory_search |
Ищет по текущему проекту и по global сразу и склеивает выдачу. all: true — поиск по всем проектам. |
memory_context |
Последние записи текущего проекта и global — для восстановления контекста в начале сессии. |
memory_delete |
Удаляет записи по ids или чистит базу целиком (all: true) в текущем проекте или в global. По умолчанию мягкое удаление, hard: true стирает строки навсегда. Чужие проектные базы инструменту недоступны. |
Память проекта лежит внутри самого проекта — в <папка>/.dsh-memory/engram.db. Переименовали или перенесли папку — память переехала вместе с ней, даже на другую машину. Общий слой хранится отдельно, в ~/.engram/engram.db, и никуда не переезжает.
Страница плагина
В Plugins → Memory (страница бандла) есть таблица памяти: выбор базы (проекты этой машины и общий слой global), список записей с типом, областью и датой, кнопки «Изменить» и «Удалить».
- В строке редактирования меняются название и содержание; сохранение идёт через
PATCH /observations/<id>. - Удаление спрашивает подтверждение и стирает запись через
DELETE /observations/<id>. - Список проектов ведётся в
~/.dsh/engram-memory/projects.json— это те папки, где память уже использовалась. Новый проект появляется в списке после первой записи или поиска в нём. - Всё это работает через авторизованный маршрут
/api/engram-memory; клиентская половина ничего не читает из базы напрямую.
Установка
cd ~/.dsh/profiles/desktop
pnpm add link:/Users/ruelephant/dev-project/deepseek/plugins/engram-memory
Затем имя бандла добавляется в dsh.profile.bundles в package.json профиля:
"@app-apopov/dsh-engram-memory"
Плагин подхватывается без перезапуска, когда DSH перечитывает состав профиля.
Требования
- Установленный
engram(brew install gentleman-programming/tap/engramилиgo install github.com/Gentleman-Programming/engram/cmd/[email protected]). - Общая база —
~/.engram/engram.db, база проекта —<папка>/.dsh-memory/engram.db.
Конфигурация
Поля необязательные; по умолчанию команда ищется в ENGRAM_BIN, затем в ~/go/bin/engram, затем в PATH.
- id: engram-memory
name: '@app-apopov/dsh-engram-memory'
config:
command: /Users/ruelephant/go/bin/engram
port: 7437
Как работает
- При загрузке плагин проверяет
GET /healthна127.0.0.1:7437; если сервиса нет — запускаетengram serve <port>и ждёт готовности до 10 секунд. Уже запущенный сервис переиспользуется и не останавливается. - Для каждого проекта, в котором идёт работа, поднимается свой локальный Engram с
ENGRAM_DATA_DIR=<папка>/.dsh-memory; порт выбирается из диапазона 7440–7499, сервис поднимается при первом обращении и живёт до выхода приложения. Внутри проектной базы проект называетсяlocal, потому что идентичность — это сама папка. - Каталог
.dsh-memoryсоздаётся сам и содержит.gitignoreс*, поэтому не попадает вgit status. - Двенадцать последних записей общего проекта кэшируются и попадают в системный промпт блоком «Shared global memory»: глобальные правила действуют в первой же реплике новой сессии, без вызова инструментов. Кэш обновляется после каждой глобальной записи и по истечении 30 секунд.
- Для каждой пары «сессия DSH + проект» создаётся сессия Engram (
POST /sessionsсprojectиdirectory); id сессии включает проект, потому что Engram отвергает запись, чей проект не совпадает с проектом сессии. memory_searchиmemory_contextопрашивают обе базы — проектную и общую — и склеивают результат без дублей; поиск упорядочен по релевантности FTS5, контекст — по времени.
Ограничения
- Память проекта живёт в его папке: удалили папку — удалилась память проекта; скопировали папку — у копии своя независимая память. Общий слой (
scope: "global") при этом остаётся в~/.engram. engramдолжен быть установлен: плагин ищет его вENGRAM_BIN, затем~/go/bin/engram, затемPATH.- Сквозного поиска в Engram нет:
scopeу записи не расширяет выдачу, поэтому общий слой и живёт отдельным проектомglobal, а склейку делает плагин. - Инструменты не поддерживают
mem_judge, timeline и сессии Engram — это остаётся в CLI и в MCP-сервере. MCP-строка в~/.dsh/cordis.patch.ymlсохранена какdisabled: true; чтобы вернутьmcp__engram__*, поставьтеdisabled: false.
Проверка
- Скажите модели «запомни, что проверка памяти — лапсанг», дождитесь
memory_save. - Начните новую сессию в той же папке и спросите про проверку памяти — модель должна вызвать
memory_searchи найти запись. - Повторите в другой папке: запись не должна находиться, пока не передан
all: true.
Из терминала: engram tui, engram projects list, engram search "слово" --project core.