프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Star-Office-UI Skill

저장소 ↗

제작자: ringhyacinth★ 7,581skill 1개

설치

What it does

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.

  • Connects Instruction files the AI reads, with steps that call an outside service
  • Account or key Some steps need a key for FLASK_SECRET_KEY, JOIN_KEY, Google Gemini (per the README)
  • Category 디자인과 웹
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/ringhyacinth-star-office-ui.svg)](https://mcp.popnx.com/en/skills/ringhyacinth-star-office-ui)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

제작자: DayuanJiang널리 사용됨↓ 2.2만/주★ 3.7만 저장소 전체의 별5일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

제작자: pascalorg널리 사용됨↓ 1천/주★ 2.6만 저장소 전체의 별어제 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드✓ 서비스 회사 · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

제작자: nteract널리 사용됨↓ 8.5천/주★ 2.7천20일 전 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
Star-Office-UI
impeccablediagram-designfrontend-slidesguizang-ppt-skill
제작자ringhyacinthpbakauscathrynlaveryzarazhangruiop7418
Skill 수11111
GitHub 별7,581112,54468,06932,51430,030
마지막 코드 변경2026년 3월 11일2026년 11월 18일2026년 11월 13일2026년 6월 24일2026년 10월 30일
라이선스–Apache-2.0MITMITAGPL-3.0

ringhyacinth의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

제작자가 밝히지 않음 · SKILL.md 형식 Skill은 Claude Code, Codex, Cursor 같은 Agent Skills 지원 앱에서 써요

설치

Is it safe?

  • Who made it

    GitHub account ringhyacinth (person), 6 years old

  • Use and upkeep

    ★ 7,581 stars · code last changed 2026년 3월 11일

  • Any scripts?

    28 scripts that can run on a computer: backend/run.sh, desktop-pet/src/ipix.ttf, healthcheck.sh, scripts/gemini_image_generate.py and 24 more

  • Uses the internet?

    Scripts that go online: healthcheck.sh, scripts/smoke_test.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit f29c107 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the star-office-ui folder again. The ZIP must have a star-office-ui folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick star-office-ui.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) for all my projects, at ~/.claude/skills/star-office-ui. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) into the project this chat is open in (at .claude/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /Star-Office-UI를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/ringhyacinth/star-office-ui.git /tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107/.' ~/.claude/skills/star-office-ui
  3. Claude Code를 다시 열고 /Star-Office-UI를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) for all my projects, at ~/.agents/skills/star-office-ui. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) into the project this chat is open in (at .agents/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

star-office-ui 폴더를 ~/.agents/skills/star-office-ui에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/ringhyacinth/star-office-ui.git /tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107/.' ~/.agents/skills/star-office-ui

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) for all my projects, at ~/.agents/skills/star-office-ui. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) into the project this chat is open in (at .agents/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/ringhyacinth/star-office-ui.git /tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107/.' ~/.agents/skills/star-office-ui
  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) for all my projects, at ~/.cursor/skills/star-office-ui. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) into the project this chat is open in (at .cursor/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 Star-Office-UI 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    git clone --depth 1 https://github.com/ringhyacinth/star-office-ui.git /tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-ringhyacinth-star-office-ui-f29c107/.' ~/.cursor/skills/star-office-ui
  3. Cursor Agent 채팅에서 /를 입력하고 Star-Office-UI 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) for all my projects, at ~/.claude/skills/star-office-ui (in Codex use ~/.agents/skills/star-office-ui, in Cursor ~/.cursor/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill star-office-ui from https://github.com/ringhyacinth/star-office-ui (commit f29c107) into the project this chat is open in (at .claude/skills/star-office-ui; in Codex use .agents/skills/star-office-ui, in Cursor .cursor/skills/star-office-ui). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

✓ 명령 확인 2026년 11월 18일

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

5,345자 · GitHub에서 전체 파일 열기

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

# Star Office UI Skill

本 Skill 面向想快速帮主人搭建"像素办公室看板"的 OpenClaw(龙虾):
- 目标:主人只需"看到效果",尽量少问问题
- 你可以按下面的步骤,一步一步帮主人跑起来并对外访问

---

## 0. 一句话告诉主人这是什么

你可以先和主人说:
> 这是一个多人协作的像素办公室仪表盘,你的 AI 助手会根据状态自动走到不同位置,还能看到昨天的工作小记!

---

## 1. 30 秒一键启动(推荐你先做一遍)

在你这台机器执行(按顺序):

```bash
# 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 就能看到像素办公室了!

---

## 2. 帮主人切状态体验一下

在项目根目录执行:

```bash
# 工作中 → 去办公桌
python3 set_state.py writing "正在帮你整理文档"

# 同步中
python3 set_state.py syncing "同步进度中"

# 报错中 → 去 bug 区
python3 set_state.py error "发现问题,正在排查"

# 待命 → 回休息区
python3 set_state.py idle "待命中,随时准备为你服务"
```

---

## 3. 侧边栏验证码设置(必须教会新龙虾)

当前默认验证码是:`1234`。

你需要这样引导主人:

1. 默认密码是 `1234`,可以先直接体验;
2. 当主人愿意时,可随时和你沟通修改密码;
3. 你应主动推荐改成强密码(更安全,防止他人误改资产和布局)。

修改方式(示例):

```bash
export ASSET_DRAWER_PASS="your-strong-pass"
```

如果是长期运行(systemd / pm2 / 容器),请把该环境变量写入服务配置,而不是只在当前 shell 临时设置。

---

## 4. 生图功能(Gemini)—— 可选

"搬新家 / 找中介"装修功能需要 Gemini API,但**基础看板不需要**,不装也能正常使用。

### 4.1 安装生图脚本环境(首次使用时)

仓库已自带生图脚本(`scripts/gemini_image_generate.py`),但运行需要独立的 Python 环境。在项目根目录执行:

```bash
# 创建 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
```

安装完成后,后端会自动检测到生图环境,"搬新家 / 找中介"按钮即可使用。

### 4.2 配置 Gemini API Key

引导用户完成这两项配置:

1. `GEMINI_API_KEY`
2. `GEMINI_MODEL`(推荐:`nanobanana-pro` 或 `nanobanana-2`)

配置方式有两种:
- **侧边栏填写**:打开资产侧边栏 → 在生图配置区域直接输入 API Key 并保存
- **环境变量**:`export GEMINI_API_KEY="your-key"`

并明确告诉用户:
- 不配置 API 也能用基础看板(状态显示、多 Agent、资产替换等)
- 配置后才能使用"搬新家 / 找中介"的 AI 生图装修能力

如果页面提示缺少 key,指导用户在侧边栏里直接填写并保存(运行时配置入口)。

---

## 5. 安装成功后,必须提醒主人的三件事

### 5.1 告知临时公网链接

推荐先用 Cloudflare Tunnel(最快):

```bash
cloudflared tunnel --url http://127.0.0.1:19000
```

拿到 `https://xxx.trycloudflare.com` 后发给主人,并补一句:
> 这是临时公网链接;如果你愿意,后续我可以一步步带你部署到本地域名。

### 5.2 装修房子入口

提醒主人:
- 现在可以点击"装修房间"开始装饰;
- 侧边栏默认密码是 `1234`;
- 当他想改密码时,可随时告诉你,你来帮他改;
- 推荐改成强密码,安全性更高。

### 5.3 生图 API 配置

提醒主人:
- 生图功能需要自己的 API;
- 当前接入的是 **Gemini 官方 API 格式与地址**;
- 若要替换成其他类型 API,请先和你沟通,由你来改接入;
- 最好让主人把对应 API 文档发给你,便于准确适配。

---

## 6. 邀请其他龙虾加入(可选)

如果有其他 OpenClaw 想加入你主人的办公室:

### 步骤 A:告诉其他龙虾用 office-agent-push.py

你可以让其他龙虾:
1) 下载 `office-agent-push.py`(可以直接从你这个仓库拿)
2) 让它调用 `join-agent` + 周期 `agent-push`
3) 你主人那边就能看到它进办公室了

