[2026-06-17] update balda docs — context fix, MCP /sse, single-image build flow, current status

This commit is contained in:
Alexey Martemyanov
2026-06-17 11:35:20 +06:00
parent 9e063ac463
commit 6dfff145ec
2 changed files with 82 additions and 117 deletions
+22 -5
View File
@@ -5,33 +5,50 @@
| Item | Value |
|------|-------|
| Repo | `~/Developer/balda/` (один код с Валерой) |
| Ветка | `main` |
| Compose | `~/Docker/claudio-agent/docker-compose.yaml` → контейнер `claudio-agent-claudio-1` |
| Config | `~/Docker/claudio-agent/.config/balda/config.yaml` |
| Env | `~/Docker/claudio-agent/.env` |
| Dockerfile | `~/Docker/claudio-agent/Dockerfile.claudio` |
| Образ | `claudio-agent-claudio` (тагается как `balda-agent-valera` для Валеры) |
## Запуск / рестарт
```bash
cd ~/Docker/claudio-agent
docker-compose restart # без пересборки
docker-compose build && docker-compose up -d # после изменений в коде
docker-compose up -d # пересоздать контейнер
# Rebuild после изменений в коде:
cd ~/Docker/claudio-agent && docker-compose build
docker tag claudio-agent-claudio:latest balda-agent-valera:latest
cd ~/Docker/claudio-agent && docker-compose up -d
cd ~/Docker/balda-agent && docker-compose up -d
```
> Валера и Клавдий — **один код и один образ** (`claudio-agent-claudio` → `balda-agent-valera`). Разница только в конфиге, `.env` и порте webhook (8091 vs 8092). Сборка всегда из `~/Docker/claudio-agent/`.
## Архитектура получения сообщений
Клавдий — **outgoing webhook bot** (bot_type=3). Zulip отправляет webhook только для @mention и DM.
Для получения всех сообщений в теме — **Events API polling** (отключён, после деплоя zulip-router будет удалён из кода):
- `events_polling.enabled: false` в config.yaml (текущее состояние)
- Сообщения приходят только через **outgoing webhook**
## Отличие от Валеры
- **Провайдер**: `claude` (claude-sonnet-4-6) через Claude Proxy (контейнер, порт 3457)
- **Порт webhook**: 8092 (у Валеры 8091)
- **База**: отдельная SQLite (NATS embedded)
## MCP Obsidian — конфиг
Аналогично Валере — URL обязательно с `/sse`:
```yaml
runtime:
mcp_servers:
obsidian:
type: sse
url: http://obsidian-mcp:3101/sse
name: obsidian
```
## Проблемы и решения
### Валера отвечал вместо Клавдия на @mention