141 lines
3.9 KiB
Markdown
141 lines
3.9 KiB
Markdown
[🇺🇸 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 工作区操作的控制平面。
|