Star Office UI — AI skill for Claude Code

STAR OFFICE · AI Agent 像素办公室

🌐 Language: **中文** | [English](./README.en.md) | [日本語](./README.ja.md)


**一个由 Codex / Claude Code hooks 驱动的像素办公室看板** —— 把 AI 助手的工作状态实时可视化，让你直观看到"谁在做什么、最近做了什么、现在是否在线"。

主界面是自适应全屏办公室，没有浏览器滚动条；点击底部办公室名称打开菜单，任务提示保留在房间左下角。支持多 Agent 协作、中英日切换、AI 生图装修和可选桌面宠物。 推荐通过 **Codex / Claude Code hooks** 自动驱动角色状态并记录会话、工具和子 Agent 活动；其他 AI Agent 也可通过脚本或 HTTP API 接入。

本项目基于 [ringhyacinth/Star-Office-UI](https://github.com/ringhyacinth/Star-Office-UI) 修改，当前开发与部署仓库为 [oiuv/Star-Office-UI](https://github.com/oiuv/Star-Office-UI)。

原项目由 **[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，也感谢每一位贡献者的支持。

---

✨ 快速上手：Codex hooks（推荐）

完成以下三步，Codex 的任务开始、工具调用、上下文整理和本轮结束就会自动映射到办公室动画与活动记录。

**环境要求：Python 3.10+**。以下示例使用 `python`；macOS / Linux 可按环境改为 `python3`。网页无需 Node.js 或前端构建；后端首次启动会初始化缺失的运行文件，已有状态与配置会保留。

1) 启动看板

git clone https://github.com/oiuv/Star-Office-UI.git
cd Star-Office-UI
python -m pip install -r backend/requirements.txt
python backend/app.py

打开 [http://127.0.0.1:19000](http://127.0.0.1:19000)。保持后端运行，另开终端进入 STAR OFFICE 项目根目录，继续配置 hooks。

2) 生成并启用 Codex hooks

python scripts/codex_hooks_config.py

把输出配置合并到你使用 Codex 的项目 `.codex/hooks.json`，或用户目录的 `~/.codex/hooks.json`（自定义 Codex 主目录时使用 `$CODEX_HOME/hooks.json`）。同一份办公室 hooks 只配置在一处，避免项目与全局重复执行；已有 hooks 应合并事件数组。然后在 Codex 中使用 `/hooks` 检查并信任配置。

两个生成器默认使用运行生成器的 Python 解释器绝对路径（`sys.executable`），脚本也使用绝对路径，可从其他项目调用。建议用项目虚拟环境生成配置：`.\.venv\Scripts\python.exe -B scripts\codex_hooks_config.py`；Claude 对应 `scripts\claude_hooks_config.py`。可用 `--python` 显式覆盖解释器，示例文件中的解释器及脚本路径均需替换。

3) 提交任务，查看动画与统计

在 Codex 中提交任务，办公室会自动显示工作状态；本轮结束或中断后恢复待命。打开 [活动档案](http://127.0.0.1:19000/stats) 查看事件、工