### 步骤 B:join key 说明

- 仓库里默认有 `join-keys.json`(`ocj_starteam01` ~ `ocj_starteam08`)
- 同一个 key 最多 3 人同时在线
- 你也可以帮主人新建自己的 key

---

## 7. 昨日小记(可选)

如果你主人想看到"昨日小记":
- 在仓库上级目录放一个 `memory/YYYY-MM-DD.md`
- 后端会自动读取昨天(或最近可用)的记录,做基础脱敏后展示

---

## 8. 常见问题(主人可能问你的)

### Q1:"我可以商用吗?"
> 代码玩法可以基于 MIT 用,但美术资产(包括角色/场景)禁止商用;如果你要商用,请务必换成你自己的原创美术资产。

### Q2:"其他龙虾怎么加入?"
> 用 join key 加入,然后持续推送状态就行;仓库里有 `office-agent-push.py` 可以给其他龙虾用。

---

## 9. 给你的提示

- 尽量帮主人把"启动步骤"做完,让主人只负责"看"和"体验"
- 如果主人要对外访问,优先用 Cloudflare Tunnel(最快最方便)
- 状态切换应由你主动执行:
  - 接任务前,先把自己状态切到"工作中"(如 `writing/researching/executing`),再开始工作;
  - 完成任务后,先把自己状态切回"待命中(idle)",再进入休息/等待下一任务。
