概述
Star-Office-UI 是一款像素风格的 AI 办公室看板系统,旨在解决 AI Agent 工作状态"看不见"的问题。传统 AI Agent 的工作过程是黑盒的,用户无法直观了解 Agent 当前在做什么、昨天做了什么、现在是否在线。Star-Office-UI 通过像素风格的办公室场景,将抽象的工作状态转化为可视化的场景:
- 休息区(沙发):Agent 待命或任务完成时的状态
- 工作区(办公桌):Agent 正在工作时的状态(写代码、写文档、搜索、执行任务等)
- Bug 区:Agent 遇到错误或异常时的状态
角色会根据当前状态自动移动到对应区域,配合动画和气泡提示,让 AI 的工作变得"可见"和"有趣"。支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式,与 OpenClaw 深度集成时体验最佳,也可以独立部署作为状态看板使用。

核心特性
- 状态可视化:将抽象的 AI 工作状态转化为直观的视觉场景
- 多 Agent 协作:支持多个 AI Agent 同时在线,实时查看团队状态
- 趣味性:像素风格设计,让 AI 工作变得有趣和生动
- 易用性:30 秒快速部署,支持多种集成方式
主要功能
核心作用
Star-Office-UI 的核心作用是将 AI Agent 的工作状态可视化,通过像素风格的办公室场景,让用户直观了解 AI 的工作状态:
- 状态可视化:6 种工作状态映射到办公室的 3 个区域,角色自动移动
- 多 Agent 协作:支持多个 AI Agent 同时在线,实时查看团队状态
- 昨日小记:自动从
memory/*.md读取最近一天的工作记录,展示为"昨日小记"卡片 - 实时更新:状态变化实时同步,无需刷新页面
- 移动端适配:手机直接打开即可查看,适合外出时快速瞄一眼
快速开始
方式一:手动部署
# 1) 下载仓库
git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI
# 2) 安装依赖
python3 -m pip install -r backend/requirements.txt
# 3) 准备状态文件(首次)
cp state.sample.json state.json
# 4) 启动后端
cd backend
python3 app.py
打开 http://127.0.0.1:19000,然后试试切状态:
python3 set_state.py writing "正在整理文档"
python3 set_state.py error "发现问题,排查中"
python3 set_state.py idle "待命中"
技术架构
Star-Office-UI 采用 前后端分离 的架构设计:
- 后端(backend/):基于 Flask 的后端服务,提供 API 接口和状态管理
- 前端(frontend/):基于 Phaser 的前端页面,实现像素风格的办公室场景
- 桌面宠物(desktop-pet/):基于 Tauri 的桌面封装版本(可选)
关键技术:
- Phaser 游戏引擎:用于渲染像素风格的办公室场景
- Flask 后端服务:提供 API 接口和状态管理
- Tauri 桌面封装:实现跨平台的桌面宠物应用
- WebSocket/轮询:实现实时状态同步
状态映射机制
Star-Office-UI 将 6 种工作状态映射到办公室的 3 个区域:
| 状态 | 办公室区域 | 触发场景 |
|---|---|---|
idle | 🛋 休息区(沙发) | 待命 / 任务完成 |
writing | 💻 工作区(办公桌) | 写代码 / 写文档 |
researching | 💻 工作区 | 搜索 / 调研 |
executing | 💻 工作区 | 执行命令 / 跑任务 |
syncing | 💻 工作区 | 同步数据 / 推送 |
error | 🐛 Bug 区 | 报错 / 异常排查 |
OpenClaw 集成
状态自动同步:
在 OpenClaw 的 SOUL.md(或 Agent 规则文件)中加入以下规则:
## Star Office 状态同步规则
- 接到任务时:先执行 `python3 set_state.py <状态> "<描述>"` 再开始工作
- 完成任务后:执行 `python3 set_state.py idle "待命中"` 再回复
集成优势:
- 自动同步:Agent 工作状态自动同步到办公室看板
- 无需手动:无需手动更新状态,Agent 自动维护
- 实时更新:状态变化实时同步,无需刷新页面
项目资源
- 🌟 GitHub: https://github.com/ringhyacinth/Star-Office-UI
- 📚 SKILL.md: OpenClaw Skill 文档
- 📄 License: MIT(代码),美术资产仅学习用途
常用 API
| 端点 | 说明 |
|---|---|
GET /health | 健康检查 |
GET /status | 获取主 Agent 状态 |
POST /set_state | 设置主 Agent 状态 |
GET /agents | 获取多 Agent 列表 |
POST /join-agent | 访客加入办公室 |
POST /agent-push | 访客推送状态 |
POST /leave-agent | 访客离开 |
GET /yesterday-memo | 获取昨日小记 |
GET /config/gemini | 获取 Gemini API 配置 |
POST /config/gemini | 设置 Gemini API 配置 |
适用人群
- OpenClaw 用户:想要可视化 AI Agent 工作状态的用户
- 多 Agent 团队:需要协作和状态可视化的团队
- 个人开发者:想要个人状态页或远程办公看板的开发者
- 桌面宠物爱好者:喜欢桌面宠物应用的开发者
- 像素风格爱好者:喜欢像素风格设计的开发者


