Web版PakePlus使用指南：无需安装客户端，在线完成应用打包

本文将详细介绍如何使用Web版PakePlus在线工具，无需安装任何客户端软件，即可将任意网页快速打包为轻量级桌面应用。通过Web界面完成从项目创建、参数配置到最终应用生成的全流程，即使是零基础用户也能在5分钟内完成操作。

准备工作：获取GitHub Token

在开始使用Web版PakePlus前，需要准备GitHub Token以确保完整功能体验。虽然未获取Token也可创建临时本地项目，但推荐按照官方文档完成Token配置，以解锁云端存储和多端同步功能。

官方Token获取教程：docs/guide/token.md

项目创建步骤

1. 访问PakePlus Web平台首页，点击右上角"+"按钮进入新建项目流程
2. 在弹出的创建窗口中填写项目名称（支持中文但不可包含空格）
3. 点击"确认"按钮后系统自动完成项目初始化，随后跳转至配置页面

项目命名规则：不可数字开头，允许字母、数字、下划线和连字符组合，建议使用与网页功能相关的名称便于管理

基础参数配置

进入项目配置页面后，需完成四项必填参数设置：

参数项	要求说明
App名称	支持多语言但不可包含空格
网站URL	必须以http/https开头，支持本地HTML文件或Vue/React构建的dist文件夹
App ID	全局唯一标识符，建议使用反向域名格式（如com.example.myapp）
版本号	遵循语义化版本规范（如0.0.1）

高级配置选项（点击右上角"更多设置"展开）：

• 窗口持久化：重启时恢复上次窗口尺寸和位置
• 单实例模式：防止应用多开
• 调试模式：开启预览窗口调试功能
• 图标设置：支持本地上传自定义图标，提供macOS圆角处理选项

应用预览与发布

完成配置后点击"预览"按钮可实时查看应用效果，确认无误后点击"发布"开始打包流程：

1. 预览窗口支持模拟不同设备布局（桌面/iPhone/iPad/Android）
2. 可通过元素过滤功能隐藏网页中不需要的元素（如广告、导航栏）
3. 发布前可注入自定义JS脚本实现功能增强，官方示例脚本：scripts/config/inject/custom.js

打包完成后，系统将自动生成多平台安装包，包括：

• Windows：docs/bundle/redbook_0.0.1_x64-setup.exe
• macOS：docs/bundle/redbook_0.0.1_aarch64.dmg
• Linux：docs/bundle/redbook_0.0.1_amd64.deb

常见问题解决

打包失败排查

若遇到打包超时或失败，可检查：

1. URL格式是否正确（必须包含协议头http/https）
2. 网页是否存在跨域限制
3. 资源文件大小是否超过10MB限制（GitHub存储限制）

详细排错指南：docs/question/debug.md

自定义配置进阶

对于高级用户，可通过JSON配置文件实现更精细的控制，配置模板参考：scripts/ppconfig.json

离线使用方案

Web版PakePlus也支持本地离线使用，通过以下步骤实现：

1. 访问项目GitHub仓库：docs/exchange/github.md
2. 下载最新版离线包
3. 本地打开index.html文件即可使用

结语

Web版PakePlus彻底简化了网页转应用的技术门槛，通过直观的可视化界面和自动化流程，让任何人都能在浏览器中完成专业级应用打包。相比传统客户端模式，Web版省去了环境配置和依赖安装步骤，平均打包时间缩短至3分钟以内。

官方完整教程：docs/guide/index.md
常见问题汇总：docs/question/index.md