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