Star-Office-UI

# Star Office UI 🌐 Language: **中文** | [English](./README.en.md) | [日本語](./README.ja.md)  **一个像素风格的 AI 办公室看板** —— 把 AI 助手的工作状态实时可视化，让你直观看到"谁在做什么、昨天做了什么、现在是否在线"。 支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式。 与 [OpenClaw](https://github.com/openclaw/openclaw) 深度集成时体验最佳，也可以独立部署作为状态看板使用。 > 本项目由 **[Ring Hyacinth](https://x.com/ring_hyacinth)** 与 **[Simon Lee](https://x.com/simonxxoo)** 共同创建（co-created project），并与社区开发者（[@Zhaohan-Wang](https://github.com/Zhaohan-Wang)、[@Jah-yee](https://github.com/Jah-yee)、[@liaoandi](https://github.com/liaoandi)）一起持续维护和共建。 > 欢迎提交 Issue 和 PR，也感谢每一位贡献者的支持。 --- ## ✨ 快速体验 ### 方式一：让龙虾帮你部署（推荐给 OpenClaw 用户） 如果你正在使用 [OpenClaw](https://github.com/openclaw/openclaw)，直接把下面这句话发给你的龙虾： ```text 请按照这个 SKILL.md 帮我完成 Star Office UI 的部署： https://github.com/ringhyacinth/Star-Office-UI/blob/master/SKILL.md ``` 龙虾会自动完成 clone、安装依赖、启动后端、配置状态同步，并把访问地址发给你。 ### 方式二：30 秒手动部署 > **环境要求：Python 3.10+**（代码使用了 `X | Y` union type 语法，不支持 3.9 及更低版本） ```bash # 1) 下载仓库 git clone https://github.com/ringhyacinth/Star-Office-UI.git cd Star-Office-UI # 2) 安装依赖（需要 Python 3.10+） 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** 然后试试切状态： ```bash python3 set_state.py writing "正在整理文档" python3 set_state.py error "发现问题，排查中" python3 set_state.py idle "待命中" ```  --- ## 🤔 适合谁用？ ### 有 OpenClaw / AI Agent 的用户 这是**完整体验**。Agent 在工作时自动切换状态，办公室里的像素角色会实时走到对应区域——你只需要打开网页，就能看到 AI 此刻在做什么。 ### 没有 OpenClaw 的用户 也完全可以部署。你可以： - 用 `set_state.py` 或 API 手动 / 脚本推送状态 - 把它当成一个像素风的个人状态页 / 远程办公看板 - 接入任何能发 HTTP 请求的系统来驱动状态 --- ## 📋 功能一览 1. **状态可视化** —— 6 种状态（`idle` / `writing` / `researching` / `executing` / `syncing` / `error`）自动映射到办公室不同区域，动画 + 气泡实时展示 2. **昨日小记** —— 自动从 `memory/*.md` 读取最近一天的工作记录，脱敏后展示为"昨日小记"卡片 3. **多 Agent 协作** —— 通过 join key 邀请其他 Agent 加入你的办公室，实时查看多人状态