> For the complete documentation index, see [llms.txt](https://docs.lazypro.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lazypro.app/pagespeed/01-quick-start.md).

# 快速開始

## 基本流程

1. 點擊表格右上角 + New 按鈕新增網址
2. 點擊底部 Start 按鈕開始分析（最多 3 個）
3. 表格顯示分析狀態
4. 點擊表格內 Analyze 按鈕查看報告

## Pro Mode 專業模式分析流程

需要使用自己的 Google PageSpeed API Key

1. 建立包含 API Key 的 JSON 檔案
2. 點擊底部 + 按鈕上傳 JSON 檔案（自動啟用 Pro Mode）
3. 點擊表格右上角 + New 按鈕新增網址
4. 點擊底部 Start 按鈕開始分析（無數量限制）
5. 表格顯示分析狀態
6. 點擊表格內 Analyze 按鈕查看報告

## 如何申請 Google PageSpeed API Key

### 申請步驟

1. 前往 [Google Cloud Console](https://console.cloud.google.com/)
2. 建立新專案或選擇現有專案
3. 啟用 PageSpeed Insights API
4. 建立 API 金鑰（API Key）
5. 將 API Key 寫入 JSON 檔案（格式見 JSON 檔案格式章節）

### API Key 限制

* Google 提供每日 25,000 次免費查詢額度
* 超過額度需付費使用
* 建議自行監控使用量

## 如何設定 Cloudflare R2（選用）

### 用途

* 用於分享報告功能
* 報告會儲存在你自己的 R2 空間
* 不設定也可正常使用分析功能，只是無法分享

### 申請步驟

#### 步驟 1：建立 R2 Bucket

1. 登入 [Cloudflare Dashboard](https://dash.cloudflare.com/)
2. 前往「R2 Object Storage」頁面
3. 點擊「Create bucket」
4. 輸入 Bucket 名稱（例如：my-pagespeed-reports）
5. Location 選項：
   * 保持「Automatic」讓 Cloudflare 自動選擇最近的區域
   * 或選擇「Specify jurisdiction」指定區域
6. 點擊「Create bucket」完成

#### 步驟 2：建立 API Token

1. 在 R2 頁面，點擊「Manage R2 API Tokens」
2. 點擊「Create API token」
3. 選擇 Token 類型：
   * User API Token（建議）：綁定你的個人帳號
   * Account API Token：綁定整個 Cloudflare 帳號（需 Super Administrator）
4. 設定 Token：
   * Token name: `PageSpeed Reporter`（可自訂）
   * Permissions: 選擇「Object Read & Write」
   * Apply to specific buckets: 選擇剛建立的 bucket
5. 點擊「Create API Token」

#### 步驟 3：保存憑證

建立後會顯示以下資訊（**只顯示一次，務必立即複製**）：

* **Access Key ID**（客戶端 ID）
* **Secret Access Key**（客戶端密鑰）

#### 步驟 4：取得 Account ID

1. 在 Cloudflare Dashboard 任何頁面
2. 右側會顯示你的 Account ID
3. 或前往「Workers & Pages」→「Overview」查看
4. Account ID 格式：32 字元的英數字串

#### 步驟 5：填入 JSON 檔案

將這些資訊寫入 JSON 檔案的 `share_report.r2` 區塊：

```json
{
  "share_report": {
    "upload": true,
    "r2": {
      "accountId": "你的 Account ID",
      "accessKeyId": "Access Key ID",
      "secretAccessKey": "Secret Access Key",
      "bucketName": "my-pagespeed-reports"
    }
  }
}
```

### R2 免費額度

* 每月 10 GB 儲存空間
* 100 萬次上傳操作
* 1000 萬次下載操作
* 無流量費用

### 安全提醒

* **Secret Access Key 是敏感資訊**
* 不要將包含 R2 憑證的 JSON 檔案上傳到公開位置
* 不要分享給他人
* 建議定期輪換 API Token
* JSON 檔案應儲存在本機安全位置


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lazypro.app/pagespeed/01-quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.