- 注意不要暴露你主人的内网地址或私有信息

---

## 10. 2026-03 增量补充(仅新增项)

> 本次重制核心请按四条理解:
> 1) 新增中英日三语
> 2) 新增资产管理(全量美术可自定义)
> 3) 接入生图 API(龙虾自动改房间 + 用户手动装修)
> 4) 美术资产替换与优化(含命名与索引重建)

### 10.1 生图模型建议(房间装修)

当用户使用"搬新家 / 找中介"时,优先推荐:

1. **gemini nanobanana pro**
2. **gemini nanobanana 2**

其他模型在房间结构保持与风格一致性上可能不稳定。

推荐配置:
- `GEMINI_API_KEY`
- `GEMINI_MODEL=nanobanana-pro`(或 `nanobanana-2`)

并提示用户:缺 key 时可在侧边栏内直接填写并保存。

### 10.2 侧边栏验证码安全提醒(必须)

默认验证码为 `1234`,但生产/公网场景必须改强密码:

```bash
export ASSET_DRAWER_PASS="your-strong-pass"
```

理由:防止外部访问者修改房间布局、装饰和资产配置。

### 10.3 版权口径更新

主角状态素材已切换为无版权争议的小猫,不再沿用旧角色版权说明。

保留统一口径:
- 代码:MIT
- 美术资产:禁止商用

### 10.4 安装时必须提醒(API 可选)

在帮助主人安装时,需明确提醒:

- 现在支持接入自己的生图 API 来改美术资产与背景(可持续更换)。
- 但基础功能(状态看板、多 Agent、资产替换/布局、三语切换)**不依赖 API**,不开 API 也能正常使用。

建议对主人口径:
> 先把基础看板跑起来;需要"无限换背景/AI 生图装修"再接入自己的 API。

### 10.5 老用户更新指南(从旧版本升级)

如果主人之前已经下载过旧版,按以下步骤升级:

1. 进入项目目录并备份本地配置(如 `state.json`、自定义资产)。
2. 拉取最新代码(`git pull` 或重新克隆到新目录)。
3. 确认依赖:`python3 -m pip install -r backend/requirements.txt`。
4. 保留并检查本地运行配置:
   - `ASSET_DRAWER_PASS`
   - `GEMINI_API_KEY` / `GEMINI_MODEL`(如需生图)
5. 如有自定义位置,确认:
   - `asset-positions.json`
   - `asset-defaults.json`
6. 重启后端并验收关键功能:
   - `/health`
   - 三语切换(CN/EN/JP)
   - 资产侧栏(选择、替换、设默认)
   - 生图入口(有 key 时可用)

### 10.6 功能更新提醒清单(对主人口播)

本次更新以后,至少提醒主人以下变化:

1. 已支持 **CN/EN/JP 三语切换**(含 loading 与气泡实时联动)。
2. 已支持 **自定义美术资产替换**(含动态素材切帧同步,减少闪烁)。
3. 已支持 **接入自有生图 API** 持续更换背景(推荐 `nanobanana-pro` / `nanobanana-2`)。
4. 新增/强化了安全项:`ASSET_DRAWER_PASS` 生产环境建议改强密码。

### 10.7 2026-03-05 稳定性修复

本次更新修复了多个影响线上稳定运行的问题:

1. **CDN 缓存修复**:静态资源 404 不再被 CDN 长缓存(之前导致 `phaser.js` 被缓存为 404 达 2.7 天)。
2. **前端加载修复**:修复 `fetchStatus()` 中的 JS 语法错误(多余 `else` 块),解决页面卡 loading 问题。
3. **生图异步化**:生图接口改为后台任务 + 轮询模式,避免 Cloudflare 524 超时(100s 限制)。前端显示实时等待进度。
4. **移动端侧边栏**:新增遮罩层、body 滚动锁定、`100dvh` 适配、`overscroll-behavior: contain`。
5. **Join Key 增强**:支持 key 级别过期时间(`expiresAt`)和并发上限(`maxConcurrent`),`join-keys.json` 不再入库。

> 详细说明见:`docs/UPDATE_REPORT_2026-03-05.md`

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
7,581
제작자
ringhyacinth
라이선스
라이선스 명시 없음 이 repo에는 라이선스가 없습니다. 기본적으로 제작자가 모든 권리를 가지므로 배포나 상업적 사용 전에 문의하세요.
최근 코드 수정
2026년 3월 11일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-collaboration, ai-assistant, dashboard, flask, mobile-friendly, multi-agent, openclaw, phaser, pixel-art, status-visiualzation