1. 项目定位与用途
Star Office UI 是一个像素风格的 AI 办公室看板应用，核心定位是将 AI 助手的工作状态实时可视化。它通过将抽象的工作状态转化为直观的像素办公室场景，让用户能够一目了然地看到 AI 当前在做什么、是否在线、昨日完成了哪些工作。项目既可与 OpenClaw 深度集成实现 Agent 状态自动同步，也可独立部署作为通用状态看板使用，适用于个人或团队的协作状态展示场景。
项目档案应用项目
Star Office UI 像素风 AI 办公室看板 - OpenClaw 状态可视化与多 Agent 协作平台
ringhyacinth/Star-Office-UI：Star Office UI 是一个像素风格的 AI 办公室看板应用，将 AI 助手工作状态实时可视化，支持 OpenClaw 深度集成与独立部本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Star Office UI 是一个像素风格的 AI 办公室看板应用，将 AI 助手工作状态实时可视化，支持 OpenClaw 深度集成与独立部署，让协作状态一目了然。
中文项目介绍
Star Office UI 是一个像素风格的 AI 办公室看板应用，旨在将 AI 助手的工作状态实时可视化。通过将抽象的工作状态转化为直观的像素办公室场景，用户可以清晰看到 AI 当前在做什么、是否在线、昨日工作内容等，从而提升人机协作的透明度和趣味性。
项目支持多 Agent 协作，允许通过 join key 邀请其他 Agent 加入办公室，实时查看多人状态。界面提供中英日三语切换，所有文案、气泡和加载提示均联动更新。此外，还支持 AI 生图装修（接入 Gemini API）、桌面宠物模式（Electron/Tauri 封装）、移动端适配等特性。
后端基于 Flask 构建，提供状态管理 API；前端使用 Phaser 引擎渲染像素场景。状态通过 state.json 文件管理，可通过 set_state.py 脚本或 HTTP API 更新。与 OpenClaw 深度集成时，Agent 可自动同步状态；独立部署时也可作为通用状态看板使用。
项目要求 Python 3.10+ 环境，安装依赖后启动后端即可访问。生产环境需配置 .env 文件设置安全参数。支持 Cloudflare Tunnel 一键公网化，也可通过桌面封装获得透明窗口体验。
详细信息与使用说明
2. 解决的问题
传统 AI 助手的工作状态对用户不可见，导致协作不透明、难以追踪进度。Star Office UI 解决了这一问题，将六种工作状态（idle、writing、researching、executing、syncing、error）映射到办公室的不同区域，通过动画和气泡实时展示，让 AI 的工作状态变得直观可见。此外，项目还通过'昨日小记'功能自动展示工作记录，进一步增强了工作可见性。
3. 适用场景
主要适用于两类场景：一是 OpenClaw 用户，可实现 Agent 状态的自动可视化与同步，Agent 在工作时自动切换状态，办公室里的像素角色会实时走到对应区域；二是非 OpenClaw 用户，可独立部署作为像素风个人状态页或远程办公看板，通过 set_state.py 脚本或 HTTP API 手动推送状态，或接入任何能发 HTTP 请求的系统来驱动状态显示。此外，多 Agent 协作场景也适用，可通过 join key 邀请多个 Agent 加入同一办公室。
4. 安装方式
项目要求 Python 3.10+ 环境。安装步骤：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。生产环境需复制 .env.example 为 .env，并设置 FLASK_SECRET_KEY 和 ASSET_DRAWER_PASS 等强随机密码。默认访问地址为 http://127.0.0.1:19000。
5. 使用方式
部署后访问 http://127.0.0.1:19000 即可查看像素办公室看板。状态切换可通过 set_state.py 脚本完成，例如：python3 set_state.py writing "正在整理文档"。OpenClaw 用户可在 SOUL.md 中添加规则，让 Agent 自动执行 set_state.py 同步状态。邀请其他 Agent 加入办公室需使用 join key 和 office-agent-push.py 脚本，访客会出现在看板上并根据状态自动走到对应区域。桌面宠物版（Electron/Tauri 封装）可提供透明窗口体验，但具体运行方式仓库中未明确给出。AI 生图装修需自行配置 Gemini API 密钥。
6. 补充说明
项目具备多项特色功能：多语言支持（中英日三语一键切换）、美术资产自定义（侧边栏管理角色/场景/装饰素材）、安全加固（侧边栏密码保护、生产环境弱密码拦截、Session Cookie 加固）、移动端适配（手机直接访问）、灵活公网访问（推荐 Cloudflare Tunnel）。技术栈包括 Flask 后端、Phaser 前端引擎，状态存储基于 JSON 文件。艺术资产仅限非商业学习使用，代码采用 MIT 许可证。
思维导图
Star Office UI
后端服务
Flask 应用
状态 API
存储管理
前端渲染
Phaser 引擎
像素场景
动画系统
状态管理
state.json
set_state.py
store_utils
多语言系统
中英日三语
文案联动
美术资产
assets 目录
资产编辑
位置配置
安全认证
侧边栏密码
Session 加固
桌面封装
Electron
Tauri
透明窗口
OpenClaw 集成
状态同步
join key
访客系统
常见问题
Star Office UI 是什么？适合谁使用？
这是一个像素风格的 AI 办公室看板应用，适合 OpenClaw 用户实现 Agent 状态可视化，也适合任何需要状态看板的团队或个人独立部署使用。
如何安装和部署 Star Office UI？
需要 Python 3.10+ 环境，依次执行：克隆仓库、安装后端依赖、初始化 state.json、启动 Flask 服务。生产环境需配置 .env 文件设置安全参数。详细步骤见安装方式章节。
支持哪些工作状态和核心功能？
支持 idle、writing、researching、executing、syncing、error 六种状态，对应办公室不同区域。核心功能包括多 Agent 协作、中英日三语切换、AI 生图装修、桌面宠物模式、移动端适配等。
如何与其他系统或 OpenClaw 集成？
OpenClaw 用户可在 SOUL.md 添加规则让 Agent 自动同步状态；非 OpenClaw 用户可通过 HTTP API 或 set_state.py 脚本推送状态；还可使用 join key 和 office-agent-push.py 邀请其他 Agent 加入办公室。
生产环境部署需要注意什么？
必须配置 .env 文件，设置强随机的 FLASK_SECRET_KEY 和 ASSET_DRAWER_PASS；推荐使用 Cloudflare Tunnel 进行公网访问；侧边栏密码和会话安全需特别注意。