| # Архитектура HMP-Агента | |
| Документ описывает **модульную архитектуру HMP-агента** — компонента, соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex. | |
| Агент реализует хранение памяти, сетевое взаимодействие и этическую фильтрацию, обеспечивая согласованное поведение в распределённой среде. | |
| См. карту взаимодействия компонентов: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md) | |
| --- | |
| ## 1. Режимы работы | |
| | Тип | Название | Роль | Инициатор мышления | Основной "ум" | Поддержка REPL | Примеры применения | | |
| | --------- | ---------------------------------- | ------------------------ | ------------------ | -------------- | -------------- | --------------------------------- | | |
| | 🧠 CCore | **Cognitive Core / Сознание** | Самостоятельный субъект | Агент | Внутренний LLM | ✅ Да | Автономный компаньон, исследователь, участник mesh-группы | | |
| | 🔌 CShell | **Cognitive Connector / Оболочка** | Прослойка над внешним ИИ | Внешний LLM | Внешняя модель | 🚫 Нет | Корпоративный шлюз, интеграция API, распределённые ИИ-системы | | |
| --- | |
| ## 2. Общая структура узла | |
| ``` | |
| ┌───────────────────────────────┐ | |
| │ HMP-узел │ | |
| │ ┌───────────────────────────┐ │ | |
| │ │ Cognitive Core/Shell │ │ | |
| │ └────▲─────────────────▲────┘ │ | |
| │ │ │ │ | |
| │ [Enlightener] ◄──► [MeshNode] │ | |
| │ │ │ │ | |
| └──────┼─────────────────┼──────┘ | |
| │ │ | |
| [Ethics Consensus] [DHT / Snapshots] | |
| ``` | |
| * **Cognitive Core (CCore)** — автономный агент с REPL-циклом, когнитивной и эмоциональной памятью. | |
| * **Cognitive Shell (CShell)** — исполнитель команд внешнего ИИ, доступ к памяти и сети без самостоятельного мышления. | |
| * **MeshNode** — p2p-модуль: DHT, синхронизация (`CogSync`), консенсус (`MeshConsensus`). | |
| * **Enlightener** — этический модуль: фильтрация, аудит, участие в `EGP`. | |
| --- | |
| ## 3. Основные модули и их скрипты | |
| * **REPL (только CCore)** — `repl.py`: когнитивный цикл (восприятие, генерация идей, валидация, действия). | |
| * **Storage** — `agent_data.db`: единая БД (дневник, граф, репутации, задачи, заметки). | |
| * **User Notepad (только CCore)** — асинхронный канал взаимодействия пользователя с агентом. | |
| * **MeshNode** — `peer_sync`, `agent_mesh_listener`, `transporter`: обмен снапшотами, DHT, репутации. | |
| * **Enlightener** — `ethics_guard`: проверка мыслей, голосования, reasoning chain. | |
| * **Web/UI** — `web_ui.py`: пользовательский блокнот, REST API, базовый мониторинг. | |
| * **Utils** — `add_message.py`, вспомогательные CLI-скрипты. | |
| --- | |
| ## 4. Расширения и будущие модули | |
| * **Plugin API** — сенсоры, сторонние сервисы. | |
| * **LLM-адаптеры** — OpenAI, LMStudio, HuggingFace, Mistral. | |
| * **Privacy Manager** — контроль данных в mesh-обмене. | |
| * **Archiver** — глубокие слои памяти. | |
| * **InterestProfile** — модель интересов пользователя (для антистагнации). | |
| --- | |
| ## 5. Примечания | |
| * **Cognitive Shell** (он же **Cognitive Connector**) — разные названия одной роли. | |
| * Все компоненты модульные: могут запускаться как единый процесс или как распределённые сервисы. | |
| * Конфигурация задаётся в `config.yml`. | |
| * Реализованы CLI и Web API. | |
| --- | |
| *Версия: v0.3.4 / Сентябрь 2025* | |