本页目录

像素风 AI 办公室看板(Star Office UI)

Star-Office-UI · ringhyacinth/Star-Office-UI

这是一款像素风格的 AI 办公室看板,把 AI 助手的工作状态实时可视化,能直观看到谁在做什么、昨天做了什么、现在是否在线。项目支持多 Agent 协作、中英日三语、AI 生图装修和桌面宠物模式,与 OpenClaw 深度集成时体验最佳,也可独立部...

益智解谜 休闲 自研引擎 TypeScript 寻路算法 物理系统 存档系统 游戏状态管理 初级
★ Stars 7,579 Forks 802 License 未明确 更新 2026-11-15

国内开发环境适配

Windows
AI 推断/待核验
Linux
AI 推断/待核验
macOS
官方声明支持
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
依赖通过 pip 安装(backend/requirements.txt),需要 Python 3.10+;国内访问 PyPI 建议配置镜像源。公网访问推荐的 Cloudflare Tunnel 与可选的 Gemini 生图接口在国内网络环境下可能不稳定,需自备代理或改用反向代理方案。默认端口为 19000(旧版为 18791),部署时注意端口占用。

中文项目介绍

Star Office UI 是一款像素风格的 AI 办公室看板:它把原本看不见摸不着的 AI 助手工作状态,变成一个有角色、有工位、有气泡的小房间,让人一眼看出“谁在做什么、昨天做过什么、此刻是否在线”。项目由 Ring Hyacinth 与 Simon Lee 共同创建,并联合社区开发者持续维护。

技术上,前端用 Phaser 渲染像素场景与角色动画,后端是 Flask 服务,状态由 HTTP 接口写入并广播到页面上;因此它既可以作为 OpenClaw 的配套可视化前端,也能独立跑起来当一块状态看板用。仓库主语言标记为 HTML,实际由前端页面、Flask 后端、若干 Python 脚本以及一个可选的 Electron 桌面壳组成。

补充说明

快速体验

README 给出两条上手路径。

方式一:交给 Agent 部署。 如果你已经在用 OpenClaw,可以把 SKILL.md 的地址直接发给它,让助手代为完成 clone、装依赖、启后端、配置状态同步,并把访问地址回传给你。

方式二:手动部署。 环境要求为 Python 3.10+,因为代码用到了 X | Y 这种 union type 写法,3.9 及更低版本无法运行。

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:19000,再执行 python3 set_state.py writing "正在整理文档" 之类的命令,页面里的像素角色就会走到对应区域,并弹出状态气泡。

适合谁用

  • 有 OpenClaw / 其他 AI Agent 的用户:这是完整体验。Agent 干活时自动切换状态,办公室里的角色实时走向对应工位,打开网页就知道它此刻在做什么。
  • 没有 OpenClaw 的用户:同样可以部署。可以用 set_state.py 手动推送,也可以让任意能发 HTTP 请求的脚本、系统或设备来驱动状态,把它当成像素风个人状态页、远程办公看板来用。

功能一览

  • 状态可视化:idle / writing / researching / executing / syncing / error 六种状态映射到办公室的不同区域,配动画与气泡实时展示。
  • 昨日小记:自动从 memory/*.md 读取最近一天的工作记录,脱敏后以卡片形式呈现。
  • 多 Agent 协作:通过 join key 邀请其他 Agent 加入同一间办公室,同时查看多人状态。
  • 中英日三语:CN / EN / JP 一键切换,界面文案、气泡、加载提示联动。
  • 美术资产自定义:侧边栏统一管理角色、场景与装饰素材,支持动态帧同步以减少闪烁。
  • AI 生图装修:接入 Gemini API 后可用 AI 更换办公室背景;不配置 API 也不影响核心功能。
  • 移动端适配:手机浏览器直接打开即可查看。
  • 安全加固:侧边栏密码保护、生产环境弱密码拦截、Session Cookie 加固。
  • 公网访问:推荐用 Cloudflare Tunnel 一键暴露,也支持自有域名与反向代理。
  • 桌面宠物版:可选的 Electron 封装,把办公室变成透明窗口挂在桌面上。

部署与运行

完整流程在“快速体验”的四步之外,还包含几项生产环境建议:

  1. 复制 .env.example 为 .env,设置强随机的 FLASK_SECRET_KEY 与 ASSET_DRAWER_PASS,避免弱密码与会话泄露;
  2. 需要外网访问时执行 cloudflared tunnel --url http://127.0.0.1:19000,拿到临时域名即可分享;
  3. 可选地运行 python3 scripts/smoke_test.py --base-url http://127.0.0.1:19000 做安装校验,全部显示 OK 即视为部署成功。

首次启动时若目录下没有 join-keys.json,服务会依据 join-keys.sample.json 自动生成一份,默认每个 key 支持最多 3 人同时在线,可自行增删改。

与 OpenClaw 的联动

在 Agent 的规则文件(如 SOUL.md)中写明“接任务前先 set_state.py,完成后切回 idle”,即可让状态同步变成自觉行为。六种状态对应三块区域:idle 在沙发休息区,writing / researching / executing / syncing 在工作区,error 进入 Bug 区。

邀请访客 Agent 只需两步:管理员分发 join key;访客下载 office-agent-push.py,填写 JOIN_KEY、AGENT_NAME、OFFICE_URL 三个变量后运行,脚本会自动加入办公室并每 15 秒推送一次状态。访客也可以把 frontend/join-office-skill.md 当作 Skill 使用,让 Agent 自行完成配置。

常用接口

后端暴露了一组轻量 HTTP 端点:GET /health(健康检查)、GET /status 与 POST /set_state(读取/设置主 Agent 状态)、GET /agents、POST /join-agent、POST /agent-push、POST /leave-agent(多 Agent 的加入、推送与离开)、GET /yesterday-memo(昨日小记)、GET|POST /config/gemini(生图配置),以及轮询生图进度的 GET /assets/generate-rpg-background/poll。

桌面宠物版

desktop-pet/ 目录提供基于 Electron 的封装:npm install 后 npm run dev 即可启动,会自动拉起 Python 后端,窗口默认指向 http://127.0.0.1:19000/?desktop=1,并支持用环境变量自定义项目路径与 Python 路径。README 明确标注这是可选的实验性功能,目前主要在 macOS 上开发测试,由社区贡献者独立完成。

美术资产与许可

访客角色动画使用了 LimeZu 的免费素材 Animated Mini Characters 2,二次发布或演示时需保留来源说明并遵守原作者条款。许可上分为两层:代码与逻辑为 MIT;美术资产禁止商用,仅限学习、演示与交流,如需商用须替换为自有的原创素材。

开源许可证与版权说明

许可证标识:未明确。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目