Skip to content

arch3rPro/1Panel-Appstore / skills

1panel-app-builder

Verified

Use when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories, icons, README files, and 1Panel validation.

FileKindSize
README.mdmarkdown2.6 KB
SKILL.mdskill md5.1 KB
evals/evals.jsonconfig1.6 KB
examples/example-usage.mdmarkdown2.3 KB
references/1panel-examples.mdmarkdown9.1 KB
scripts/download-icon.shexecutablescript7.6 KB
scripts/generate-app.shexecutablescript27.0 KB
scripts/validate-app.shexecutablescript11.6 KB
templates/data.yml.tplother1.1 KB
templates/docker-compose.yml.tplother396 B
tests/run_all.shexecutablescript358 B
tests/test_skills_scripts.shexecutablescript13.4 KB

scripts/generate-app.sh

View on GitHub
#!/usr/bin/env bash

# =============================================================================
# 1Panel App Builder - 主生成脚本
# 功能:从 GitHub 项目、docker-compose、docker run 命令生成 1Panel APP 配置
# 用法:./generate-app.sh <输入源> [输出目录]
# =============================================================================

set -euo pipefail

# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

# 默认配置
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
TEMPLATE_DIR="${SCRIPT_DIR}/../templates"
OUTPUT_BASE="./apps"
ICON_MODE="auto"
ICON_URL=""
ICON_CACHE_DIR="${SCRIPT_DIR}/../.cache/icons"
USER_APP_KEY=""
USER_APP_NAME=""
USER_VERSION=""
USER_SERVICE=""
FORCE=false
DRY_RUN=false
CHECK_DEPS_ONLY=false
POSITIONAL=()
SERVICE_VOLUMES=()
SERVICE_ENV=()
SERVICE_ENV_FILES=()
DOCKER_RUN_CONTENT=""
GITHUB_API_BASE_URL="${GITHUB_API_BASE_URL:-https://api.github.com/repos}"
GITHUB_RAW_BASE_URL="${GITHUB_RAW_BASE_URL:-https://raw.githubusercontent.com}"

# 打印帮助
print_help() {
  cat << EOF
${BLUE}1Panel App Builder${NC} - 快速生成 1Panel 应用配置

${YELLOW}用法:${NC}
  $0 [选项] <输入源> [输出目录]

${YELLOW}输入源支持:${NC}
  1. GitHub 项目链接
     例如: https://github.com/alist-org/alist

  2. docker-compose.yml 文件链接
     例如: https://raw.githubusercontent.com/alist-org/alist/master/docker-compose.yml

  3. docker run 命令
     例如: "docker run -d --name=alist -p 5244:5244 xhofe/alist:v3.45.0"

  4. 本地文件路径
     例如: ./myapp/docker-compose.yml

${YELLOW}输出:${NC}
  在指定目录(默认 ./apps)下生成:
  <app-name>/<version>/
  ├── data.yml          # 应用元数据
  ├── docker-compose.yml # 编排文件
  ├── logo.png          # 应用图标
  ├── README.md         # 中文简介
  └── README_en.md      # 英文简介

${YELLOW}示例:${NC}
  $0 https://github.com/alist-org/alist
  $0 ./my-docker-compose.yml ./my-apps
  $0 "docker run -d --name nginx -p 80:80 nginx:latest"
  $0 --app-key demo-app --name DemoApp --version 1.2.3 --icon-mode skip ./docker-compose.yml

${YELLOW}选项:${NC}
  --output <目录>              输出目录(默认: ./apps)
  --app-key <key>              显式指定应用目录名
  --name <名称>                显式指定应用显示名
  --service <服务名>           从 compose 中选择主服务
  --version <版本>             显式指定具体版本目录和镜像 tag
  --icon-mode <模式>           auto|required|skip|cache-only
  --icon-url <URL>             使用指定图标 URL
  --force                      允许覆盖已有输出目录
  --dry-run                    只解析和打印结果,不写文件
  --check-deps                 只检查脚本依赖
EOF
}

# 日志函数
log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
log_error() { echo -e "${RED}[ERROR]${NC} $1"; }

normalize_app_key() {
  echo "$1" | tr '[:upper:]' '[:lower:]' | tr ' _' '--' | tr -cd 'a-z0-9.-'
}

