xworkspace-console/docs/zh/FEATURES.md

🇺🇸 English | 🇨🇳 中文

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 中进行了单独记录。

8. 代码库角色

该代码库被划分为清晰的功能区域：

• dashboard/
  • 用户界面
• api/
  • 状态和健康端点
• config/
  • 桌面和服务配置
• scripts/
  • 安装、启动、重置和启动辅助脚本
• docs/
  • 架构、设置、操作和特性参考

9. 这个代码库不是什么

XWorkspace 控制台的目的不是成为：

• 一个完整的桌面环境替代品
• 一个自定义合成器 (compositor) 项目
• 一个没有服务编排的通用 Web 应用程序 Shell
• 一个没有运行时集成的营销网站

它是一个专注于 AI 工作区操作的控制平面。