docs(platform): add policy configs, runbooks, ops scripts and platform documentation
Config policies (16 files): alert_routing, architecture_pressure, backlog, cost_weights, data_governance, incident_escalation, incident_intelligence, network_allowlist, nodes_registry, observability_sources, rbac_tools_matrix, release_gate, risk_attribution, risk_policy, slo_policy, tool_limits, tools_rollout Ops (22 files): Caddyfile, calendar compose, grafana voice dashboard, deployments/incidents logs, runbooks for alerts/audit/backlog/incidents/sofiia/voice, cron jobs, scripts (alert_triage, audit_cleanup, migrate_*, governance, schedule), task_registry, voice alerts/ha/latency/policy Docs (30+ files): HUMANIZED_STEPAN v2.7-v3 changelogs and runbooks, NODA1/NODA2 status and setup, audit index and traces, backlog, incident, supervisor, tools, voice, opencode, release, risk, aistalk, spacebot Made-with: Cursor
This commit is contained in:
98
docs/spacebot/README.md
Normal file
98
docs/spacebot/README.md
Normal file
@@ -0,0 +1,98 @@
|
||||
# Spacebot — Sofiia Telegram Agent
|
||||
|
||||
Spacebot — це Rust-based multi-agent framework від Spacedrive. Використовується як Telegram-фронтенд для агента Sofiia в екосистемі DAARION.
|
||||
|
||||
- GitHub: https://github.com/spacedriveapp/spacebot
|
||||
- Версія: v0.1.15
|
||||
- Telegram bot: @SofiiaDaarionbot
|
||||
|
||||
## Архітектура
|
||||
|
||||
```
|
||||
[Telegram] ←→ [Spacebot (Rust)] ←→ [GLM-5 / Grok 4.1]
|
||||
↕
|
||||
LanceDB (vector memory)
|
||||
SOUL.md / IDENTITY.md / USER.md
|
||||
```
|
||||
|
||||
## Встановлення (перший раз)
|
||||
|
||||
### Залежності
|
||||
|
||||
```bash
|
||||
brew install rust protobuf cmake
|
||||
curl -fsSL https://bun.sh/install | bash
|
||||
```
|
||||
|
||||
### Збірка з вихідного коду
|
||||
|
||||
```bash
|
||||
git clone --depth=1 https://github.com/spacedriveapp/spacebot.git ~/github-projects/spacebot
|
||||
cd ~/github-projects/spacebot
|
||||
cargo build --release # ~7-20 хвилин
|
||||
```
|
||||
|
||||
### Конфіг
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.spacebot
|
||||
cp docs/spacebot/config.toml.example ~/.spacebot/config.toml
|
||||
# Відредагуй ~/.spacebot/config.toml — виправ модель і ключі якщо потрібно
|
||||
```
|
||||
|
||||
Ключі зберігаються в `.env` проекту:
|
||||
- `SOFIIA_TELEGRAM_BOT_TOKEN` — токен бота @SofiiaDaarionbot
|
||||
- `ZHIPU_API_KEY` / `GLM5_API_KEY` — GLM-5 (Zhipu AI)
|
||||
- `XAI_API_KEY` — Grok (xAI), fallback
|
||||
|
||||
### Ідентичність агента
|
||||
|
||||
Файли в `~/.spacebot/agents/sofiia/workspace/`:
|
||||
- `IDENTITY.md` — хто такий агент, контекст DAARION, засновник
|
||||
- `SOUL.md` — стиль спілкування, мова, межі
|
||||
- `USER.md` — інформація про Повелителя Хаосу / Іван Титар
|
||||
|
||||
## Управління
|
||||
|
||||
```bash
|
||||
# Запуск
|
||||
./ops/scripts/start_spacebot.sh start
|
||||
|
||||
# Статус
|
||||
./ops/scripts/start_spacebot.sh status
|
||||
|
||||
# Live логи
|
||||
./ops/scripts/start_spacebot.sh logs
|
||||
|
||||
# Перезапуск (після змін конфігу або identity файлів)
|
||||
./ops/scripts/start_spacebot.sh restart
|
||||
|
||||
# Зупинка
|
||||
./ops/scripts/start_spacebot.sh stop
|
||||
```
|
||||
|
||||
## Важливо перед запуском
|
||||
|
||||
Якщо бот раніше використовував webhook (наприклад через gateway.daarion.city), треба видалити його:
|
||||
|
||||
```bash
|
||||
source .env
|
||||
curl "https://api.telegram.org/bot${SOFIIA_TELEGRAM_BOT_TOKEN}/deleteWebhook?drop_pending_updates=true"
|
||||
```
|
||||
|
||||
## Моделі (поточні)
|
||||
|
||||
| Призначення | Модель | Provider |
|
||||
|-------------|--------|----------|
|
||||
| channel (чат) | glm-5 | Zhipu AI |
|
||||
| branch (задачі) | glm-5 | Zhipu AI |
|
||||
| worker (фон) | glm-4.5-air | Zhipu AI |
|
||||
| cortex (память) | glm-4.7 | Zhipu AI |
|
||||
| fallback | grok-4-1 / grok-4-1-mini | xAI |
|
||||
|
||||
## Де логи
|
||||
|
||||
```
|
||||
~/.spacebot/logs/spacebot.log.YYYY-MM-DD
|
||||
~/.spacebot/agents/sofiia/ — workspace, memory, lancedb
|
||||
```
|
||||
Reference in New Issue
Block a user