| name | metabot-post-metaapp |
| description | 通过问答引导用户把本地 MetaApp 运行时目录/ZIP 与源码目录/ZIP 按 /protocols/metaapp 协议发布到链上。当用户说“发布metaapp”“上传metaapp”“我有一个app要分享”“把应用发到链上”等意图时调用此技能。 |
| official | true |
MetaBot Post MetaApp
将用户已开发好的 MetaApp 运行时包、源码包、图标和封面先上传为 metafile://<pinId>.<ext>，再按 /protocols/metaapp 组装协议 JSON，让用户确认后发布到链上。
何时调用
当用户表达以下意图时调用：
- “我要发布 metaapp”“我要上传 metapp/metaapp”
- “我有一个 app 要分享”“把这个应用发到链上”
- 能推断出用户想把本地应用作为链上 MetaApp 发布
对话发布流程
1. 收集运行时 content
先询问用户已开发好的 MetaApp 运行时目录或 ZIP 文件路径。
- 如果用户给出目录：后续由脚本压缩成 ZIP，再上传，
contentType 使用 application/zip。
- 如果用户给出 ZIP：直接上传，
contentType 使用 application/zip。
- 如果用户暂时没有可运行的运行时：允许
content 为空，但要继续询问源码 code。content 和 code 不能同时为空。
2. 收集源码 code
询问用户源码目录或 ZIP 文件路径。
- 如果用户给出目录：后续由脚本压缩成 ZIP，再上传，
codeType 使用 application/zip。
- 如果用户给出 ZIP：直接上传，
codeType 使用 application/zip。
- 如果用户暂时不想公开源码：允许
code 为空，但 content 必须非空。
3. 收集 MetaApp 元数据
一次性询问并尽量给出默认值：
| 字段 | 必填 | 默认/说明 |
|---|
| title | 是 | 应用展示标题 |
| appName | 是 | 应用名称/标识 |
| icon | 建议 | 本地图片路径或已上传的 metafile://，本地图片会先上传 |
| coverImg | 建议 | 本地图片路径或已上传的 metafile://，本地图片会先上传 |
| intro | 建议 | 应用介绍 |
| version | 是 | 建议 v1.0.0 或用户已有版本 |
| prompt | 否 | AI 生成提示词，没有则空字符串 |
| introImgs | 否 | 本地图片路径或 metafile:// 数组，没有则 [] |
| runtime | 否 | 默认 browser |
| indexFile | 否 | 默认 index.html |
| tags | 否 | 默认 [] |
| metadata | 否 | 缺失/为空时自动补 {"title":...,"appName":...} 默认值，不允许空字符串上链 |
| disabled | 否 | 默认 false |
contentHash 不询问用户手填：当 content 来自本地目录或 ZIP 时，脚本自动计算最终 content ZIP 文件的 SHA256；当 content 是已有 metafile:// 时，可沿用用户提供的 contentHash，否则为空。
MetaFile URI 协议层面允许 metafile://<pinId> 和 metafile://<pinId>.<ext> 两种形式；官方应用发布实践中，默认推荐带扩展名。这样前端可以直接从 URI 判断文件类型，避免为了拿 contentType 再查一次 /file pin。
4. 准备并让用户确认
把用户信息写入 request JSON 后先运行准备命令。准备阶段会上传运行时 ZIP、源码 ZIP、icon、coverImg、introImgs，并生成最终协议 payload，但不会发布 /protocols/metaapp。
node "$SKILLS_ROOT/metabot-post-metaapp/scripts/index.js" \
--prepare-request /tmp/metabot-post-metaapp-request.json \
--output /tmp/metabot-post-metaapp-prepared.json
Request 文件格式：
{
"title": "简单音乐播放器",
"appName": "id-music-player",
"intro": "一个简单链上音乐播放器",
"version": "v1.0.0",
"runtime": "browser/android/windows/ios/macOS/linux",
"content": "/path/to/runtime-dir-or.zip",
"code": "/path/to/source-dir-or.zip",
"icon": "/path/to/icon.png",
"coverImg": "/path/to/cover.png",
"introImgs": [],
"tags": ["music player"]
}
准备完成后，必须把 /tmp/metabot-post-metaapp-prepared.json 中的 payload 完整展示给用户确认。用户确认前不要发布 MetaApp 协议本体；准备阶段已经上传的 ZIP 或图片无需回滚。
5. 确认后发布
用户确认 payload 后再运行：
node "$SKILLS_ROOT/metabot-post-metaapp/scripts/index.js" \
--publish-prepared /tmp/metabot-post-metaapp-prepared.json
脚本会把确认后的 JSON 以 contentType: application/json 发布到 /protocols/metaapp。
Payload 形状
链上协议路径：/protocols/metaapp。协议字段顺序按 SOT 和现有链上样例保持：
{
"title": "应用标题",
"appName": "应用名称",
"prompt": "",
"icon": "metafile://pinid.png",
"coverImg": "metafile://pinid.jpg",
"introImgs": [],
"intro": "应用介绍文本",
"runtime": "browser",
"version": "v1.0.0",
"contentType": "application/zip",
"content": "metafile://runtime-zip-pinid.zip",
"indexFile": "index.html",
"code": "metafile://source-zip-pinid.zip",
"contentHash": "sha256_hex_of_content_zip"
打包排除（非运行时文件）
目录打包时自动排除非运行时文件（发布规范）：README*、*.md、*.log、.zip，以及预览截图命名（preview.*、*.screenshot.*、screenshot*、snapshot*）。规则只按文件名/扩展名匹配，不影响合法运行时资源（如 assets/icon.png、favicon.png）。发布前脚本会输出打包清单（文件数、总大小、文件列表）与 metadata 值，供核验后再发布。
AI 行为约束
- 先问运行时
content，再问源码 code；二者允许其一为空，但不能同时为空。
- 用户给目录时默认压缩为 ZIP；本技能当前默认运行时和源码都按
application/zip 上链。
- 本地图片、ZIP 都要先上传并替换成
metafile://<pinId>.<ext>；用户已提供的合法 metafile://<pinId> 可保留，但新组装的 URI 默认带扩展名。
- 准备阶段可先上传文件；真正发布
/protocols/metaapp 前必须展示完整 JSON 并得到用户确认。
- 始终使用
$SKILLS_ROOT/metabot-post-metaapp/scripts/index.js，不要绕开脚本另写临时发布逻辑。
- 底层 RPC 通过
IDBOTS_METABOT_ID 获取发布身份，无需向用户询问 MetaBot 身份。
- 协议细节优先参考链上 SOT；本技能参考文档见
references/metaapp-protocol.md。
