Web UI
OpenSquilla 的 Web UI 是用于设置、聊天 session、审批、channels、日志、agent、用量和运维状态的本地控制台。当你希望使用基于浏览器的聊天、可见的工具活动、持久化审批以及对运行时健康状态的快速视图时，它是最佳入口。
0.4.0 中默认的 Control UI 是由 gateway 提供的 Vue 产品 UI。旧版前端仅作为维护者回滚的兜底保留，而不是常规的用户路径。
启动 Web UI
在前台运行 gateway：
opensquilla gateway run打开：
http://127.0.0.1:18791/control/或者启动一个托管的后台 gateway：
opensquilla gateway start --json
opensquilla gateway status为安全起见，默认 gateway 绑定到 127.0.0.1。
关于 gateway 生命周期、主机/端口以及对外暴露的详情，参见 gateway.md。
主要区域
| 区域 | 用途 |
|---|---|
| Chat | 运行和恢复聊天 session，查看工具活动，启动 /meta 工作流，发布 artifact，并使用手动 compact 控件。 |
| Conversations | 从侧边栏切换活动 session，并让长时间运行的工作保持可见。 |
| Overview / Health | 查看就绪状态、provider 状态、记忆状态、sandbox 策略和恢复建议。 |
| Settings | 通过模态流程配置 provider、router、搜索、channels、权限和其他设置章节。 |
| Channels | 查看已配置 channel 适配器的状态，并跳转到引导式设置以进行配置更改。 |
| Skills | 浏览 skill 就绪状态和 MetaSkill 可用性。 |
| Sessions | 查看持久化的 session 账本和运维状态。 |
| Agents | 管理持久化 agent 条目。 |
| Usage | 查看 token 和预估成本的汇总。 |
| Cron | 查看和管理已调度的运行。 |
| Logs | 查看运行时日志和诊断信息。 |
| Approvals | 响应敏感工具调用的审批请求。 |
聊天 session
聊天 UI 支持：
- 流式 assistant 输出；
- 工具调用卡片；
- 针对 provider、router、工具和用量事件的 turn 活动与 RunTrace 视图；
- 敏感操作的内联审批请求；
- 在有预览可用时带缩略图的 artifact 卡片；
- 用于存放生成输出的交付物抽屉；
- 用于交接的分享和导出操作；
- 用于切换 session 的对话侧边栏；
- 在 gateway 支撑的聊天 session 上的
/meta列表与运行启动； - 在 compaction 或运行时工作进行中时的待发送消息队列行为；
- 手动
/compact； - 在可用时显示每个 turn 的用量和节省元数据；
- 可复制的 session key；
- 在窄屏上让聊天、session 和运维视图保持可达的移动端标签页。
使用 session 选择器在已有的 session 之间切换。在报告 bug 或请求另一个 OpenSquilla 入口查看同一 session 时，请复制 session key。
当你希望将代码修改通过 opensquilla code-task 来处理时，可以在聊天中启用 Coding 模式。启用 Coding 模式后，代码更改会使用 cli.md 中所述的受控宿主工作流，而不是普通的会话内编辑。
手动 compaction
长 session 可以从聊天中进行 compact。如果不需要 compaction，UI 会提示：
Already within context budget; no compact was applied如果 compaction 正在运行，请等待其终止状态再认为下一条消息已经具备 compact 后的上下文。参见 features/compaction-and-cache.md。
artifact
当 agent 发布一个文件时，Web UI 会显示一个 artifact 卡片。artifact 卡片可用于：
- 生成的 HTML 原型；
- 报告和简报；
- 导出的数据文件；
- PDF、幻灯片、图片以及其他生成的输出。
artifact 卡片可能包含缩略图或预览元数据，并且交付物抽屉会在原始 turn 滚动离开后仍让已发布的输出保持可发现。
关于 channel 投递限制和 artifact 恢复，参见 artifacts-and-media.md。
审批
某些工具需要确认。审批区域为操作者提供一个持久化的位置来批准或拒绝敏感操作，而不是将决定淹没在聊天文本中。
在以下情况使用审批区域：
- agent 想要写文件；
- 某个命令需要更高权限；
- 某个 channel 或外部操作需要人工确认；
- 无人值守自动化在执行有风险的操作前应该先暂停。
日志和诊断
进行本地诊断：
opensquilla diagnostics on
opensquilla gateway status
opensquilla doctor使用 Web UI 的日志和健康视图，将 provider 就绪状态、channel 状态、session 状态和用户可见的错误关联起来。
安全
Web UI 默认是本地的。如果你将 gateway 绑定到公开网络接口，请先配置 token 认证和网络管控：
opensquilla gateway run --listen 0.0.0.0 --port 18791不要将未认证的 gateway 暴露到公共互联网。