[🇺🇸 English](../../README.md) | [🇨🇳 中文](../../README.zh.md) # XWorkspace 控制台特性 本文档总结了 XWorkspace 控制台面向用户和操作者的特性。它旨在作为主页 README 中链接的详细特性参考。 ## 1. 产品范围 XWorkspace 控制台是一个本地 AI 工作区控制平面，它结合了： - 用于工作区导航的 React 仪表板 - 用于服务和健康状态的 Go API - 用于运行时编排的 systemd 用户服务 - 用于桌面集成的 XFCE 和 XDG 模板 - 对本地 AI 工具和服务的基于浏览器的访问 该控制台针对本地优先的使用场景进行了优化，浏览器充当主要的操作员界面。 ## 2. 主页体验 主页作为中央控制界面： - 显示工作区概览 - 呈现服务健康和运行时状态 - 提供对服务和选项卡的快速访问 - 保持布局紧凑且具有操作性 - 支持将图像和视频伪影审查作为自定义选项卡 README 中的主页预览是规范的视觉入口点。 ## 3. 选项卡系统 选项卡是在工作区不同区域之间导航的主要方式。 ### 内置选项卡 - `Workspace` (工作区) - 主要概览和仪表板入口 - `OpenClaw` - 网关访问和频道视图 - `LiteLLM` - 模型路由和提供商管理 - `Vault` (金库) - 机密和身份验证管理 - `Terminal` (终端) - 嵌入式的本地 Shell 访问 ### 自定义选项卡 控制台还可以托管用于面向伪影工作流的自定义选项卡。这正是图像和视频工作流自然契合的地方。 这种选项卡模型让工作区能够将审查、导航和运行时操作保持在一个地方，而不是将它们分散到不同的应用程序中。 ## 4. 图像和视频工作流 图像和视频工作流是首要的控制台用例。 它们被设计为支持： - 预览生成或导入的媒体 - 在查看服务状态的同时审查输出 - 在不离开控制台 Shell 的情况下，在伪影和运行时工具之间切换 - 将以媒体为中心的工作保持在同一个操作工作区内 ## 5. 服务集成 控制台集成了本地运行时服务，并将它们作为工作区体验的一部分暴露出来。 ### 核心服务 - 控制台仪表板 (Console dashboard) - Go 状态 API (Go status API) - 桥接控制平面 (Bridge control plane) - OpenClaw 网关 (OpenClaw Gateway) - LiteLLM UI/API - 金库 (Vault) - ttyd 终端 (ttyd terminal) ### 状态表面 仪表板可以使用： - `/health` - `/services` - `/metrics/simple` 这使得 UI 在保持响应的同时，仍能反映当前的本地运行时状态。 ## 6. 桌面集成 该代码库包含用于以下用途的桌面支持文件： - XFCE 会话和面板配置 - XDG 自动启动启动器 - systemd 用户单元 - Chrome 或 Chromium 应用模式启动路径 - 本地控制台启动脚本 这使得控制台很容易自动启动，并易于与最小化桌面 Shell 对齐。 ## 7. 访问模型 控制台专为本地优先访问而设计。 常见的访问点包括： - `http://127.0.0.1:17000` 用于主控制台 - `http://127.0.0.1:8788` 用于 Go API - `http://127.0.0.1:18789` 用于 OpenClaw - `http://127.0.0.1:4000/ui` 用于 LiteLLM - `http://127.0.0.1:8200/ui` 用于 Vault - `http://127.0.0.1:7681` 用于嵌入式终端 端口规划在 [`docs/operations/service-port-plan.md`](./operations/service-port-plan.md) 中进行了单独记录。 ## 8. 代码库角色 该代码库被划分为清晰的功能区域： - `dashboard/` - 用户界面 - `api/` - 状态和健康端点 - `config/` - 桌面和服务配置 - `scripts/` - 安装、启动、重置和启动辅助脚本 - `docs/` - 架构、设置、操作和特性参考 ## 9. 这个代码库不是什么 XWorkspace 控制台的目的**不是**成为： - 一个完整的桌面环境替代品 - 一个自定义合成器 (compositor) 项目 - 一个没有服务编排的通用 Web 应用程序 Shell - 一个没有运行时集成的营销网站 它是一个专注于 AI 工作区操作的控制平面。