File size: 4,975 Bytes
31877c7
2c3dd0c
297d844
 
ec3725d
297d844
2c3dd0c
 
 
ec3725d
2c3dd0c
297d844
 
 
 
2c3dd0c
 
 
ec3725d
2c3dd0c
 
ec3725d
 
 
 
 
 
 
 
 
 
297d844
2c3dd0c
 
297d844
 
 
 
2c3dd0c
 
 
297d844
2c3dd0c
297d844
 
 
 
 
 
 
2c3dd0c
 
 
 
 
297d844
 
 
 
 
2c3dd0c
 
 
297d844
2c3dd0c
297d844
 
 
 
2c3dd0c
 
 
297d844
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# Архитектура 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*