🧠 BrainAgent for DeepSeek Harness

Когнитивная архитектура как плагин: память, эмоции, мотивация, обучение и автономия для вашего агента dsh.

Что это

BrainAgent — плагин для DeepSeek Harness (dsh), который превращает штатного агента из исполнителя разовых задач в долгоживущего персонального ассистента с внутренней когнитивной системой, смоделированной по принципам работы мозга.

~60 модулей, 6 точек интеграции с платформой, 918 unit-тестов, всё работает поверх штатных хуков dsh без единого исключения: анти-спам-пейсинг гол-раундов встроен в сам плагин, патчить хост не нужно. Установка — одна команда, без сборки и разрешений на скрипты.

Возможности

💾 Память

Эпизодическая — события разговоров с эмоциями и важностью
Семантическая — устойчивые факты с историей ревизий
Процедурная — выученные сценарии действий («как отвечать / как делать»)
Укрепление при воспроизведении (правило Хебба), затухание нерелевантного
Хранение локально на диске — ваши данные не покидают машину

🎭 Эмоции и эмпатия

Амигдала классифицирует эмоциональную окраску сообщений
Зеркальные нейроны строят модель собеседника (настроение, стиль, экспертиза)
Эмоциональная память сохраняет яркие моменты («flashbulb»)

📚 Обучение

Каждый оборот диалога завершается циклом обучения
Дофаминовая система подкрепляет успешные стратегии
Базальные ганглии формируют привычки с оценкой успешности

⚡ Автономия

Четыре драйва: социальный, познавательный, творческий, мастерство
Vital Impulse — агент сам пишет вам, когда есть что сказать (цель, инсайт, желание)
Goal Stack ведёт долгосрочные цели, Curiosity Drive находит пробелы в знаниях
DMN «думает в фоне», Autonomous Research сам ищет информацию
Встроенные предохранители: минимум 10 минут между проактивными сообщениями, разрыватель цикла

🌙 Саморегуляция

Циркадный ритм и Dream Mode — ночью агент «спит» и консолидирует память
Attention Gate фильтрует контекст по релевантности (экономия токенов)
Token Economy и таламический гейт пропускают простые сообщения без дорогих LLM-вызовов
Metabolic Budget следит за расходом ресурсов модулей

🪞 Личность

Agent Identity: автобиографическая память, уроки, профиль способностей
Qualia Simulator: текущее субъективное состояние
Temporal Binding: ощущение непрерывности времени

Установка

Вариант 1: как пакет dsh (рекомендуется)

Одна команда — плагин скачается прямо с GitHub:

▼
sh
复制代码
npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent

Затем запустите Web UI:

▼
sh
复制代码
npx @deepseek-ai/dsh web

Пакет содержит готовый собранный модуль (lib/index.js) и не содержит install-скриптов.

