docs: 添加 1Panel 应用描述的使用方式

Author: rdc-dev-liucl

deploy/1panel/README.md

@@ -0,0 +1,43 @@
+# 1Panel 部署 OneBots
+
+本目录提供与 [1Panel 应用商店](https://github.com/1Panel-dev/appstore) 相同布局的 **`onebots`** 应用描述，便于一键安装或向官方商店提交 PR。
+
+## 目录说明
+
+```
+onebots/
+├── data.yml              # 应用元数据（名称、标签、架构等）
+├── logo.png              # 列表图标
+├── README.md             # 应用商店内说明
+└── 0.5.0/                # 与镜像版本对应的目录（发新版时复制并改镜像标签）
+    ├── data.yml          # 安装表单（端口等）
+    └── docker-compose.yml
+```
+
+发新版时：新增目录 `x.y.z/`，将 `docker-compose.yml` 中镜像改为 `ghcr.io/<owner>/onebots:x.y.z`（或与 CI 实际打的 tag 一致，例如 `master`）。
+
+## 在 1Panel 中使用
+
+### 方式 A：本地 Compose（最快）
+
+1. 打开 **容器 → Compose → 创建编排**
+2. 将 `onebots/0.5.0/docker-compose.yml` 内容粘贴进编辑器（或选择本仓库目录下的该文件）
+3. 在 1Panel 中设置 **端口**（映射到容器 **6727**）与 **数据卷**（挂载到容器 **`/data`**，用于 `config.yaml`、数据库等）
+4. 网络选用 **`1panel-network`**（与面板其他应用一致；若不存在可改为 `bridge` 并去掉 `external: true`）
+
+镜像默认：`ghcr.io/lc-cn/onebots:0.5.0`。若该 tag 尚未推送，可改为 `ghcr.io/lc-cn/onebots:master`（以你仓库 CI 实际产物为准）。
+
+### 方式 B：第三方应用商店源
+
+1. 将本仓库（或仅 `deploy/1panel/`）托管为 Git 仓库
+2. 在 1Panel **应用商店 → 设置** 中添加该源（需符合 1Panel 对应用源目录结构的要求）
+3. 在商店中安装 **OneBots**
+
+### 方式 C：合并进官方 appstore
+
+向 [1Panel-dev/appstore](https://github.com/1Panel-dev/appstore) 提交 PR，将 `onebots/` 复制到其 `apps/onebots/`，并遵循官方贡献说明（镜像需公开可拉取、维护活跃度等）。
+
+## 说明
+
+- 首次启动容器会在 **`/data`** 下自动生成 **`config.yaml`**（由镜像 entrypoint 从示例复制），请在面板或 SSH 中编辑后重启容器。
+- 默认 CMD 已注册多类适配器与协议；可按需改为挂载自定义命令或自建镜像。

deploy/1panel/onebots/0.5.0/data.yml

@@ -0,0 +1,21 @@
+additionalProperties:
+  formFields:
+    - default: 6727
+      edit: true
+      envKey: PANEL_APP_PORT_HTTP
+      labelEn: Gateway HTTP port
+      labelZh: 网关 HTTP 端口
+      label:
+        en: Gateway HTTP port
+        zh: 网关 HTTP 端口
+        es-es: Puerto HTTP del gateway
+        zh-Hant: 閘道 HTTP 埠
+        ja: ゲートウェイ HTTP ポート
+        ko: 게이트웨이 HTTP 포트
+        ms: Port HTTP gerbang
+        pt-br: Porta HTTP do gateway
+        ru: HTTP-порт шлюза
+        tr: Ağ geçidi HTTP bağlantı noktası
+      required: true
+      rule: paramPort
+      type: number

deploy/1panel/onebots/0.5.0/docker-compose.yml

@@ -0,0 +1,18 @@
+# OneBots — 与根目录 Dockerfile / docker-entrypoint.sh 一致：配置与数据在 /data
+services:
+  onebots:
+    image: ghcr.io/lc-cn/onebots:0.5.0
+    container_name: ${CONTAINER_NAME}
+    restart: always
+    networks:
+      - 1panel-network
+    ports:
+      - "${PANEL_APP_PORT_HTTP}:6727"
+    volumes:
+      - ./data:/data
+    labels:
+      createdBy: "Apps"
+
+networks:
+  1panel-network:
+    external: true

deploy/1panel/onebots/README.md

@@ -0,0 +1,17 @@
+# OneBots
+
+[OneBots](https://github.com/lc-cn/onebots) 是 **TypeScript / Node.js** 的多平台、多协议即时通讯机器人框架，可作为网关将 QQ、微信、Discord、Telegram、飞书、企业微信等接入 **OneBot v11/v12、Satori、Milky** 等协议。
+
+## 使用说明
+
+- **数据目录**：请将宿主机目录挂载到容器 **`/data`**，内含 `config.yaml`、SQLite 数据库等。
+- **首次启动**：若 `/data/config.yaml` 不存在，镜像会自动从内置示例复制一份，请按需修改（账号、协议端口、Token 等）后重启。
+- **Web 管理**：默认监听 **`6727`**，安装时在面板中映射该端口即可访问（具体路径见你所启用的协议配置）。
+
+## 镜像
+
+默认使用 **`ghcr.io/lc-cn/onebots:<版本>`**。若需跟踪最新构建，可将 compose 中镜像 tag 改为 CI 实际推送的分支 tag（如 `master`）。
+
+## 文档
+
+仓库内 [Docker 说明](../../../docs/src/guide/docker.md) 与 [快速开始](https://github.com/lc-cn/onebots)。

deploy/1panel/onebots/README_en.md

@@ -0,0 +1,17 @@
+# OneBots
+
+[OneBots](https://github.com/lc-cn/onebots) is a **TypeScript / Node.js** framework and gateway for multi-platform, multi-protocol instant-messaging bots. It bridges QQ, WeChat, Discord, Telegram, Feishu, WeCom and more to **OneBot v11/v12, Satori, Milky**, etc.
+
+## Usage
+
+- **Data directory**: Mount a host path to **`/data`** in the container (`config.yaml`, SQLite, etc.).
+- **First run**: If `/data/config.yaml` is missing, the image copies a sample file; edit it and restart.
+- **Web UI**: Default port **`6727`** — map it in 1Panel (exact paths depend on enabled protocols).
+
+## Image
+
+Default: **`ghcr.io/lc-cn/onebots:<version>`**. Use your CI tag (e.g. `master`) if a semver tag is not published yet.
+
+## Docs
+
+[Docker guide](../../../docs/src/guide/docker.md) in this repository.

deploy/1panel/onebots/data.yml

@@ -0,0 +1,34 @@
+name: onebots
+tags:
+  - 开发工具
+title: OneBots 多平台机器人网关
+description: 多平台、多协议（OneBot / Satori / Milky 等）即时通讯机器人应用框架与网关
+additionalProperties:
+  key: onebots
+  name: OneBots
+  tags:
+    - DevTools
+  shortDescZh: 多平台多协议 IM 机器人网关
+  shortDescEn: Multi-platform multi-protocol IM bot gateway
+  description:
+    en: OneBots connects QQ, WeChat, Discord, Telegram, Feishu and more to OneBot, Satori, Milky and other protocols.
+    zh: OneBots 将 QQ、微信、Discord、Telegram、飞书等平台接入 OneBot、Satori、Milky 等协议。
+    ja: 複数のIMプラットフォームをOneBot/Satori等のプロトコルに接続するゲートウェイです。
+    ko: 여러 IM 플랫폼을 OneBot, Satori 등 프로토콜에 연결하는 게이트웨이입니다.
+    zh-Hant: 多平台多協定 IM 機器人閘道。
+    es-es: Puerta de enlace multiplataforma para bots de mensajería instantánea.
+    ms: Gerbang bot IM pelbagai platform dan protokol.
+    pt-br: Gateway de bots de mensagens multiplataforma e multiprotocolo.
+    ru: Шлюз мультиплатформенных ботов для мгновенных сообщений.
+    tr: Çoklu platform ve protokol için anlık mesaj botu ağ geçidi.
+  type: website
+  crossVersionUpdate: true
+  limit: 0
+  recommend: 0
+  batchInstallSupport: true
+  website: https://github.com/lc-cn/onebots
+  github: https://github.com/lc-cn/onebots
+  document: https://github.com/lc-cn/onebots#readme
+  architectures:
+    - amd64
+    - arm64

deploy/1panel/onebots/logo.png

@@ -63,6 +63,10 @@ docker logs -f onebots
 docker stop onebots && docker rm onebots
 ```
 
+### 方式三：1Panel
+
+仓库内提供与 [1Panel 应用商店](https://github.com/1Panel-dev/appstore) 相同布局的应用描述（`data.yml`、`docker-compose.yml`、表单端口等），便于在面板中一键编排或向官方应用库投稿。说明见 **[deploy/1panel](../../../deploy/1panel/README.md)**。
+
 ## 使用 GitHub 构建的镜像
 
 若仓库已配置 [GitHub Actions 构建 Docker 镜像](https://github.com/lc-cn/onebots/actions)，可直接拉取 GHCR 镜像，无需本地构建：