[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ringhyacinth--Star-Office-UI":3,"tool-ringhyacinth--Star-Office-UI":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":77,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":79,"languages":80,"stars":101,"forks":102,"last_commit_at":103,"license":104,"difficulty_score":23,"env_os":105,"env_gpu":106,"env_ram":106,"env_deps":107,"category_tags":113,"github_topics":114,"view_count":23,"oss_zip_url":77,"oss_zip_packed_at":77,"status":16,"created_at":125,"updated_at":126,"faqs":127,"releases":158},3741,"ringhyacinth\u002FStar-Office-UI","Star-Office-UI","A pixel office for your OpenClaw: 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.","Star-Office-UI 是一款像素风格的 AI 办公室可视化看板，旨在将抽象的 AI 助手工作状态转化为直观、温馨的互动场景。它解决了用户在多 Agent 协作或后台任务运行时“看不见、摸不着”的痛点，通过生动的像素动画实时展示每个 AI 角色此刻是在写作、调研、执行代码还是处于待机状态，并自动汇总显示昨日的关键工作记录。\n\n这款工具特别适合 OpenClaw 用户、AI 开发者以及需要监控自动化流程的研究人员。对于 OpenClaw 用户，它能实现深度的状态自动同步，让 AI 在办公区内自由走动；普通开发者也可将其作为独立的状态仪表盘，通过简单的 API 或脚本手动驱动，甚至用作个性化的远程办公状态页。\n\n其技术亮点在于支持多 Agent 协同办公，允许多个智能体加入同一空间并实时联动；内置中、英、日三语切换，适应全球化团队需求；更创新性地接入 AI 生图功能，让用户能自定义办公室背景装修。此外，它还提供了桌面宠物模式（Electron 封装）和移动端适配，让监控 AI 工作变得既专业又充满趣味。无论是用于生产环境的状态监控，还是作为学习 AI 协作的演示工具，Star-Off","Star-Office-UI 是一款像素风格的 AI 办公室可视化看板，旨在将抽象的 AI 助手工作状态转化为直观、温馨的互动场景。它解决了用户在多 Agent 协作或后台任务运行时“看不见、摸不着”的痛点，通过生动的像素动画实时展示每个 AI 角色此刻是在写作、调研、执行代码还是处于待机状态，并自动汇总显示昨日的关键工作记录。\n\n这款工具特别适合 OpenClaw 用户、AI 开发者以及需要监控自动化流程的研究人员。对于 OpenClaw 用户，它能实现深度的状态自动同步，让 AI 在办公区内自由走动；普通开发者也可将其作为独立的状态仪表盘，通过简单的 API 或脚本手动驱动，甚至用作个性化的远程办公状态页。\n\n其技术亮点在于支持多 Agent 协同办公，允许多个智能体加入同一空间并实时联动；内置中、英、日三语切换，适应全球化团队需求；更创新性地接入 AI 生图功能，让用户能自定义办公室背景装修。此外，它还提供了桌面宠物模式（Electron 封装）和移动端适配，让监控 AI 工作变得既专业又充满趣味。无论是用于生产环境的状态监控，还是作为学习 AI 协作的演示工具，Star-Office-UI 都能提供轻量且高效的解决方案。","# Star Office UI\n\n🌐 Language: **中文** | [English](.\u002FREADME.en.md) | [日本語](.\u002FREADME.ja.md)\n\n![Star Office UI 封面](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_ed474dddfd0f.jpg)\n\n**一个像素风格的 AI 办公室看板** —— 把 AI 助手的工作状态实时可视化，让你直观看到\"谁在做什么、昨天做了什么、现在是否在线\"。\n\n支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式。\n与 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw) 深度集成时体验最佳，也可以独立部署作为状态看板使用。\n\n> 本项目由 **[Ring Hyacinth](https:\u002F\u002Fx.com\u002Fring_hyacinth)** 与 **[Simon Lee](https:\u002F\u002Fx.com\u002Fsimonxxoo)** 共同创建（co-created project），并与社区开发者（[@Zhaohan-Wang](https:\u002F\u002Fgithub.com\u002FZhaohan-Wang)、[@Jah-yee](https:\u002F\u002Fgithub.com\u002FJah-yee)、[@liaoandi](https:\u002F\u002Fgithub.com\u002Fliaoandi)）一起持续维护和共建。\n> 欢迎提交 Issue 和 PR，也感谢每一位贡献者的支持。\n\n---\n\n## ✨ 快速体验\n\n### 方式一：让龙虾帮你部署（推荐给 OpenClaw 用户）\n\n如果你正在使用 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw)，直接把下面这句话发给你的龙虾：\n\n```text\n请按照这个 SKILL.md 帮我完成 Star Office UI 的部署：\nhttps:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fblob\u002Fmaster\u002FSKILL.md\n```\n\n龙虾会自动完成 clone、安装依赖、启动后端、配置状态同步，并把访问地址发给你。\n\n### 方式二：30 秒手动部署\n\n> **环境要求：Python 3.10+**（代码使用了 `X | Y` union type 语法，不支持 3.9 及更低版本）\n\n```bash\n# 1) 下载仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI.git\ncd Star-Office-UI\n\n# 2) 安装依赖（需要 Python 3.10+）\npython3 -m pip install -r backend\u002Frequirements.txt\n\n# 3) 准备状态文件（首次）\ncp state.sample.json state.json\n\n# 4) 启动后端\ncd backend\npython3 app.py\n```\n\n打开 **http:\u002F\u002F127.0.0.1:19000** 然后试试切状态：\n\n```bash\npython3 set_state.py writing \"正在整理文档\"\npython3 set_state.py error \"发现问题，排查中\"\npython3 set_state.py idle \"待命中\"\n```\n\n![Star Office UI 预览](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_343e1849be7e.jpg)\n\n---\n\n## 🤔 适合谁用？\n\n### 有 OpenClaw \u002F AI Agent 的用户\n这是**完整体验**。Agent 在工作时自动切换状态，办公室里的像素角色会实时走到对应区域——你只需要打开网页，就能看到 AI 此刻在做什么。\n\n### 没有 OpenClaw 的用户\n也完全可以部署。你可以：\n- 用 `set_state.py` 或 API 手动 \u002F 脚本推送状态\n- 把它当成一个像素风的个人状态页 \u002F 远程办公看板\n- 接入任何能发 HTTP 请求的系统来驱动状态\n\n\n---\n\n## 📋 功能一览\n\n1. **状态可视化** —— 6 种状态（`idle` \u002F `writing` \u002F `researching` \u002F `executing` \u002F `syncing` \u002F `error`）自动映射到办公室不同区域，动画 + 气泡实时展示\n2. **昨日小记** —— 自动从 `memory\u002F*.md` 读取最近一天的工作记录，脱敏后展示为\"昨日小记\"卡片\n3. **多 Agent 协作** —— 通过 join key 邀请其他 Agent 加入你的办公室，实时查看多人状态\n4. **中英日三语** —— CN \u002F EN \u002F JP 一键切换，界面文案、气泡、加载提示全部联动\n5. **美术资产自定义** —— 侧边栏管理角色 \u002F 场景 \u002F 装饰素材，支持动态帧同步，避免闪烁\n6. **AI 生图装修** —— 接入 Gemini API，用 AI 给办公室换背景；不接入 API 也能正常使用核心功能\n7. **移动端适配** —— 手机直接打开即可查看，适合外出时快速瞄一眼\n8. **安全加固** —— 侧边栏密码保护、生产环境弱密码拦截、Session Cookie 加固\n9. **灵活公网访问** —— 推荐 Cloudflare Tunnel 一键公网化，也可用自有域名 \u002F 反向代理\n10. **桌面宠物版** —— 可选的 Electron 桌面封装，把办公室变成透明窗口的桌面宠物（见下方说明）\n\n---\n\n## 🚀 详细部署指南\n\n### 1) 安装依赖\n\n```bash\ncd Star-Office-UI\npython3 -m pip install -r backend\u002Frequirements.txt\n```\n\n### 2) 初始化状态文件\n\n```bash\ncp state.sample.json state.json\n```\n\n### 3) 启动后端\n\n```bash\ncd backend\npython3 app.py\n```\n\n打开 `http:\u002F\u002F127.0.0.1:19000`\n\n> ✅ 首次部署可以先保留默认配置；在生产环境中，请复制 `.env.example` 为 `.env` 并设置强随机的 `FLASK_SECRET_KEY` 与 `ASSET_DRAWER_PASS`，避免弱密码和会话泄露。\n\n### 4) 切换状态\n\n```bash\npython3 set_state.py writing \"正在整理文档\"\npython3 set_state.py syncing \"同步进度中\"\npython3 set_state.py error \"发现问题，排查中\"\npython3 set_state.py idle \"待命中\"\n```\n\n### 5) 公网访问（可选）\n\n```bash\ncloudflared tunnel --url http:\u002F\u002F127.0.0.1:19000\n```\n\n拿到 `https:\u002F\u002Fxxx.trycloudflare.com` 链接即可分享。\n\n### 6) 验证安装（可选）\n\n```bash\npython3 scripts\u002Fsmoke_test.py --base-url http:\u002F\u002F127.0.0.1:19000\n```\n\n所有检查显示 `OK` 即表示部署成功。\n\n---\n\n## 🦞 OpenClaw 深度集成\n\n> 以下内容面向 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw) 用户。如果你不使用 OpenClaw，可以跳过这一节。\n\n### 状态自动同步\n\n在你的 `SOUL.md`（或 Agent 规则文件）中加入以下规则，让 Agent 自觉维护状态：\n\n```markdown\n## Star Office 状态同步规则\n- 接到任务时：先执行 `python3 set_state.py \u003C状态> \"\u003C描述>\"` 再开始工作\n- 完成任务后：执行 `python3 set_state.py idle \"待命中\"` 再回复\n```\n\n**6 种状态 → 3 个区域的映射：**\n\n| 状态 | 办公室区域 | 触发场景 |\n|------|-----------|---------|\n| `idle` | 🛋 休息区（沙发） | 待命 \u002F 任务完成 |\n| `writing` | 💻 工作区（办公桌） | 写代码 \u002F 写文档 |\n| `researching` | 💻 工作区 | 搜索 \u002F 调研 |\n| `executing` | 💻 工作区 | 执行命令 \u002F 跑任务 |\n| `syncing` | 💻 工作区 | 同步数据 \u002F 推送 |\n| `error` | 🐛 Bug 区 | 报错 \u002F 异常排查 |\n\n### 邀请其他 Agent 加入办公室\n\n**Step 1：准备 join key**\n\n首次启动后端时，如果当前目录下不存在 `join-keys.json`，服务会自动根据 `join-keys.sample.json` 生成一个运行时的 `join-keys.json`（内含示例 key，例如 `ocj_example_team_01`）。你可以在生成后的 `join-keys.json` 中自行添加、修改或删除 key，每个 key 默认支持最多 3 人同时在线。\n\n**Step 2：让访客 Agent 运行推送脚本**\n\n访客只需下载 `office-agent-push.py`，填写 3 个变量即可：\n\n```python\nJOIN_KEY = \"ocj_starteam02\"          # 你分配的 key\nAGENT_NAME = \"小明的龙虾\"            # 显示名称\nOFFICE_URL = \"https:\u002F\u002Foffice.hyacinth.im\"  # 你的办公室地址\n```\n\n```bash\npython3 office-agent-push.py\n```\n\n脚本会自动加入办公室并每 15 秒推送一次状态。访客会出现在看板上，根据状态自动走到对应区域。\n\n**Step 3（可选）：访客安装 Skill**\n\n访客也可以把 `frontend\u002Fjoin-office-skill.md` 作为 Skill 使用，Agent 会自动完成配置和推送。\n\n> 详细的访客接入说明见 [`frontend\u002Fjoin-office-skill.md`](.\u002Ffrontend\u002Fjoin-office-skill.md)\n\n---\n\n## 📡 常用 API\n\n| 端点 | 说明 |\n|------|------|\n| `GET \u002Fhealth` | 健康检查 |\n| `GET \u002Fstatus` | 获取主 Agent 状态 |\n| `POST \u002Fset_state` | 设置主 Agent 状态 |\n| `GET \u002Fagents` | 获取多 Agent 列表 |\n| `POST \u002Fjoin-agent` | 访客加入办公室 |\n| `POST \u002Fagent-push` | 访客推送状态 |\n| `POST \u002Fleave-agent` | 访客离开 |\n| `GET \u002Fyesterday-memo` | 获取昨日小记 |\n| `GET \u002Fconfig\u002Fgemini` | 获取 Gemini API 配置 |\n| `POST \u002Fconfig\u002Fgemini` | 设置 Gemini API 配置 |\n| `GET \u002Fassets\u002Fgenerate-rpg-background\u002Fpoll` | 轮询生图进度 |\n\n---\n\n## 🖥 桌面宠物版（可选）\n\n`desktop-pet\u002F` 目录提供了一个基于 **Electron** 的桌面封装版本，可以把像素办公室变成一个透明窗口的桌面宠物。\n\n```bash\ncd desktop-pet\nnpm install\nnpm run dev\n```\n\n- 启动时自动拉起 Python 后端\n- 窗口默认指向 `http:\u002F\u002F127.0.0.1:19000\u002F?desktop=1`\n- 支持通过环境变量自定义项目路径和 Python 路径\n\n> ⚠️ 这是一个**可选的实验性功能**，目前主要在 macOS 上开发测试。详见 [`desktop-pet\u002FREADME.md`](.\u002Fdesktop-pet\u002FREADME.md)。\n>\n> 🙏 桌面宠物版由 [@Zhaohan-Wang](https:\u002F\u002Fgithub.com\u002FZhaohan-Wang) 独立开发，感谢他的贡献！\n\n---\n\n## 🎨 美术资产与开源许可\n\n### 资产来源\n\n访客角色动画使用了 **LimeZu** 的免费资产：\n- [Animated Mini Characters 2 (Platformer) [FREE]](https:\u002F\u002Flimezu.itch.io\u002Fanimated-mini-characters-2-platform-free)\n\n请在二次发布 \u002F 演示时保留来源说明，并遵守原作者许可条款。\n\n### 许可协议\n\n- **代码 \u002F 逻辑：MIT**（见 [`LICENSE`](.\u002FLICENSE)）\n- **美术资产：禁止商用**（仅学习 \u002F 演示 \u002F 交流用途）\n\n> 如需商用，请将所有美术资产替换为你自己的原创素材。\n\n---\n\n## 📝 更新日志\n\n| 日期 | 概要 | 详情 |\n|------|------|------|\n| 2026-03-06 | 🔌 默认端口调整 — 默认后端端口从 18791 调整为 19000，以避开 OpenClaw Browser Control 端口冲突；同步更新脚本、桌面壳与文档默认值 | [`docs\u002FCHANGELOG_2026-03.md`](.\u002Fdocs\u002FCHANGELOG_2026-03.md) |\n| 2026-03-05 | 📱 稳定性修复 — CDN 缓存修复、生图异步化、移动端侧边栏优化、Join Key 过期与并发控制 | [`docs\u002FUPDATE_REPORT_2026-03-05.md`](.\u002Fdocs\u002FUPDATE_REPORT_2026-03-05.md) |\n| 2026-03-04 | 🔒 P0\u002FP1 安全加固 — 弱密码拦截、后端模块拆分、stale 状态自动回 idle、首屏骨架屏优化 | [`docs\u002FUPDATE_REPORT_2026-03-04_P0_P1.md`](.\u002Fdocs\u002FUPDATE_REPORT_2026-03-04_P0_P1.md) |\n| 2026-03-03 | 📋 开源发布检查清单完成 | [`docs\u002FOPEN_SOURCE_RELEASE_CHECKLIST.md`](.\u002Fdocs\u002FOPEN_SOURCE_RELEASE_CHECKLIST.md) |\n| 2026-03-01 | 🎉 **v2 重制发布** — 新增三语支持、资产管理系统、AI 生图装修、美术资产全面替换 | [`docs\u002FFEATURES_NEW_2026-03-01.md`](.\u002Fdocs\u002FFEATURES_NEW_2026-03-01.md) |\n\n---\n\n## 📁 项目结构\n\n```text\nStar-Office-UI\u002F\n├── backend\u002F            # Flask 后端\n│   ├── app.py\n│   ├── requirements.txt\n│   └── run.sh\n├── frontend\u002F           # 前端页面与资产\n│   ├── index.html\n│   ├── join.html\n│   ├── invite.html\n│   └── layout.js\n├── desktop-pet\u002F        # Electron 桌面宠物版（可选）\n├── docs\u002F               # 文档与截图\n│   └── screenshots\u002F\n├── office-agent-push.py  # 访客推送脚本\n├── set_state.py          # 状态切换脚本\n├── state.sample.json     # 状态文件模板\n├── join-keys.sample.json # Join Key 模板（启动时生成 join-keys.json）\n├── SKILL.md              # OpenClaw Skill\n└── LICENSE               # MIT 许可\n```\n\n---\n\n## ⭐ Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_f95ae24e63ba.png)](https:\u002F\u002Fwww.star-history.com\u002F?repos=ringhyacinth%2FStar-Office-UI&type=date&legend=top-left)\n","# 星际办公室 UI\n\n🌐 语言: **中文** | [English](.\u002FREADME.en.md) | [日本語](.\u002FREADME.ja.md)\n\n![星际办公室 UI 封面](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_ed474dddfd0f.jpg)\n\n**一个像素风格的 AI 办公室看板** —— 把 AI 助手的工作状态实时可视化，让你直观看到\"谁在做什么、昨天做了什么、现在是否在线\"。\n\n支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式。\n与 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw) 深度集成时体验最佳，也可以独立部署作为状态看板使用。\n\n> 本项目由 **[Ring Hyacinth](https:\u002F\u002Fx.com\u002Fring_hyacinth)** 与 **[Simon Lee](https:\u002F\u002Fx.com\u002Fsimonxxoo)** 共同创建（co-created project），并与社区开发者（[@Zhaohan-Wang](https:\u002F\u002Fgithub.com\u002FZhaohan-Wang)、[@Jah-yee](https:\u002F\u002Fgithub.com\u002FJah-yee)、[@liaoandi](https:\u002F\u002Fgithub.com\u002Fliaoandi)）一起持续维护和共建。\n> 欢迎提交 Issue 和 PR，也感谢每一位贡献者的支持。\n\n---\n\n## ✨ 快速体验\n\n### 方式一：让龙虾帮你部署（推荐给 OpenClaw 用户）\n\n如果你正在使用 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw)，直接把下面这句话发给你的龙虾：\n\n```text\n请按照这个 SKILL.md 帮我完成 Star Office UI 的部署：\nhttps:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fblob\u002Fmaster\u002FSKILL.md\n```\n\n龙虾会自动完成 clone、安装依赖、启动后端、配置状态同步，并把访问地址发给你。\n\n### 方式二：30 秒手动部署\n\n> **环境要求：Python 3.10+**（代码使用了 `X | Y` union type 语法，不支持 3.9 及更低版本）\n\n```bash\n# 1) 下载仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI.git\ncd Star-Office-UI\n\n# 2) 安装依赖（需要 Python 3.10+）\npython3 -m pip install -r backend\u002Frequirements.txt\n\n# 3) 准备状态文件（首次）\ncp state.sample.json state.json\n\n# 4) 启动后端\ncd backend\npython3 app.py\n```\n\n打开 **http:\u002F\u002F127.0.0.1:19000** 然后试试切状态：\n\n```bash\npython3 set_state.py writing \"正在整理文档\"\npython3 set_state.py error \"发现问题，排查中\"\npython3 set_state.py idle \"待命中\"\n```\n\n![星际办公室 UI 预览](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_343e1849be7e.jpg)\n\n---\n\n## 🤔 适合谁用？\n\n### 有 OpenClaw \u002F AI Agent 的用户\n这是**完整体验**。Agent 在工作时自动切换状态，办公室里的像素角色会实时走到对应区域——你只需要打开网页，就能看到 AI 此刻在做什么。\n\n### 没有 OpenClaw 的用户\n也完全可以部署。你可以：\n- 用 `set_state.py` 或 API 手动 \u002F 脚本推送状态\n- 把它当成一个像素风的个人状态页 \u002F 远程办公看板\n- 接入任何能发 HTTP 请求的系统来驱动状态\n\n\n---\n\n## 📋 功能一览\n\n1. **状态可视化** —— 6 种状态（`idle` \u002F `writing` \u002F `researching` \u002F `executing` \u002F `syncing` \u002F `error`）自动映射到办公室不同区域，动画 + 气泡实时展示\n2. **昨日小记** —— 自动从 `memory\u002F*.md` 读取最近一天的工作记录，脱敏后展示为\"昨日小记\"卡片\n3. **多 Agent 协作** —— 通过 join key 邀请其他 Agent 加入你的办公室，实时查看多人状态\n4. **中英日三语** —— CN \u002F EN \u002F JP 一键切换，界面文案、气泡、加载提示全部联动\n5. **美术资产自定义** —— 侧边栏管理角色 \u002F 场景 \u002F 装饰素材，支持动态帧同步，避免闪烁\n6. **AI 生图装修** —— 接入 Gemini API，用 AI 给办公室换背景；不接入 API 也能正常使用核心功能\n7. **移动端适配** —— 手机直接打开即可查看，适合外出时快速瞄一眼\n8. **安全加固** —— 侧边栏密码保护、生产环境弱密码拦截、Session Cookie 加固\n9. **灵活公网访问** —— 推荐 Cloudflare Tunnel 一键公网化，也可用自有域名 \u002F 反向代理\n10. **桌面宠物版** —— 可选的 Electron 桌面封装，把办公室变成透明窗口的桌面宠物（见下方说明）\n\n---\n\n## 🚀 详细部署指南\n\n### 1) 安装依赖\n\n```bash\ncd Star-Office-UI\npython3 -m pip install -r backend\u002Frequirements.txt\n```\n\n### 2) 初始化状态文件\n\n```bash\ncp state.sample.json state.json\n```\n\n### 3) 启动后端\n\n```bash\ncd backend\npython3 app.py\n```\n\n打开 `http:\u002F\u002F127.0.0.1:19000`\n\n> ✅ 首次部署可以先保留默认配置；在生产环境中，请复制 `.env.example` 为 `.env` 并设置强随机的 `FLASK_SECRET_KEY` 与 `ASSET_DRAWER_PASS`，避免弱密码和会话泄露。\n\n### 4) 切换状态\n\n```bash\npython3 set_state.py writing \"正在整理文档\"\npython3 set_state.py syncing \"同步进度中\"\npython3 set_state.py error \"发现问题，排查中\"\npython3 set_state.py idle \"待命中\"\n```\n\n### 5) 公网访问（可选）\n\n```bash\ncloudflared tunnel --url http:\u002F\u002F127.0.0.1:19000\n```\n\n拿到 `https:\u002F\u002Fxxx.trycloudflare.com` 链接即可分享。\n\n### 6) 验证安装（可选）\n\n```bash\npython3 scripts\u002Fsmoke_test.py --base-url http:\u002F\u002F127.0.0.1:19000\n```\n\n所有检查显示 `OK` 即表示部署成功。\n\n---\n\n## 🦞 OpenClaw 深度集成\n\n> 以下内容面向 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw) 用户。如果你不使用 OpenClaw，可以跳过这一节。\n\n### 状态自动同步\n\n在你的 `SOUL.md`（或 Agent 规则文件）中加入以下规则，让 Agent 自觉维护状态：\n\n```markdown\n## Star Office 状态同步规则\n- 接到任务时：先执行 `python3 set_state.py \u003C状态> \"\u003C描述>\"` 再开始工作\n- 完成任务后：执行 `python3 set_state.py idle \"待命中\"` 再回复\n```\n\n**6 种状态 → 3 个区域的映射：**\n\n| 状态 | 办公室区域 | 触发场景 |\n|------|-----------|---------|\n| `idle` | 🛋 休息区（沙发） | 待命 \u002F 任务完成 |\n| `writing` | 💻 工作区（办公桌） | 写代码 \u002F 写文档 |\n| `researching` | 💻 工作区 | 搜索 \u002F 调研 |\n| `executing` | 💻 工作区 | 执行命令 \u002F 跑任务 |\n| `syncing` | 💻 工作区 | 同步数据 \u002F 推送 |\n| `error` | 🐛 Bug 区 | 报错 \u002F 异常排查 |\n\n### 邀请其他 Agent 加入办公室\n\n**Step 1：准备 join key**\n\n首次启动后端时，如果当前目录下不存在 `join-keys.json`，服务会自动根据 `join-keys.sample.json` 生成一个运行时的 `join-keys.json`（内含示例 key，例如 `ocj_example_team_01`）。你可以在生成后的 `join-keys.json` 中自行添加、修改或删除 key，每个 key 默认支持最多 3 人同时在线。\n\n**Step 2：让访客 Agent 运行推送脚本**\n\n访客只需下载 `office-agent-push.py`，填写 3 个变量即可：\n\n```python\nJOIN_KEY = \"ocj_starteam02\"          # 你分配的 key\nAGENT_NAME = \"小明的龙虾\"            # 显示名称\nOFFICE_URL = \"https:\u002F\u002Foffice.hyacinth.im\"  # 你的办公室地址\n```\n\n```bash\npython3 office-agent-push.py\n```\n\n脚本会自动加入办公室并每 15 秒推送一次状态。访客会出现在看板上，根据状态自动走到对应区域。\n\n**Step 3（可选）：访客安装 Skill**\n\n访客也可以把 `frontend\u002Fjoin-office-skill.md` 作为 Skill 使用，Agent 会自动完成配置和推送。\n\n> 详细的访客接入说明见 [`frontend\u002Fjoin-office-skill.md`](.\u002Ffrontend\u002Fjoin-office-skill.md)\n\n---\n\n## 📡 常用 API\n\n| 端点 | 说明 |\n|------|------|\n| `GET \u002Fhealth` | 健康检查 |\n| `GET \u002Fstatus` | 获取主 Agent 状态 |\n| `POST \u002Fset_state` | 设置主 Agent 状态 |\n| `GET \u002Fagents` | 获取多 Agent 列表 |\n| `POST \u002Fjoin-agent` | 访客加入办公室 |\n| `POST \u002Fagent-push` | 访客推送状态 |\n| `POST \u002Fleave-agent` | 访客离开 |\n| `GET \u002Fyesterday-memo` | 获取昨日小记 |\n| `GET \u002Fconfig\u002Fgemini` | 获取 Gemini API 配置 |\n| `POST \u002Fconfig\u002Fgemini` | 设置 Gemini API 配置 |\n| `GET \u002Fassets\u002Fgenerate-rpg-background\u002Fpoll` | 轮询生图进度 |\n\n---\n\n## 🖥 桌面宠物版（可选）\n\n`desktop-pet\u002F` 目录提供了一个基于 **Electron** 的桌面封装版本，可以把像素办公室变成一个透明窗口的桌面宠物。\n\n```bash\ncd desktop-pet\nnpm install\nnpm run dev\n```\n\n- 启动时自动拉起 Python 后端\n- 窗口默认指向 `http:\u002F\u002F127.0.0.1:19000\u002F?desktop=1`\n- 支持通过环境变量自定义项目路径和 Python 路径\n\n> ⚠️ 这是一个**可选的实验性功能**，目前主要在 macOS 上开发测试。详见 [`desktop-pet\u002FREADME.md`](.\u002Fdesktop-pet\u002FREADME.md)。\n>\n> 🙏 桌面宠物版由 [@Zhaohan-Wang](https:\u002F\u002Fgithub.com\u002FZhaohan-Wang) 独立开发，感谢他的贡献！\n\n---\n\n## 🎨 美术资产与开源许可\n\n### 资产来源\n\n访客角色动画使用了 **LimeZu** 的免费资产：\n- [Animated Mini Characters 2 (Platformer) [FREE]](https:\u002F\u002Flimezu.itch.io\u002Fanimated-mini-characters-2-platform-free)\n\n请在二次发布 \u002F 演示时保留来源说明，并遵守原作者许可条款。\n\n### 许可协议\n\n- **代码 \u002F 逻辑：MIT**（见 [`LICENSE`](.\u002FLICENSE)）\n- **美术资产：禁止商用**（仅学习 \u002F 演示 \u002F 交流用途）\n\n> 如需商用，请将所有美术资产替换为你自己的原创素材。\n\n---\n\n## 📝 更新日志\n\n| 日期 | 概要 | 详情 |\n|------|------|------|\n| 2026-03-06 | 🔌 默认端口调整 — 默认后端端口从 18791 调整为 19000，以避开 OpenClaw Browser Control 端口冲突；同步更新脚本、桌面壳与文档默认值 | [`docs\u002FCHANGELOG_2026-03.md`](.\u002Fdocs\u002FCHANGELOG_2026-03.md) |\n| 2026-03-05 | 📱 稳定性修复 — CDN 缓存修复、生图异步化、移动端侧边栏优化、Join Key 过期与并发控制 | [`docs\u002FUPDATE_REPORT_2026-03-05.md`](.\u002Fdocs\u002FUPDATE_REPORT_2026-03-05.md) |\n| 2026-03-04 | 🔒 P0\u002FP1 安全加固 — 弱密码拦截、后端模块拆分、stale 状态自动回 idle、首屏骨架屏优化 | [`docs\u002FUPDATE_REPORT_2026-03-04_P0_P1.md`](.\u002Fdocs\u002FUPDATE_REPORT_2026-03-04_P0_P1.md) |\n| 2026-03-03 | 📋 开源发布检查清单完成 | [`docs\u002FOPEN_SOURCE_RELEASE_CHECKLIST.md`](.\u002Fdocs\u002FOPEN_SOURCE_RELEASE_CHECKLIST.md) |\n| 2026-03-01 | 🎉 **v2 重制发布** — 新增三语支持、资产管理系统、AI 生图装修、美术资产全面替换 | [`docs\u002FFEATURES_NEW_2026-03-01.md`](.\u002Fdocs\u002FFEATURES_NEW_2026-03-01.md) |\n\n---\n\n## 📁 项目结构\n\n```text\nStar-Office-UI\u002F\n├── backend\u002F            # Flask 后端\n│   ├── app.py\n│   ├── requirements.txt\n│   └── run.sh\n├── frontend\u002F           # 前端页面与资产\n│   ├── index.html\n│   ├── join.html\n│   ├── invite.html\n│   └── layout.js\n├── desktop-pet\u002F        # Electron 桌面宠物版（可选）\n├── docs\u002F               # 文档与截图\n│   └── screenshots\u002F\n├── office-agent-push.py  # 访客推送脚本\n├── set_state.py          # 状态切换脚本\n├── state.sample.json     # 状态文件模板\n├── join-keys.sample.json # Join Key 模板（启动时生成 join-keys.json）\n├── SKILL.md              # OpenClaw Skill\n└── LICENSE               # MIT 许可\n```\n\n---\n\n## ⭐ 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_readme_f95ae24e63ba.png)](https:\u002F\u002Fwww.star-history.com\u002F?repos=ringhyacinth%2FStar-Office-UI&type=date&legend=top-left)","# Star-Office-UI 快速上手指南\n\nStar-Office-UI 是一个像素风格的 AI 办公室看板，用于实时可视化 AI 助手的工作状态（如“正在写作”、“排查错误”等）。支持多 Agent 协作、中英日三语切换及桌面宠物模式。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：Linux \u002F macOS \u002F Windows\n*   **Python 版本**：**Python 3.10+**（必须，代码使用了 `X | Y` 联合类型语法，不支持 3.9 及以下版本）\n*   **依赖管理**：pip\n*   **网络访问**：需能访问 GitHub 以克隆仓库（国内用户若遇网络问题，可使用镜像源或代理）\n\n## 安装步骤\n\n### 1. 克隆项目\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI.git\ncd Star-Office-UI\n```\n\n### 2. 安装后端依赖\n```bash\npython3 -m pip install -r backend\u002Frequirements.txt\n```\n> 💡 **国内加速提示**：若下载缓慢，可添加国内镜像源参数：\n> `python3 -m pip install -r backend\u002Frequirements.txt -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple`\n\n### 3. 初始化配置文件\n复制示例状态文件以生成正式配置文件：\n```bash\ncp state.sample.json state.json\n```\n\n### 4. 启动服务\n进入后端目录并运行应用：\n```bash\ncd backend\npython3 app.py\n```\n\n启动成功后，终端将显示服务地址，默认为 `http:\u002F\u002F127.0.0.1:19000`。\n\n## 基本使用\n\n### 1. 访问看板\n打开浏览器访问：\n```text\nhttp:\u002F\u002F127.0.0.1:19000\n```\n你将看到像素风格的办公室界面，默认状态下角色处于“待命”状态。\n\n### 2. 手动切换状态\n在项目根目录下，使用提供的脚本模拟 AI 状态变化，观察看板上的角色动作和气泡文字：\n\n**切换到“写作”状态：**\n```bash\npython3 set_state.py writing \"正在整理文档\"\n```\n\n**切换到“同步”状态：**\n```bash\npython3 set_state.py syncing \"同步进度中\"\n```\n\n**切换到“报错”状态：**\n```bash\npython3 set_state.py error \"发现问题，排查中\"\n```\n\n**恢复“待命”状态：**\n```bash\npython3 set_state.py idle \"待命中\"\n```\n\n### 3. 进阶场景（可选）\n*   **OpenClaw 用户**：可直接让 Agent 读取 `SKILL.md` 自动执行状态同步，无需手动调用脚本。\n*   **公网访问**：如需在外网查看，可使用 Cloudflare Tunnel：\n    ```bash\n    cloudflared tunnel --url http:\u002F\u002F127.0.0.1:19000\n    ```\n*   **桌面宠物**：进入 `desktop-pet` 目录，运行 `npm install && npm run dev` 可将看板封装为透明窗口桌面宠物。","某独立开发者正在利用 OpenClaw 构建一个由多个 AI Agent 协作完成的自动化数据分析项目，需要实时监控各助手的运行状态。\n\n### 没有 Star-Office-UI 时\n- **状态黑盒难感知**：开发者无法直观判断 Agent 是在深度思考、执行代码还是陷入死循环，只能盯着滚动的终端日志猜测进度。\n- **异常响应滞后**：当某个 Agent 报错卡顿时，往往要等到任务超时或人工轮询日志才发现，错过了最佳干预时机。\n- **协作过程不可见**：多个 Agent 并行工作时，缺乏统一的视角来确认“谁在做什么”，难以协调资源或理解分工逻辑。\n- **工作记录分散**：每日的工作产出和思维链散落在各个日志文件中，缺乏一个聚合的“昨日小记”来快速回顾进展。\n\n### 使用 Star-Office-UI 后\n- **工作状态可视化**：像素办公室实时映射 Agent 行为，看到角色在“办公桌”忙碌代表正在编码，在\"Bug 区”徘徊则意味着正在排查错误，一目了然。\n- **即时异常预警**：一旦 Agent 触发 `error` 状态，界面上对应角色会立即进入异常区域并弹出气泡提示，开发者可秒级介入处理。\n- **多角色协同全景**：通过加入同一个办公室看板，不同 Agent 的位置和状态同屏展示，清晰呈现团队协作的动态流程。\n- **自动沉淀日报**：系统自动读取记忆文件生成“昨日小记”卡片，让开发者每天打开网页就能回顾团队昨天的核心产出与思考路径。\n\nStar-Office-UI 将抽象的代码执行流转化为具象的办公室生活场景，让 AI 协作从“盲盒模式”变成了透明、可控且充满趣味的可视化过程。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fringhyacinth_Star-Office-UI_ed474ddd.jpg","ringhyacinth",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fringhyacinth_e14b5965.jpg","https:\u002F\u002Fgithub.com\u002Fringhyacinth",[81,85,89,93,97],{"name":82,"color":83,"percentage":84},"HTML","#e34c26",70,{"name":86,"color":87,"percentage":88},"Python","#3572A5",16.5,{"name":90,"color":91,"percentage":92},"JavaScript","#f1e05a",11.2,{"name":94,"color":95,"percentage":96},"Rust","#dea584",2.1,{"name":98,"color":99,"percentage":100},"Shell","#89e051",0.1,6507,698,"2026-04-05T07:26:50","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":108,"python":109,"dependencies":110},"代码使用了 Python 3.10+ 特有的联合类型语法（X | Y），不支持 3.9 及以下版本。桌面宠物版为基于 Electron 的可选实验性功能，目前主要在 macOS 上测试。若需使用 AI 生图装修功能，需配置 Gemini API。生产环境建议设置强随机的 FLASK_SECRET_KEY 与 ASSET_DRAWER_PASS。","3.10+",[111,112],"Flask (隐含)","Electron (桌面宠物版可选)",[15],[115,116,117,118,119,120,121,122,123,124],"agent-collaboration","ai-assistant","dashboard","flask","mobile-friendly","multi-agent","openclaw","phaser","pixel-art","status-visiualzation","2026-03-27T02:49:30.150509","2026-04-06T05:37:53.683144",[128,133,138,143,148,153],{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},17129,"启动项目后访问页面提示\"Unauthorized\"或无法加载，如何解决？","这通常是因为默认端口 18791 被其他服务（如 OpenClaw Browser Control）占用，导致你访问的不是 Star Office UI 后端。解决方案如下：\n1. 拉取最新代码：git pull origin master\n2. 最新版已将默认端口改为 19000，并修复了首次访问的 401 问题。\n3. 重新安装依赖：pip install -r backend\u002Frequirements.txt\n4. 启动后端：cd backend && python3 app.py\n5. 浏览器访问：http:\u002F\u002F127.0.0.1:19000\n如需自定义端口，可通过环境变量覆盖：STAR_BACKEND_PORT=\u003C端口> python3 backend\u002Fapp.py，并确保浏览器访问对应端口。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F54",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},17130,"OpenClaw 与本项目存在端口冲突怎么办？","OpenClaw 的 Browser Control 服务确实会占用 18791 端口，这与 Star Office UI 的旧默认端口冲突。该问题已在 master 分支修复：\n- 默认后端端口已从 18791 调整为 19000。\n- 同步更新了所有脚本、桌面壳与文档的默认地址。\n- 如需自定义端口，可通过环境变量覆盖：STAR_BACKEND_PORT=\u003C端口> python3 backend\u002Fapp.py。\n请确保更新到最新版本以避免冲突。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F31",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},17131,"页面一直显示\"Loading...\"且进度条卡在 0，或者双击 HTML 文件无法正常显示？","这是因为前端是通过后端 Flask 托管的，所有 API 都使用相对路径。直接双击打开 HTML 文件（file:\u002F\u002F 协议）会导致 fetch 请求全部失败。\n正确做法：\n1. 不要直接双击打开 index.html。\n2. 设置环境变量（如需改端口）：export STAR_BACKEND_PORT=19000（或其他端口）。\n3. 运行后端：python3 backend\u002Fapp.py。\n4. 在浏览器中打开 http:\u002F\u002F127.0.0.1:19000\u002F（或你设置的端口）。\n如果仍然卡住，请按 F12 打开浏览器控制台查看具体报错信息。此外，早期版本的 JS 语法错误也可能导致此问题，请确保拉取的是最新代码。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F46",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},17132,"如何替换默认的龙虾猫角色为自定义精灵（Sprite）？","替换角色需要替换对应的精灵图表（spritesheet）文件，而不是旧的单张图片。当前版本在 frontend\u002Fgame.js 中使用的资源包括：\n- star-idle-spritesheet.(png|webp)：空闲状态\n- star-researching-spritesheet.(png|webp)：研究中状态\n- star-working-spritesheet.(png|webp)：工作中状态\n注意事项：\n1. 确保新图片的尺寸和帧数配置正确（需修改 game.js 中的动画帧计数）。\n2. 如果看到多个角色重叠，可能是因为替换了多个状态文件但使用了相同的图片，导致不同状态的实体渲染在同一位置。\n3. 浏览器可能会强缓存资源（Cache-Control: immutable），测试时请强制刷新或清除缓存。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F86",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},17133,"Agent（龙虾猫）的状态永远是 idle，不随任务更新怎么办？","状态不更新通常是因为状态源没有被正确读取或 Agent 未主动上报状态。Star Office UI 读取 state.json 文件来获取当前状态。\n解决方法：\n1. 在你的 Agent 规则文件（如 SOUL.md）中加入状态同步规则：\n   - 接到任务前：执行 python3 set_state.py \u003C状态> \"\u003C描述>\"\n   - 完成任务后：执行 python3 set_state.py idle \"待命中\"\n2. 如果你修改了后端端口，请确保 office-agent-push.py 中的 LOCAL_STATUS_URL 指向正确的端口，或使用环境变量指定：OFFICE_LOCAL_STATE_FILE=\u002F你的\u002Fstate.json\u002F路径 python3 office-agent-push.py。\n注意：该功能在某些版本中可能存在间歇性问题，建议保持代码更新至最新版。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F87",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},17134,"如何排查端口是否被占用以及确认后端是否正常启动？","可以通过以下步骤排查：\n1. 检查端口占用情况：\n   lsof -i :18791 (或你使用的端口号)\n2. 显式启动本项目后端：\n   cd star-office-ui\u002Fbackend\n   python app.py\n3. 验证健康检查接口：\n   curl http:\u002F\u002F127.0.0.1:18791\u002Fhealth\n   正常响应应包含：{\"status\":\"ok\", ...}\n如果 \u002Fhealth 接口正常但浏览器仍显示 Unauthorized，请检查是否有其他旧进程占用了端口，或尝试更换端口启动。","https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fissues\u002F20",[159,164],{"id":160,"version":161,"summary_zh":162,"released_at":163},99321,"v1.0.0","# Star Office UI v1.0.0 🎉\n\n从 v0.1.0 到 v1.0.0，经历了 154 次提交、完整的架构重构和社区共建。这是第一个正式的稳定版本。\n\n![Star Office UI](docs\u002Fscreenshots\u002Freadme-cover-2.jpg)\n\n---\n\n## ✨ 核心特性\n\n- **像素办公室看板** — 6 种 AI 工作状态实时可视化，角色自动走到对应区域\n- **多 Agent 协作** — 通过 Join Key 邀请其他 Agent 加入你的办公室\n- **中英日三语** — CN \u002F EN \u002F JP 一键切换，全部 UI 文案联动\n- **AI 生图装修** — 接入 Gemini API 用 AI 给办公室换背景\n- **昨日小记** — 自动读取 memory 日志，脱敏展示\n- **移动端适配** — 手机直接打开查看\n- **桌面宠物版** — 可选的 Tauri 桌面封装\n\n## 🚀 快速体验\n\n### OpenClaw 用户\n\n发给你的龙虾：\n\n```\n请按照这个 SKILL.md 帮我完成 Star Office UI 的部署：\nhttps:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI\u002Fblob\u002Fmaster\u002FSKILL.md\n```\n\n### 手动部署\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fringhyacinth\u002FStar-Office-UI.git\ncd Star-Office-UI\npython3 -m pip install -r backend\u002Frequirements.txt\ncp state.sample.json state.json\ncd backend && python3 app.py\n```\n\n打开 http:\u002F\u002F127.0.0.1:19000 即可。\n\n---\n\n## 📋 v0.1.0 → v1.0.0 主要变更\n\n### 🎨 v2 重制（2026-03-01）\n- 全新美术资产替换\n- 资产管理系统（侧边栏管理角色\u002F场景\u002F装饰）\n- AI 生图装修系统（Gemini API）\n- 中英日三语完整支持\n\n### 🔒 安全加固（2026-03-04）\n- 侧边栏弱密码拦截\n- 后端模块拆分（security \u002F memo \u002F store utils）\n- Stale 状态自动回 idle\n- 首屏骨架屏优化\n\n### 📱 稳定性修复（2026-03-05）\n- CDN 缓存策略修复\n- 生图异步化（避免 Cloudflare 524 超时）\n- 移动端侧边栏 UX 优化\n- Join Key 过期与并发控制\n\n### 🔌 端口调整（2026-03-06）\n- 默认端口从 18791 调整为 19000（避开 OpenClaw Browser Control 冲突）\n- 同步更新所有脚本、桌面壳与文档\n\n### 📖 文档重构（2026-03-06）\n- README 三语重构：双路径快速体验、适用人群说明、社区共建文案\n- 更新日志倒序排列\n\n### 🤝 社区贡献\n感谢以下贡献者参与改进：\n- @Jah-yee — 文档改进、代码质量、Bug 修复（#56-#63）\n- @liaoandi — 访客 Agent 重叠修复（#64）\n- @vingmo、@thomasmmin、@Mammmth — Issue 反馈与问题定位\n\n---\n\n## 许可协议\n\n- **代码：MIT**\n- **美术资产：禁止商用**（仅学习\u002F演示\u002F交流）\n\n---\n\n> 本项目由 [Ring Hyacinth](https:\u002F\u002Fx.com\u002Fring_hyacinth) 与 [Simon Lee](https:\u002F\u002Fx.com\u002Fsimonxxoo) 共同创建，并与社区开发者一起持续维护和共建。\n","2026-03-06T10:08:45",{"id":165,"version":166,"summary_zh":167,"released_at":168},99322,"v0.1.0","Star Office UI 初次发布——专为您的 AI 助手打造的微型像素办公状态界面。","2026-02-26T03:50:13"]