check_dependencies() {
  local missing=()
  local dep

  for dep in curl jq yq python3; do
    if ! command -v "$dep" >/dev/null 2>&1; then
      missing+=("$dep")
    fi
  done

  if ((${#missing[@]} > 0)); then
    log_error "缺少依赖: ${missing[*]}"
    log_info "请先安装缺失工具后再运行 generate-app.sh"
    return 1
  fi

  return 0
}

parse_args() {
  POSITIONAL=()
  while [[ $# -gt 0 ]]; do
    case "$1" in
      --output|-o)
        OUTPUT_BASE="${2:-}"
        shift 2
        ;;
      --app-key)
        USER_APP_KEY="${2:-}"
        shift 2
        ;;
      --name)
        USER_APP_NAME="${2:-}"
        shift 2
        ;;
      --service)
        USER_SERVICE="${2:-}"
        shift 2
        ;;
      --version)
        USER_VERSION="${2:-}"
        shift 2
        ;;
      --icon-mode)
        ICON_MODE="${2:-}"
        shift 2
        ;;
      --icon-url)
        ICON_URL="${2:-}"
        shift 2
        ;;
      --force)
        FORCE=true
        shift
        ;;
      --dry-run)
        DRY_RUN=true
        shift
        ;;
      --check-deps)
        CHECK_DEPS_ONLY=true
        shift
        ;;
      -h|--help)
        print_help
        exit 0
        ;;
      --)
        shift
        POSITIONAL+=("$@")
        break
        ;;
      -*)
        log_error "未知选项: $1"
        exit 2
        ;;
      *)
        POSITIONAL+=("$1")
        shift
        ;;
    esac
  done

  case "$ICON_MODE" in
    auto|required|skip|cache-only) ;;
    *)
      log_error "无效图标模式: $ICON_MODE"
      exit 2
      ;;
  esac

  if [[ ${#POSITIONAL[@]} -gt 1 ]]; then
    OUTPUT_BASE="${POSITIONAL[1]}"
  fi
}

# 解析镜像引用(支持 registry/namespace/repo:tag)
parse_image_ref() {
  local image_ref="$1"
  local image_no_tag tag

  # 去掉 digest
  image_ref="${image_ref%%@*}"

  if [[ "$image_ref" =~ ^(.+):([^/:]+)$ ]]; then
    image_no_tag="${BASH_REMATCH[1]}"
    tag="${BASH_REMATCH[2]}"
  else
    image_no_tag="$image_ref"
    tag="latest"
  fi

  local first_segment="${image_no_tag%%/*}"
  if [[ "$image_no_tag" == */* ]] && ([[ "$first_segment" == *.* ]] || [[ "$first_segment" == *:* ]] || [[ "$first_segment" == "localhost" ]]); then
    REGISTRY="$first_segment"
    IMAGE_PATH="${image_no_tag#*/}"
  else
    REGISTRY="docker.io"
    IMAGE_PATH="$image_no_tag"
  fi

  if [[ "$IMAGE_PATH" == */* ]]; then
    NAMESPACE="${IMAGE_PATH%%/*}"
    REPO_PATH="${IMAGE_PATH#*/}"
  else
    NAMESPACE="library"
    REPO_PATH="$IMAGE_PATH"
  fi

  IMAGE_BASE="$image_no_tag"
  TAG="$tag"
}

# 获取 Docker Hub 最新版本号
get_latest_tag_docker_hub() {
  local namespace="$1"
  local repo_path="$2"
  local url="https://hub.docker.com/v2/repositories/${namespace}/${repo_path}/tags?page_size=100&ordering=last_updated"
  local tags
  tags=$(curl -fsSL --connect-timeout 5 --max-time 20 "$url" | jq -r '.results[].name' 2>/dev/null || true)

  local semver
  semver=$(echo "$tags" | grep -E '^[vV]?[0-9]+\.[0-9]+(\.[0-9]+)?$' | sort -V | tail -n1 || true)
  if [[ -n "$semver" ]]; then
    echo "$semver"
    return 0
  fi

  local nonlatest
  nonlatest=$(echo "$tags" | grep -v '^latest$' | head -n1 || true)
  echo "${nonlatest:-latest}"
}

# 获取 GHCR 最新版本号
get_latest_tag_ghcr() {
  local namespace="$1"
  local repo_path="$2"
  local token tags

  token=$(curl -fsSL --connect-timeout 5 --max-time 20 "https://ghcr.io/token?service=ghcr.io&scope=repository:${namespace}/${repo_path}:pull" | jq -r '.token' 2>/dev/null || true)
  if [[ -z "$token" || "$token" == "null" ]]; then
    echo "latest"
    return 0
  fi

  tags=$(curl -fsSL --connect-timeout 5 --max-time 20 -H "Authorization: Bearer ${token}" "https://ghcr.io/v2/${namespace}/${repo_path}/tags/list" | jq -r '.tags[]' 2>/dev/null || true)

  local semver
  semver=$(echo "$tags" | grep -E '^[vV]?[0-9]+\.[0-9]+(\.[0-9]+)?$' | sort -V | tail -n1 || true)
  if [[ -n "$semver" ]]; then
    echo "$semver"
    return 0
  fi

  local nonlatest
  nonlatest=$(echo "$tags" | grep -v '^latest$' | sort -V | tail -n1 || true)
  echo "${nonlatest:-latest}"
}

# 统一获取最新版本号
get_latest_tag() {
  if [[ "$REGISTRY" == "ghcr.io" ]]; then
    get_latest_tag_ghcr "$NAMESPACE" "$REPO_PATH"
    return 0
  fi

  # 默认走 Docker Hub
  get_latest_tag_docker_hub "$NAMESPACE" "$REPO_PATH"
}

# 解析端口映射条目为 host:container
parse_port_entry() {
  local entry="$1"
  entry="${entry%\"}"
  entry="${entry#\"}"
  if [[ "$entry" == */* ]]; then
    entry="${entry%/*}"
  fi
  IFS=':' read -r -a parts <<< "$entry"
  local host_port container_port
  if [[ ${#parts[@]} -eq 1 ]]; then
    host_port="${parts[0]}"
    container_port="${parts[0]}"
  elif [[ ${#parts[@]} -eq 2 ]]; then
    host_port="${parts[0]}"
    container_port="${parts[1]}"
  else
    host_port="${parts[-2]}"
    container_port="${parts[-1]}"
  fi
  echo "${host_port}:${container_port}"
}

# 根据端口号选择 1Panel 常用 envKey
map_port_envkey() {
  local port="$1"
  local index="$2"
  case "$port" in
    80|8080|3000|5173|8000|5000)
      echo "PANEL_APP_PORT_HTTP"
      ;;
    443|8443)
      echo "PANEL_APP_PORT_HTTPS"
      ;;
    22)
      echo "PANEL_APP_PORT_SSH"
      ;;
    3306|5432|27017|6379)
      echo "PANEL_APP_PORT_DB"
      ;;
    9000|9001|8081|7001)
      echo "PANEL_APP_PORT_API"
      ;;
    *)
      if [[ "$index" -eq 0 ]]; then
        echo "PANEL_APP_PORT_HTTP"
      else
        echo "PANEL_APP_PORT_API"
      fi
      ;;
  esac
}

# envKey 对应标签
labels_for_envkey() {
  local envkey="$1"
  case "$envkey" in
    PANEL_APP_PORT_HTTP) echo "Web Port|Web端口" ;;
    PANEL_APP_PORT_HTTPS) echo "HTTPS Port|HTTPS端口" ;;
    PANEL_APP_PORT_API) echo "API Port|API端口" ;;
    PANEL_APP_PORT_ADMIN) echo "Admin Port|管理端口" ;;
    PANEL_APP_PORT_PROXY) echo "Proxy Port|代理端口" ;;
    PANEL_APP_PORT_DB) echo "DB Port|数据库端口" ;;
    PANEL_APP_PORT_SSH) echo "SSH Port|SSH端口" ;;
    PANEL_APP_PORT_S3) echo "S3 Port|S3端口" ;;
    PANEL_APP_PORT_PROXY_HTTP) echo "Proxy HTTP Port|代理HTTP端口" ;;
    PANEL_APP_PORT_PROXY_HTTPS) echo "Proxy HTTPS Port|代理HTTPS端口" ;;
    PANEL_APP_PORT_SYNC) echo "Sync Port|同步端口" ;;
    *) echo "Port|端口" ;;
  esac
}
# 检测输入类型
detect_input_type() {
  local input="$1"

  # GitHub 项目链接
  if [[ "$input" =~ ^https?://github\.com/[^/]+/[^/]+ ]]; then
    echo "github"
    return 0
  fi

  # docker-compose 文件链接
  if [[ "$input" =~ ^https?://.*\.ya?ml$ ]] || [[ "$input" =~ docker-compose ]]; then
    echo "compose_url"
    return 0
  fi

  # docker run 命令
  if [[ "$input" =~ ^docker\ run ]] || [[ "$input" =~ ^docker\ run$ ]]; then
    echo "docker_run"
    return 0
  fi

  # 本地文件
  if [[ -f "$input" ]]; then
    if [[ "$input" =~ \.ya?ml$ ]]; then
      echo "compose_file"
      return 0
    fi
  fi

  echo "unknown"
}

# 从 GitHub 项目提取信息
extract_from_github() {
  local github_url="$1"
  local api_url

  log_info "正在从 GitHub 项目提取信息: $github_url"

  local owner_repo
  owner_repo=$(echo "$github_url" | sed -E 's|https?://github.com/||; s|/$||; s|\.git$||')
  api_url="${GITHUB_API_BASE_URL%/}/${owner_repo}"

  # 获取项目信息
  local repo_info
  repo_info=$(curl -fsSL --connect-timeout 5 --max-time 20 "$api_url" 2>/dev/null || echo "{}")

  # 提取字段
  APP_NAME=$(echo "$repo_info" | jq -r '.name // empty')
  APP_KEY=$(normalize_app_key "$APP_NAME")
  DESCRIPTION=$(echo "$repo_info" | jq -r '.description // empty')
  GITHUB="$github_url"
  WEBSITE=$(echo "$repo_info" | jq -r '.homepage // empty')
  if [[ -z "$WEBSITE" ]]; then
    WEBSITE="$github_url"
  fi
  DEFAULT_BRANCH=$(echo "$repo_info" | jq -r '.default_branch // "main"')

  COMPOSE_CONTENT=$(discover_github_compose "$owner_repo" "$DEFAULT_BRANCH")
  if [[ -z "${COMPOSE_CONTENT:-}" ]]; then
    DOCKER_RUN_CONTENT=$(discover_github_docker_run "$owner_repo" "$DEFAULT_BRANCH")
  fi
  if [[ -z "${COMPOSE_CONTENT:-}" && -z "${DOCKER_RUN_CONTENT:-}" ]]; then
    log_error "未在 GitHub 项目中发现常见 docker-compose 文件或 README docker run 命令"
    exit 1
  fi

  log_info "应用名称: $APP_NAME"
  log_info "描述: $DESCRIPTION"
}

discover_github_compose() {
  local owner_repo="$1"
  local default_branch="$2"
  local branches=("$default_branch")
  local branch path url content
  local paths=(
    "docker-compose.yml"
    "docker-compose.yaml"
    "compose.yml"
    "compose.yaml"
    "deploy/docker-compose.yml"
    "deploy/docker-compose.yaml"
    "docker/docker-compose.yml"
    "docker/docker-compose.yaml"
  )

  if [[ "$default_branch" != "main" ]]; then
    branches+=("main")
  fi
  if [[ "$default_branch" != "master" ]]; then
    branches+=("master")
  fi

  for branch in "${branches[@]}"; do
    for path in "${paths[@]}"; do
      url="${GITHUB_RAW_BASE_URL%/}/${owner_repo}/${branch}/${path}"
      content=$(curl -fsSL --connect-timeout 5 --max-time 20 "$url" 2>/dev/null || true)
      if [[ -n "$content" ]] && echo "$content" | yq -e '.services' >/dev/null 2>&1; then
        log_info "发现 compose 文件: ${path} (${branch})" >&2
        printf '%s\n' "$content"
        return 0
      fi
    done
  done

  return 0
}

discover_github_docker_run() {
  local owner_repo="$1"
  local default_branch="$2"
  local branches=("$default_branch")
  local branch path url content line
  local paths=(
    "README.md"
    "README_en.md"
    "docs/README.md"
  )

  if [[ "$default_branch" != "main" ]]; then
    branches+=("main")
  fi
  if [[ "$default_branch" != "master" ]]; then
    branches+=("master")
  fi

  for branch in "${branches[@]}"; do
    for path in "${paths[@]}"; do
      url="${GITHUB_RAW_BASE_URL%/}/${owner_repo}/${branch}/${path}"
      content=$(curl -fsSL --connect-timeout 5 --max-time 20 "$url" 2>/dev/null || true)
      if [[ -z "$content" ]]; then
        continue
      fi
      line=$(printf '%s\n' "$content" | sed -n 's/^[[:space:]]*//; /docker run /{s/^`*//; s/`*$//; p; q;}')
      if [[ -n "$line" ]]; then
        log_info "发现 README docker run 命令: ${path} (${branch})" >&2
        printf '%s\n' "$line"
        return 0
      fi
    done
  done

  return 0
}

# 从 docker-compose 提取信息
extract_from_compose() {
  local compose_content="$1"

  log_info "正在解析 docker-compose 内容"

  # 提取服务名
  if [[ -n "$USER_SERVICE" ]]; then
    SERVICE_NAME="$USER_SERVICE"
    if ! echo "$compose_content" | yq -e ".services[\"${SERVICE_NAME}\"]" >/dev/null 2>&1; then
      log_error "compose 中不存在指定服务: $SERVICE_NAME"
      exit 1
    fi
  else
    SERVICE_NAME=$(echo "$compose_content" | yq -r '.services | keys | .[0]' 2>/dev/null || echo "")
  fi

  # 提取镜像
  local image
  image=$(echo "$compose_content" | yq -r ".services[\"${SERVICE_NAME}\"].image" 2>/dev/null || echo "")
  if [[ -z "$image" || "$image" == "null" ]]; then
    log_error "服务 ${SERVICE_NAME} 缺少 image,无法生成应用版本"
    exit 1
  fi
  parse_image_ref "$image"

  # 提取端口
  PORT_ENTRIES=()
  while IFS= read -r line; do
    [[ -z "$line" || "$line" == "null" ]] && continue
    PORT_ENTRIES+=("$line")
  done < <(echo "$compose_content" | yq -r ".services[\"${SERVICE_NAME}\"].ports[]" 2>/dev/null || true)

  if [[ ${#PORT_ENTRIES[@]} -eq 0 ]]; then
    PORT_ENTRIES=("8080")
  fi

  SERVICE_VOLUMES=()
  while IFS= read -r line; do
    [[ -z "$line" || "$line" == "null" ]] && continue
    SERVICE_VOLUMES+=("$line")
  done < <(echo "$compose_content" | yq -r ".services[\"${SERVICE_NAME}\"].volumes[]?" 2>/dev/null || true)

  SERVICE_ENV=()
  while IFS= read -r line; do
    [[ -z "$line" || "$line" == "null" ]] && continue
    SERVICE_ENV+=("$line")
  done < <(echo "$compose_content" | yq -r ".services[\"${SERVICE_NAME}\"].environment[]?" 2>/dev/null || true)

  SERVICE_ENV_FILES=()
  while IFS= read -r line; do
    [[ -z "$line" || "$line" == "null" ]] && continue
    SERVICE_ENV_FILES+=("$line")
  done < <(echo "$compose_content" | yq -r ".services[\"${SERVICE_NAME}\"].env_file[]?" 2>/dev/null || true)

  log_info "服务名: $SERVICE_NAME"
  log_info "镜像: $IMAGE_BASE:$TAG"
  log_info "端口数量: ${#PORT_ENTRIES[@]}"
}

# 从 docker run 命令提取信息
extract_from_docker_run() {
  local cmd="$1"

  log_info "正在解析 docker run 命令"

  local args=()
  while IFS= read -r line; do
    args+=("$line")
  done < <(python3 - "$cmd" <<'PY'
import shlex
import sys

for item in shlex.split(sys.argv[1]):
    print(item)
PY
)

  local i=0
  if [[ "${args[0]:-}" == "docker" && "${args[1]:-}" == "run" ]]; then
    i=2
  fi

  SERVICE_NAME="app"
  PORT_ENTRIES=()
  SERVICE_VOLUMES=()
  SERVICE_ENV=()
  SERVICE_ENV_FILES=()

  local image_ref=""
  while ((i < ${#args[@]})); do
    local arg="${args[$i]}"
    case "$arg" in
      --name=*)
        SERVICE_NAME="${arg#--name=}"
        ;;
      --name)
        ((i+=1))
        SERVICE_NAME="${args[$i]:-app}"
        ;;
      -p|--publish)
        ((i+=1))
        PORT_ENTRIES+=("${args[$i]:-}")
        ;;
      -p=*|--publish=*)
        PORT_ENTRIES+=("${arg#*=}")
        ;;
      -v|--volume)
        ((i+=1))
        SERVICE_VOLUMES+=("${args[$i]:-}")
        ;;
      -v=*|--volume=*)
        SERVICE_VOLUMES+=("${arg#*=}")
        ;;
      -e|--env)
        ((i+=1))
        SERVICE_ENV+=("${args[$i]:-}")
        ;;
      -e=*|--env=*)
        SERVICE_ENV+=("${arg#*=}")
        ;;
      --env-file)
        ((i+=1))
        SERVICE_ENV_FILES+=("${args[$i]:-}")
        ;;
      --env-file=*)
        SERVICE_ENV_FILES+=("${arg#--env-file=}")
        ;;
      --)
        ((i+=1))
        image_ref="${args[$i]:-}"
        break
        ;;
      -d|--detach|--rm|--init|-i|-t|-it|-ti|--privileged)
        ;;
      --restart|--network|--hostname|--user|--workdir|--entrypoint|--add-host|--dns)
        ((i+=1))
        ;;
      --restart=*|--network=*|--hostname=*|--user=*|--workdir=*|--entrypoint=*|--add-host=*|--dns=*)
        ;;
      -*)
        if [[ "$arg" != *=* && "${args[$((i + 1))]:-}" != -* && "${args[$((i + 1))]:-}" != "" ]]; then
          ((i+=1))
        fi
        ;;
      *)
        image_ref="$arg"
        break
        ;;
    esac
    ((i+=1))
  done

  if [[ -z "$image_ref" ]]; then
    log_error "未能从 docker run 命令中解析出镜像"
    exit 1
  fi

  parse_image_ref "$image_ref"

  if [[ ${#PORT_ENTRIES[@]} -eq 0 ]]; then
    PORT_ENTRIES=("8080")
  fi

  APP_NAME="$SERVICE_NAME"
  APP_KEY=$(normalize_app_key "$SERVICE_NAME")

  log_info "应用名称: $APP_NAME"
  log_info "镜像: $IMAGE_BASE:$TAG"
  log_info "端口数量: ${#PORT_ENTRIES[@]}"
}

# 生成 data.yml
generate_data_yml() {
  local output_file="$1"

  log_info "生成 data.yml: $output_file"

  cat > "$output_file" << EOF
name: ${APP_NAME:-MyApp}
tags:
    - 实用工具
    - 容器
title: ${APP_NAME:-MyApp} - 容器应用
description: ${DESCRIPTION:-自动生成的应用配置}
additionalProperties:
    key: ${APP_KEY:-myapp}
    name: ${APP_NAME:-MyApp}
    tags:
        - Tool
        - Container
    shortDescZh: ${DESCRIPTION:-自动生成的应用配置}
    shortDescEn: ${DESCRIPTION:-Auto-generated application configuration}
    description:
        en: ${DESCRIPTION:-Auto-generated application configuration}
        ja: ${DESCRIPTION:-Auto-generated application configuration}
        ms: ${DESCRIPTION:-Auto-generated application configuration}
        pt-br: ${DESCRIPTION:-Auto-generated application configuration}
        ru: ${DESCRIPTION:-Auto-generated application configuration}
        ko: ${DESCRIPTION:-Auto-generated application configuration}
        zh-Hant: ${DESCRIPTION:-Auto-generated application configuration}
        zh: ${DESCRIPTION:-自动生成的应用配置}
    type: website
    crossVersionUpdate: true
    limit: 0
    recommend: 50
    website: ${WEBSITE:-https://example.com}
    github: ${GITHUB:-https://github.com}
    document: ${GITHUB:-https://github.com}
    architectures:
      - amd64
      - arm64
EOF
}

# 生成 version/data.yml(参数定义)
generate_version_data_yml() {
  local output_file="$1"

  log_info "生成版本 data.yml: $output_file"

  cat > "$output_file" << EOF
additionalProperties:
  formFields:
EOF

  local i
  for ((i=0; i<${#CONTAINER_PORTS[@]}; i++)); do
    local envkey="${PORT_ENV_KEYS[$i]}"
    local default_port="${HOST_PORTS[$i]}"
    local labels
    labels=$(labels_for_envkey "$envkey")
    local label_en="${labels%%|*}"
    local label_zh="${labels##*|}"
    cat >> "$output_file" << EOF
    - default: ${default_port}
      edit: true
      envKey: ${envkey}
      labelEn: ${label_en}
      labelZh: ${label_zh}
      required: true
      rule: paramPort
      type: number
      label:
        en: ${label_en}
        zh: ${label_zh}
EOF
  done
}

# 生成 docker-compose.yml
generate_docker_compose() {
  local output_file="$1"
  local image_tag="$2"

  log_info "生成 docker-compose.yml: $output_file"

  cat > "$output_file" << EOF
services:
  ${SERVICE_NAME:-app}:
    container_name: \${CONTAINER_NAME}
    restart: always
    networks:
      - 1panel-network
    ports:
EOF

  local i
  for ((i=0; i<${#CONTAINER_PORTS[@]}; i++)); do
    cat >> "$output_file" << EOF
      - "\${${PORT_ENV_KEYS[$i]}}:${CONTAINER_PORTS[$i]}"
EOF
  done

  cat >> "$output_file" << EOF
    volumes:
EOF

  if ((${#SERVICE_VOLUMES[@]} > 0)); then
    local volume
    for volume in "${SERVICE_VOLUMES[@]}"; do
      cat >> "$output_file" << EOF
      - ${volume}
EOF
    done
  else
    cat >> "$output_file" << EOF
      - ./data/data:/app/data
EOF
  fi

  cat >> "$output_file" << EOF
    environment:
EOF

  if ((${#SERVICE_ENV[@]} > 0)); then
    local env
    for env in "${SERVICE_ENV[@]}"; do
      cat >> "$output_file" << EOF
      - ${env}
EOF
    done
  else
    cat >> "$output_file" << EOF
      - PUID=0
      - PGID=0
      - UMASK=022
EOF
  fi

  if ((${#SERVICE_ENV_FILES[@]} > 0)); then
    cat >> "$output_file" << EOF
    env_file:
EOF
    local env_file
    for env_file in "${SERVICE_ENV_FILES[@]}"; do
      cat >> "$output_file" << EOF
      - ${env_file}
EOF
    done
  fi

  cat >> "$output_file" << EOF
    image: ${IMAGE_BASE:-app}:${image_tag}
    labels:
      createdBy: "Apps"
networks:
  1panel-network:
    external: true
EOF
}

# 生成 README
generate_readme() {
  local output_dir="$1"

  log_info "生成 README 文件"

  cat > "${output_dir}/README.md" << EOF
# ${APP_NAME:-MyApp}

## 简介

${DESCRIPTION:-这是一个自动生成的应用配置。}

## 使用说明

1. 在 1Panel 应用商店中安装此应用
2. 配置相关参数
3. 启动应用

## 更多信息

- 官网: ${WEBSITE:-https://example.com}
- GitHub: ${GITHUB:-https://github.com}
- 文档: ${GITHUB:-https://github.com}
EOF

  cat > "${output_dir}/README_en.md" << EOF
# ${APP_NAME:-MyApp}

## Introduction

${DESCRIPTION:-This is an auto-generated application configuration.}

## Usage

1. Install this app from 1Panel App Store
2. Configure parameters
3. Start the application

## More Information

- Website: ${WEBSITE:-https://example.com}
- GitHub: ${GITHUB:-https://github.com}
- Documentation: ${GITHUB:-https://github.com}
EOF
}

# 下载图标
download_icon() {
  local app_name="$1"
  local output_file="$2"
  local args=(--mode "$ICON_MODE" --cache-dir "$ICON_CACHE_DIR")

  if [[ -n "$ICON_URL" ]]; then
    args+=(--url "$ICON_URL")
  fi

  if bash "${SCRIPT_DIR}/download-icon.sh" "${args[@]}" "$app_name" "$output_file"; then
    return 0
  fi

  if [[ "$ICON_MODE" == "required" ]]; then
    log_error "图标为 required 模式,但未能获取图标"
    return 1
  fi

  log_warn "未找到图标,请手动补充 logo.png"
  return 0
}

# 主函数
main() {
  parse_args "$@"

  if [[ "$CHECK_DEPS_ONLY" == "true" ]]; then
    check_dependencies
    exit $?
  fi
  check_dependencies

  local input="${POSITIONAL[0]:-}"
  local input_type

  # 参数检查
  if [[ -z "$input" ]] || [[ "$input" == "-h" ]] || [[ "$input" == "--help" ]]; then
    print_help
    exit 0
  fi

  log_info "开始处理: $input"

  # 检测输入类型
  input_type=$(detect_input_type "$input")
  log_info "检测到输入类型: $input_type"

  # 根据类型提取信息
  case "$input_type" in
    github)
      extract_from_github "$input"
      if [[ -n "$COMPOSE_CONTENT" ]]; then
        extract_from_compose "$COMPOSE_CONTENT"
      elif [[ -n "$DOCKER_RUN_CONTENT" ]]; then
        extract_from_docker_run "$DOCKER_RUN_CONTENT"
      fi
      ;;
    compose_url)
      COMPOSE_CONTENT=$(curl -fsSL --connect-timeout 5 --max-time 20 "$input" 2>/dev/null)
      extract_from_compose "$COMPOSE_CONTENT"
      APP_NAME="$SERVICE_NAME"
      APP_KEY=$(normalize_app_key "$SERVICE_NAME")
      ;;
    compose_file)
      COMPOSE_CONTENT=$(cat "$input")
      extract_from_compose "$COMPOSE_CONTENT"
      APP_NAME="$SERVICE_NAME"
      APP_KEY=$(normalize_app_key "$SERVICE_NAME")
      ;;
    docker_run)
      extract_from_docker_run "$input"
      ;;
    *)
      log_error "无法识别的输入类型: $input"
      exit 1
      ;;
  esac

  if [[ -n "$USER_APP_NAME" ]]; then
    APP_NAME="$USER_APP_NAME"
  fi
  if [[ -n "$USER_APP_KEY" ]]; then
    APP_KEY=$(normalize_app_key "$USER_APP_KEY")
  fi
  if [[ -z "${APP_KEY:-}" ]]; then
    APP_KEY=$(normalize_app_key "${APP_NAME:-app}")
  fi

  # 生成端口映射数组
  HOST_PORTS=()
  CONTAINER_PORTS=()
  PORT_ENV_KEYS=()
  PORT_ENV_KEYS_USED=()
  local i
  for ((i=0; i<${#PORT_ENTRIES[@]}; i++)); do
    local mapping
    mapping=$(parse_port_entry "${PORT_ENTRIES[$i]}")
    local host_port="${mapping%%:*}"
    local container_port="${mapping##*:}"
    HOST_PORTS+=("$host_port")
    CONTAINER_PORTS+=("$container_port")
    local envkey
    envkey=$(map_port_envkey "$container_port" "$i")
    # 保证 envKey 唯一
    if [[ " ${PORT_ENV_KEYS_USED[*]} " == *" ${envkey} "* ]]; then
      envkey="${envkey}_${i}"
    fi
    PORT_ENV_KEYS+=("$envkey")
    PORT_ENV_KEYS_USED+=("$envkey")
  done

  # 获取最新版本号
  if [[ -n "$USER_VERSION" ]]; then
    VERSION_TAG="$USER_VERSION"
  else
    VERSION_TAG=$(get_latest_tag)
    if [[ -z "$VERSION_TAG" ]]; then
      VERSION_TAG="$TAG"
    fi
  fi
  if [[ -z "$VERSION_TAG" ]]; then
    VERSION_TAG="latest"
  fi

  if [[ "$DRY_RUN" == "true" ]]; then
    echo "app_key=${APP_KEY}"
    echo "app_name=${APP_NAME:-}"
    echo "service=${SERVICE_NAME:-}"
    echo "image=${IMAGE_BASE:-}:${VERSION_TAG}"
    echo "output=${OUTPUT_BASE}/${APP_KEY}"
    exit 0
  fi

  # 创建输出目录(latest + 具体版本)
  local output_dir_latest="${OUTPUT_BASE}/${APP_KEY}/latest"
  if [[ -e "${OUTPUT_BASE}/${APP_KEY}" && "$FORCE" != "true" ]]; then
    log_error "输出目录已存在: ${OUTPUT_BASE}/${APP_KEY}(如需覆盖请使用 --force)"
    exit 1
  fi
  mkdir -p "$output_dir_latest"

  local output_dir_version=""
  if [[ "$VERSION_TAG" != "latest" ]]; then
    output_dir_version="${OUTPUT_BASE}/${APP_KEY}/${VERSION_TAG}"
    mkdir -p "$output_dir_version"
  else
    log_warn "未能获取具体版本号,version 目录将使用 latest(请手动修正)"
  fi

  log_info "输出目录: $output_dir_latest"
  if [[ -n "$output_dir_version" ]]; then
    log_info "输出目录: $output_dir_version"
  fi

  # 生成 latest 版本文件
  generate_version_data_yml "${output_dir_latest}/data.yml"
  generate_docker_compose "${output_dir_latest}/docker-compose.yml" "latest"

  # 生成具体版本文件
  if [[ -n "$output_dir_version" ]]; then
    generate_version_data_yml "${output_dir_version}/data.yml"
    generate_docker_compose "${output_dir_version}/docker-compose.yml" "$VERSION_TAG"
  fi

  generate_readme "${OUTPUT_BASE}/${APP_KEY}"
  download_icon "$APP_NAME" "${OUTPUT_BASE}/${APP_KEY}/logo.png"

  # 生成上级目录的 data.yml
  generate_data_yml "${OUTPUT_BASE}/${APP_KEY}/data.yml"
  # 输出结果
  echo ""
  log_info "${GREEN}✓ 生成完成!${NC}"
  echo ""
  echo "目录结构:"
  tree "${OUTPUT_BASE}/${APP_KEY}" 2>/dev/null || find "${OUTPUT_BASE}/${APP_KEY}" -type f
  echo ""
  log_info "下一步:"
  echo "  1. 检查生成的配置文件"
  echo "  2. 补充完善应用描述和标签"
  echo "  3. 替换 logo.png 为合适的应用图标"
  echo "  4. 测试 docker-compose.yml"
  echo "  5. 提交到应用商店仓库"
}

# 执行主函数
main "$@"
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall