Cover Arts Launcher Skill

COMPATIBILITY CONTRACT

接入 Cover-Arts 启动器

约 1.5 秒

未接入情况下用户将重启设备再选择其他游戏，可选接入 Cover-Arts 兼容后可在玩法封面长按 UP 键返回 Cover-Arts 启动器。

DEFAULT

通用兼容

玩法正常启动和运行；复位或重新上电后返回 Launcher，原有名称和封面继续保留。

OPTIONAL

可选增强

在玩法封面长按上键约 1.5 秒，即可返回玩法库。

交给 Agent 接入

将下面的指令发送给支持 Skill 的 Agent。

请先在当前玩法项目目录安装并使用 AI Passport Cover Arts Launcher Skill：

npx skills add yishan/ai-passport-cover-arts-launcher -y

如果 GitHub 安装不可用，可使用 Vercel ZIP 备用源：
npx skills add https://calm.yishan.app/skills/ai-passport-cover-arts-launcher.zip --skill ai-passport-cover-arts-launcher -y

如果当前环境无法运行 skills CLI，请直接读取主 Skill：
https://calm.yishan.app/skills/ai-passport-cover-arts-launcher/SKILL.md

然后使用 $ai-passport-cover-arts-launcher，仅在当前玩法已有的封面／开始页接入长按 Up 返回 Cover Arts Launcher。不要全局占用 Up Long，不要修改游戏、设置、暂停或其他状态的按键行为；如果项目没有可可靠识别的封面状态，先说明情况，不要擅自新增封面页。保留设备重启返回 Launcher 的兼容策略。安装 Skill 不代表授权烧录、commit、push 或发布。

首选安装：GitHub 仓库 · skills.sh；备用来源：Vercel ZIP · 查看主 Skill。默认安装到当前项目，不使用全局安装。

先检查，不修改

只需要兼容性结论时，使用审计模式。

请使用 $ai-passport-cover-arts-launcher 检查这个玩法能否接入仅封面页生效的 Up Long 返回协议。不要修改文件；列出封面状态、输入分发点、分区假设和仍需确认的真机项目。

WHAT THE SKILL CHANGES

使用 Skill 后会发生什么

即使完全不接入，通用玩法仍可被 Cover-Arts Launcher 安装和启动，只是返回 Launcher 需要重启设备或重新上电。Skill 提供的是“封面页快捷返回”，不是安装或启动的兼容资格。

发生什么过程

01
交给 Agent
开发者提供 $ai-passport-cover-arts-launcher 和当前玩法项目。
02
先检查边界
Agent 检查按键系统、状态机和已有封面／开始页，不直接改代码。
03
能识别才接入
只有能可靠识别封面状态时，才加入带状态门控的快捷返回并运行测试。
04
无法识别就停止
Agent 会说明阻碍，不全局监听 Up Long，也不擅自新增封面页。

Skill 不自动授权烧录、commit、push 或发布；这些操作仍需开发者明确确认。

接入前／接入后

BEFORE · 通用兼容

重启返回玩法库

玩法可正常安装和启动。需要切换游戏时，重启设备或重新上电返回 Launcher。

AFTER · 可选增强

封面页快捷返回

仅在玩法已有封面／开始页长按 Up 约 1.5 秒返回 Launcher。游戏、设置、暂停、结算及其他状态中的 Up Long 保持原有行为。

玩法标题、封面、规则、存档和正常启动流程不变；factory Launcher 缺失或无效时，只记录错误并保持玩法运行。

代码层面变化

通常只增加一个小型 launcher_contract ESP-IDF 组件，并在现有输入分发点加入状态门控：

if (app_state == APP_STATE_COVER &&
    input.event == UP_LONG) {
    launcher_contract_return_to_factory();
}

组件在运行时查找并校验 factory，设置下次启动分区后重启。不能硬编码 factory 地址，也不能全局监听 Up Long。

不会发生的变化

不改变玩法 UI 风格、游戏规则、分区表、标题封面或存档
不增加网络依赖，也不要求 Launcher SDK
不把 Up Long 注册成全局快捷键
不要求所有社区玩法必须适配
除非创作者明确要求，不新增提示文字或弹窗

SKILL PACKAGE

下载指引、协议与参考组件

ZIP 包含双语 Agent 指引、协议与验收清单，以及运行时查找并校验 factory 分区的 ESP-IDF 参考组件。

下载 Skill ZIP 中文 Skill English Skill 协议与验收

公开入口：calm.yishan.app/skills · Skill：ai-passport-cover-arts-launcher