# Web Console

Web 控制台提供一句话、快捷功能模式与手势控制入口，不在浏览器中生成 CAN。所有动作统一提交给后端编排、配置校验、安全门禁和执行链路。

当前页面包括：

- 一句话联动座椅、空调、天幕和氛围灯，支持 Enter 执行和 GPT/本地规则切换。
- 观影、午休、零重力快捷模式，以及当前副驾驶姿态的命名保存入口。
- 六阶段执行链路、整车联合孪生、领域状态、配置、CAN 计划和执行结果。
- 右侧手势控制抽屉，包含摄像头画面、关键点骨架、保持进度、动作速查与自定义映射。

UI 只展示可审计的“决策摘要”和“处理轨迹”，不展示模型私有思维过程。

当前座椅阶段一控制台为无构建静态页面，由 `cognitive_agent.server` 同源提供 API 和资源。运行：

```bash
make dev
```

局域网演示使用：

```bash
make dev-lan
```

其他设备访问启动日志打印的 `http://<LAN-IP>:8000`。页面与后端 API 由同一服务提供，无需单独配置前端地址。

公网入口由后端统一认证，前端不保存密码或 API Key。未认证访问自动进入
`/login`，主控制台提供退出按钮。固定入口是
`https://511.kendeji.fun`，应用容器只监听服务器回环地址，再由 Caddy 提供
HTTPS。部署方式见
[`deploy/server/README.md`](../../deploy/server/README.md)。

页面支持 GPT/本地解析切换、六阶段流水线、主副驾热舒适、五轴位置状态和 3D 座椅孪生、GPT 结构化能力请求、决策与校验轨迹、FunctionConfig、CommandPlan、虚拟帧和 ExecutionReport。硬件执行在服务端固定关闭，不是仅靠前端按钮限制。

## 手势资源与安全规则

手势模型随当前工程交付，默认位置为：

```text
assets/gesture/gesture_recognizer.task
../../config/gesture/default.yaml
```

后端提供 `/api/gesture/runtime` 和 `/api/gesture/model`，前端以二进制缓冲区加载模型，避免依赖外部 `seat_gesture_control` 目录。MediaPipe Web 运行时从 jsDelivr 按需加载；摄像头帧和手部关键点只在当前浏览器中处理。

安全规则：张掌保持 1 秒激活；动作保持 600 ms 且至少连续 8 帧才执行；换动作不重新锁止；握拳立即停止但不解除激活；3 秒无有效动作自动锁止；单次连续运动最多 1.5 秒；检测到多只手时不执行。自定义映射保存在浏览器 `localStorage`。

摄像头仅能在安全来源使用：本机访问 `http://127.0.0.1:8000`，远程访问必须使用 HTTPS。关闭抽屉、页面隐藏或离开页面时会立即停止摄像头轨道。