Star Office UI

在 AI 智能体（Agent）日益普及的今天，如何直观地感知它们的运行状态？它们是在努力工作、深度研究，还是遇到了 Bug？Star Office UI 给出了一个充满创意且实用的答案：打造一个像素风格的“多人协作办公室”看板。

这不仅是一个监控面板，更是一个生动的虚拟空间。你的 AI 助手（如 OpenClaw/龙虾）会根据实时状态，自动漫步到办公室的不同区域（休息区、工作区、Bug 排查区），并展示它们的“昨日小记”。让冷冰冰的代码运行状态，变成看得见、摸得着的像素生活。

核心功能：让 AI 工作状态“活”起来

1. 实时状态可视化

系统预设了多种状态，并映射到办公室的具体场景与动画中：

• 🟢 Idle (待命)：在休息区闲逛或喝咖啡。
• ✍️ Writing (工作)：在工位上敲击键盘。
• 🔍 Researching (研究)：在书架或电脑前查阅资料。
• ⚙️ Executing (执行)：忙碌地搬运文件或操作工具。
• 🔄 Syncing (同步)：与云端或其他 Agent 交换数据。
• 🔴 Error (报 Bug)：头顶冒汗，在角落排查问题。

2. “昨日小记”微型总结

前端展示专属卡片，后端自动读取 memory/*.md 中的历史记录，经脱敏处理后，生动呈现 AI 昨天的工作成果与思考片段。

3. 多 Agent 协作与访客系统

• 邀请机制：通过 join key 邀请其他 AI Agent 或用户加入办公室。
• 状态推送：访客可实时推送自身状态，共同构建一个热闹的“像素办公室”。
• 列表管理：实时查看在线 Agent 列表及其当前活动。

4. 高度定制化与智能化

• 三语支持：完美支持 中文 (CN)、英文 (EN)、日文 (JP) 无缝切换，界面文案、提示气泡即时更新。
• 自定义美术资产：内置资产管理侧边栏，支持替换角色、场景、装饰素材。动态切帧逻辑优化，杜绝闪烁。
• 生图 API 接入：支持接入自有生图 API（推荐 nanobanana-pro），实现“搬新家”、“智能装修”功能。AI 可根据主题自动生成全新背景，或让用户手动输入指令改造办公室。

5. 全平台与灵活部署

• 移动端适配：手机浏览器即可完美访问，随时随地查看 AI 动态。
• 公网访问：默认推荐 Cloudflare Tunnel 一键穿透，也支持自定义域名与反向代理。

2026 年 3 月重制版：四大核心升级

本次更新并非简单修补，而是基于原项目的完整重制：

1. 全球化：新增中英日三语全局支持。
2. 资产自由：新增完整的资产管理系统，用户可自定义所有美术素材。
3. AI 装修：接入生图 API，支持“找中介”式智能换房与手动装修。
4. 视觉焕新：核心资产大规模重绘，重构命名索引，优化动态切帧，大幅提升稳定性。

30 秒快速体验

1. 安装与启动

# 克隆仓库
git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI

# 安装依赖
python3 -m pip install -r backend/requirements.txt

# 初始化状态文件
cp state.sample.json state.json

# 启动后端
cd backend
python3 app.py

浏览器访问：http://127.0.0.1:18791

2. 模拟状态切换

在项目根目录运行以下命令，观察办公室内的变化：

python3 set_state.py writing "正在整理文档"
python3 set_state.py syncing "同步进度中"
python3 set_state.py error "发现问题，排查中"
python3 set_state.py idle "待命中"

常用 API 接口

⚠️ 重要声明与许可

• 代码许可：核心代码与逻辑遵循 MIT 协议，欢迎 Fork、二次开发与商用。
• 美术资产：
  • 访客角色动画源自 LimeZu 的免费资产 (Animated Mini Characters 2)，请保留来源说明。
  • 本仓库自带的所有美术资产（含主角色、场景、整包素材）严禁商用，仅限学习与演示用途。
  • 商用建议：若需商用，请务必替换为您自己原创或购买授权的美术资产。