---
title: "小组件和快捷指令"
description: "通过主屏幕和锁定屏幕小组件、控制中心开关，以及快捷指令 App 及其自动化中的 potatso:// URL 来控制 Potatso。"
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 小组件和快捷指令

无需打开 Potatso，你就可以连接、断开、切换模式和切换节点：通过小组件、控制中心或快捷指令。它们都作用于 Potatso 中当前选中的配置。

## 主屏幕小组件 {#widgets}

用常规方式添加小组件：长按主屏幕，轻点**编辑**，再轻点**添加小组件**，然后搜索 Potatso。Potatso 有两个小组件。

### VPN 连接 {#connection-widget}

连接、切换模式和选择节点。

| 尺寸 | 显示内容 |
| --- | --- |
| 小 | 配置、其状态，以及**连接**或**断开**按钮。 |
| 中 | 同上，外加模式按钮：**规则**、**全局**、**智能**和**直连**。 |
| 大 | 模式按钮，以及主出站的最多 4 个节点及其延迟。 |

轻点某个模式或节点即可切换到它。如果你已连接，更改会立即生效。当更改需要打开 App 时，小组件会显示**打开 Potatso 以应用此更改。**

有了 Potatso Pro，大号小组件还有一个**测速**按钮，用来测试它所显示的节点。

有些选项对某些配置不可用。例如，个人 VPN 配置没有模式或节点按钮，直连模式也不使用节点。

### 节点 {#nodes-widget}

一个中号小组件，带有连接按钮和你最常连接的三个节点。轻点某个节点即可切换到它。

## 锁定屏幕小组件 {#lock-screen}

**VPN 连接**小组件也有锁定屏幕尺寸：

- 圆形小组件显示你是否已连接以及连接了多久。轻点它可连接或断开。
- 矩形小组件显示状态、配置、其模式和路由。
- 行内小组件用一行显示状态。

## 控制中心 {#control-center}

在 iOS 18 或更高版本上，你可以把 Potatso 开关添加到控制中心：

1. 打开控制中心，触碰并按住空白区域。
2. 轻点**添加控制**并搜索 Potatso。
3. 选择 **VPN 连接**。

轻点开关即可连接或断开。

## URL 操作 {#urls}

Potatso 会响应下面这些 URL：

| URL | 操作 |
| --- | --- |
| `potatso://on` | 连接。 |
| `potatso://off` | 断开连接。 |
| `potatso://switch` | 未连接时连接，否则断开。 |

打开其中一个 URL 会先打开 Potatso，然后连接或断开。

## 在快捷指令中使用 Potatso {#shortcuts}

要制作一个用于连接的快捷指令：

1. 在“快捷指令”App 中，新建一个快捷指令。
2. 添加**打开 URL** 操作。
3. 输入 `potatso://on`。

使用 `potatso://off` 断开，或使用 `potatso://switch` 切换。

### 自动连接 {#automations}

快捷指令自动化会为你执行 URL 操作。例如，要在离开家中 Wi-Fi 时连接：

1. 在“快捷指令”App 中，轻点**自动化**，然后新建一个自动化。
2. 选择 **Wi-Fi** 触发条件，选择你家中的网络，并设为 iPhone 离开该网络时运行。
3. 选择立即运行。
4. 添加**打开 URL** 操作，URL 为 `potatso://on`。

再制作第二个自动化，使用 `potatso://off`，在 iPhone 加入你家中的 Wi-Fi 时运行，这样回到家就会再次断开。

Source: https://potatso.com/docs/zh/guides/widgets-and-shortcuts/index.mdx