dsh-brainagent

dsh plugin --profile web add dsh-brainagent

🧠 BrainAgent for DeepSeek Harness

  

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

[English version below](#english)

---

Что это

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:

npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent

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

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: из локальной копии (для разработки)

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):

- 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 флагов) — любой компонент можно отключить:

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

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

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

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

npm install --legacy-peer-deps   # пиры (cordis, dsh-agent, dsh-llm, ...) предоставляет
                                 # хост dsh; в репозитории они закреплены в devDependencies
npm test                         # vitest: 64 файла, 918 тестов
npm run typecheck                # tsc --noEmit
npm run build                    # esbuild → lib/index.js

Помимо юнит-тестов модулей есть интеграционный eval-харнесс (`

…(truncated)