Skip to content
Back to search

star-office-ui

SkillWorks with Claude CodeGitHub

Star Office UI 一键化 Skill:帮主人快速部署像素办公室看板,支持多 Agent 加入、状态可视化、移动端查看与公网访问。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ringhyacinth--star-office-ui/badge.svg)](/listings/ringhyacinth--star-office-ui)

HTML

<a href="/listings/ringhyacinth--star-office-ui"><img src="/api/listings/ringhyacinth--star-office-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 295 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: star-office-ui
  3. description: Star Office UI 一键化 Skill:帮主人快速部署像素办公室看板,支持多 Agent 加入、状态可视化、移动端查看与公网访问。
  4. ---
  5. # Star Office UI Skill
  6. 本 Skill 面向想快速帮主人搭建"像素办公室看板"的 OpenClaw(龙虾):
  7. - 目标:主人只需"看到效果",尽量少问问题
  8. - 你可以按下面的步骤,一步一步帮主人跑起来并对外访问
  9. ---
  10. ## 0. 一句话告诉主人这是什么
  11. 你可以先和主人说:
  12. > 这是一个多人协作的像素办公室仪表盘,你的 AI 助手会根据状态自动走到不同位置,还能看到昨天的工作小记!
  13. ---
  14. ## 1. 30 秒一键启动(推荐你先做一遍)
  15. 在你这台机器执行(按顺序):
  16. ```bash
  17. # 1) 下载仓库
  18. git clone https://github.com/ringhyacinth/Star-Office-UI.git
  19. cd Star-Office-UI
  20. # 2) 安装依赖
  21. python3 -m pip install -r backend/requirements.txt
  22. # 3) 准备状态文件(首次)
  23. cp state.sample.json state.json
  24. # 4) 启动后端
  25. cd backend
  26. python3 app.py
  27. ```
  28. 然后告诉主人:
  29. > 好了,你现在打开 http://127.0.0.1:19000 就能看到像素办公室了!
  30. ---
  31. ## 2. 帮主人切状态体验一下
  32. 在项目根目录执行:
  33. ```bash
  34. # 工作中 → 去办公桌
  35. python3 set_state.py writing "正在帮你整理文档"
  36. # 同步中
  37. python3 set_state.py syncing "同步进度中"
  38. # 报错中 → 去 bug 区
  39. python3 set_state.py error "发现问题,正在排查"
  40. # 待命 → 回休息区
  41. python3 set_state.py idle "待命中,随时准备为你服务"
  42. ```
  43. ---
  44. ## 3. 侧边栏验证码设置(必须教会新龙虾)
  45. 当前默认验证码是:`1234`。
  46. 你需要这样引导主人:
  47. 1. 默认密码是 `1234`,可以先直接体验;
  48. 2. 当主人愿意时,可随时和你沟通修改密码;
  49. 3. 你应主动推荐改成强密码(更安全,防止他人误改资产和布局)。
  50. 修改方式(示例):
  51. ```bash
  52. export ASSET_DRAWER_PASS="your-strong-pass"
  53. ```
  54. 如果是长期运行(systemd / pm2 / 容器),请把该环境变量写入服务配置,而不是只在当前 shell 临时设置。
  55. ---
  56. ## 4. 生图功能(Gemini)—— 可选
  57. "搬新家 / 找中介"装修功能需要 Gemini API,但**基础看板不需要**,不装也能正常使用。
  58. ### 4.1 安装生图脚本环境(首次使用时)
  59. 仓库已自带生图脚本(`scripts/gemini_image_generate.py`),但运行需要独立的 Python 环境。在项目根目录执行:
  60. ```bash
  61. # 创建 skill 目录结构
  62. mkdir -p ../skills/gemini-image-generate/scripts
  63. # 复制脚本到 skill 目录
  64. cp scripts/gemini_image_generate.py ../skills/gemini-image-generate/scripts/
  65. # 创建独立虚拟环境并安装依赖
  66. python3 -m venv ../skills/gemini-image-generate/.venv
  67. ../skills/gemini-image-generate/.venv/bin/pip install google-genai
  68. ```
  69. 安装完成后,后端会自动检测到生图环境,"搬新家 / 找中介"按钮即可使用。
  70. ### 4.2 配置 Gemini API Key
  71. 引导用户完成这两项配置:
  72. 1. `GEMINI_API_KEY`
  73. 2. `GEMINI_MODEL`(推荐:`nanobanana-pro` 或 `nanobanana-2`)
  74. 配置方式有两种:
  75. - **侧边栏填写**:打开资产侧边栏 → 在生图配置区域直接输入 API Key 并保存
  76. - **环境变量**:`export GEMINI_API_KEY="your-key"`
  77. 并明确告诉用户:
  78. - 不配置 API 也能用基础看板(状态显示、多 Agent、资产替换等)
  79. - 配置后才能使用"搬新家 / 找中介"的 AI 生图装修能力
  80. 如果页面提示缺少 key,指导用户在侧边栏里直接填写并保存(运行时配置入口)。
  81. ---
  82. ## 5. 安装成功后,必须提醒主人的三件事
  83. ### 5.1 告知临时公网链接
  84. 推荐先用 Cloudflare Tunnel(最快):
  85. ```bash
  86. cloudflared tunnel --url http://127.0.0.1:19000
  87. ```
  88. 拿到 `https://xxx.trycloudflare.com` 后发给主人,并补一句:
  89. > 这是临时公网链接;如果你愿意,后续我可以一步步带你部署到本地域名。
  90. ### 5.2 装修房子入口
  91. 提醒主人:
  92. - 现在可以点击"装修房间"开始装饰;
  93. - 侧边栏默认密码是 `1234`;
  94. - 当他想改密码时,可随时告诉你,你来帮他改;
  95. - 推荐改成强密码,安全性更高。
  96. ### 5.3 生图 API 配置
  97. 提醒主人:
  98. - 生图功能需要自己的 API;
  99. - 当前接入的是 **Gemini 官方 API 格式与地址**;
  100. - 若要替换成其他类型 API,请先和你沟通,由你来改接入;
  101. - 最好让主人把对应 API 文档发给你,便于准确适配。
  102. ---
  103. ## 6. 邀请其他龙虾加入(可选)
  104. 如果有其他 OpenClaw 想加入你主人的办公室:
  105. ### 步骤 A:告诉其他龙虾用 office-agent-push.py
  106. 你可以让其他龙虾:
  107. 1) 下载 `office-agent-push.py`(可以直接从你这个仓库拿)
  108. 2) 让它调用 `join-agent` + 周期 `agent-push`
  109. 3) 你主人那边就能看到它进办公室了
  110. ### 步骤 B:join key 说明
  111. - 仓库里默认有 `join-keys.json`(`ocj_starteam01` ~ `ocj_starteam08`)
  112. - 同一个 key 最多 3 人同时在线
  113. - 你也可以帮主人新建自己的 key
  114. ---
  115. ## 7. 昨日小记(可选)
  116. 如果你主人想看到"昨日小记":
  117. - 在仓库上级目录放一个 `memory/YYYY-MM-DD.md`
  118. - 后端会自动读取昨天(或最近可用)的记录,做基础脱敏后展示
  119. ---
  120. ## 8. 常见问题(主人可能问你的)
  121. ### Q1:"我可以商用吗?"
  122. > 代码玩法可以基于 MIT 用,但美术资产(包括角色/场景)禁止商用;如果你要商用,请务必换成你自己的原创美术资产。
  123. ### Q2:"其他龙虾怎么加入?"
  124. > 用 join key 加入,然后持续推送状态就行;仓库里有 `office-agent-push.py` 可以给其他龙虾用。
  125. ---
  126. ## 9. 给你的提示
  127. - 尽量帮主人把"启动步骤"做完,让主人只负责"看"和"体验"
  128. - 如果主人要对外访问,优先用 Cloudflare Tunnel(最快最方便)
  129. - 状态切换应由你主动执行:
  130. - 接任务前,先把自己状态切到"工作中"(如 `writing/researching/executing`),再开始工作;
  131. - 完成任务后,先把自己状态切回"待命中(idle)",再进入休息/等待下一任务。
  132. - 注意不要暴露你主人的内网地址或私有信息
  133. ---
  134. ## 10. 2026-03 增量补充(仅新增项)
  135. > 本次重制核心请按四条理解:
  136. > 1) 新增中英日三语
  137. > 2) 新增资产管理(全量美术可自定义)
  138. > 3) 接入生图 API(龙虾自动改房间 + 用户手动装修)
  139. > 4) 美术资产替换与优化(含命名与索引重建)
  140. ### 10.1 生图模型建议(房间装修)
  141. 当用户使用"搬新家 / 找中介"时,优先推荐:
  142. 1. **gemini nanobanana pro**
  143. 2. **gemini nanobanana 2**
  144. 其他模型在房间结构保持与风格一致性上可能不稳定。
  145. 推荐配置:
  146. - `GEMINI_API_KEY`
  147. - `GEMINI_MODEL=nanobanana-pro`(或 `nanobanana-2`)
  148. 并提示用户:缺 key 时可在侧边栏内直接填写并保存。
  149. ### 10.2 侧边栏验证码安全提醒(必须)
  150. 默认验证码为 `1234`,但生产/公网场景必须改强密码:
  151. ```bash
  152. export ASSET_DRAWER_PASS="your-strong-pass"
  153. ```
  154. 理由:防止外部访问者修改房间布局、装饰和资产配置。
  155. ### 10.3 版权口径更新
  156. 主角状态素材已切换为无版权争议的小猫,不再沿用旧角色版权说明。
  157. 保留统一口径:
  158. - 代码:MIT
  159. - 美术资产:禁止商用
  160. ### 10.4 安装时必须提醒(API 可选)
  161. 在帮助主人安装时,需明确提醒:
  162. - 现在支持接入自己的生图 API 来改美术资产与背景(可持续更换)。
  163. - 但基础功能(状态看板、多 Agent、资产替换/布局、三语切换)**不依赖 API**,不开 API 也能正常使用。
  164. 建议对主人口径:
  165. > 先把基础看板跑起来;需要"无限换背景/AI 生图装修"再接入自己的 API。
  166. ### 10.5 老用户更新指南(从旧版本升级)
  167. 如果主人之前已经下载过旧版,按以下步骤升级:
  168. 1. 进入项目目录并备份本地配置(如 `state.json`、自定义资产)。
  169. 2. 拉取最新代码(`git pull` 或重新克隆到新目录)。
  170. 3. 确认依赖:`python3 -m pip install -r backend/requirements.txt`。
  171. 4. 保留并检查本地运行配置:
  172. - `ASSET_DRAWER_PASS`
  173. - `GEMINI_API_KEY` / `GEMINI_MODEL`(如需生图)
  174. 5. 如有自定义位置,确认:
  175. - `asset-positions.json`
  176. - `asset-defaults.json`
  177. 6. 重启后端并验收关键功能:
  178. - `/health`
  179. - 三语切换(CN/EN/JP)
  180. - 资产侧栏(选择、替换、设默认)
  181. - 生图入口(有 key 时可用)
  182. ### 10.6 功能更新提醒清单(对主人口播)
  183. 本次更新以后,至少提醒主人以下变化:
  184. 1. 已支持 **CN/EN/JP 三语切换**(含 loading 与气泡实时联动)。
  185. 2. 已支持 **自定义美术资产替换**(含动态素材切帧同步,减少闪烁)。
  186. 3. 已支持 **接入自有生图 API** 持续更换背景(推荐 `nanobanana-pro` / `nanobanana-2`)。
  187. 4. 新增/强化了安全项:`ASSET_DRAWER_PASS` 生产环境建议改强密码。
  188. ### 10.7 2026-03-05 稳定性修复
  189. 本次更新修复了多个影响线上稳定运行的问题:
  190. 1. **CDN 缓存修复**:静态资源 404 不再被 CDN 长缓存(之前导致 `phaser.js` 被缓存为 404 达 2.7 天)。
  191. 2. **前端加载修复**:修复 `fetchStatus()` 中的 JS 语法错误(多余 `else` 块),解决页面卡 loading 问题。
  192. 3. **生图异步化**:生图接口改为后台任务 + 轮询模式,避免 Cloudflare 524 超时(100s 限制)。前端显示实时等待进度。
  193. 4. **移动端侧边栏**:新增遮罩层、body 滚动锁定、`100dvh` 适配、`overscroll-behavior: contain`。
  194. 5. **Join Key 增强**:支持 key 级别过期时间(`expiresAt`)和并发上限(`maxConcurrent`),`join-keys.json` 不再入库。
  195. > 详细说明见:`docs/UPDATE_REPORT_2026-03-05.md`
