Star Office UI - 像素风 AI 办公室看板
将 AI 助手的工作状态实时可视化，在温馨的像素办公室中展示谁在做什么、昨天做了什么、现在是否在线。
证据显示：后端默认监听本地地址，提供密码保护、弱密码阻止、会话cookie加固等安全措施；但未发现用户确认机制（如状态变更前确认），数据流透明度有限（未详细说明数据流向），敏感数据处理（如Gemini API密钥）仅提及配置，未说明存储和传输安全；依赖仅flask，未提供版本锁定或漏洞扫描；外部效果（如Cloudflare Tunnel）需用户主动配置，但未说明风险；无回滚机制；来源归属明确（MIT许可证、作者署名）。扣分：用户确认缺失、数据流透明度不足、依赖安全未处理、无回滚。
证据显示：README与项目结构一致，状态定义清晰；依赖仅flask，但未提供版本锁定或镜像，可用性依赖PyPI；失败消息未详细说明，但提供了smoke_test脚本。扣分：依赖可用性未充分保障，失败消息不具体。
证据显示：明确面向OpenClaw用户和普通用户，提供多种使用场景；能力边界（如状态映射、API）有说明，但触发精度（如状态切换规则）依赖用户配置；环境适配（如Python版本、端口）有说明，但未覆盖所有平台。扣分：触发精度依赖用户，环境适配不全面。
证据显示：README结构清晰，安装步骤详细，命名稳定（状态名、API端点），有示例和FAQ（部分），已知限制（如桌面宠物实验性）有提及，许可证明确（MIT+艺术资产非商业），有变更日志，维护责任由作者和社区承担。扣分：示例和FAQ不完整，已知限制不全面，维护责任未明确。
证据显示：输出为可视化仪表盘，可直接使用；边际价值高（多代理协作、AI房间设计）；成本效益合理（免费开源，但需自部署）。扣分：成本效益未量化，依赖用户自部署。
证据显示：README中的功能描述与代码结构基本一致，但未提供测试结果或独立验证；跨来源佐证不足（仅README和代码）；事实与推断未明确区分。扣分：跨来源佐证缺失，事实与推断未分离。
- 未发现用户确认机制，状态变更可能自动执行，需谨慎配置。
- 敏感数据（如Gemini API密钥）处理方式未详细说明，建议自行审查。
- 依赖未锁定版本，存在供应链风险，建议使用锁文件或镜像。
- 无回滚机制，状态变更不可逆，需备份状态文件。
这个 Agent 能做什么，适合哪些场景？
Star Office UI 是一个像素风格的 AI 办公室状态看板，通过 Flask 后端和 Phaser 前端实现，将 AI 助手的状态（如写作、研究、报错）映射到办公室的不同区域，并实时展示动画和气泡。它支持多 Agent 协作，通过 join key 邀请其他 Agent 加入，并支持中英日三语切换。项目包含状态可视化、昨日小记、多 Agent 协作、AI 生图装修（需 Gemini API）、移动端适配、安全加固和可选的 Electron 桌面宠物模式。代码采用 MIT 许可，但美术资产仅供非商业学习使用。与 OpenClaw 深度集成时体验最佳，也可独立部署为状态看板。
后端 Flask 应用（backend/app.py）提供 REST API，包括 GET /status 获取主 Agent 状态、POST /set_state 设置状态、GET /agents 获取多 Agent 列表、POST /join-agent 让访客加入办公室、POST /agent-push 推送访客状态、GET /yesterday-memo 读取 memory/*.md 生成昨日小记等。前端（frontend/index.html 等）使用 Phaser 渲染像素办公室，通过 WebSocket 或轮询实时更新动画。支持 6 种状态（idle/writing/researching/executing/syncing/error）映射到不同区域。通过 set_state.py 或 API 脚本切换状态，Python 3.10+ 环境运行。可选功能包括 Gemini API 生图装修、Cloudflare Tunnel 公网访问、Electron 桌面宠物（desktop-pet/）。
- OpenClaw 用户：通过 SOUL.md 集成，让 Agent 在工作时自动更新状态，打开网页即可看到其正在进行的任务（如写作、搜索、执行命令）。
- 多 Agent 团队协作：使用 join key 邀请其他 Agent 加入办公室，实时查看每个成员的当前状态和所在区域。
- 远程办公团队：将办公室作为团队状态看板，成员通过 HTTP API 或脚本手动推送状态，展示工作状态。
- 个人开发者：作为自己的像素风状态页，通过 set_state.py 或 API 手动更新状态，展示当前工作内容。
- 想要 AI 生图装修的用户：接入 Gemini API，用 AI 生成办公室背景，让界面更个性化。
这个 Agent 有哪些优点和局限？
- 与 OpenClaw 深度集成，Agent 自动同步状态，提供完整的可视化体验。
- 支持多 Agent 协作，通过 join key 邀请其他 Agent 加入，适合团队使用。
- 像素风格美观，提供中英日三语支持，适合国际化场景。
- 代码 MIT 许可，可自由修改和二次开发。
- 美术资产禁止商用，仅限学习/演示，商用需替换自有素材。
- 需要 Python 3.10+，对低版本环境不兼容。
- AI 生图功能依赖 Gemini API，不接入则功能受限。
- 桌面宠物版是实验性功能，主要在 macOS 上开发测试，Windows/Linux 可能不稳定。
如何安装或部署这个 Agent？
环境要求：Python 3.10+。克隆仓库：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。可选：设置 .env 文件中的 FLASK_SECRET_KEY 和 ASSET_DRAWER_PASS。
如何使用这个 Agent？
启动后端后，使用 set_state.py 切换状态，例如：python3 set_state.py writing "正在整理文档"；访问前端页面查看状态。与 OpenClaw 集成：在 SOUL.md 中加入状态同步规则，Agent 会在任务开始/结束时调用 set_state.py。多 Agent：在 join-keys.json 中添加 join key，访客使用 office-agent-push.py 配置 JOIN_KEY、AGENT_NAME、OFFICE_URL 后运行，每 15 秒推送状态。