Спринт: Wiki, статус-страница, рой агентов на DeepSeek
Wiki в Gitea: 9 страниц (архитектура, сервисы, агенты, дорожная карта, регламенты, ADR, онбординг, работа). Инициализирована через API, затем пушится как git-репозиторий. Статус-страница hub.buryans.ru/status: 62 сервиса по группам, состояние берётся из docker ps (TCP-проверка давала ложные срабатывания для CT111), кэш 60 с, JSON на /status.json. Рой агентов: groups.yaml (6 групп), policy.yaml (классы A/B/C/D, лимиты, тихие часы), ТЗ шести секретарей и Головы, раннер (наблюдение) и мозг на DeepSeek (json-ответ: диагноз, severity, предложенные действия). Таймеры: раннер каждые 30 минут, мозг ежечасно. В v0 ничего не выполняется — только диагностика и предложения; уведомление уходит при crit. Найдено и исправлено агентом: freshrss, catalog и их oauth2-proxy были недоступны — перезапущены, статус 62/62.
This commit is contained in:
1 parent
a931175a30
commit
c20cddd747
13 files changed
+908
No files matched your search
@@ -0,0 +1,173 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Мозг роя на DeepSeek: агент анализирует свою группу и предлагает действия.
|
||||
|
||||
v0 — режим наблюдения: ничего не выполняет, только диагностирует и предлагает.
|
||||
Правила: строго по ТЗ агента, ответ в JSON, журнал, эскалация Голове.
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
import time
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
from datetime import datetime
|
||||
|
||||
sys.path.insert(0, "/opt/hub-agents")
|
||||
import agent_runner as runner # noqa: E402
|
||||
|
||||
API = "https://api.deepseek.com/v1/chat/completions"
|
||||
KEY_FILE = "/root/.deepseek-key"
|
||||
MODEL = os.environ.get("DEEPSEEK_MODEL", "deepseek-chat")
|
||||
JOURNAL = "/var/lib/hub-agents/journal"
|
||||
STATE = "/var/lib/hub-agents/state.json"
|
||||
AGENTS = "/opt/hub-agents/agents"
|
||||
|
||||
|
||||
def api_key():
|
||||
try:
|
||||
return open(KEY_FILE, encoding="utf-8").read().strip()
|
||||
except Exception:
|
||||
return ""
|
||||
|
||||
|
||||
def llm(system, user, max_tokens=700):
|
||||
key = api_key()
|
||||
if not key:
|
||||
return None, "нет ключа"
|
||||
body = {
|
||||
"model": MODEL,
|
||||
"messages": [{"role": "system", "content": system},
|
||||
{"role": "user", "content": user}],
|
||||
"temperature": 0.2,
|
||||
"max_tokens": max_tokens,
|
||||
"response_format": {"type": "json_object"},
|
||||
}
|
||||
req = urllib.request.Request(API, data=json.dumps(body).encode(), method="POST",
|
||||
headers={"Authorization": "Bearer " + key,
|
||||
"Content-Type": "application/json"})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=90) as r:
|
||||
data = json.loads(r.read() or b"{}")
|
||||
return data["choices"][0]["message"]["content"], None
|
||||
except urllib.error.HTTPError as e:
|
||||
return None, f"HTTP {e.code}: {e.read()[:200].decode('utf-8', 'replace')}"
|
||||
except Exception as e:
|
||||
return None, str(e)[:150]
|
||||
|
||||
|
||||
def load_agent(name):
|
||||
path = os.path.join(AGENTS, name + ".yaml")
|
||||
return runner.read_yaml(path)
|
||||
|
||||
|
||||
def state():
|
||||
try:
|
||||
return json.load(open(STATE, encoding="utf-8"))
|
||||
except Exception:
|
||||
return {}
|
||||
|
||||
|
||||
def save_state(st):
|
||||
os.makedirs(os.path.dirname(STATE), exist_ok=True)
|
||||
json.dump(st, open(STATE, "w", encoding="utf-8"), ensure_ascii=False)
|
||||
|
||||
|
||||
def agent_system(tz):
|
||||
return (
|
||||
"Ты — секретарь направления в домашней инфраструктуре Buryans Hub. "
|
||||
"Работаешь строго в рамках ТЗ. Не выдумывай фактов: опирайся только на данные. "
|
||||
f"ТЗ: имя={tz.get('name')}, зона={tz.get('group')}, миссия={tz.get('mission')}. "
|
||||
f"Разрешённые классы действий: {tz.get('allowed')}. "
|
||||
f"Запрещено: {tz.get('forbidden')}. "
|
||||
"Верни JSON: {\"diagnosis\": краткий вывод, \"severity\": \"ok|warn|crit\", "
|
||||
"\"actions\": [{\"class\":\"A|B|C\",\"action\":\"restart_container|cleanup_logs|"
|
||||
"update_container|reindex|notify|noop\",\"target\":\"имя\",\"why\":\"причина\"}], "
|
||||
"\"summary\": одно предложение для человека}. "
|
||||
"Если всё в порядке — actions: [] и severity: ok. Не предлагай запрещённое."
|
||||
)
|
||||
|
||||
|
||||
def run_agent(name, tz, group_report, policy, history):
|
||||
user = json.dumps({
|
||||
"group": group_report,
|
||||
"policy": policy.get("classes") or {},
|
||||
"recent": history[-3:],
|
||||
"now": datetime.now().isoformat(timespec="seconds"),
|
||||
}, ensure_ascii=False)
|
||||
raw, err = llm(agent_system(tz), user)
|
||||
if err:
|
||||
return {"agent": name, "error": err}
|
||||
try:
|
||||
parsed = json.loads(raw)
|
||||
except Exception:
|
||||
parsed = {"diagnosis": raw[:300], "severity": "warn", "actions": [], "summary": ""}
|
||||
parsed["agent"] = name
|
||||
parsed["ts"] = datetime.now().isoformat(timespec="seconds")
|
||||
parsed["group"] = group_report.get("group")
|
||||
return parsed
|
||||
|
||||
|
||||
def main():
|
||||
groups_doc = runner.read_yaml("/opt/hub-agents/groups.yaml")
|
||||
policy = runner.read_yaml("/opt/hub-agents/policy.yaml")
|
||||
st = runner.status()
|
||||
os.makedirs(JOURNAL, exist_ok=True)
|
||||
stamp = datetime.now().strftime("%Y-%m-%d")
|
||||
results = []
|
||||
problems = 0
|
||||
|
||||
for gname, group in (groups_doc.get("groups") or {}).items():
|
||||
if not isinstance(group, dict):
|
||||
continue
|
||||
rep = runner.check_group(gname, group, st)
|
||||
agent = group.get("agent") or gname
|
||||
tz = load_agent(agent)
|
||||
|
||||
has_issue = bool(rep["down"])
|
||||
extra = rep.get("extra") or {}
|
||||
if extra.get("disk_used_pct", 0) > 80 or extra.get("swap_used_pct", 0) > 70:
|
||||
has_issue = True
|
||||
if (extra.get("newest_backup_hours") or 0) > 30:
|
||||
has_issue = True
|
||||
|
||||
if not has_issue:
|
||||
continue
|
||||
|
||||
problems += 1
|
||||
hist = []
|
||||
try:
|
||||
hist = json.load(open(os.path.join(JOURNAL, f"{stamp}-{agent}.json"),
|
||||
encoding="utf-8"))
|
||||
hist = hist if isinstance(hist, list) else [hist]
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
res = run_agent(agent, tz, rep, policy, hist)
|
||||
results.append(res)
|
||||
path = os.path.join(JOURNAL, f"{stamp}-{agent}-llm.json")
|
||||
json.dump(res, open(path, "w", encoding="utf-8"), ensure_ascii=False, indent=1)
|
||||
sev = res.get("severity", "?")
|
||||
print(f" {agent:<10} severity={sev:<5} {str(res.get('summary') or res.get('diagnosis'))[:90]}")
|
||||
for a in res.get("actions") or []:
|
||||
print(f" → [{a.get('class')}] {a.get('action')} {a.get('target')}: {a.get('why')}")
|
||||
|
||||
if not problems:
|
||||
print("все группы в норме — LLM не вызывался")
|
||||
|
||||
# Голова: если есть crit — уведомить
|
||||
crit = [r for r in results if r.get("severity") == "crit"]
|
||||
if crit:
|
||||
lines = [f"🔴 {r['agent']}: {r.get('summary') or r.get('diagnosis')}" for r in crit]
|
||||
runner.notify("Голова: критичные проблемы", "\n".join(lines)[:1500])
|
||||
print(" уведомление Головы отправлено")
|
||||
|
||||
stt = state()
|
||||
stt["last_run"] = datetime.now().isoformat(timespec="seconds")
|
||||
stt["agents"] = {r["agent"]: {"severity": r.get("severity"),
|
||||
"summary": r.get("summary") or r.get("diagnosis")}
|
||||
for r in results}
|
||||
save_state(stt)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,217 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Раннер роя: читает группы и политику, проверяет сервисы, пишет журнал.
|
||||
|
||||
Режим v0 — только наблюдение: ничего не меняет, только собирает факты
|
||||
и готовит отчёт Голове.
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
import shutil
|
||||
import socket
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
from datetime import datetime
|
||||
|
||||
AGENTS_DIR = "/opt/hub-agents"
|
||||
JOURNAL = "/var/lib/hub-agents/journal"
|
||||
STATUS_URL = "http://127.0.0.1:9120/status.json"
|
||||
NOTIFY = "http://127.0.0.1:9120/notify"
|
||||
|
||||
|
||||
def read_yaml(path):
|
||||
"""Минимальный YAML-парсер под наши файлы (без зависимостей)."""
|
||||
out, cur, stack = {}, None, []
|
||||
try:
|
||||
lines = open(path, encoding="utf-8").read().splitlines()
|
||||
except Exception:
|
||||
return {}
|
||||
for raw in lines:
|
||||
if not raw.strip() or raw.strip().startswith("#"):
|
||||
continue
|
||||
indent = len(raw) - len(raw.lstrip())
|
||||
line = raw.strip()
|
||||
key, _, val = line.partition(":")
|
||||
val = val.strip()
|
||||
if indent == 0:
|
||||
cur = None
|
||||
if val:
|
||||
out[key] = parse_scalar(val)
|
||||
else:
|
||||
out[key] = {}
|
||||
stack = [(0, out[key])]
|
||||
continue
|
||||
# вложенность
|
||||
while stack and indent <= stack[-1][0]:
|
||||
stack.pop()
|
||||
if not stack:
|
||||
continue
|
||||
target = stack[-1][1]
|
||||
if val.startswith("["):
|
||||
target[key] = [x.strip().strip("'\"") for x in val.strip("[]").split(",") if x.strip()]
|
||||
elif val:
|
||||
target[key] = parse_scalar(val)
|
||||
else:
|
||||
target[key] = {}
|
||||
stack.append((indent, target[key]))
|
||||
return out
|
||||
|
||||
|
||||
def parse_scalar(v):
|
||||
v = v.strip()
|
||||
if v in ("true", "yes"):
|
||||
return True
|
||||
if v in ("false", "no"):
|
||||
return False
|
||||
if v.isdigit():
|
||||
return int(v)
|
||||
return v.strip("'\"")
|
||||
|
||||
|
||||
def status():
|
||||
import urllib.request
|
||||
try:
|
||||
with urllib.request.urlopen(STATUS_URL, timeout=25) as r:
|
||||
return json.loads(r.read())
|
||||
except Exception:
|
||||
return {"services": [], "groups": {}, "total": 0, "up": 0}
|
||||
|
||||
|
||||
def disk():
|
||||
st = os.statvfs("/")
|
||||
used = 1 - st.f_bavail / st.f_blocks
|
||||
return round(used * 100, 1)
|
||||
|
||||
|
||||
def swap():
|
||||
try:
|
||||
for line in open("/proc/meminfo"):
|
||||
if line.startswith("SwapTotal"):
|
||||
total = int(line.split()[1])
|
||||
if line.startswith("SwapFree"):
|
||||
free = int(line.split()[1])
|
||||
return round(100 * (total - free) / total, 1) if total else 0.0
|
||||
except Exception:
|
||||
return 0.0
|
||||
|
||||
|
||||
def backup_age_hours():
|
||||
"""Сколько часов самому свежему дампу/архиву."""
|
||||
best = None
|
||||
for root in ("/mnt/backups", "/root/matrix-backups"):
|
||||
for dirpath, _, files in os.walk(root):
|
||||
for f in files:
|
||||
if not (f.endswith((".gz", ".tar.gz", ".sql.gz", ".zst", ".tar"))):
|
||||
continue
|
||||
p = os.path.join(dirpath, f)
|
||||
try:
|
||||
m = os.path.getmtime(p)
|
||||
except Exception:
|
||||
continue
|
||||
if best is None or m > best:
|
||||
best = m
|
||||
if not best:
|
||||
return None
|
||||
return round((time.time() - best) / 3600, 1)
|
||||
|
||||
|
||||
def tcp(ip, port, timeout=1.2):
|
||||
try:
|
||||
with socket.create_connection((ip, port), timeout=timeout):
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
def notify(title, message):
|
||||
import urllib.request
|
||||
body = json.dumps({"title": title, "message": message}).encode()
|
||||
req = urllib.request.Request(NOTIFY, data=body, method="POST",
|
||||
headers={"Content-Type": "application/json"})
|
||||
try:
|
||||
urllib.request.urlopen(req, timeout=15).read()
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
def check_group(name, group, st):
|
||||
"""Проверка группы: сервисы + доп. проверки."""
|
||||
wanted = [x for x in (group.get("services") or []) if x]
|
||||
services = st.get("services") or []
|
||||
checked, down = 0, []
|
||||
for svc in wanted:
|
||||
matches = [s for s in services
|
||||
if svc in (s.get("name") or "") or (s.get("name") or "") in svc]
|
||||
if not matches:
|
||||
continue
|
||||
checked += len(matches)
|
||||
for m in matches:
|
||||
if not m.get("up"):
|
||||
down.append(m.get("name"))
|
||||
down = sorted(set(down))
|
||||
extra = {}
|
||||
checks = group.get("extra_checks") or []
|
||||
if "disk" in checks:
|
||||
extra["disk_used_pct"] = disk()
|
||||
if "swap" in checks:
|
||||
extra["swap_used_pct"] = swap()
|
||||
if "backups" in checks:
|
||||
extra["newest_backup_hours"] = backup_age_hours()
|
||||
if "tls" in checks:
|
||||
extra["tls_ok"] = tcp("127.0.0.1", 443)
|
||||
if "ha_api" in checks:
|
||||
extra["ha_ok"] = tcp("192.168.1.106", 8123)
|
||||
if "zigbee" in checks:
|
||||
extra["zigbee_bridge"] = tcp("192.168.1.10", 8098)
|
||||
return {
|
||||
"group": name,
|
||||
"checked": checked,
|
||||
"down": down,
|
||||
"extra": extra,
|
||||
}
|
||||
|
||||
|
||||
def main():
|
||||
groups_doc = read_yaml(os.path.join(AGENTS_DIR, "groups.yaml"))
|
||||
policy = read_yaml(os.path.join(AGENTS_DIR, "policy.yaml"))
|
||||
st = status()
|
||||
os.makedirs(JOURNAL, exist_ok=True)
|
||||
stamp = datetime.now().strftime("%Y-%m-%d")
|
||||
reports = []
|
||||
|
||||
for name, group in (groups_doc.get("groups") or {}).items():
|
||||
if not isinstance(group, dict):
|
||||
continue
|
||||
rep = check_group(name, group, st)
|
||||
rep["agent"] = group.get("agent")
|
||||
rep["ts"] = datetime.now().isoformat(timespec="seconds")
|
||||
reports.append(rep)
|
||||
path = os.path.join(JOURNAL, f"{stamp}-{rep['agent']}.json")
|
||||
json.dump(rep, open(path, "w", encoding="utf-8"), ensure_ascii=False)
|
||||
|
||||
total_down = sum(len(r["down"]) for r in reports)
|
||||
total_checked = sum(r["checked"] for r in reports)
|
||||
print(f"проверено сервисов: {total_checked}, проблем: {total_down}")
|
||||
for r in reports:
|
||||
tail = f" — {', '.join(r['down'])}" if r["down"] else ""
|
||||
print(f" {r['group']:<14} {r['checked'] - len(r['down'])}/{r['checked']}{tail}")
|
||||
for k, v in (r["extra"] or {}).items():
|
||||
print(f" {k}: {v}")
|
||||
|
||||
# Голова: сообщает только если есть проблемы и не тихие часы
|
||||
hour = datetime.now().hour
|
||||
quiet = hour >= 23 or hour < 8
|
||||
if total_down and not quiet:
|
||||
lines = [f"⚠️ Проблемы: {total_down}"]
|
||||
for r in reports:
|
||||
if r["down"]:
|
||||
lines.append(f"• {r['group']}: {', '.join(r['down'])}")
|
||||
notify("Страж: проблемы в сервисах", "\n".join(lines))
|
||||
print(" уведомление отправлено")
|
||||
else:
|
||||
print(" уведомление не нужно")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,9 @@
|
||||
name: automaton
|
||||
title: Автомат
|
||||
group: automation
|
||||
mission: n8n, боты, сценарии, доставка уведомлений, дайджест.
|
||||
allowed: [A, B]
|
||||
forbidden: [delete_workflow]
|
||||
schedule: "*/20 * * * *"
|
||||
kpi: {webhooks_ok: true, bots_active: true}
|
||||
escalate: chief
|
||||
@@ -0,0 +1,8 @@
|
||||
name: chief
|
||||
title: Голова
|
||||
group: all
|
||||
mission: Собирать отчёты, разрешать конфликты, эскалировать человеку, вести приоритеты.
|
||||
allowed: [A]
|
||||
forbidden: [direct_change]
|
||||
schedule: "5 12 * * *"
|
||||
reports_to: owner
|
||||
@@ -0,0 +1,9 @@
|
||||
name: domovoy
|
||||
title: Домовой
|
||||
group: home
|
||||
mission: Устройства, Zigbee, MQTT, сценарии, интеграции Home Assistant.
|
||||
allowed: [A]
|
||||
forbidden: [change_zigbee_channel, remove_device]
|
||||
schedule: "*/15 * * * *"
|
||||
kpi: {zigbee_online: true, ha_ok: true}
|
||||
escalate: keeper
|
||||
@@ -0,0 +1,9 @@
|
||||
name: keeper
|
||||
title: Хранитель
|
||||
group: core
|
||||
mission: Следить за входом, сертификатами, DNS, БД и бэкапами; восстанавливать первым.
|
||||
allowed: [A, B]
|
||||
forbidden: [delete_backup, change_dns, rotate_root_password]
|
||||
schedule: "*/30 * * * *"
|
||||
kpi: {backup_age_hours_max: 26, disk_max: 85, swap_max: 50}
|
||||
escalate: chief
|
||||
@@ -0,0 +1,9 @@
|
||||
name: librarian
|
||||
title: Библиотекарь
|
||||
group: knowledge
|
||||
mission: Документы, книги, закладки, git, файлы, индексация.
|
||||
allowed: [A, B]
|
||||
forbidden: [delete_documents]
|
||||
schedule: "0 6 * * *"
|
||||
kpi: {paperless_ok: true, gitea_ok: true}
|
||||
escalate: chief
|
||||
@@ -0,0 +1,9 @@
|
||||
name: mediator
|
||||
title: Медиатор
|
||||
group: media
|
||||
mission: Библиотеки, каталог, метаданные, субтитры, запросы.
|
||||
allowed: [A, B]
|
||||
forbidden: [delete_media]
|
||||
schedule: "0 */2 * * *"
|
||||
kpi: {arr_ok: true, bazarr_linked: true}
|
||||
escalate: chief
|
||||
@@ -0,0 +1,9 @@
|
||||
name: watcher
|
||||
title: Страж
|
||||
group: observability
|
||||
mission: Метрики, алерты, SLO, разбор инцидентов, журнал.
|
||||
allowed: [A]
|
||||
forbidden: [change_retention, delete_metrics]
|
||||
schedule: "*/10 * * * *"
|
||||
kpi: {prometheus_ok: true, alerts_delivered: true}
|
||||
escalate: chief
|
||||
@@ -0,0 +1,54 @@
|
||||
version: 1
|
||||
# Группы сервисов и их секретари. Источник: services.yaml (ключ group).
|
||||
|
||||
groups:
|
||||
core:
|
||||
title: Ядро
|
||||
agent: keeper
|
||||
criticality: high
|
||||
services: [authentik-security-server-1, authentik-security-worker-1,
|
||||
authentik-security-postgresql-1, authentik-security-redis-1,
|
||||
homeassistant-db, matrix-synapse, element-web, gitea, postgres]
|
||||
extra_checks: [disk, swap, backups, tls]
|
||||
|
||||
home:
|
||||
title: Дом
|
||||
agent: domovoy
|
||||
criticality: high
|
||||
services: [homeassistant, mosquitto, zigbee2mqtt, adguard, frigate]
|
||||
extra_checks: [zigbee, ha_api]
|
||||
|
||||
media:
|
||||
title: Медиа
|
||||
agent: mediator
|
||||
criticality: normal
|
||||
services: [jellyfin, plex, radarr, sonarr, lidarr, prowlarr, bazarr,
|
||||
seerr, tautulli, navidrome, calibre-web, immich_database,
|
||||
immich_machine_learning, qbittorrent]
|
||||
extra_checks: [library_counts]
|
||||
|
||||
knowledge:
|
||||
title: Знания
|
||||
agent: librarian
|
||||
criticality: normal
|
||||
services: [paperless, gitea, nextcloud, linkding, freshrss, syncthing, mealie]
|
||||
extra_checks: [documents]
|
||||
|
||||
automation:
|
||||
title: Автоматизация
|
||||
agent: automaton
|
||||
criticality: high
|
||||
services: [n8n, hub-core, book-bot, tg-admin-bot, dashy, catalog]
|
||||
extra_checks: [bots, workflows]
|
||||
|
||||
observability:
|
||||
title: Наблюдаемость
|
||||
agent: watcher
|
||||
criticality: high
|
||||
services: [prometheus, alertmanager, grafana, loki, uptime_kuma]
|
||||
extra_checks: [alerts]
|
||||
|
||||
chief:
|
||||
agent: chief
|
||||
schedule: "12:05"
|
||||
reports_to: owner
|
||||
@@ -0,0 +1,46 @@
|
||||
version: 1
|
||||
# Политика действий агентов.
|
||||
|
||||
classes:
|
||||
A:
|
||||
title: Безопасное
|
||||
auto: true
|
||||
examples: [restart_container, cleanup_logs, health_check, vacuum_journal]
|
||||
limits:
|
||||
actions_per_hour: 10
|
||||
actions_per_day: 50
|
||||
B:
|
||||
title: Заметное
|
||||
auto: true
|
||||
notify: journal
|
||||
examples: [update_container, rotate_logs, reindex_library, refresh_cache]
|
||||
limits:
|
||||
actions_per_hour: 3
|
||||
actions_per_day: 10
|
||||
C:
|
||||
title: Рискованное
|
||||
auto: false
|
||||
approval: matrix_owner
|
||||
examples: [change_config, migrate_data, delete_service, change_dns]
|
||||
D:
|
||||
title: Запрещено
|
||||
auto: false
|
||||
approval: never
|
||||
examples: [delete_backup, read_secrets, change_router_config, disable_2fa]
|
||||
|
||||
notifications:
|
||||
owner:
|
||||
channels: [matrix]
|
||||
max_per_day: 3
|
||||
quiet_hours: "23:00-08:00"
|
||||
digest: "12:00"
|
||||
family:
|
||||
channels: [matrix]
|
||||
only: [personal]
|
||||
journal: /var/lib/hub-agents/journal
|
||||
|
||||
safety:
|
||||
dry_run_first_days: 14
|
||||
snapshot_before_change: true
|
||||
auto_rollback_if_unhealthy: true
|
||||
max_parallel_actions: 1
|
||||
@@ -21,3 +21,20 @@
|
||||
|
||||
Мониторинг и Home Assistant теперь пишут в Matrix: если что-то упало —
|
||||
узнаете сразу, а не случайно.
|
||||
|
||||
## 2026-10-21 — Вики как единая истина
|
||||
|
||||
Вся документация теперь в Gitea Wiki: архитектура, карточки сервисов, агенты,
|
||||
регламенты. Открывается по адресу `git.buryans.ru/agent-qwen/buryan-infra/wiki`.
|
||||
|
||||
## 2026-10-21 — Страница статуса
|
||||
|
||||
`hub.buryans.ru/status` показывает, что работает прямо сейчас: 62 сервиса
|
||||
по группам, обновление раз в минуту. Не нужно спрашивать «а оно живое?».
|
||||
|
||||
## 2026-10-21 — Рой агентов
|
||||
|
||||
Появились шесть секретарей направлений: Хранитель (ядро), Домовой (дом),
|
||||
Медиатор (медиа), Библиотекарь (знания), Автомат (автоматизация), Страж
|
||||
(наблюдаемость) и Голова. Пока они только смотрят и предлагают — ничего
|
||||
не меняют без разрешения. Отчёт приходит, только если есть проблема.
|
||||
@@ -0,0 +1,339 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Генерирует страницы Wiki из реестра и документов."""
|
||||
import os
|
||||
import re
|
||||
|
||||
REPO = "/root/buryan-infra"
|
||||
OUT = "/root/wiki"
|
||||
REG = os.path.join(REPO, "ops/registry/services.yaml")
|
||||
|
||||
|
||||
def parse_registry():
|
||||
text = open(REG, encoding="utf-8").read()
|
||||
facts = {}
|
||||
for m in re.finditer(r"^ (guests_ct|guests_vm|containers|domains|databases): (.+)$", text, re.M):
|
||||
facts[m.group(1)] = m.group(2).strip()
|
||||
services = []
|
||||
cur = None
|
||||
for line in text.splitlines():
|
||||
if line.startswith(" - key:"):
|
||||
if cur:
|
||||
services.append(cur)
|
||||
cur = {"key": line.split(":", 1)[1].strip().strip('"')}
|
||||
elif cur is not None and line.startswith(" "):
|
||||
k, _, v = line.strip().partition(":")
|
||||
cur[k] = v.strip().strip('"')
|
||||
if cur:
|
||||
services.append(cur)
|
||||
return facts, services
|
||||
|
||||
|
||||
def page_home(facts):
|
||||
return f"""# Buryans Hub — база знаний
|
||||
|
||||
Центральная истина проекта. Всё, что здесь описано, работает на домашнем
|
||||
сервере Proxmox VE.
|
||||
|
||||
## Что такое Hub
|
||||
|
||||
Дом, который сам себя обслуживает: единый вход, единый канал уведомлений,
|
||||
единый реестр сервисов, рой агентов-секретарей.
|
||||
|
||||
## Цифры
|
||||
|
||||
| Параметр | Значение |
|
||||
|---|---|
|
||||
| Гостей | {facts.get('guests_ct', '?')} CT + {facts.get('guests_vm', '?')} ВМ |
|
||||
| Контейнеров | {facts.get('containers', '?')} |
|
||||
| Доменов | {facts.get('domains', '?')} |
|
||||
| Баз данных | {facts.get('databases', '?')} |
|
||||
|
||||
## Разделы
|
||||
|
||||
- [Архитектура](Architecture) — группы сервисов, потоки
|
||||
- [Сервисы](Services) — карточки всех сервисов
|
||||
- [Агенты](Agents) — рой и правила
|
||||
- [Дорожная карта](Roadmap) — что и когда
|
||||
- [Регламенты](Runbooks) — что делать при сбое
|
||||
- [Решения (ADR)](ADR) — почему сделано так
|
||||
- [Онбординг](Onboarding) — как добавить человека или сервис
|
||||
- [Работа: ВКС/Presale](Work) — отдельный контур
|
||||
|
||||
## Главные документы
|
||||
|
||||
- `ops/audit/FULL-AUDIT-2026-10-20.md` — состояние системы
|
||||
- `ops/audit/AUDIT-2026-10-21-VISION.md` — аудит развития
|
||||
- `ops/registry/services.yaml` — реестр
|
||||
- `ops/product/WHATS-NEW.md` — что нового для людей
|
||||
|
||||
## Правила
|
||||
|
||||
1. Нет карточки в Wiki — сервиса не существует.
|
||||
2. Нет ADR — изменение не начинается.
|
||||
3. У каждого сервиса есть бэкап, SSO и владелец.
|
||||
4. Уведомления — не больше трёх в день человеку.
|
||||
"""
|
||||
|
||||
|
||||
def page_architecture():
|
||||
return """# Архитектура
|
||||
|
||||
## Шесть групп
|
||||
|
||||
| Группа | Назначение | Агент |
|
||||
|---|---|---|
|
||||
| Ядро | вход, сеть, БД, бэкапы | Хранитель |
|
||||
| Дом | устройства, сценарии | Домовой |
|
||||
| Медиа | фильмы, музыка, книги, фото | Медиатор |
|
||||
| Знания | документы, код, файлы, закладки | Библиотекарь |
|
||||
| Автоматизация | n8n, боты, hub-core | Автомат |
|
||||
| Наблюдаемость | метрики, алерты, логи | Страж |
|
||||
|
||||
Над ними — **Голова**: сводка, приоритеты, эскалация.
|
||||
|
||||
## Потоки
|
||||
|
||||
```
|
||||
Пользователь → Authentik (SSO + TOTP) → сервис
|
||||
Событие → hub-core / MQTT → агент → действие или журнал
|
||||
Контент → библиотека → дайджест 12:00 → Matrix
|
||||
Инцидент → Страж → Голова → Matrix (с приоритетом)
|
||||
```
|
||||
|
||||
## Принципы
|
||||
|
||||
1. **Один вход** — Authentik.
|
||||
2. **Один канал** — Matrix, с резервом в Telegram.
|
||||
3. **Один реестр** — `services.yaml`.
|
||||
4. **Один журнал** — действия агентов.
|
||||
5. **Одна истина** — эта Wiki.
|
||||
"""
|
||||
|
||||
|
||||
def page_services(facts, services):
|
||||
groups = {}
|
||||
for s in services:
|
||||
groups.setdefault(s.get("group", "other"), []).append(s)
|
||||
names = {
|
||||
"core": "Ядро", "home": "Дом", "media": "Медиа", "knowledge": "Знания",
|
||||
"automation": "Автоматизация", "observability": "Наблюдаемость",
|
||||
"support": "Служебные", "other": "Прочее",
|
||||
}
|
||||
out = [f"# Сервисы\n", f"Всего контейнеров: **{len(services)}**.\n"]
|
||||
for g in ("core", "home", "media", "knowledge", "automation", "observability", "support", "other"):
|
||||
items = groups.get(g) or []
|
||||
if not items:
|
||||
continue
|
||||
out.append(f"\n## {names.get(g, g)} ({len(items)})\n")
|
||||
out.append("| Сервис | CT | Образ | Критичность |")
|
||||
out.append("|---|---|---|---|")
|
||||
for s in sorted(items, key=lambda x: x.get("name", "")):
|
||||
out.append(f"| `{s.get('name')}` | {s.get('ct')} | {s.get('image', '')[:48]} | {s.get('criticality')} |")
|
||||
out.append("\n## Как добавить сервис\n")
|
||||
out.append("1. Добавить в `services.yaml` (или перегенерировать реестр).")
|
||||
out.append("2. Создать карточку: домен, порт, SSO, бэкап, владелец.")
|
||||
out.append("3. Настроить мониторинг и бэкап.")
|
||||
out.append("4. Записать анонс в `ops/product/WHATS-NEW.md`.")
|
||||
return "\n".join(out)
|
||||
|
||||
|
||||
def page_agents():
|
||||
return """# Агенты
|
||||
|
||||
## Рой
|
||||
|
||||
| Агент | Группа | Отвечает |
|
||||
|---|---|---|
|
||||
| Хранитель | Ядро | вход, TLS, DNS, бэкапы, восстановление |
|
||||
| Домовой | Дом | устройства, сценарии, Zigbee, HA |
|
||||
| Медиатор | Медиа | библиотеки, каталог, метаданные |
|
||||
| Библиотекарь | Знания | документы, книги, закладки, git |
|
||||
| Автомат | Автоматизация | n8n, боты, сценарии |
|
||||
| Страж | Наблюдаемость | метрики, алерты, SLO |
|
||||
| Голова | все | сводка, приоритеты, эскалация |
|
||||
|
||||
## Классы действий
|
||||
|
||||
| Класс | Что | Кто решает |
|
||||
|---|---|---|
|
||||
| A | перезапуск упавшего, чистка логов, health | агент сам |
|
||||
| B | обновление, ротация, переиндексация | агент + журнал |
|
||||
| C | конфиг, миграция, удаление | владелец в Matrix |
|
||||
| D | бэкапы, DNS, секреты | запрещено автоматизировать |
|
||||
|
||||
## Режимы
|
||||
|
||||
1. **Наблюдатель** — только читает и предлагает (первая неделя).
|
||||
2. **Класс A** — безопасные действия сам.
|
||||
3. **Класс B** — с записью в журнал.
|
||||
4. **Класс C** — только с подтверждением.
|
||||
|
||||
## Журнал
|
||||
|
||||
`/var/lib/hub-agents/journal/` — по файлу на агента в день.
|
||||
Голова агрегирует и присылает сводку только при проблемах.
|
||||
"""
|
||||
|
||||
|
||||
def page_roadmap():
|
||||
return """# Дорожная карта
|
||||
|
||||
| Фаза | Статус | Результат |
|
||||
|---|---|---|
|
||||
| 0. Скелет | ✅ сделано | реестр, Wiki, статус-страница, сверка с аудитом |
|
||||
| 1. Агенты-наблюдатели | 🔄 в работе | 6 агентов «читать и предлагать», журнал |
|
||||
| 2. Автономия A | ⏳ | перезапуск, чистка, health |
|
||||
| 3. Автономия B | ⏳ | обновления, ротация |
|
||||
| 4. Класс C + Голова | ⏳ | подтверждения, сводки |
|
||||
| 5. Быт | ⏳ | Grocy, Vikunja, Actual, Mealie |
|
||||
| 6. Работа | ⏳ | Presale Cockpit |
|
||||
| 7. Интеллект | ⏳ | RAG, CLIP, MCP |
|
||||
| 8. Устойчивость | ⏳ | учения, резервный канал, UPS |
|
||||
|
||||
Подробно — `ops/audit/AUDIT-2026-10-21-VISION.md`.
|
||||
"""
|
||||
|
||||
|
||||
def page_runbooks():
|
||||
return """# Регламенты
|
||||
|
||||
## Сервис не отвечает
|
||||
|
||||
1. `!статус` или статус-страница — что именно упало.
|
||||
2. Проверить контейнер: `docker ps -a | grep <имя>`.
|
||||
3. Логи: `docker logs --tail 50 <имя>`.
|
||||
4. Перезапуск: `docker restart <имя>` (класс A).
|
||||
5. Если не помогло — смотреть зависимости (БД, SSO, сеть).
|
||||
6. Записать в журнал.
|
||||
|
||||
## Matrix недоступен
|
||||
|
||||
1. `pct exec 155 -- docker ps` — Synapse.
|
||||
2. Логи Synapse.
|
||||
3. Резервный канал — Telegram (userbot).
|
||||
|
||||
## Диск заполнен
|
||||
|
||||
1. `df -h`, `lvs` — что растёт.
|
||||
2. Логи: journald, nginx, docker json.
|
||||
3. Чистка безопасна (класс A), удаление данных — только с подтверждением.
|
||||
|
||||
## Бэкап не создался
|
||||
|
||||
1. Проверить cron и `/mnt/backups`.
|
||||
2. Проверить место.
|
||||
3. Запустить вручную и убедиться.
|
||||
"""
|
||||
|
||||
|
||||
def page_adr():
|
||||
return """# Решения (ADR)
|
||||
|
||||
## ADR-001. Gitea — центральная истина
|
||||
Вся документация, реестр и решения живут в Gitea. Wiki — точка входа.
|
||||
Причина: знания не должны зависеть от памяти одного человека.
|
||||
|
||||
## ADR-002. Authentik как единый вход
|
||||
Все сервисы за SSO, 2FA обязателен.
|
||||
Причина: один пароль, один контур безопасности.
|
||||
|
||||
## ADR-003. Matrix как единый канал
|
||||
Уведомления, боты, отчёты — в Matrix. Резерв — Telegram.
|
||||
Причина: не десять приложений, а один канал.
|
||||
|
||||
## ADR-004. Реестр сервисов как код
|
||||
`services.yaml` генерируется из факта и правится вручную только осознанно.
|
||||
Причина: «что у нас есть» должно быть проверяемым.
|
||||
|
||||
## ADR-005. Агенты начинают с наблюдения
|
||||
Сначала только читают и предлагают, права добавляются постепенно.
|
||||
Причина: автономия без доверия опасна.
|
||||
"""
|
||||
|
||||
|
||||
def page_onboarding():
|
||||
return """# Онбординг
|
||||
|
||||
## Добавить человека
|
||||
|
||||
1. Authentik → Directory → Users → создать.
|
||||
2. Добавить в группы (family, медиа, книги).
|
||||
3. Выдать доступы к сервисам (SSO автоматически).
|
||||
4. Пользователь при первом входе настраивает TOTP.
|
||||
5. Добавить в нужные Matrix-комнаты.
|
||||
|
||||
## Добавить сервис
|
||||
|
||||
1. Развернуть в отдельном CT.
|
||||
2. Завести oauth2-proxy и домен.
|
||||
3. Добавить в `services.yaml` (или перегенерировать).
|
||||
4. Настроить бэкап (данные + конфиг).
|
||||
5. Добавить монитор в Kuma/Strap.
|
||||
6. Записать карточку в Wiki.
|
||||
7. Анонс в `ops/product/WHATS-NEW.md`.
|
||||
|
||||
## Добавить агента
|
||||
|
||||
1. Описать ТЗ в `/opt/hub-agents/agents/<имя>.yaml`.
|
||||
2. Указать группу, классы действий, расписание.
|
||||
3. Запустить в режиме «наблюдатель».
|
||||
4. Через неделю — включить класс A.
|
||||
"""
|
||||
|
||||
|
||||
def page_work():
|
||||
return """# Работа: ВКС/Presale
|
||||
|
||||
Отдельный контур для рабочих задач: требования, сравнения ВКС,
|
||||
заметки встреч, шаблоны КП.
|
||||
|
||||
## Задача
|
||||
|
||||
Много данных и рутины: требования заказчиков, сравнение решений,
|
||||
история договорённостей, шаблоны документов.
|
||||
|
||||
## Стек (план)
|
||||
|
||||
| Блок | Инструмент |
|
||||
|---|---|
|
||||
| База знаний | эта Wiki + `buryan-work` |
|
||||
| Заметки встреч | Whisper + Ollama |
|
||||
| Задачи | Vikunja |
|
||||
| CRM-lite | Twenty / EspoCRM |
|
||||
| Документы | OnlyOffice / Docuseal |
|
||||
| Автоматизация | n8n |
|
||||
|
||||
## MVP
|
||||
|
||||
1. Шаблоны КП, ТЗ, чек-лист.
|
||||
2. Матрица сравнения ВКС.
|
||||
3. Транскрипция встречи → выжимка → база.
|
||||
4. Бот `!пресейл <клиент>` — история и следующие шаги.
|
||||
|
||||
Приватность: всё локально, без облаков.
|
||||
"""
|
||||
|
||||
|
||||
def main():
|
||||
os.makedirs(OUT, exist_ok=True)
|
||||
facts, services = parse_registry()
|
||||
pages = {
|
||||
"Home.md": page_home(facts),
|
||||
"Architecture.md": page_architecture(),
|
||||
"Services.md": page_services(facts, services),
|
||||
"Agents.md": page_agents(),
|
||||
"Roadmap.md": page_roadmap(),
|
||||
"Runbooks.md": page_runbooks(),
|
||||
"ADR.md": page_adr(),
|
||||
"Onboarding.md": page_onboarding(),
|
||||
"Work.md": page_work(),
|
||||
}
|
||||
for name, text in pages.items():
|
||||
open(os.path.join(OUT, name), "w", encoding="utf-8").write(text)
|
||||
print("страниц:", len(pages))
|
||||
for name in pages:
|
||||
print(" ", name)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in new issue
Block a user