README.md · README · 295 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Star Office UI
  2. 🌐 Language: **中文** | [English](./README.en.md) | [日本語](./README.ja.md)
  3. ![Star Office UI 封面](docs/screenshots/readme-cover-2.jpg)
  4. **一个像素风格的 AI 办公室看板** —— 把 AI 助手的工作状态实时可视化,让你直观看到"谁在做什么、昨天做了什么、现在是否在线"。
  5. 支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式。
  6. 与 [OpenClaw](https://github.com/openclaw/openclaw) 深度集成时体验最佳,也可以独立部署作为状态看板使用。
  7. > 本项目由 **[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))一起持续维护和共建。
  8. > 欢迎提交 Issue 和 PR,也感谢每一位贡献者的支持。
  9. ---
  10. ## ✨ 快速体验
  11. ### 方式一:让龙虾帮你部署(推荐给 OpenClaw 用户)
  12. 如果你正在使用 [OpenClaw](https://github.com/openclaw/openclaw),直接把下面这句话发给你的龙虾:
  13. ```text
  14. 请按照这个 SKILL.md 帮我完成 Star Office UI 的部署:
  15. https://github.com/ringhyacinth/Star-Office-UI/blob/master/SKILL.md
  16. ```
  17. 龙虾会自动完成 clone、安装依赖、启动后端、配置状态同步,并把访问地址发给你。
  18. ### 方式二:30 秒手动部署
  19. > **环境要求:Python 3.10+**(代码使用了 `X | Y` union type 语法,不支持 3.9 及更低版本)
  20. ```bash
  21. # 1) 下载仓库
  22. git clone https://github.com/ringhyacinth/Star-Office-UI.git
  23. cd Star-Office-UI
  24. # 2) 安装依赖(需要 Python 3.10+)
  25. python3 -m pip install -r backend/requirements.txt
  26. # 3) 准备状态文件(首次)
  27. cp state.sample.json state.json
  28. # 4) 启动后端
  29. cd backend
  30. python3 app.py
  31. ```
  32. 打开 **http://127.0.0.1:19000** 然后试试切状态:
  33. ```bash
  34. python3 set_state.py writing "正在整理文档"
  35. python3 set_state.py error "发现问题,排查中"
  36. python3 set_state.py idle "待命中"
  37. ```
  38. ![Star Office UI 预览](docs/screenshots/readme-cover-1.jpg)
  39. ---
  40. ## 🤔 适合谁用?
  41. ### 有 OpenClaw / AI Agent 的用户
  42. 这是**完整体验**。Agent 在工作时自动切换状态,办公室里的像素角色会实时走到对应区域——你只需要打开网页,就能看到 AI 此刻在做什么。
  43. ### 没有 OpenClaw 的用户
  44. 也完全可以部署。你可以:
  45. - 用 `set_state.py` 或 API 手动 / 脚本推送状态
  46. - 把它当成一个像素风的个人状态页 / 远程办公看板
  47. - 接入任何能发 HTTP 请求的系统来驱动状态
  48. ---
  49. ## 📋 功能一览
  50. 1. **状态可视化** —— 6 种状态(`idle` / `writing` / `researching` / `executing` / `syncing` / `error`)自动映射到办公室不同区域,动画 + 气泡实时展示
  51. 2. **昨日小记** —— 自动从 `memory/*.md` 读取最近一天的工作记录,脱敏后展示为"昨日小记"卡片
  52. 3. **多 Agent 协作** —— 通过 join key 邀请其他 Agent 加入你的办公室,实时查看多人状态
  53. 4. **中英日三语** —— CN / EN / JP 一键切换,界面文案、气泡、加载提示全部联动
  54. 5. **美术资产自定义** —— 侧边栏管理角色 / 场景 / 装饰素材,支持动态帧同步,避免闪烁
  55. 6. **AI 生图装修** —— 接入 Gemini API,用 AI 给办公室换背景;不接入 API 也能正常使用核心功能
  56. 7. **移动端适配** —— 手机直接打开即可查看,适合外出时快速瞄一眼
  57. 8. **安全加固** —— 侧边栏密码保护、生产环境弱密码拦截、Session Cookie 加固
  58. 9. **灵活公网访问** —— 推荐 Cloudflare Tunnel 一键公网化,也可用自有域名 / 反向代理
  59. 10. **桌面宠物版** —— 可选的 Electron 桌面封装,把办公室变成透明窗口的桌面宠物(见下方说明)
  60. ---
  61. ## 🚀 详细部署指南
  62. ### 1) 安装依赖
  63. ```bash
  64. cd Star-Office-UI
  65. python3 -m pip install -r backend/requirements.txt
  66. ```
  67. ### 2) 初始化状态文件
  68. ```bash
  69. cp state.sample.json state.json
  70. ```
  71. ### 3) 启动后端
  72. ```bash
  73. cd backend
  74. python3 app.py
  75. ```
  76. 打开 `http://127.0.0.1:19000`
  77. > ✅ 首次部署可以先保留默认配置;在生产环境中,请复制 `.env.example` 为 `.env` 并设置强随机的 `FLASK_SECRET_KEY` 与 `ASSET_DRAWER_PASS`,避免弱密码和会话泄露。
  78. ### 4) 切换状态
  79. ```bash
  80. python3 set_state.py writing "正在整理文档"
  81. python3 set_state.py syncing "同步进度中"
  82. python3 set_state.py error "发现问题,排查中"
  83. python3 set_state.py idle "待命中"
  84. ```
  85. ### 5) 公网访问(可选)
  86. ```bash
  87. cloudflared tunnel --url http://127.0.0.1:19000
  88. ```
  89. 拿到 `https://xxx.trycloudflare.com` 链接即可分享。
  90. ### 6) 验证安装(可选)
  91. ```bash
  92. python3 scripts/smoke_test.py --base-url http://127.0.0.1:19000
  93. ```
  94. 所有检查显示 `OK` 即表示部署成功。
  95. ---
  96. ## 🦞 OpenClaw 深度集成
  97. > 以下内容面向 [OpenClaw](https://github.com/openclaw/openclaw) 用户。如果你不使用 OpenClaw,可以跳过这一节。
  98. ### 状态自动同步
  99. 在你的 `SOUL.md`(或 Agent 规则文件)中加入以下规则,让 Agent 自觉维护状态:
  100. ```markdown
  101. ## Star Office 状态同步规则
  102. - 接到任务时:先执行 `python3 set_state.py <状态> "<描述>"` 再开始工作
  103. - 完成任务后:执行 `python3 set_state.py idle "待命中"` 再回复
  104. ```
  105. **6 种状态 → 3 个区域的映射:**
  106. | 状态 | 办公室区域 | 触发场景 |
  107. |------|-----------|---------|
  108. | `idle` | 🛋 休息区(沙发) | 待命 / 任务完成 |
  109. | `writing` | 💻 工作区(办公桌) | 写代码 / 写文档 |
  110. | `researching` | 💻 工作区 | 搜索 / 调研 |
  111. | `executing` | 💻 工作区 | 执行命令 / 跑任务 |
  112. | `syncing` | 💻 工作区 | 同步数据 / 推送 |
  113. | `error` | 🐛 Bug 区 | 报错 / 异常排查 |
  114. ### 邀请其他 Agent 加入办公室
  115. **Step 1:准备 join key**
  116. 首次启动后端时,如果当前目录下不存在 `join-keys.json`,服务会自动根据 `join-keys.sample.json` 生成一个运行时的 `join-keys.json`(内含示例 key,例如 `ocj_example_team_01`)。你可以在生成后的 `join-keys.json` 中自行添加、修改或删除 key,每个 key 默认支持最多 3 人同时在线。
  117. **Step 2:让访客 Agent 运行推送脚本**
  118. 访客只需下载 `office-agent-push.py`,填写 3 个变量即可:
  119. ```python
  120. JOIN_KEY = "ocj_starteam02" # 你分配的 key
  121. AGENT_NAME = "小明的龙虾" # 显示名称
  122. OFFICE_URL = "https://office.hyacinth.im" # 你的办公室地址
  123. ```
  124. ```bash
  125. python3 office-agent-push.py
  126. ```
  127. 脚本会自动加入办公室并每 15 秒推送一次状态。访客会出现在看板上,根据状态自动走到对应区域。
  128. **Step 3(可选):访客安装 Skill**
  129. 访客也可以把 `frontend/join-office-skill.md` 作为 Skill 使用,Agent 会自动完成配置和推送。
  130. > 详细的访客接入说明见 [`frontend/join-office-skill.md`](./frontend/join-office-skill.md)
  131. ---
  132. ## 📡 常用 API
  133. | 端点 | 说明 |
  134. |------|------|
  135. | `GET /health` | 健康检查 |
  136. | `GET /status` | 获取主 Agent 状态 |
  137. | `POST /set_state` | 设置主 Agent 状态 |
  138. | `GET /agents` | 获取多 Agent 列表 |
  139. | `POST /join-agent` | 访客加入办公室 |
  140. | `POST /agent-push` | 访客推送状态 |
  141. | `POST /leave-agent` | 访客离开 |
  142. | `GET /yesterday-memo` | 获取昨日小记 |
  143. | `GET /config/gemini` | 获取 Gemini API 配置 |
  144. | `POST /config/gemini` | 设置 Gemini API 配置 |
  145. | `GET /assets/generate-rpg-background/poll` | 轮询生图进度 |
  146. ---
  147. ## 🖥 桌面宠物版(可选)
  148. `desktop-pet/` 目录提供了一个基于 **Electron** 的桌面封装版本,可以把像素办公室变成一个透明窗口的桌面宠物。
  149. ```bash
  150. cd desktop-pet
  151. npm install
  152. npm run dev
  153. ```
  154. - 启动时自动拉起 Python 后端
  155. - 窗口默认指向 `http://127.0.0.1:19000/?desktop=1`
  156. - 支持通过环境变量自定义项目路径和 Python 路径
  157. > ⚠️ 这是一个**可选的实验性功能**,目前主要在 macOS 上开发测试。详见 [`desktop-pet/README.md`](./desktop-pet/README.md)。
  158. >
  159. > 🙏 桌面宠物版由 [@Zhaohan-Wang](https://github.com/Zhaohan-Wang) 独立开发,感谢他的贡献!
  160. ---
  161. ## 🎨 美术资产与开源许可
  162. ### 资产来源
  163. 访客角色动画使用了 **LimeZu** 的免费资产:
  164. - [Animated Mini Characters 2 (Platformer) [FREE]](https://limezu.itch.io/animated-mini-characters-2-platform-free)
  165. 请在二次发布 / 演示时保留来源说明,并遵守原作者许可条款。
  166. ### 许可协议
  167. - **代码 / 逻辑:MIT**(见 [`LICENSE`](./LICENSE))
  168. - **美术资产:禁止商用**(仅学习 / 演示 / 交流用途)
  169. > 如需商用,请将所有美术资产替换为你自己的原创素材。
  170. ---
  171. ## 📝 更新日志
  172. | 日期 | 概要 | 详情 |
  173. |------|------|------|
  174. | 2026-03-06 | 🔌 默认端口调整 — 默认后端端口从 18791 调整为 19000,以避开 OpenClaw Browser Control 端口冲突;同步更新脚本、桌面壳与文档默认值 | [`docs/CHANGELOG_2026-03.md`](./docs/CHANGELOG_2026-03.md) |
  175. | 2026-03-05 | 📱 稳定性修复 — CDN 缓存修复、生图异步化、移动端侧边栏优化、Join Key 过期与并发控制 | [`docs/UPDATE_REPORT_2026-03-05.md`](./docs/UPDATE_REPORT_2026-03-05.md) |
  176. | 2026-03-04 | 🔒 P0/P1 安全加固 — 弱密码拦截、后端模块拆分、stale 状态自动回 idle、首屏骨架屏优化 | [`docs/UPDATE_REPORT_2026-03-04_P0_P1.md`](./docs/UPDATE_REPORT_2026-03-04_P0_P1.md) |
  177. | 2026-03-03 | 📋 开源发布检查清单完成 | [`docs/OPEN_SOURCE_RELEASE_CHECKLIST.md`](./docs/OPEN_SOURCE_RELEASE_CHECKLIST.md) |
  178. | 2026-03-01 | 🎉 **v2 重制发布** — 新增三语支持、资产管理系统、AI 生图装修、美术资产全面替换 | [`docs/FEATURES_NEW_2026-03-01.md`](./docs/FEATURES_NEW_2026-03-01.md) |
  179. ---
  180. ## 📁 项目结构
  181. ```text
  182. Star-Office-UI/
  183. ├── backend/ # Flask 后端
  184. │ ├── app.py
  185. │ ├── requirements.txt
  186. │ └── run.sh
  187. ├── frontend/ # 前端页面与资产
  188. │ ├── index.html
  189. │ ├── join.html
  190. │ ├── invite.html
  191. │ └── layout.js
  192. ├── desktop-pet/ # Electron 桌面宠物版(可选)
  193. ├── docs/ # 文档与截图
  194. │ └── screenshots/
  195. ├── office-agent-push.py # 访客推送脚本
  196. ├── set_state.py # 状态切换脚本
  197. ├── state.sample.json # 状态文件模板
  198. ├── join-keys.sample.json # Join Key 模板(启动时生成 join-keys.json)
  199. ├── SKILL.md # OpenClaw Skill
  200. └── LICENSE # MIT 许可
  201. ```
  202. ---
  203. ## ⭐ Star History
  204. [![Star History Chart](https://api.star-history.com/image?repos=ringhyacinth/Star-Office-UI&type=date&legend=top-left)](https://www.star-history.com/?repos=ringhyacinth%2FStar-Office-UI&type=date&legend=top-left)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.