| # Архитектура 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* |
|
|
