控制台 /console · 机房自动化执行中心展示说明书架构日志
第 02 章

🎛️控制台 /console

核心介绍

LZ-Agent 控制台页面,导航栏新增入口,三个分区:模型设置 / 执行记录 / Agent。

一、模型设置

  • 默认提供方下拉:选择默认 AI 提供方
  • 中转站模型 ID:可一键拉取中转站当前可用模型列表并点选填入
  • 中转站地址 / Key / 超时:配置自建中转站连接参数
  • 火山端点与 Key:(历史,已下线,保留清理逻辑)
  • 测试连通性:真实发请求,返回耗时与回复内容
  • 恢复默认:一键恢复默认配置

控制台模型设置

中转站接入参数

项 值
地址 .76:18080/v1
Key opencode-model-20260819
默认模型 Zen-big-pickle(实测 14.3s 最快)
provider 命名 relay(旧别名 lz-qwen3090 保留兼容)
单次临时指定 relay:<model_id> 语法,不影响全局设置

中转站可用模型(2026-10-18 实测)

模型 耗时 状态
Zen-big-pickle 14.6s 可用
Zen-space-bunny-free 22.8s 可用
Zen-longcat-2.5-preview-free 30.1s 可用
Zen-mimo-v2.6-flash-free 39.0s 可用
Zen-beam-free / Zen-deepseek-v4.1-flash-free / Zen-glm-5.3-flash-free / Zen-nemotron-3.5-super-vl-free — 502
Zen-jev-1.13-free / Zen-nemotron-3.5-lightning-free — 超时

API

方法 路径 说明
GET/PUT /api/model-settings 读取/更新模型设置
POST /api/model-settings/reset 恢复默认
POST /api/model-settings/test 测试连通性
GET /api/relay/models 拉取中转站 /v1/models

踩坑

  1. model_settings.update_settings 持锁后调用同样加锁的 get_settings → 非重入锁死锁导致 PUT 挂起,须用 threading.RLock
  2. 前端 Object.entries() 处理对象数组会把键变成索引号,导致下拉框值为空,须改用 forEach
  3. 切换到火山/豆包时测试按钮必失败:前端无条件把「中转站模型 ID」随测试请求发送;修复为仅 relay 类 provider 才带 model
  4. 设置未加载完就点保存会写坏配置:前端下拉为空直接拦下;后端把空字符串视为「未提供」

二、执行记录

控制台执行记录

  • 总数 / 运行中 / 成功 / 失败 统计
  • 按状态 / Agent / 关键词筛选的任务表
  • 含模型、轮次、耗时、详情跳转
  • 15 秒自动刷新

三、Agent

  • Agent 卡片:Skills、累计任务数
  • 兼容旧 provider 名(volcano-ds / doubao / lz-qwen3090):不再报错,一律回落中转站默认模型

四、模型设置持久化

  • 运行期模型设置持久化到 data/model_settings.json
  • 改后无需重启即对新建任务生效(mtime 缓存)
  • llm_provider 默认值:volcano-ds → relay

相关链接


本说明书由 Leon 独立整理维护 · 内容以现场实际为准