Pake 是一个命令行工具，能让您将任意网页打包成一个轻量级的桌面应用程序。它基于 Rust 的 Tauri 框架，生成的安装包通常小于 10MB，内存占用低且运行速度快。

1. 系统要求

  • 操作系统：macOS、Windows 或 Linux。
  • Node.js：版本 >= 20（推荐使用 LTS 版本，如 22.x）。
  • 包管理器：pnpm（推荐，但 npm 也可用）。
  • Rust（仅当您需要从源码开发或自定义高级功能时需要）：版本 >= 1.85。

2. 安装 Pake CLI

Pake 的核心使用方式是通过命令行工具 pake-cli。

打开终端（Terminal）或命令提示符，执行以下命令进行全局安装：

1
pnpm install -g pake-cli

或者，如果您更习惯使用 npm：

1
npm install -g pake-cli

安装完成后，您可以通过 pake --version 验证是否安装成功。

3. 快速开始：一键打包应用

3.1 基础用法

最简单的命令是提供网页 URL 和应用名称，Pake 会自动获取网站图标并打包：

1
pake https://github.com --name GitHub

3.2 自定义选项

您可以通过添加参数自定义窗口大小、图标、是否隐藏标题栏等：

1
2
3
4
5
6
pake https://weekly.tw93.fun \
  --name Weekly \
  --icon https://cdn.tw93.fun/pake/weekly.icns \
  --width 1200 \
  --height 800 \
  --hide-title-bar

3.3 参数说明（部分常用）

参数 说明 示例
--name 应用名称 --name MyApp
--icon 应用图标（本地路径或URL） --icon ./icon.png
--width 窗口宽度（像素） --width 1200
--height 窗口高度（像素） --height 800
--hide-title-bar 隐藏标题栏（创建极简窗口） --hide-title-bar
--fullscreen 启动时全屏 --fullscreen
--resize 允许调整窗口大小 --resize
--json 以 JSON 格式输出结果（便于脚本解析） --json

注意：首次打包时需要下载 Rust 依赖和环境，速度可能较慢。后续打包会利用缓存，速度会显著提升。

4. 高级使用方式

4.1 使用配置文件批量打包

您可以创建一个 JSON 配置文件来描述应用参数，然后使用 --config 指定它：

1
pake --config app.json

app.json 示例内容：

1
2
3
4
5
6
7
{
  "name": "MyApp",
  "url": "https://example.com",
  "width": 1000,
  "height": 700,
  "hideTitleBar": true
}

4.2 打包本地构建产物

Pake 也可以将本地构建的静态网站（如 dist 目录）打包成应用：

1
pake ./dist --name MyLocalApp

4.3 脚本化与自动化

在脚本或 AI Agent 中使用时，可以添加 --json 参数以获取机器可解析的输出：

1
pake https://github.com --name GitHub --json

5. 快速获取现成应用（非开发者）

如果您不想使用命令行，Pake 项目也提供了大量已打包好的热门应用（如微信读书、Twitter、ChatGPT、YouTube Music 等）供直接下载。

  1. 访问项目的 GitHub Releases 页面。
  2. 在 “Assets” 区域，根据您的操作系统（macOS .dmg，Windows .exe，Linux .deb/.AppImage）下载对应的安装包。
  3. 直接安装运行即可。

6. 从源码开发（面向贡献者/高级用户）

如果您想为 Pake 贡献代码或进行深度定制，可以按照以下步骤从源码运行。

6.1 前提条件

  • 安装 Rust 工具链（>= 1.85）。
  • 安装 Node.js（>= 20）和 pnpm。
  • 根据 Tauri 文档 安装系统依赖（如 macOS 的 Xcode Command Line Tools，Linux 的 libwebkit2gtk 等）。

6.2 克隆与运行

1
2
3
4
5
6
7
8
9
10
11
12
# 克隆仓库
git clone https://github.com/tw93/Pake.git
cd Pake

# 安装依赖
pnpm i

# 运行开发模式（右键可打开开发者工具）
pnpm run dev

# 构建生产版本
pnpm run build

7. 常见问题排查

问题 可能原因 解决方案
pnpm install -g pake-cli 失败 Node.js 版本过低或网络问题 检查 Node.js 版本（需 >=20），尝试使用 npm 或配置镜像源。
首次打包速度极慢 正在下载 Rust 依赖和编译 正常现象，请耐心等待。后续打包会快很多。
打包的应用无法启动或闪退 系统缺少 Tauri 运行时依赖 检查并安装 Tauri 系统依赖（参考其官方文档）。
应用图标未更新 图标缓存或路径问题 确保 --icon 参数路径正确，尝试使用绝对路径或不同格式（PNG/ICNS/ICO）。

8. 总结

Pake 的核心价值在于提供了一种极其轻量和便捷的方式，将常用的网页服务转化为独立的桌面应用，减少浏览器标签页的杂乱。

核心使用路径：

  1. 安装 CLI：pnpm install -g pake-cli。
  2. 一键打包：pake <网页URL> --name <应用名>。
  3. （可选） 添加自定义参数调整窗口行为。
  4. （或） 直接从 Releases 下载现成应用。

对于大多数用户，通过 CLI 工具或下载现成应用是最直接高效的方式。如果您遇到问题，可以优先检查 Node.js 版本和网络连接。

项目地址：https://github.com/tw93/Pake