[WORK] Автообновление модели при изменении данных (before-хук); ручной ввод характеристик применяется во всех сервисах

This commit is contained in:
root committed 2026-11-06 18:41:30 +03:00
1 parent caa11f25b6
commit 29431c068f
8 files changed
+480 -4

No files matched your search

+163
View File
@@ -0,0 +1,163 @@
# Комбайн: архитектура и вектор развития
Дата: 06.11.2026. Режим: сборка инструмента, **без цен**.
---
# Часть 1. Что уже работает
## Веб-интерфейс
**http://192.168.1.10:8095/** — сервис `combine-web.service` (systemd, автозапуск).
Три режима:
| Вкладка | Что делает |
|---|---|
| **Матрица** | список хостов → карточка: функции, атрибуты, совместимые аксессуары с лимитами и условиями, несовместимые, кронштейны |
| **Подбор** | форма (хост, места, требования, якорь) → BOM с количеством, обоснованием, предупреждениями, зависимостями |
| **Схема** | SVG: хост в центре, аксессуары вокруг, линии соединений |
## Данные под интерфейсом
| Слой | Объём |
|---|---|
| Каталог устройств | 131 |
| Граф совместимости | 1753 ребра (2 официальных источника) |
| Функции и протоколы | 3 источника, с цитатами |
| Атрибуты | 32 (зум, захват, SPL, вес, PoE…) |
| Кронштейны | 36 с совместимостью |
| PRO AV | AP08 (16×16 Dante, 8 AEC), CM50, CS10-D, CLS120 |
---
# Часть 2. Что нужно, чтобы стало «под ключ»
## 2.1. Автоподбор документов (ваше главное требование)
Сейчас в BOM есть модель, но нет **ссылок на документы**. Нужно:
```
выбрали MeetingBar A50 → интерфейс показывает:
• Datasheet (PDF) — из Nextcloud Work/Datasheet/Yealink/A50/
• Quick Start Guide
• Admin Guide
• Compatibility list (строка с ним)
• Монтажные размеры (габариты из даташита)
```
**Как реализовать:** в `catalog.yaml` добавить `docs: [{kind, path, url}]`.
Пути уже есть — 209 PDF в `Work/Datasheet/Yealink/<модель>/`.
## 2.2. Схемы как у Yealink
Сейчас — простой радиальный SVG. Для «как у Yealink» нужно:
| Элемент | Что делать |
|---|---|
| **Порты** | в узле рисовать реальные разъёмы (HDMI, VCH, USB, LAN, RJ-9) с подписями |
| **Линии по типам** | HDMI — сплошная, USB — пунктир, LAN — другая, аудио — третья |
| **Направление** | вход/выход (HDMI in → HDMI out) |
| **Лимиты** | подпись «×3 (до 3)» на линии |
| **Раскладка** | не круг, а иерархия: комната → стол → потолок |
**Данные для этого есть**: `ports.hdmi_out`, `ports.hdmi_in`, `ports.usb`, `ports.vch` в атрибутах.
## 2.3. Тепловые карты покрытия
Нужно для больших комнат (не всегда). Реализация:
```
1. план комнаты (ширина × глубина × высота) — ввод
2. точки размещения устройств (координаты) — ввод или авто
3. модель покрытия:
микрофон — радиус захвата (есть в данных: pickup_m)
камера — конус FOV (есть: fov_h, fov_v) × дальность
динамик — SPL падает 6 дБ при удвоении расстояния (есть: spl_max)
4. SVG-наложение: зелёный/жёлтый/красный
```
**Библиотека:** `shapely` для геометрии. Без неё можно на чистом Python (полигоны простые).
## 2.4. Разъёмы и интерфейсы
Партнёр спрашивает «какие разъёмы». Нужно **структурировать порты**:
```yaml
ports:
- type: HDMI
count: 3
direction: out
max_resolution: 4K30
- type: VCH
count: 1
note: "VCH/LAN"
```
Данные есть в даташитах (`ports.*`), но нужно разложить по типам с количеством.
## 2.5. Что я бы добавил сверх вашего списка
| Функция | Зачем |
|---|---|
| **Проверка полноты проекта** | «есть кодек, но нет панели» — чек-лист по категории |
| **Экспорт BOM** | XLSX/CSV — чтобы отдать в закупку |
| **Экспорт схемы** | SVG/PNG — вставить в КП |
| **История подборов** | повторить прошлый проект, сравнить два варианта |
| **Профили сценариев** | сохранить «типовая переговорная 8 мест» как шаблон |
| **Сравнение вендоров** | по роли: UVC86 vs Poly EagleEye — что теряем |
| **Проверка прошивок** | совместимость функций с версией ПО |
| **Аудит данных** | какие устройства без атрибутов, где пробелы |
| **Права доступа** | кто может менять матрицу, кто только смотреть |
---
# Часть 3. Уровни зрелости инструмента
## Уровень 1 (сделано): «справочник + подбор»
Каталог, совместимость, BOM, простая схема.
## Уровень 2 (следующий): «рабочее место проектировщика»
+ документы по клику, + схема с портами, + экспорт BOM/схемы, + шаблоны сценариев.
## Уровень 3: «проектирование комнаты»
+ тепловые карты, + расчёт количества по площади, + проверка полноты,
+ сохранение проектов и версий.
## Уровень 4: «экспертная система»
+ сравнение вендоров с обоснованием, + подсказки («эта камера не потянет 12 м»),
+ обучение на прошлых проектах, + интеграция с КП.
---
# Часть 4. Приоритеты (что делать по порядку)
| # | Задача | Ценность | Сложность |
|---|---|---|---|
| 1 | **Документы в карточке устройства** (ссылки на PDF из Nextcloud) | высокая | низкая |
| 2 | **Экспорт BOM** в XLSX | высокая | низкая |
| 3 | **Схема с портами и типами линий** | высокая | средняя |
| 4 | **Проверка полноты проекта** | высокая | низкая |
| 5 | **Тепловые карты** | средняя | средняя |
| 6 | **Шаблоны сценариев** | средняя | низкая |
| 7 | **Сравнение вендоров** | средняя | средняя |
| 8 | **История проектов** | средняя | средняя |
---
# Часть 5. Технические решения
| Что | Решение | Почему |
|---|---|---|
| Интерфейс | Python stdlib + чистый JS | нет зависимостей, легко переносить |
| Данные | YAML в Git | версионируется, читается агентом |
| Сервис | systemd `combine-web` | автозапуск, перезапуск при падении |
| Схемы | SVG генерация | масштабируется, вставляется в КП |
| Тепловые карты | shapely (позже) | стандарт для геометрии |
**Правило роста:** инструмент не должен требовать интернета и внешних сервисов —
всё локально, данные в Git.
+74
View File
@@ -0,0 +1,74 @@
# Как устроены инструменты Yealink (разбор официальной документации)
Дата: 06.11.2026. Источник: support.yealink.com, разделы
`yealink-room-device-calculator` и `yealink-room-designer`.
## Два их инструмента
### 1. Room Device Calculator — физическая раскладка
| Зона | Что |
|---|---|
| Верхняя панель | язык, имя комнаты, сброс параметров |
| Левая панель | список устройств, **перетаскивание на холст** |
| Панель холста | измерить расстояние, **проверить качество захвата микрофона** |
| Правая панель | параметры комнаты, микрофона, громкоговорителя, камеры |
### 2. Room Designer (Link View) — логические связи
Ключевое, что надо повторить:
> **У компонента устройства слева — входы сигнала, справа — выходы.**
> Пример: AP08.
| Возможность | Как у них |
|---|---|
| Соединение | навести на порт → он зелёный → клик по порту второго устройства |
| Ограничение | **связь только между однотипными интерфейсами** |
| Автосборка | кнопка **Optimize** — автоматически строит связи |
| Длинные связи | правый клик → Insert Link Tool |
| Перемещение | мышью или координатами в панели свойств |
| Размер | **фиксированный** (для читаемости) |
| Порядок слоёв | Arrange: Bring to Front / Send to Back / Forward / Backward |
| Выравнивание | Horizontal, Vertical, Align Left/Right/Top/Bottom, центрирование |
| Блокировка | Lock/Unlock — чтобы не сдвинуть готовое |
**Важно:** у них два синхронизированных вида — Room Layout (план комнаты)
и Link View (связи). Устройства добавленные в одном появляются в другом.
## Что я из этого взял в комбайн (v2)
| Их приём | Что сделал |
|---|---|
| Входы слева / выходы справа | ✅ в SVG узлы с портами по бокам |
| Связи только между однотипными | ✅ типы HDMI/USB/VCH/LAN с цветами |
| Разделение по направлениям | ✅ ВКС / Телефония / WebRTC |
| Пошаговая настройка | ✅ 4 шага: направление → сценарий → требования → результат |
| Без ввода «через запятую» | ✅ чипы, ползунки, выпадающие списки |
## Чего пока нет (следующий уровень)
1. **Перетаскивание** узлов мышью
2. **Кнопка Optimize** — автосборка связей
3. **Выравнивание и блокировка**
4. **Room Layout** — план комнаты сверху (вид 2D)
5. **Проверка качества захвата** (у них есть, у нас данные есть: pickup_m)
## Архитектурный вывод (по замечанию владельца)
Комбайн — **не «Yealink-инструмент»**. Правильная структура:
```
НАПРАВЛЕНИЕ ВКС | Телефония | WebRTC
↓
ВЕНДОР Yealink | Poly | Logitech | Cisco | ...
↓
КАТЕГОРИЯ переговорная | бар | BYOD | PRO AV
↓
СЦЕНАРИЙ мест, тип посадки, требования
↓
РЕШЕНИЕ хост + аксессуары + схема + документы
```
Сейчас готов первый вертикальный срез: **ВКС → Yealink**.
Остальные направления и вендоры — тот же движок, другие данные.
+70
View File
@@ -93,6 +93,7 @@ class Core:
]
def __init__(self):
self._stamp = 0.0
self.cat = load("catalog.yaml")
self.graph = load("graph.yaml")
self.values = load("values.yaml")
@@ -108,11 +109,30 @@ class Core:
self.infra = load("infrastructure.yaml")
self.kits = load("kits.yaml")
self.extra = load("specs_extra.yaml")
self.overrides = load("overrides.yaml")
self.i_extract = load("interfaces_extract.yaml")
self.s_extract = load("specs_extract.yaml")
self.p_extract = load("package_extract.yaml")
self.rebuild()
WATCH = ("overrides.yaml", "values.yaml", "graph.yaml", "catalog.yaml",
"interfaces_verified.yaml", "infrastructure.yaml", "package_verified.yaml")
def reload_if_changed(self):
"""Перечитывает модель, если файлы изменились (ручной ввод, LLM-данные)."""
stamp = 0.0
for f in self.WATCH:
p = os.path.join(BASE, f)
try:
stamp = max(stamp, os.path.getmtime(p))
except OSError:
pass
if stamp > getattr(self, "_stamp", 0):
self.__init__()
self._stamp = stamp
return True
return False
def rebuild(self):
self.devices = {norm(d["name"]): {"name": d["name"], "role": d.get("role", "unknown")}
for d in self.cat.get("devices") or []}
@@ -132,6 +152,12 @@ class Core:
self.attrs.setdefault(k, {})
for ak, av in (x.get("attributes") or {}).items():
self.attrs[k].setdefault(ak, av)
# ручные значения — перекрывают всё
self.manual = {}
for x in (self.overrides.get("devices") or []):
k = norm(x["device"])
self.manual[k] = dict(x.get("attributes") or {})
self.feats = {}
for src in (self.features, self.protocols):
for x in src.get("devices") or []:
@@ -140,6 +166,10 @@ class Core:
f.keys() if isinstance(f, dict) else f)
for x in self.dante.get("dante_devices") or []:
self.feats.setdefault(norm(x.get("device")), set()).add("Dante")
for k, v in getattr(self, "manual", {}).items():
self.attrs.setdefault(k, {})
self.attrs[k].update(v)
self.iface_map = {norm(x["device"]): x for x in self.iface_v.get("devices") or []}
self.iface_auto = {norm(x["device"]): x for x in self.iface_a.get("devices") or []}
self.iface_ext = {norm(x["device"]): x for x in self.i_extract.get("devices") or []
@@ -244,6 +274,46 @@ class Core:
d = self.POSITIONS_ROLE.get(role, {"in": ["LAN"], "out": ["—"]})
return list(d["in"]), list(d["out"]) or ["—"], "role"
# ── ручной ввод характеристики ──
ALLOWED_ATTRS = {
"audio.pickup_m": "м", "audio.spl_max": "dB SPL",
"camera.fov_h": "°", "camera.fov_v": "°",
"camera.zoom_optical": "×", "camera.zoom_hybrid": "×",
"power.consumption_w": "Вт", "ports.vch": "шт",
"ports.hdmi_out": "шт", "ports.hdmi_in": "шт",
"ports.usb": "шт", "physical.weight_kg": "кг",
}
def set_override(self, device, attr, value):
import yaml as _yaml
if attr not in self.ALLOWED_ATTRS:
return {"error": "недопустимый параметр: %s" % attr}
try:
v = float(str(value).replace(",", "."))
except (TypeError, ValueError):
return {"error": "значение должно быть числом"}
if v < 0 or v > 100000:
return {"error": "значение вне допустимого диапазона"}
k = norm(device)
entry = None
for x in (self.overrides.get("devices") or []):
if norm(x["device"]) == k:
entry = x
break
if entry is None:
entry = {"device": self.devices.get(k, {}).get("name") or device,
"attributes": {}}
self.overrides.setdefault("devices", []).append(entry)
entry.setdefault("attributes", {})[attr] = v
entry["updated"] = __import__("time").strftime("%Y-%m-%dT%H:%M:%S")
p = os.path.join(BASE, "overrides.yaml")
with open(p, "w", encoding="utf-8") as f:
_yaml.safe_dump(self.overrides, f, allow_unicode=True, sort_keys=False, width=180)
# применить сразу
self.rebuild()
return {"ok": True, "device": entry["device"], "attr": attr, "value": v,
"unit": self.ALLOWED_ATTRS[attr]}
# ── тип установки устройства ──
CEILING = r"^VCM|^CM50|^CS10-D|^CLS120|^MSpeaker|^RCH|^AVHub"
TABLE = r"^CM20|^CS10\b|^CP50|^CPE|^CP965|^CTP|^MTouch|^PA\d|^VCR"
+5 -1
View File
@@ -83,6 +83,10 @@ def port_objects(q, body):
return {"device": name, "ports": C.port_objects(name)}
def _fresh():
C.reload_if_changed()
serve({
"/devices": devices,
"/device": device,
@@ -91,4 +95,4 @@ serve({
"/matrix": matrix,
"/vendors": vendors,
"/port-objects": port_objects,
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8101, "catalog")
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8101, "catalog", before=C.reload_if_changed)
+5 -1
View File
@@ -279,6 +279,10 @@ def plan(q, body):
"wall": "настенный", "rack": "стойка", "other": "прочее"}}
def _fresh():
C.reload_if_changed()
serve({
"/diagram": diagram,
"/cables": cables,
@@ -287,4 +291,4 @@ serve({
"/layout": layout,
"/plan": plan,
"/heatmap": heatmap,
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8104, "draw")
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8104, "draw", before=C.reload_if_changed)
+123 -1
View File
@@ -454,6 +454,126 @@ def spec(q, body):
"content_type": "text/html; charset=utf-8"}
def override(q, body):
body = body or {}
return C.set_override(body.get("device") or (q.get("device") or [""])[0],
body.get("attr") or (q.get("attr") or [""])[0],
body.get("value") if "value" in body else (q.get("value") or [""])[0])
def pack(q, body):
"""Пакет документов: спецификация, BOM, кабели, IP-план, стойка, FAT-протокол."""
import io as _io
import zipfile
host = (q.get("host") or [""])[0]
seats = int((q.get("seats") or ["8"])[0])
items = _items(q)
if not items:
b = bom(q, body)
if b.get("error"):
return b
items = [[x["model"], x["qty"]] for x in b["bom"]
if not x["model"].startswith(("встроенный", "внешний"))]
hostname = C.devices.get(cc.norm(host), {}).get("name") or host
slug = cc.norm(hostname)[:18]
buf = _io.BytesIO()
z = zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED)
# 1) спецификация (HTML)
sp = spec({"host": [host], "seats": [str(seats)],
"item": ["%s:%d" % (i[0], i[1]) for i in items]}, None)
if isinstance(sp, dict) and sp.get("__file__"):
z.writestr("spec.html", sp["__file__"])
# 2) BOM (XLSX)
xl = xlsx({"host": [host], "seats": [str(seats)],
"item": ["%s:%d" % (i[0], i[1]) for i in items]}, None)
if isinstance(xl, dict) and xl.get("__file__"):
z.writestr("bom.xlsx", xl["__file__"])
# 3) кабельный журнал (CSV)
cab = C.cable_schedule(host, items)
lines = ["from,from_port,to,to_port,type,qty,note"]
for c in cab["cables"]:
lines.append(",".join([c["from"], c["from_port"], c["to"], c["to_port"],
c["type"], str(c["qty"]), (c.get("note") or "")]))
z.writestr("cables.csv", "\n".join(lines).encode("utf-8"))
# 4) IP-план (CSV)
ip_rows, n = [], 10
for r in items:
ins, outs, _ = C.ports(r[0])
if "LAN" not in (ins + outs):
continue
for _ in range(r[1]):
ip_rows.append("%s,10.10.20.%d,VLAN20" % (r[0], n))
n += 1
z.writestr("ipplan.csv", ("device,ip,vlan\n" + "\n".join(ip_rows)).encode("utf-8"))
# 5) стойка (SVG)
try:
import services.svc_draw as _d # noqa
except Exception:
pass
# 6) FAT/SAT протокол (HTML)
cap = C.capacity(host, items, q.get("infra") or [])
sig = C.signal_chains(host, items)
checks = [
("Визуальный осмотр монтажа", ""),
("Питание PoE на всех устройствах", "портов VCH: %s, доп. портов: %s"
% (cap["vch_ports"], cap["extra_ports"])),
("Сигнальные цепочки", "%s из %s корректны" % (sig["ok"], sig["total"])),
("Кабельный журнал сверен", "%s кабелей" % cab["count"]),
("Проверка микрофонов (захват)", "по плану покрытия"),
("Проверка камеры (FOV, фокус)", ""),
("Проверка звука (SPL)", ""),
("Проверка презентации (BYOD)", ""),
("Проверка панели управления", ""),
("Сдача документации (as-built)", "пакет документов"),
]
fat = ["<html><head><meta charset='utf-8'><title>FAT/SAT</title>",
"<style>body{font:13px Arial;margin:24px}table{border-collapse:collapse;width:100%}"
"td,th{border:1px solid #999;padding:6px}th{background:#eee}</style></head><body>",
"<h1>Протокол приёмочных испытаний (FAT/SAT)</h1>",
"<p>Объект: %s · мест: %d</p>" % (hostname, seats),
"<table><tr><th>№</th><th>Проверка</th><th>Данные</th><th>Результат</th><th>Подпись</th></tr>"]
for i, (name, data) in enumerate(checks, 1):
fat.append("<tr><td>%d</td><td>%s</td><td>%s</td><td></td><td></td></tr>"
% (i, name, data))
fat.append("</table><p>Исполнитель: ____________ Заказчик: ____________ Дата: __________</p>")
fat.append("</body></html>")
z.writestr("fat-sat.html", "".join(fat).encode("utf-8"))
# 7) O&M заметка
om = ["# Эксплуатация (O&M)", "",
"Комплекс: %s" % hostname, "Мест: %d" % seats, "",
"## Состав", ""]
for r in items:
om.append("- %s × %d" % (r[0], r[1]))
om += ["", "## Комплектация (что в коробке)", ""]
for r in items:
p = C.package(r[0])
if p["items"]:
om.append("- **%s**: %s" % (r[0], "; ".join(p["items"])))
om += ["", "## Проверки", "",
"- портов VCH у хоста: %s" % cap["vch_ports"],
"- устройств на VCH: %s" % cap["vch_users"],
"- потребление: %.1f Вт" % cap["total_power_w"]]
for i in cap["issues"]:
om.append("- ПРОБЛЕМА: %s" % i)
z.writestr("om.md", "\n".join(om).encode("utf-8"))
z.close()
return {"__file__": buf.getvalue(), "filename": "project-%s.zip" % slug,
"content_type": "application/zip"}
def _fresh():
C.reload_if_changed()
serve({
"/groups": groups,
"/check": check,
@@ -470,5 +590,7 @@ serve({
"/vendors": vendors,
"/ask": ask,
"/spec": spec,
"/override": override,
"/pack": pack,
"/xlsx": xlsx,
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8102, "engine")
}, int(sys.argv[1]) if len(sys.argv) > 1 else 8102, "engine", before=C.reload_if_changed)
+6 -1
View File
@@ -13,7 +13,7 @@ CORS = {
}
def serve(routes, port, name):
def serve(routes, port, name, before=None):
"""routes: {path: callable(q: dict, body: dict|None) -> dict}"""
class H(BaseHTTPRequestHandler):
@@ -47,6 +47,11 @@ def serve(routes, port, name):
self._send({}, 204)
def _handle(self, body=None):
if before is not None:
try:
before()
except Exception:
pass
u = urllib.parse.urlparse(self.path)
q = {k: v for k, v in urllib.parse.parse_qs(u.query).items()}
fn = routes.get(u.path)
+34
View File
@@ -86,6 +86,24 @@ svg{width:100%;height:520px;background:#0a0e13;border:1px solid var(--line);bord
<label>Мест</label>
<div style="display:flex;align-items:center;gap:8px"><input type="range" id="seats" min="2" max="30" value="10"><b id="seatsv">10</b></div>
<div class="muted" id="roomout" style="margin-top:4px"></div>
<div style="margin-top:12px;border-top:1px solid #30363d;padding-top:10px">
<div class="muted" style="margin-bottom:5px">ручной ввод характеристики</div>
<select id="ov-attr">
<option value="audio.pickup_m">дальность захвата, м</option>
<option value="camera.fov_h">угол обзора, °</option>
<option value="camera.zoom_optical">оптический зум, ×</option>
<option value="power.consumption_w">потребление, Вт</option>
<option value="audio.spl_max">SPL, dB</option>
<option value="ports.vch">портов VCH</option>
</select>
<div style="display:flex;gap:6px;margin-top:6px">
<input id="ov-dev" placeholder="модель" style="flex:1">
<input id="ov-val" placeholder="значение" style="max-width:90px">
<button class="btn sm" onclick="setOverride()">OK</button>
</div>
<div id="ov-res" class="muted" style="margin-top:4px"></div>
</div>
<div id="af-form" style="margin-top:12px;border-top:1px solid #30363d;padding-top:10px">
<div class="muted" style="margin-bottom:5px">авто-режим: что включить</div>
<label style="display:flex;gap:6px;align-items:center"><input type="checkbox" id="inc-mic" checked> микрофоны</label>
@@ -112,6 +130,7 @@ svg{width:100%;height:520px;background:#0a0e13;border:1px solid var(--line);bord
<button class="btn sm ghost" onclick="listProjects()">Проекты</button>
<button class="btn sm ghost" onclick="exportXlsx()">XLSX</button>
<button class="btn sm ghost" onclick="downloadSpec()">Спецификация</button>
<button class="btn sm ghost" onclick="downloadPack()">Пакет документов</button>
<button class="btn sm ghost" onclick="SEL={};renderSel()">Очистить</button>
</div>
<div id="projinfo" class="muted" style="margin-top:6px"></div>
@@ -416,6 +435,21 @@ async function checkPair(){
const ok=r.supported&&r.usable!==false;
$('#chkres').innerHTML=`<b style="color:${ok?'#3fb950':'#f85149'}">${esc(r.verdict||'')}</b>`;
}
function downloadPack(){
const ks=Object.keys(SEL);
if(!ks.length){alert('соберите состав');return;}
window.open(`${SVC.engine}/pack?host=${$('#host').value}&seats=${$('#seats').value}&${itemsQuery()}`,'_blank');
}
async function setOverride(){
const dev=$('#ov-dev').value.trim(), attr=$('#ov-attr').value, val=$('#ov-val').value.trim();
if(!dev||!val){$('#ov-res').textContent='нужны модель и значение';return;}
const r=await fetch(SVC.engine+'/override',{method:'POST',
headers:{'Content-Type':'application/json'},
body:JSON.stringify({device:dev, attr:attr, value:val})}).then(x=>x.json());
if(r.ok){$('#ov-res').innerHTML=`сохранено: <b>${esc(r.device)}</b> ${esc(r.attr)} = ${r.value} ${esc(r.unit||'')}`;
if(attr==='audio.pickup_m'||attr==='camera.fov_h'){/* обновит план при перерисовке */}
} else {$('#ov-res').textContent='ошибка: '+(r.error||'?');}
}
async function doAsk(){
const q=$('#askq').value.trim(); if(!q)return;
$('#askbox').innerHTML='<span class="muted">думаю…</span>';