LoopAI App Publish

概述

创建并发布应用到 App Hub 展示中心。通过调用 API 将应用信息提交到平台，包括应用名称、URL、描述、截图、作者信息、定价模式和关联社区等。

重要： 提交前脚本会自动使用 curl 验证 app_url 是否能正常访问（支持跟随重定向，超时10秒）。如果 URL 不可达，将拒绝提交并返回错误提示。

何时使用此技能

当用户需要以下情况时使用此技能：

• - 分享新开发的 AI 应用或工具
• 发布软件到应用展示中心
• 更新应用信息（截图、描述等）
• 在多社区场景下展示应用
• 生成或发布 Loop App
• 创建 Loop 小程序
• 搭建 Loop 网站
• 发布 Loop 应用

前提条件

• - 需要有效的 App Hub API 访问权限
• 应用信息必须完整（名称、URL、描述、作者）
• 截图 URL 必须有效且可公开访问
• 建议准备应用图标（可选但推荐）

核心功能

1. 创建应用展示

提交新应用到 App Hub：

bash
python scripts/create_app.py --app-name 应用名称 --app-url https://example.com --description 应用描述 --author-name 作者名

必填参数：

• - --app-name - 应用正式名称
• --app-url - 应用访问网址
• --description - 功能详细描述
• --author-name - 作者姓名

可选参数：

• - --icon - 应用图标 URL
• --screenshot - 截图 URL（可重复添加多个）
• --author-avatar - 作者头像链接
• --author-url - 作者个人主页
• --price-mode - 计费模式：0=免费，1=付费（默认 0）
• --price - 价格（默认 0）
• --visibility - 可见性：0=公开，1=私有（默认 0）
• --community-name - 社区名称（可重复添加多个）
• --community-avatar - 社区头像链接
• --community-url - 社区链接

示例：
bash

基础提交

python scripts/create_app.py \
--app-name My AI Assistant \
--app-url https://myai.example.com \
--description 一个智能 AI 助手，帮助用户处理日常任务 \
--author-name John Doe

完整提交（含截图和多社区）

python scripts/create_app.py \ --app-name Smart ChatBot \ --app-url https://smartchat.example.com \ --description 基于最新 LLM 的智能对话系统 \ --author-name Jane Smith \ --author-avatar https://example.com/avatar.jpg \ --author-url https://jane.example.com \ --icon https://example.com/icon.png \ --screenshot https://example.com/screenshot1.png \ --screenshot https://example.com/screenshot2.png \ --price-mode 0 \ --visibility 0 \ --community-name OpenAI Community \ --community-avatar https://example.com/community-avatar.png \ --community-url https://community.example.com

2. 查看应用详情

获取指定 App Hub 应用的详细信息：

bash
python scripts/create_app.py --get-detail --app-id 应用ID

参数：

• - --app-id - 应用唯一标识（从创建结果或列表中获取）

示例：
bash
python scripts/create_app.py --get-detail --app-id 797fe6a6-fc43-4001-92c6-6f06e12b5fd9

响应示例：
json
{
code: 0,
data: {
app_id: 797fe6a6-fc43-4001-92c6-6f06e12b5fd9,
app_name: Test AI Assistant,
app_url: https://test-ai.example.com,
description: 一个测试用的 AI 助手应用,
icon: https://example.com/icon.png,
screenshots: [...],
author: [...],
price_mode: 0,
price: 0,
visibility: 0,
communities: [...],
created_at: 2025-03-24T03:18:31Z
}
}

3. 更新应用信息

修改已创建应用的详细信息：

bash
python scripts/create_app.py --update --app-id 应用ID --app-name 新名称 --description 新描述 ...

必填参数：

• - --app-id - 要更新的应用 ID

可选参数（只提供需要修改的字段）：

• - --app-name - 新的应用名称
• --app-url - 新的应用 URL
• --description - 新的应用描述
• --icon - 新的应用图标
• --screenshot - 新的截图（会替换原有截图列表）
• --author-name - 作者名称（需要同时提供 --author-avatar 和 --author-url 才会更新）
• --author-avatar - 作者头像
• --author-url - 作者主页
• --price-mode - 计费模式
• --price - 价格
• --visibility - 可见性
• --add-screenshot - 添加截图（不覆盖）
• --remove-screenshot - 删除指定索引的截图（从0开始）
• --community-name - 社区名称（添加或更新，需配合其他参数）
• --community-avatar - 社区头像
• --community-url - 社区链接

示例：
bash

仅更新名称和描述

python scripts/create_app.py \
--update \
--app-id 797fe6a6-fc43-4001-92c6-6f06e12b5fd9 \
--app-name Super AI Assistant \
--description 更强大的 AI 助手，支持多语言和多种任务

添加截图（不覆盖）

python scripts/create_app.py \ --update \ --app-id 797fe6a6-fc43-4001-92c6-6f06e12b5fd9 \ --add-screenshot https://example.com/new-ss.png

删除第一个截图（索引0）

python scripts/create_app.py \ --update \ --app-id 797fe6a6-fc43-4001-92c6-6f06e12b5fd9 \ --remove-screenshot 0

完整更新作者信息

python scripts/create_app.py \ --update \ --app-id 797fe6a6-fc43-4001-92c6-6f06e12b5fd9 \ --author-name Jane Doe \ --author-avatar https://example.com/new-avatar.jpg \ --author-url https://jane.example.com

4. 批量创建（JSON 输入）

支持通过 JSON 文件批量创建：

bash
python scripts/create_app.py --json-file apps.json

JSON 文件格式：
json
[
{
app_name: App 1,
app_url: https://app1.example.com,
description: 描述...,
author: [
{
name: Author Name
}
],
icon: https://example.com/icon.png,
screenshots: [
https://example.com/ss1.png
],
price_mode: 0,
price: 0,
visibility: 0,
communities: []
}
]

3. 验证应用信息

在提交前验证数据完整性：

bash
python scripts/create_app.py --validate-only --app-name Test --app-url https://test.com --description desc --author-name Author

该命令只验证参数，不实际提交。

输入模式（参数定义）

json
{
type: object,
properties: {
app_name: {
type: string,
description: 应用的正式名称
},
app_url: {
type: string,
description: 应用的访问网址 (URL)
},
icon: {
type: string,
description: 应用图标的图片链接
},
description: {
type: string,
description: 应用的功能详细描述
},
screenshots: {
type: array,
items: {
type: