英文 |简体中文

1panel-appstore-skills 是创建 1Panel 应用商店应用安装包的技能。

它专为已经支持基于 Docker 部署的应用程序设计。它可以从官方仓库、官方文档、Docker 镜像、docker-compose.yml或已准备好的中间规范中生成遵循 1Panel App Store 应用格式的包。

何时使用？

适合：

• 将 Docker 化应用打包为 1Panel 应用商店应用。
• 将官方仓库或官方文档中的 Docker / Docker Compose 安装方法转换为 1Panel 应用包。
• 将现有的docker-compose.yml组织到1Panel应用商店目录结构中。
• 从预备好的应用规范生成 data.yml、[docker-compose.yml、README 文件和数据目录。

不适合：

• 没有可靠基于 Docker 的安装方法的应用程序。
• 需要发明应用部署架构、镜像、端口、数据目录或环境变量的场景。
• 发布到远程应用商店仓库。该技能仅生成应用包内容。

支持的输入

• 应用程序名称或官方仓库URL。

1Panel Appstore Skills

English | 简体中文

1panel-appstore-skills is a skill for creating 1Panel App Store app installation packages.

It is designed for applications that already support Docker-based deployment. It can generate a package that follows the 1Panel App Store app format from official repositories, official documentation, Docker images, docker-compose.yml, or a prepared intermediate spec.

When to Use

Suitable for:

• Packaging a Dockerized application as a 1Panel App Store app.
• Converting Docker / Docker Compose installation methods from official repositories or official documentation into a 1Panel app package.
• Organizing an existing docker-compose.yml into the 1Panel App Store directory structure.
• Generating data.yml, docker-compose.yml, README files, and data directories from a prepared app spec.

Not suitable for:

• Applications without a reliable Docker-based installation method.
• Scenarios that require inventing the application deployment architecture, image, ports, data directories, or environment variables.
• Publishing to a remote app store repository. This skill only generates app package content.

Supported Inputs

• Application name or official repository URL.
• Docker image and required deployment parameters.
• Official docker-compose.yml / compose.yml file.
• Intermediate JSON spec that follows references/appspec.md.

Output

The generated result is a 1Panel App Store app package directory. The default structure is:

apps//
  logo.png
  README.md
  README_en.md
  data.yml
  /
    data.yml
    docker-compose.yml
    data/
    scripts/        # Optional: generated init.sh and manually added lifecycle scripts

Based on the input and official sources, it handles:

• Basic app information, version, type, tags, website, documentation, and repository URL.
• Main service and dependent service images, ports, environment variables, data volumes, and startup dependencies.
• data.yml fields, form fields, and multilingual descriptions required by 1Panel.
• Chinese README; English README when the official application or documentation supports English.
• Persistent directory permission initialization script, generated only when official sources prove it is required.

Project Layout

1panel-appstore-skills/
  README.md
  README.zh-CN.md
  SKILL.md
  assets/
  references/
  scripts/

Core files:

• SKILL.md: defines trigger scenarios, workflow, and packaging rules.
• assets/sample-appspec.json: intermediate spec example, useful for understanding the generation flow.
• references/appstore-format.md: 1Panel app package directory and field rules.
• references/appspec.md: intermediate spec fields and generation boundaries.
• references/review-checklist.md: package review and local testing checklist.