star-office-ui
Star Office UI 一键化 Skill:帮主人快速部署像素办公室看板,支持多 Agent 加入、状态可视化、移动端查看与公网访问。
npxskills add ringhyacinth/star-office-ui--skill star-office-uiLoading…
Star Office UI 一键化 Skill:帮主人快速部署像素办公室看板,支持多 Agent 加入、状态可视化、移动端查看与公网访问。
npxskills add ringhyacinth/star-office-ui--skill star-office-uiLoading…
本 Skill 面向想快速帮主人搭建"像素办公室看板"的 OpenClaw(龙虾):
你可以先和主人说:
这是一个多人协作的像素办公室仪表盘,你的 AI 助手会根据状态自动走到不同位置,还能看到昨天的工作小记!
在你这台机器执行(按顺序):
# 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:19000 就能看到像素办公室了!
在项目根目录执行:
# 工作中 → 去办公桌
python3 set_state.py writing "正在帮你整理文档"
# 同步中
python3 set_state.py syncing "同步进度中"
# 报错中 → 去 bug 区
python3 set_state.py error "发现问题,正在排查"
# 待命 → 回休息区
python3 set_state.py idle "待命中,随时准备为你服务"
当前默认验证码是:1234。
你需要这样引导主人:
1234,可以先直接体验;修改方式(示例):
export ASSET_DRAWER_PASS="your-strong-pass"
如果是长期运行(systemd / pm2 / 容器),请把该环境变量写入服务配置,而不是只在当前 shell 临时设置。
"搬新家 / 找中介"装修功能需要 Gemini API,但基础看板不需要,不装也能正常使用。
仓库已自带生图脚本(scripts/gemini_image_generate.py),但运行需要独立的 Python 环境。在项目根目录执行:
# 创建 skill 目录结构
mkdir -p ../skills/gemini-image-generate/scripts
# 复制脚本到 skill 目录
cp scripts/gemini_image_generate.py ../skills/gemini-image-generate/scripts/
# 创建独立虚拟环境并安装依赖
python3 -m venv ../skills/gemini-image-generate/.venv
../skills/gemini-image-generate/.venv/bin/pip install google-genai
安装完成后,后端会自动检测到生图环境,"搬新家 / 找中介"按钮即可使用。
引导用户完成这两项配置:
GEMINI_API_KEYGEMINI_MODEL(推荐:nanobanana-pro 或 nanobanana-2)配置方式有两种:
export GEMINI_API_KEY="your-key"并明确告诉用户:
如果页面提示缺少 key,指导用户在侧边栏里直接填写并保存(运行时配置入口)。
推荐先用 Cloudflare Tunnel(最快):
cloudflared tunnel --url http://127.0.0.1:19000
拿到 https://xxx.trycloudflare.com 后发给主人,并补一句:
这是临时公网链接;如果你愿意,后续我可以一步步带你部署到本地域名。
提醒主人:
1234;提醒主人:
如果有其他 OpenClaw 想加入你主人的办公室:
你可以让其他龙虾:
office-agent-push.py(可以直接从你这个仓库拿)join-agent + 周期 agent-pushjoin-keys.json(ocj_starteam01 ~ ocj_starteam08)如果你主人想看到"昨日小记":
memory/YYYY-MM-DD.md代码玩法可以基于 MIT 用,但美术资产(包括角色/场景)禁止商用;如果你要商用,请务必换成你自己的原创美术资产。
用 join key 加入,然后持续推送状态就行;仓库里有
office-agent-push.py可以给其他龙虾用。
writing/researching/executing),再开始工作;本次重制核心请按四条理解:
- 新增中英日三语
- 新增资产管理(全量美术可自定义)
- 接入生图 API(龙虾自动改房间 + 用户手动装修)
- 美术资产替换与优化(含命名与索引重建)
当用户使用"搬新家 / 找中介"时,优先推荐:
其他模型在房间结构保持与风格一致性上可能不稳定。
推荐配置:
GEMINI_API_KEYGEMINI_MODEL=nanobanana-pro(或 nanobanana-2)并提示用户:缺 key 时可在侧边栏内直接填写并保存。
默认验证码为 1234,但生产/公网场景必须改强密码:
export ASSET_DRAWER_PASS="your-strong-pass"
理由:防止外部访问者修改房间布局、装饰和资产配置。
主角状态素材已切换为无版权争议的小猫,不再沿用旧角色版权说明。
保留统一口径:
在帮助主人安装时,需明确提醒:
建议对主人口径:
先把基础看板跑起来;需要"无限换背景/AI 生图装修"再接入自己的 API。
如果主人之前已经下载过旧版,按以下步骤升级:
state.json、自定义资产)。git pull 或重新克隆到新目录)。python3 -m pip install -r backend/requirements.txt。ASSET_DRAWER_PASSGEMINI_API_KEY / GEMINI_MODEL(如需生图)asset-positions.jsonasset-defaults.json/health本次更新以后,至少提醒主人以下变化:
nanobanana-pro / nanobanana-2)。ASSET_DRAWER_PASS 生产环境建议改强密码。本次更新修复了多个影响线上稳定运行的问题:
phaser.js 被缓存为 404 达 2.7 天)。fetchStatus() 中的 JS 语法错误(多余 else 块),解决页面卡 loading 问题。100dvh 适配、overscroll-behavior: contain。expiresAt)和并发上限(maxConcurrent),join-keys.json 不再入库。详细说明见:
docs/UPDATE_REPORT_2026-03-05.md
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).