OpenSquilla Web UI 与 Electron 桌面端：本地 AI Agent 控制台的 6 大强大能力
OpenSquilla Web UI 与 Electron 桌面端：本地 AI Agent 控制台的 6 大强大能力
OpenSquilla 是一款注重 Token 效率的本地 AI Agent 框架，而它的 Web UI 控制台与 Electron 桌面端正是普通用户最友好的两个操作入口。通过浏览器访问本地 Gateway 的 Vue 控制台，或直接安装桌面应用，你可以管理会话、审批敏感操作、查看用量成本，并一键交付 AI 生成的产物——无需服务器，数据全部留在本机。
3 步打开本地 AI Agent 控制台
无论是 Web UI 还是桌面端，目标都指向同一个本地控制台（Control Console）。
方式一：浏览器访问 Web UI
- 终端运行网关（Gateway）：
opensquilla gateway run - 打开
http://127.0.0.1:18791/control/ - 立即进入控制台，开始会话
如果你更希望网关在后台托管运行，可以使用 opensquilla gateway start --json，再用 opensquilla gateway status 查看状态。默认情况下网关只绑定 127.0.0.1，确保控制台仅限本机访问，安全性拉满。
方式二：安装 Electron 桌面端（推荐给非技术用户）
macOS（Apple Silicon）与 Windows 均提供打包好的桌面安装包，安装后双击即可使用——无需 Node.js、无需 npm、无需手动启动任何进程。桌面端把 Vue 控制台和 Python 网关运行时一起封装进了 Electron 外壳，首次运行会自动弹出设置窗口，引导你配置模型供应商、Base URL 和 API Key。
Web UI 功能地图：一个控制台管全部
Web UI 不是单纯的聊天窗口，而是覆盖了 Agent 全生命周期的管理面板。官方文档 docs/web-ui.md 中列出了以下核心功能区：
| 功能区 | 用途 |
|---|---|
| Chat | 运行/恢复会话、查看工具活动、发布产物 |
| Conversations | 侧边栏切换会话，长任务状态一目了然 |
| Overview / Health | 查看供应商状态、记忆状态、沙箱姿态与恢复提示 |
| Settings | 以弹窗流程配置供应商、路由、搜索、渠道与权限 |
| Approvals | 集中审批敏感工具调用 |
| Usage | 查看 Token 与预估成本汇总 |
| Cron | 查看和管理定时任务 |
| Logs | 检查运行日志与诊断信息 |
| Skills / Sessions / Agents / Channels | 技能就绪度、会话台账、Agent 管理与渠道适配器状态 |
会话体验：流式输出 + 工具卡片 + 产物抽屉
聊天区（Chat）是控制台使用频率最高的区域，它对普通用户最友好的几项能力：
- 🌊 流式输出：助手回复实时逐字呈现，并附带工具调用卡片（tool-call cards）
- 🔍 RunTrace 视图：展开任意一轮，可查看供应商、路由、工具与用量事件
- 📦 产物卡片（Artifacts）：AI 生成的 HTML 原型、报告、PDF、幻灯片等会以带缩略图的卡片展示，并通过"Deliverables 抽屉"沉淀，长会话滚动后也能找回
- 🎯 /goal 目标模式：发起多轮持久目标，暂停/恢复、编辑、护栏状态全程可视化
- 💬 /meta 工作流：直接在会话中列出并启动元技能
- 🧹 /compact 手动压缩：长会话随时压缩上下文，节省 Token
- 📱 移动端适配：窄屏下以标签页保持聊天、会话与运维视图可达
敏感操作（如写文件、提权命令）会触发内联审批请求，审批决策直接出现在对话流中，无需翻聊天记录。
安全与运维：审批中心 + 日志诊断 + 健康总览
- Approvals（审批中心）：为"AI 想做什么"提供持久化的批准/拒绝入口，特别适合无人值守自动化在危险操作前主动暂停
- Logs & Diagnostics：与
opensquilla doctor、opensquilla diagnostics on等命令行诊断互相印证，快速定位供应商就绪、渠道与会话状态 - Health 总览：一页看清供应商、记忆、沙箱姿态与恢复建议
安全提示：控制台默认仅本地可用。若确需绑定公网接口，请先配置 Token 认证与网络控制，切勿将未认证的网关暴露到公网。
Electron 桌面端：本地 AI Agent 桌面应用的工程亮点
桌面端源码位于 desktop/electron/，其设计说明见 desktop/electron/README.md。对用户体验影响最大的几个点：
- 窗口永远先于网关出现：Electron 先加载本地渲染窗口，再在后台启动捆绑的 Gateway；即使网关启动失败，窗口依然可见并给出日志与重试按钮，不会出现"点了应用却没有窗口"
- API Key 加密存储：密钥通过 Electron
safeStorage加密，配置与状态统一存放在桌面端专属的userData目录，与终端安装的~/.opensquilla相互隔离 - 产物隔离预览：桌面端可为 HTML 产物提供类浏览器的独立预览，每个预览项使用独立的临时 Cookie/存储分区，且无法访问宿主 Gateway，安全隔离不妥协
- Dock/任务栏激活语义修复：macOS 下关闭窗口后点击 Dock 图标会聚焦或重建窗口并复用已有网关，不再重复启动
- 更新与签名：内置 electron-updater 更新通道，Windows 安装包走 DigiCert 签名流程（策略见 docs/code-signing-policy.md）
延伸阅读：文档与源码路径速查
- 📄 Web UI 官方文档：docs/web-ui.md
- 🖥️ 桌面端工程说明：desktop/electron/README.md
- 🚀 产品级任务文档：README.product.md
- 🧩 Web UI 前端源码：opensquilla-webui/src/
- 📡 网关与静态资源：src/opensquilla/gateway/
- 📜 发布说明：docs/releases/0.5.4.md
小结：OpenSquilla 的 Web UI 让你用浏览器管好一个本地 AI Agent 的全部"家务"，Electron 桌面端则把这一切打包成双击即用的原生体验——同预算、更高智能密度，这正是它吸引开发者和普通用户的理由。