⚠️ Про pnpm ≥ 10: по политике безопасности pnpm по умолчанию блокирует любые git-пакеты, поэтому вместо чистого завершения вы можете увидеть ERR_PNPM_IGNORED_BUILDS. Это общая для всех git-плагинов dsh политика pnpm (см. обсуждение #2230), а не ошибка установки: файлы плагина уже развёрнуты, npx @deepseek-ai/dsh web будет работать.

Чтобы установка завершалась без предупреждения, скопируйте точный ключ из текста ошибки в ~/.dsh/profiles/web/pnpm-workspace.yaml и повторите команду:
▼
yaml
复制代码
allowBuilds:
  dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/<хеш-коммита>: true
Разрешение безопасно: у пакета нет скриптов, которым это разрешение что-либо позволяет выполнять.

Вариант 2: из локальной копии (для разработки)

▼
sh
复制代码
git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent
npx @deepseek-ai/dsh web

Либо подключите исходники оверлеем (запускайте с --patch):

▼
yaml
复制代码
- insert:
    - id: brainagent
      name: file:///абсолютный/путь/к/dsh-brainagent/src/index.ts
      config: {}

Использование

Поговорите с агентом — BrainAgent включается автоматически. В чате доступны команды:

Команда	Что делает
`/brain status`	Полный отчёт о состоянии всех систем
`/brain memory <запрос>`	Поиск по памяти
`/brain goals`	Текущие цели
`/brain neuro`	Нейромодуляторы (дофамин и др.)
`/brain habits`	Выученные привычки
`/brain learning`	Циклы обучения и инсайты
`/brain circadian`	Циркадный ритм и сон
`/brain dream`	Запустить консолидацию памяти

…и другие: predict, pathways, personality, metabolic, emergent.

Все модули настраиваются через Config-схему (39 флагов) — любой компонент можно отключить:

▼
yaml
复制代码
- id: brainagent
  name: dsh-brainagent
  config:
    autonomousMinGapMs: 1800000   # пауза между проактивными сообщениями (30 мин)
    modules:
      actionDispatcher: false     # например, отключить автономию

Тестирование

▼
sh
复制代码
pnpm install        # из корня monorepo dsh
pnpm vitest run     # 64 файла, 918 тестов

Автономно, вне монорепо:

▼
sh
复制代码
npm install --legacy-peer-deps   # пиры предоставляет хост dsh, а wildcard-зависимости
                                 # тянут несогласованные rc-версии — ставим мягко
npm test                         # vitest: 64 файла, 918 тестов
npm run typecheck                # tsc --noEmit
npm run build                    # esbuild → lib/index.js

Помимо юнит-тестов модулей есть интеграционный eval-харнесс (src/eval/): плагин поднимается целиком на мокнутом dsh-контексте (изолированный dataDir, честный cleanup эффектов) и прогоняет golden-сценарии — «живой» диалог через полный конвейер, петлю обучения reward-ledger → strategy-bandit на реальных событиях шины, автономию (доставка, гейт инструментов, loop-breaker) и регрессию recall «при таком состоянии памяти recall возвращает это». Это страховка для будущих рефакторингов: изменение поведения конвейера видно сразу. Первая же находка (v0.5.1): фрейминг проактивной доставки не распознавался как автономный цикл — детекция унифицирована и починена.

Архитектура

Обработанный дsh message проходит конвейер:

▼
text
复制代码
Thalamus (классификация) → Amygdala (эмоции) → Hippocampus (извлечение памяти)
→ Prefrontal Cortex (решение, fast/slow path) → контекстная инъекция (pre-step)
→ Cerebellum (оценка качества после ответа) → цикл обучения

Все модули обмениваются типизированными сигналами через внутренний event bus (Corpus Callosum), автономные таймеры работают через ctx.effect.

Код плагина разбит на слои: src/index.ts — только композиция (инициализация модулей, хуки dsh, cleanup), вся логика — в src/plugin/ (config.ts — схема и merge конфига, autonomy.ts — проактивная доставка и резолвер намерений, cycles.ts — жизненный цикл цикла, context.ts — сборка контекста для agent/pre-step).

Что под капотом на самом деле

Честно, без метафор. BrainAgent — это конвейер эвристических фильтров + статистические хранилища + инъекции контекста:

Фильтры и классификаторы — каждый модуль по своим эвристикам решает, что во входящем сообщении важно: домен, эмоция, приоритет, намерение.
Статистические хранилища — JSON-файлы в .brainagent/: эпизодическая и семантическая память, привычки, прогнозы, пробелы в знаниях, журнал наград. Нейросетей и обучаемых весов внутри плагина нет.
Инъекции контекста — перед вызовом модели модули собирают компактные текстовые блоки («вспомнил», «привычка», «прогнозирую») и добавляют их к сообщению. Сама «когнитивность» происходит в основной LLM, не в плагине.

Имена модулей (гиппокамп, дофамин, DMN…) — метафора для читаемости: они описывают роль модуля в конвейере, а не механизм реализации. Это не симуляция мозга, и плагин её не обещает.

Единственная явная петля обучения с политикой — learningLoop: журнал наград (reward-ledger) сводит оценки всех источников в единый журнал, а многорукий бандит (strategy-bandit, UCB1) по накопленной награде решает, какие блоки контекста подавать. Политика хранится в таблицах, а не в весах — обучение с подкреплением без GPU. Отдельные модули (базальные ганглии, прогнозный движок, зеркальные нейроны) тоже статистически адаптируются — но без явной политики выбора.

Требования

DeepSeek Harness (dsh) с поддержкой плагинов Cordis
Node.js 22+

Лицензия

BrainAgent Noncommercial License — свободное некоммерческое использование для всех; коммерческое использование только по соглашению с автором. Подробнее в LICENSE.

English

BrainAgent is a plugin for DeepSeek Harness (dsh) that turns the stock agent into a long-lived personal assistant with a brain-inspired cognitive system.

~60 modules, 6 platform integration points, 918 unit tests, running entirely on stock dsh hooks — zero core changes.

Highlights

Memory — episodic, semantic and procedural; Hebbian strengthening, decay, local-only storage
Emotions & empathy — Amygdala classification, Mirror Neurons user modeling, flashbulb memories
Learning — per-turn learning cycles, dopamine reinforcement, habit formation
Autonomy — four drives, proactive messages (Vital Impulse) with anti-loop guards, goal stack, curiosity, background DMN insights
Self-regulation — circadian rhythm, Dream Mode consolidation, Attention Gate token budgeting, Token Economy
Personality — Agent Identity, Qualia Simulator, Temporal Binding

Install — one command, fetched straight from GitHub:

▼
sh
复制代码
npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent
npx @deepseek-ai/dsh web

Or from a local clone:

▼
sh
复制代码
git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent

Ships a prebuilt bundle (lib/index.js) and contains no install scripts.

⚠️ About pnpm ≥ 10: pnpm's security policy blocks any git-hosted package by default, so instead of a clean exit you may see ERR_PNPM_IGNORED_BUILDS. This is pnpm policy common to all git-installed dsh plugins (see discussion #2230), not an install failure — the plugin files are already in place and npx @deepseek-ai/dsh web will work.

For a warning-free install, copy the exact key from the error message into ~/.dsh/profiles/web/pnpm-workspace.yaml and re-run the command:
▼
yaml
复制代码
allowBuilds:
  dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/<commit-hash>: true
Approving is safe: the package has no scripts the permission would ever run.

Commands: /brain status, /brain memory <query>, /brain goals, /brain neuro, /brain habits, /brain learning, /brain circadian, /brain dream and more

Tests: pnpm vitest run — 64 files, 918 tests

License: BrainAgent Noncommercial License — free noncommercial use for everyone; commercial use requires an agreement with the author. See LICENSE.

🧠 BrainAgent for DeepSeek Harness

Когнитивная архитектура как плагин: память, эмоции, мотивация, обучение и автономия для вашего агента dsh.

English version below

Что это

Возможности

💾 Память

Эпизодическая — события разговоров с эмоциями и важностью
Семантическая — устойчивые факты с историей ревизий
Процедурная — выученные сценарии действий («как отвечать / как делать»)
Укрепление при воспроизведении (правило Хебба), затухание нерелевантного
Хранение локально на диске — ваши данные не покидают машину

🎭 Эмоции и эмпатия

Амигдала классифицирует эмоциональную окраску сообщений
Зеркальные нейроны строят модель собеседника (настроение, стиль, экспертиза)
Эмоциональная память сохраняет яркие моменты («flashbulb»)

📚 Обучение

Каждый оборот диалога завершается циклом обучения
Дофаминовая система подкрепляет успешные стратегии
Базальные ганглии формируют привычки с оценкой успешности

⚡ Автономия

Четыре драйва: социальный, познавательный, творческий, мастерство
Vital Impulse — агент сам пишет вам, когда есть что сказать (цель, инсайт, желание)
Goal Stack ведёт долгосрочные цели, Curiosity Drive находит пробелы в знаниях
DMN «думает в фоне», Autonomous Research сам ищет информацию
Встроенные предохранители: минимум 10 минут между проактивными сообщениями, разрыватель цикла

🌙 Саморегуляция

Циркадный ритм и Dream Mode — ночью агент «спит» и консолидирует память
Attention Gate фильтрует контекст по релевантности (экономия токенов)
Token Economy и таламический гейт пропускают простые сообщения без дорогих LLM-вызовов
Metabolic Budget следит за расходом ресурсов модулей

🪞 Личность

Agent Identity: автобиографическая память, уроки, профиль способностей
Qualia Simulator: текущее субъективное состояние
Temporal Binding: ощущение непрерывности времени

Установка

Вариант 1: как пакет dsh (рекомендуется)

Одна команда — плагин скачается прямо с GitHub:

▼
sh
复制代码
npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent

Затем запустите Web UI:

▼
sh
复制代码
npx @deepseek-ai/dsh web

Пакет содержит готовый собранный модуль (lib/index.js) и не содержит install-скриптов.

⚠️ Про pnpm ≥ 10: по политике безопасности pnpm по умолчанию блокирует любые git-пакеты, поэтому вместо чистого завершения вы можете увидеть ERR_PNPM_IGNORED_BUILDS. Это общая для всех git-плагинов dsh политика pnpm (см. обсуждение #2230), а не ошибка установки: файлы плагина уже развёрнуты, npx @deepseek-ai/dsh web будет работать.

Чтобы установка завершалась без предупреждения, скопируйте точный ключ из текста ошибки в ~/.dsh/profiles/web/pnpm-workspace.yaml и повторите команду:
▼
yaml
复制代码
allowBuilds:
  dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/<хеш-коммита>: true
Разрешение безопасно: у пакета нет скриптов, которым это разрешение что-либо позволяет выполнять.

Вариант 2: из локальной копии (для разработки)

▼
sh
复制代码
git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent
npx @deepseek-ai/dsh web

Либо подключите исходники оверлеем (запускайте с --patch):

▼
yaml
复制代码
- insert:
    - id: brainagent
      name: file:///абсолютный/путь/к/dsh-brainagent/src/index.ts
      config: {}

Использование

Поговорите с агентом — BrainAgent включается автоматически. В чате доступны команды:

Команда	Что делает
`/brain status`	Полный отчёт о состоянии всех систем
`/brain memory <запрос>`	Поиск по памяти
`/brain goals`	Текущие цели
`/brain neuro`	Нейромодуляторы (дофамин и др.)
`/brain habits`	Выученные привычки
`/brain learning`	Циклы обучения и инсайты
`/brain circadian`	Циркадный ритм и сон
`/brain dream`	Запустить консолидацию памяти

…и другие: predict, pathways, personality, metabolic, emergent.

Все модули настраиваются через Config-схему (39 флагов) — любой компонент можно отключить:

▼
yaml
复制代码
- id: brainagent
  name: dsh-brainagent
  config:
    autonomousMinGapMs: 1800000   # пауза между проактивными сообщениями (30 мин)
    modules:
      actionDispatcher: false     # например, отключить автономию

Тестирование

▼
sh
复制代码
pnpm install        # из корня monorepo dsh
pnpm vitest run     # 64 файла, 918 тестов

Автономно, вне монорепо:

▼
sh
复制代码
npm install --legacy-peer-deps   # пиры предоставляет хост dsh, а wildcard-зависимости
                                 # тянут несогласованные rc-версии — ставим мягко
npm test                         # vitest: 64 файла, 918 тестов
npm run typecheck                # tsc --noEmit
npm run build                    # esbuild → lib/index.js

Архитектура

Обработанный дsh message проходит конвейер:

▼
text
复制代码
Thalamus (классификация) → Amygdala (эмоции) → Hippocampus (извлечение памяти)
→ Prefrontal Cortex (решение, fast/slow path) → контекстная инъекция (pre-step)
→ Cerebellum (оценка качества после ответа) → цикл обучения

Что под капотом на самом деле

Фильтры и классификаторы — каждый модуль по своим эвристикам решает, что во входящем сообщении важно: домен, эмоция, приоритет, намерение.
Статистические хранилища — JSON-файлы в .brainagent/: эпизодическая и семантическая память, привычки, прогнозы, пробелы в знаниях, журнал наград. Нейросетей и обучаемых весов внутри плагина нет.
Инъекции контекста — перед вызовом модели модули собирают компактные текстовые блоки («вспомнил», «привычка», «прогнозирую») и добавляют их к сообщению. Сама «когнитивность» происходит в основной LLM, не в плагине.

Требования

DeepSeek Harness (dsh) с поддержкой плагинов Cordis
Node.js 22+

Лицензия

English

BrainAgent is a plugin for DeepSeek Harness (dsh) that turns the stock agent into a long-lived personal assistant with a brain-inspired cognitive system.

~60 modules, 6 platform integration points, 918 unit tests, running entirely on stock dsh hooks — zero core changes.

Highlights

Memory — episodic, semantic and procedural; Hebbian strengthening, decay, local-only storage
Emotions & empathy — Amygdala classification, Mirror Neurons user modeling, flashbulb memories
Learning — per-turn learning cycles, dopamine reinforcement, habit formation
Autonomy — four drives, proactive messages (Vital Impulse) with anti-loop guards, goal stack, curiosity, background DMN insights
Self-regulation — circadian rhythm, Dream Mode consolidation, Attention Gate token budgeting, Token Economy
Personality — Agent Identity, Qualia Simulator, Temporal Binding

Install — one command, fetched straight from GitHub:

▼
sh
复制代码
npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent
npx @deepseek-ai/dsh web

Or from a local clone:

▼
sh
复制代码
git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent

Ships a prebuilt bundle (lib/index.js) and contains no install scripts.

⚠️ About pnpm ≥ 10: pnpm's security policy blocks any git-hosted package by default, so instead of a clean exit you may see ERR_PNPM_IGNORED_BUILDS. This is pnpm policy common to all git-installed dsh plugins (see discussion #2230), not an install failure — the plugin files are already in place and npx @deepseek-ai/dsh web will work.

For a warning-free install, copy the exact key from the error message into ~/.dsh/profiles/web/pnpm-workspace.yaml and re-run the command:
▼
yaml
复制代码
allowBuilds:
  dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/<commit-hash>: true
Approving is safe: the package has no scripts the permission would ever run.

Commands: /brain status, /brain memory <query>, /brain goals, /brain neuro, /brain habits, /brain learning, /brain circadian, /brain dream and more

Tests: pnpm vitest run — 64 files, 918 tests

License: BrainAgent Noncommercial License — free noncommercial use for everyone; commercial use requires an agreement with the author. See LICENSE.