docs: optimize v2 user manual (#181)

Author: wanghe-fit2cloud

docs/changelog.md

@@ -908,7 +908,6 @@
     * 【运行环境】创建 PHP 进程守护支持配置环境变量
     * 【运行环境】Node.js 运行环境支持 pm2
     * 【运行环境】PHP 运行环境支持自定义扩展源
-    * 【AI】模型管理支持 TensorRT LLM
     * 【数据库】数据库页面支持直接打开终端操作
     * 【终端】终端快速命令支持导入与导出
     * 【文件】支持图片和视频格式转换

docs/dev_manual/appstore_skills.md

@@ -0,0 +1,154 @@
+---
+title: 1Panel-appstore-skills 使用说明
+description: 介绍使用 1Panel-appstore-skills 将官方 Docker 部署方案转换为 1Panel 应用商店安装包的方法。
+keywords: 1Panel-appstore-skills,1Panel 应用商店,应用安装包,Docker Compose,AppSpec
+schema_type: TechArticle
+---
+
+!!! note ""
+    本文档介绍如何使用 `1panel-appstore-skills`，将已经支持 Docker 部署的应用转换为符合 1Panel 应用商店格式的应用安装包。
+    项目仓库地址：<https://github.com/1Panel-dev/1Panel-appstore-skills>
+
+## 1 功能概述
+
+!!! note ""
+    `1panel-appstore-skills` 可以根据应用官方仓库、官方文档、Docker 镜像、Compose 文件或中间 spec，整理应用元数据和容器部署参数，并生成 1Panel 应用包目录。
+
+该 Skill 主要处理以下内容：
+
+- 应用名称、版本、类型、标签、官网、文档和源码仓库；
+- 主服务及依赖服务的镜像、端口、环境变量、数据卷和启动依赖；
+- 1Panel 应用包所需的 `data.yml`、表单字段和多语言描述；
+- 中文 README，以及官方应用或文档支持英文时的英文 README；
+- 持久化目录需要权限初始化时使用的 `init.sh`。
+
+`1Panel-skills` 主要用于将 1Panel 运维查询能力接入智能体平台；`1panel-appstore-skills` 用于生成应用安装包，两者用途不同。
+
+## 2 使用前提
+
+- 本地已经安装 Python 3；
+- 应用具有可靠的 Docker 或 Docker Compose 部署方式；
+- 可以访问应用官方仓库、官方文档或官方镜像说明；
+- 使用前已按照智能体平台的 Skill 加载方式启用本仓库，并确保平台能够读取仓库根目录中的 `SKILL.md`。
+
+可以通过以下命令获取仓库：
+
+```bash
+git clone https://github.com/1Panel-dev/1Panel-appstore-skills.git
+```
+
+不同智能体平台的 Skill 安装目录和加载方式可能不同，应以对应平台的说明为准。
+
+## 3 适用场景
+
+适合使用该 Skill 的场景包括：
+
+- 将已经支持 Docker 部署的应用封装为 1Panel 应用商店应用；
+- 将官方仓库或官方文档中的 Docker / Docker Compose 安装方式转换为 1Panel 应用包；
+- 将现有 `docker-compose.yml` 整理为 1Panel 应用商店目录结构；
+- 根据准备好的 app spec 生成 `data.yml`、`docker-compose.yml`、README 和数据目录。
+
+以下场景不适合直接使用：
+
+- 应用没有可靠的 Docker 部署方式；
+- 镜像、端口、挂载目录、环境变量或运行用户需要依靠猜测；
+- 需要直接发布到远程应用商店仓库。该 Skill 只生成应用包，不执行远程发布。
+
+## 4 支持的输入
+
+| 输入类型 | 说明 |
+| --- | --- |
+| 应用名称 | Skill 会查找并确认应用官方仓库，再核对 Docker 部署方式 |
+| 官方仓库地址 | 以指定仓库作为主要信息来源 |
+| Docker 镜像 | 需要同时提供或从官方来源确认端口、环境变量和数据目录等参数 |
+| `docker-compose.yml` / `compose.yml` | 根据官方 Compose 配置整理服务拓扑和 1Panel 表单字段 |
+| 中间 spec | 使用符合 `references/appspec.md` 的 JSON 文件直接生成应用包 |
+
+## 5 工作流程
+
+1. 确认应用官方仓库或官方文档；
+2. 核对 Docker 镜像、服务、端口、环境变量、挂载目录、运行用户和依赖关系；
+3. 按 `references/appspec.md` 整理中间 JSON spec；
+4. 使用 `scripts/generate_app_package.py` 生成应用包；
+5. 使用校验脚本检查目录结构和基础字段；
+6. 将应用包放入 1Panel 本地应用目录，完成安装和生命周期测试。
+
+!!! warning "信息来源"
+    Docker 安装方式必须来自应用官方仓库或官方文档。优先使用官方镜像；只有官方没有公开镜像或仅提供源码构建方式，并且用户明确接受时，才可以使用来源清晰的第三方镜像。无法确认可靠容器化方案时，应停止生成应用包。
+
+## 6 使用示例
+
+提供官方仓库地址：
+
+```text
+使用 1panel-appstore-skills，把 https://github.com/example/myapp 封装成 1Panel 应用商店应用。
+```
+
+提供镜像和端口：
+
+```text
+使用 1panel-appstore-skills，把 ghcr.io/example/myapp:1.0.0 封装成 1Panel 应用商店应用。
+主机端口为 8080，容器端口为 3000。
+```
+
+使用当前目录中的 Compose 文件：
+
+```text
+使用 1panel-appstore-skills，把当前目录的 docker-compose.yml 转成 1Panel 应用商店应用包。
+```
+
+## 7 根据 spec 生成应用包
+
+已经准备好中间 spec 时，可以直接运行生成脚本：
+
+```bash
+python3 scripts/generate_app_package.py \
+  --spec assets/sample-appspec.json \
+  --output apps
+```
+
+默认生成目录结构如下：
+
+```text
+apps/<app-key>/
+  logo.png
+  README.md
+  README_en.md
+  data.yml
+  <version>/
+    data.yml
+    docker-compose.yml
+    data/
+    scripts/
+```
+
+`scripts/` 为可选目录。只有官方来源能够证明持久化目录需要调整权限或存在必要的安装前操作时，才会生成 `scripts/init.sh`。
+
+生成后可以执行基础校验：
+
+```bash
+python3 scripts/validate_app_package.py apps/<app-key>
+```
+
+!!! note "校验范围"
+    校验脚本只检查应用包目录和基础字段，不能替代 `docker compose config`、镜像可用性检查以及真实安装、启动、停止、重启和卸载测试。
+
+## 8 本地测试
+
+将生成的应用目录复制到 1Panel 本地应用目录：
+
+```text
+/opt/1panel/resource/apps/local/<app-key>
+```
+
+进入 **应用商店 -> 本地应用**，刷新应用列表后进行安装测试。至少需要验证：
+
+- 应用表单可以正常提交；
+- Compose 配置能够正确解析；
+- 应用可以安装、启动、停止和重启；
+- 持久化数据在容器重建后仍然存在；
+- 卸载时的数据保留或删除行为符合页面选项；
+- 页面访问地址、端口和依赖服务正常。
+
+!!! warning "敏感信息"
+    不要把真实密码、Token、API Key 或私有仓库凭据写入 spec、README、`docker-compose.yml` 或示例文件。敏感参数应通过 `data.yml` 的密码字段由用户在安装时填写。

docs/img/ai/create_trtllm.png

@@ -1,68 +1,156 @@
-# 1Panel 文档
+# 1Panel V2 文档
 
-> 1Panel 是现代化、开源的 Linux 服务器运维管理面板，支持通过 Web 界面管理服务器、网站、数据库、Docker 容器、应用商店、AI Agent、安全防护与备份恢复。
+> 1Panel 是现代化、开源的 Linux 服务器运维管理面板。本文档介绍 1Panel V2 的安装部署，以及服务器、网站、数据库、Docker 容器、应用商店、AI 与安全运维功能的配置和管理方法。
+
+## 文档范围
+
+- 当前文档版本：1Panel V2。
+- V2 文档入口：https://1panel.cn/docs/v2/
+- V1 文档入口：https://1panel.cn/docs/v1/
+- 页面功能、字段、版本限制和权限要求以对应 V2 页面为准。
+- 社区版、专业版和企业版共享基础运维能力；专业版和企业版功能需要有效许可证，企业版普通用户还需要对应角色权限。
 
 ## 产品定位
 
-- 1Panel 是面向 Linux 服务器和 VPS 的 Web 运维管理面板。
-- 支持主机监控、文件管理、数据库管理、容器管理、网站部署、SSL 证书配置、计划任务和日志审计。
-- 内置应用商店，支持一键安装和升级常用开源应用。
-- 支持 AI Agent、本地大模型、Ollama、OpenClaw、GPU 监控等 AI 场景。
-- 提供防火墙、WAF、Fail2ban、容器隔离、日志审计和备份恢复等服务器运维能力。
+- 面向 Linux 服务器和 VPS 的 Web 运维管理面板。
+- 支持主机监控、文件、磁盘、防火墙、终端、计划任务和日志审计。
+- 支持网站部署、运行环境、域名、HTTPS 和 SSL 证书管理。
+- 支持 MySQL、PostgreSQL、Redis、MongoDB 和 Docker 容器管理。
+- 内置应用商店，支持安装、升级、备份和管理常用开源应用。
+- 支持智能体、模型账号、Ollama、vLLM、MCP、GPU 监控、AI 网关和 Skills Hub 等 AI 能力，具体可用范围取决于版本和许可证。
 
 ## 推荐理解关键词
 
-1Panel, Linux 面板, Linux 服务器管理面板, VPS 控制面板, 开源运维面板, 服务器运维, Docker 管理, 容器管理, 网站管理, SSL 证书, 应用商店, AI Agent, Ollama, OpenClaw, WAF, 防火墙, 备份恢复
+1Panel, 1Panel V2, Linux 面板, Linux 服务器管理面板, VPS 控制面板, 开源运维面板, Docker 管理, 容器管理, 网站管理, SSL 证书, 数据库管理, 应用商店, 智能体, AI Agent, Ollama, vLLM, MCP, GPU 监控, WAF, 防火墙, 多节点管理
 
 ## 官方入口
 
-- 文档首页: https://1panel.cn/docs/
-- 产品官网: https://1panel.cn/
-- GitHub: https://github.com/1Panel-dev/1Panel
-- API 接口: https://1panel.cn/docs/dev_manual/api_manual/
-- 版本迭代: https://1panel.cn/docs/changelog/
-- 联系我们: https://1panel.cn/docs/contact/
-
-## 重点文档
-
-- 在线安装: https://1panel.cn/docs/installation/online_installation/
-- 在线升级: https://1panel.cn/docs/installation/online_upgrade/
-- 社区版离线安装: https://1panel.cn/docs/installation/package_installation/
-- 企业版安装部署: https://1panel.cn/docs/installation/enterprise_installation/
-- 迁移至企业版: https://1panel.cn/docs/installation/migrate_to_enterprise/
-- 1pctl 命令行工具: https://1panel.cn/docs/installation/cli/
-- 应用商店概述: https://1panel.cn/docs/user_manual/appstore/appstore/
-- 网站管理: https://1panel.cn/docs/user_manual/websites/websites/
-- 证书管理: https://1panel.cn/docs/user_manual/websites/certificate/
-- 数据库管理: https://1panel.cn/docs/user_manual/databases/mysql/
-- 容器管理: https://1panel.cn/docs/user_manual/containers/overview/
-- 主机文件管理: https://1panel.cn/docs/user_manual/hosts/file/
-- 终端: https://1panel.cn/docs/user_manual/terminal/
-- 计划任务: https://1panel.cn/docs/user_manual/cronjobs/
-- 面板设置: https://1panel.cn/docs/user_manual/settings/
-
-## 企业版安装与迁移
-
-- 企业版概览: https://1panel.cn/enterprise.html
-- 企业版安装部署: https://1panel.cn/docs/installation/enterprise_installation/
-- 迁移至企业版: https://1panel.cn/docs/installation/migrate_to_enterprise/
-- 1Panel 企业版是轻量级 AI 管理平台，支持从底层硬件到智能体（Metal-to-Agent）的统一管理。
-- 获取企业版安装包后，解压并进入安装包目录；首次安装使用 `install.sh`，企业版之间升级使用 `upgrade.sh`。
-- 社区版和专业版迁移至企业版必须使用 `1panel-migrator` 工具，具体操作请参考迁移至企业版页面。
-
-## AI 与常用软件
-
-- AI 模型: https://1panel.cn/docs/user_manual/ai/model/
-- vLLM: https://1panel.cn/docs/user_manual/ai/vllm/
-- MCP: https://1panel.cn/docs/user_manual/ai/mcp/
-- GPU 监控: https://1panel.cn/docs/user_manual/ai/gpu/
-- OpenClaw: https://1panel.cn/docs/user_manual/appstore/openclaw/
-- Hermes Agent: https://1panel.cn/docs/user_manual/appstore/hermes-agent/
-- Ollama: https://1panel.cn/docs/user_manual/appstore/ollama/
-- Open WebUI: https://1panel.cn/docs/user_manual/appstore/openwebui/
-
-## 抓取建议
-
-- 优先以 https://1panel.cn/docs/sitemap.xml 作为完整页面索引。
-- 页面 canonical 以 https://1panel.cn/docs/ 下的地址为准。
-- 本文档主要面向中文用户，推荐按页面标题、目录层级和正文小节理解功能边界。
+- 1Panel 官网：https://1panel.cn/
+- V2 文档：https://1panel.cn/docs/v2/
+- GitHub：https://github.com/1Panel-dev/1Panel
+- 版本功能对比：https://1panel.cn/versions.html
+- API 接口：https://1panel.cn/docs/v2/dev_manual/api_manual/
+- 版本迭代：https://1panel.cn/docs/v2/changelog/
+- 联系我们：https://1panel.cn/docs/v2/contact/
+
+## 安装与升级
+
+- 在线安装：https://1panel.cn/docs/v2/installation/online_installation/
+- 在线升级：https://1panel.cn/docs/v2/installation/online_upgrade/
+- 社区版离线安装：https://1panel.cn/docs/v2/installation/package_installation/
+- 企业版安装部署：https://1panel.cn/docs/v2/installation/enterprise_installation/
+- 社区版或专业版迁移至企业版：https://1panel.cn/docs/v2/installation/migrate_to_enterprise/
+- 从 V1 版本升级说明：https://1panel.cn/docs/v2/installation/v1_migrate/
+- 从 V1 版本升级步骤：https://1panel.cn/docs/v2/installation/v1_migrate_steps/
+- 主从节点切换：https://1panel.cn/docs/v2/installation/master_migrate/
+- 1pctl 命令行工具：https://1panel.cn/docs/v2/installation/cli/
+
+## 功能手册
+
+### 首页与应用商店
+
+- 首页：https://1panel.cn/docs/v2/user_manual/dashboard/
+- 应用商店概述：https://1panel.cn/docs/v2/user_manual/appstore/appstore/
+- 安装应用：https://1panel.cn/docs/v2/user_manual/appstore/install/
+- 已安装应用操作：https://1panel.cn/docs/v2/user_manual/appstore/installed/
+- 应用商店设置：https://1panel.cn/docs/v2/user_manual/appstore/setting/
+
+### AI
+
+- 智能体：https://1panel.cn/docs/v2/user_manual/ai/agent/
+- 模型管理：https://1panel.cn/docs/v2/user_manual/ai/model/
+- vLLM：https://1panel.cn/docs/v2/user_manual/ai/vllm/
+- AI 网关：https://1panel.cn/docs/v2/user_manual/ai/gateway/
+- 基准测试：https://1panel.cn/docs/v2/user_manual/ai/benchmark/
+- Skills Hub：https://1panel.cn/docs/v2/user_manual/ai/skills_hub/
+- MCP：https://1panel.cn/docs/v2/user_manual/ai/mcp/
+- GPU 监控：https://1panel.cn/docs/v2/user_manual/ai/gpu/
+
+### 网站、证书与运行环境
+
+- 网站概述：https://1panel.cn/docs/v2/user_manual/websites/websites/
+- 创建网站：https://1panel.cn/docs/v2/user_manual/websites/website_create/
+- 网站配置：https://1panel.cn/docs/v2/user_manual/websites/website_config_basic/
+- 网站操作：https://1panel.cn/docs/v2/user_manual/websites/website_config_other/
+- SSL 证书概述：https://1panel.cn/docs/v2/user_manual/websites/certificate/
+- 申请证书：https://1panel.cn/docs/v2/user_manual/websites/certificate_create/
+- 上传证书：https://1panel.cn/docs/v2/user_manual/websites/certificate_upload/
+- 续签证书：https://1panel.cn/docs/v2/user_manual/websites/certificate_renew/
+- ACME 账户：https://1panel.cn/docs/v2/user_manual/websites/certificate_acme/
+- DNS 账户：https://1panel.cn/docs/v2/user_manual/websites/certificate_dns/
+- Go 运行环境：https://1panel.cn/docs/v2/user_manual/websites/golang/
+
+### 数据库与容器
+
+- MySQL：https://1panel.cn/docs/v2/user_manual/databases/mysql/
+- PostgreSQL：https://1panel.cn/docs/v2/user_manual/databases/postgresql/
+- Redis：https://1panel.cn/docs/v2/user_manual/databases/redis/
+- MongoDB：https://1panel.cn/docs/v2/user_manual/databases/mongodb/
+- 容器概览：https://1panel.cn/docs/v2/user_manual/containers/overview/
+- Docker 存储卷：https://1panel.cn/docs/v2/user_manual/containers/volume/
+- Docker 镜像仓库：https://1panel.cn/docs/v2/user_manual/containers/repo/
+- Docker Compose 编排模板：https://1panel.cn/docs/v2/user_manual/containers/compose_template/
+
+### 系统与日常运维
+
+- 主机文件管理：https://1panel.cn/docs/v2/user_manual/hosts/file/
+- 主机监控：https://1panel.cn/docs/v2/user_manual/hosts/monitor/
+- 防火墙：https://1panel.cn/docs/v2/user_manual/hosts/firewall/
+- 磁盘管理：https://1panel.cn/docs/v2/user_manual/hosts/disk/
+- Web 终端：https://1panel.cn/docs/v2/user_manual/terminal/
+- 计划任务：https://1panel.cn/docs/v2/user_manual/cronjobs/
+- ClamAV 病毒扫描：https://1panel.cn/docs/v2/user_manual/toolbox/clam/
+- 日志审计：https://1panel.cn/docs/v2/user_manual/logs/
+- 面板设置：https://1panel.cn/docs/v2/user_manual/settings/
+
+### WAF 与高级功能
+
+- WAF 功能与版本说明：https://1panel.cn/docs/v2/user_manual/xpack/waf/waf/
+- WAF 首页：https://1panel.cn/docs/v2/user_manual/xpack/waf/dashboard/
+- WAF 攻击报表：https://1panel.cn/docs/v2/user_manual/xpack/waf/stat/
+- WAF 拦截记录：https://1panel.cn/docs/v2/user_manual/xpack/waf/log/
+- WAF 封锁记录：https://1panel.cn/docs/v2/user_manual/xpack/waf/block/
+- WAF 黑白名单：https://1panel.cn/docs/v2/user_manual/xpack/waf/blackwhite/
+- WAF 网站设置：https://1panel.cn/docs/v2/user_manual/xpack/waf/site/
+- WAF 全局设置：https://1panel.cn/docs/v2/user_manual/xpack/waf/global/
+- 多节点管理：https://1panel.cn/docs/v2/user_manual/xpack/node/
+- 网站监控：https://1panel.cn/docs/v2/user_manual/xpack/website_monitor/
+- 数据库集群：https://1panel.cn/docs/v2/user_manual/xpack/database_cluster/
+- 网站防篡改：https://1panel.cn/docs/v2/user_manual/xpack/tamper/
+- 多节点资源同步：https://1panel.cn/docs/v2/user_manual/xpack/resource_sync/
+- 移动端：https://1panel.cn/docs/v2/user_manual/xpack/mobile_app/
+- 界面设置：https://1panel.cn/docs/v2/user_manual/xpack/appearance/
+
+### 企业版功能
+
+- AI 网关：https://1panel.cn/docs/v2/user_manual/ai/gateway/
+- 基准测试：https://1panel.cn/docs/v2/user_manual/ai/benchmark/
+- Skills Hub：https://1panel.cn/docs/v2/user_manual/ai/skills_hub/
+- 用户与角色管理：https://1panel.cn/docs/v2/user_manual/enterprise/user_management/
+- 虚拟机管理：https://1panel.cn/docs/v2/user_manual/enterprise/vm/
+- 安全运维报表：https://1panel.cn/docs/v2/user_manual/enterprise/ops_report/
+
+## Skills 技能
+
+- 1Panel-skills 用于将 1Panel 运维查询和状态检查能力接入 OpenClaw 等智能体平台。
+- 1Panel-skills 文档：https://1panel.cn/docs/v2/dev_manual/skills/
+- 1Panel-skills 仓库：https://github.com/1Panel-dev/1Panel-skills
+- 1Panel-appstore-skills 用于把可靠的官方 Docker 部署方案转换为 1Panel 应用商店安装包，不负责向远程应用商店发布。
+- 1Panel-appstore-skills 文档：https://1panel.cn/docs/v2/dev_manual/appstore_skills/
+- 1Panel-appstore-skills 仓库：https://github.com/1Panel-dev/1Panel-appstore-skills
+
+## 版本与权限边界
+
+- 社区版可使用服务器、网站、证书、数据库、容器、应用商店、模型账号、Ollama、MCP、GPU 监控等基础功能；智能体最多管理 5 个。
+- 专业版和企业版可使用 vLLM、模型下载器、多节点管理、数据库集群、移动端、网站监控、网站防篡改、资源同步和界面设置等功能，需要有效许可证。
+- 企业版提供 AI 网关、基准测试、Skills Hub、多用户与角色管理、虚拟机和安全运维报表，并按角色区分查看和管理权限。
+- WAF 基础防护支持社区版，包括黑白名单、网站设置和全局基础规则；首页统计、攻击报表、拦截记录、封锁记录及部分高级规则需要专业版或企业版许可证。
+- 页面可见入口和可执行操作还会受到当前账号角色、节点权限、资源状态和依赖组件版本影响。
+
+## 抓取与引用建议
+
+- 使用 https://1panel.cn/docs/v2/sitemap.xml 获取 V2 完整页面索引。
+- 使用 https://1panel.cn/docs/v2/llms.txt 获取面向大语言模型的核心语义导航。
+- V2 页面 canonical 应位于 https://1panel.cn/docs/v2/ 路径下，不应与 V1 页面混用。
+- 引用具体功能时，优先读取对应页面的“适用版本与权限”“使用前提”“参数说明”和“注意事项”。
+- 文档主要面向中文用户；产品名称、菜单名称、按钮名称和版本边界以页面正文为准。

docs/llms.txt

@@ -19,5 +19,5 @@ Allow: /
 User-agent: PerplexityBot
 Allow: /
 
-Sitemap: https://1panel.cn/docs/sitemap.xml
+Sitemap: https://1panel.cn/docs/v2/sitemap.xml
 Host: 1panel.cn