概述
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 团队：需要协作和状态可视化的团队
- 个人开发者：想要个人状态页或远程办公看板的开发者
- 桌面宠物爱好者：喜欢桌面宠物应用的开发者
- 像素风格爱好者：喜欢像素风格设计的开发者
