Thanks to visit codestin.com
Credit goes to github.com

Skip to content
BranchesTags
 
 

Repository files navigation

Star Office UI

一个面向多 Agent 协作的像素办公室看板：把 AI 助手（OpenClaw / 龙虾）的工作状态实时可视化，帮助团队直观看到“谁在做什么、昨天做了什么、现在是否在线”。

Star Office UI 预览

这是个什么项目？（一句话）

Star Office UI 是一个“多人协作状态看板”——你可以把它想象成：

一个实时更新的“像素办公室仪表盘”：你的 AI 助手（和你邀请的其他 Agent）会根据状态自动走到不同位置（休息区 / 工作区 / bug 区），你还能看到他们昨天的工作小记。

✨ 30 秒快速体验（推荐先看这里）

# 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

打开：http://127.0.0.1:18791

切状态试试（在项目根目录执行）：

python3 set_state.py writing "正在整理文档"
python3 set_state.py syncing "同步进度中"
python3 set_state.py error "发现问题，排查中"
python3 set_state.py idle "待命中"

1、这个项目实现了什么

Star Office UI 目前实现了：

  1. 可视化龙虾工作状态

    • 状态：idle（闲置）、writing（工作）、researching（研究）、executing（执行）、syncing（同步）、error（报 bug）
    • 状态会映射到办公室里的不同区域，并通过动画/气泡展示。

  2. “昨日小记”微型总结

    • 前端展示“昨日小记”卡片。
    • 后端从 memory/*.md 中读取昨天（或最近可用）的记录，做基础脱敏后展示。

  3. 支持邀请其他访客加入办公室（功能持续迭代中）

    • 通过 join key 加入。
    • 访客可持续 push 自己状态到办公室看板。
    • 当前已可用，但整体仍在持续优化交互与接入体验。

  4. 已适配手机端访问

    • 移动端可直接打开与查看状态（适合外出时快速查看）。

  5. 公网访问方式灵活

    • Skill 默认建议使用 Cloudflare Tunnel 快速公网化。
    • 也可以使用你自己的公网域名 / 反向代理方案。

2、本次更新相比上次的主要内容

本次发布相对早期基础版，新增/升级重点如下：

  • 新增多 Agent 机制：/join-agent、/agent-push、/leave-agent、/agents
  • 新增“昨日小记”接口与前端展示：/yesterday-memo
  • 状态体系更完整：支持 syncing、error 等状态可视化
  • 场景与角色动画升级：补充大量像素动画资产（含访客角色）
  • 文档与 Skill 重写：更适合外部程序员快速上手
  • 清理发布结构：去除临时文件 / 缓存 / 日志，降低阅读门槛
  • 补充开源声明：代码 MIT、但美术资产禁止商用

3、快速开始

1) 安装依赖

cd star-office-ui
python3 -m pip install -r backend/requirements.txt

2) 初始化状态文件

cp state.sample.json state.json

3) 启动后端

cd backend
python3 app.py

打开：http://127.0.0.1:18791

4) 切换主 Agent 状态（示例）

python3 set_state.py writing "正在整理文档"
python3 set_state.py syncing "同步进度中"
python3 set_state.py error "发现问题，排查中"
python3 set_state.py idle "待命中"

4、常用 API

  • GET /health：健康检查
  • GET /status：主 Agent 状态
  • POST /set_state：设置主 Agent 状态
  • GET /agents：获取多 Agent 列表
  • POST /join-agent：访客加入
  • POST /agent-push：访客推送状态
  • POST /leave-agent：访客离开
  • GET /yesterday-memo：昨日小记

5、美术资产使用说明（请务必阅读）

访客角色资产来源

访客角色动画使用了 LimeZu 的免费资产：

请在二次发布/演示时保留来源说明，并遵守原作者许可条款。

其他资产说明与免责（重要）

  • 主角色（宝石海星）与谐音说明：

    • “宝石海星”是任天堂《宝可梦》（Pokémon）系列中已有的角色 IP，不是本项目原创 IP。
    • 本项目仅为非商用二创/粉丝创作：选择这个角色，是因为“宝石海星”与作者名字“海辛”在中文发音上有谐音趣味。
    • 本项目的二创内容仅供学习、演示、交流使用，无任何商业用途。
    • 任天堂、宝可梦、“宝石海星”均为任天堂/宝可梦公司的商标或注册商标。
    • 若你计划使用本项目相关内容，请使用你自己的原创角色/美术资产。

  • 办公室场景与其他素材：由本项目作者团队自行制作。

商用限制（重要）

  • 代码玩法可以基于 MIT 使用与二次开发。
  • 本仓库所有美术资产（含主角色/场景/素材整包）禁止商用。
  • 若你要做商用，请务必制作并替换成你自己的原创美术资产。

6、开源许可与声明

  • Code / Logic：MIT（见 LICENSE）
  • Art Assets：非商用，仅学习/演示用途

欢迎 Fork、交流玩法、提 PR；但请严格遵守资产使用边界。

7、期待更多玩法交流

欢迎你基于这个框架扩展：

  • 更丰富的状态语义与自动编排
  • 多房间/多团队协作地图
  • 任务看板、时间线、日报自动生成
  • 更完整的访问控制与权限体系

如果你做了有趣改造，欢迎分享！

8、作者社交账号

项目结构（简版）

star-office-ui/
  backend/
    app.py
    requirements.txt
    run.sh
  frontend/
    index.html
    join.html
    invite.html
    layout.js
    ...assets
  docs/
    screenshots/
  office-agent-push.py
  set_state.py
  state.sample.json
  join-keys.json
  SKILL.md
  README.md
  LICENSE

Star Office UI

A pixel office dashboard for multi-agent collaboration: visualize your AI assistants’ (OpenClaw / "lobster") work status in real-time, helping the team intuitively see "who is doing what, what they did yesterday, and whether they are online now."

Star Office UI Preview

What is this project? (In one sentence)

Star Office UI is a "multi-person collaboration status dashboard"—think of it as:

A real-time "pixel office dashboard": your AI assistants (and other agents you invite) automatically move to different areas based on their status (breakroom / desk / bug area), and you can also see a micro-summary of their work from yesterday.

✨ 30-second Quick Start (Recommended)

# 1) Clone repository
git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI

# 2) Install dependencies
python3 -m pip install -r backend/requirements.txt

# 3) Initialize state file (first run)
cp state.sample.json state.json

# 4) Start backend
cd backend
python3 app.py

Open: http://127.0.0.1:18791

Try changing states (run from project root):

python3 set_state.py writing "Organizing documents"
python3 set_state.py syncing "Syncing progress"
python3 set_state.py error "Found an issue, debugging"
python3 set_state.py idle "Standing by"

I. What does this project do?

Star Office UI currently provides:

  1. Visualize lobster work status

    • States: idle, writing, researching, executing, syncing, error
    • States map to different areas in the office and are shown with animations / bubbles.

  2. "Yesterday Memo" micro-summary

    • A "Yesterday Memo" card in the UI.
    • Backend reads yesterday’s (or most recent available) records from memory/*.md and displays them after basic privacy sanitization.

  3. Support inviting other guests to join the office (feature ongoing)

    • Join via join key.
    • Guests can continuously push their status to the office dashboard.
    • Currently usable, but overall interaction and onboarding experience are still being optimized.

  4. Mobile-friendly access

    • Mobile devices can directly open and view status (great for quick checks on the go).

  5. Flexible public access options

    • Skill defaults to using Cloudflare Tunnel for quick public access.
    • You can also use your own public domain / reverse proxy setup.

II. Main changes in this update

This release adds/upgrades the following compared to the early base version:

  • Added multi-agent mechanism: /join-agent, /agent-push, /leave-agent, /agents
  • Added "Yesterday Memo" endpoint and UI: /yesterday-memo
  • More complete state system: supports visualization for syncing, error, etc.
  • Scene and character animation upgrade: added lots of pixel art assets (including guest roles)
  • Rewrote docs and Skill: more beginner-friendly for external programmers
  • Cleaned up release structure: removed temp files / cache / logs to lower comprehension barrier
  • Added open-source notice: code under MIT, but art assets are non-commercial

III. Quick Start

1) Install dependencies

cd star-office-ui
python3 -m pip install -r backend/requirements.txt

2) Initialize state file

cp state.sample.json state.json

3) Start backend

cd backend
python3 app.py

Open: http://127.0.0.1:18791

4) Switch main Agent status (example)

python3 set_state.py writing "Organizing documents"
python3 set_state.py syncing "Syncing progress"
python3 set_state.py error "Found an issue, debugging"
python3 set_state.py idle "Standing by"

IV. Common APIs

  • GET /health: Health check
  • GET /status: Main agent status
  • POST /set_state: Set main agent status
  • GET /agents: Get multi-agent list
  • POST /join-agent: Guest joins
  • POST /agent-push: Guest pushes status
  • POST /leave-agent: Guest leaves
  • GET /yesterday-memo: Yesterday Memo

V. Art Asset Usage Notes (Please Read)

Guest character asset source

Guest character animations use LimeZu’s free assets:

Please keep the source attribution and follow the original author’s license terms when redistributing / demonstrating.

Other asset notes & disclaimer (Important)

  • Main character (Starmie) & homophone note:

    • “Starmie” is an existing character IP from Nintendo/Pokémon, not original to this project.
    • This project is non-commercial fan creation only: this character was chosen because of a fun homophone between “Starmie” and the author’s Chinese name “海辛” (Hǎi Xīn).
    • All fan-created content in this project is for learning, demonstration, and idea sharing only, with no commercial use.
    • Nintendo, Pokémon, and “Starmie” are trademarks or registered trademarks of Nintendo/The Pokémon Company.
    • If you plan to use any content related to this project, please use your own original characters/art assets.

  • Office scene & other assets: created by the project author team.

Commercial restriction (Important)

  • Code/logic may be used and modified under MIT.
  • All art assets in this repo (including main character / scene / full pack) are NOT for commercial use.
  • If you want to use this commercially, please create and replace with your own original art assets.

VI. Open-source License & Notice

  • Code / Logic: MIT (see LICENSE)
  • Art Assets: non-commercial, for learning / demo only

Forks, idea sharing, and PRs are welcome; please strictly respect the asset usage boundaries.

VII. Looking forward to more idea sharing

Feel free to extend this framework with:

  • Richer state semantics and auto-orchestration
  • Multi-room / multi-team collaboration maps
  • Task boards, timelines, auto-generated daily reports
  • More complete access control and permission systems

If you make an interesting modification, please share!

VIII. Author social accounts

Project structure (simplified)

star-office-ui/
  backend/
    app.py
    requirements.txt
    run.sh
  frontend/
    index.html
    join.html
    invite.html
    layout.js
    ...assets
  docs/
    screenshots/
  office-agent-push.py
  set_state.py
  state.sample.json
  join-keys.json
  SKILL.md
  README.md
  LICENSE

About

A pixel office for your AI crew: turn invisible work states into a cozy little space with characters, daily notes, and guest agents. Code under MIT; art assets for non-commercial learning only.

Resources

Readme
License
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages