# 投票模板

投票模板可让你保存一份投票结构（标题、描述和选项），并在每次使用时无需重新输入所有细节即可重复使用。适用于总是采用相同格式的重复评估。

***

## /poll\_template create

通过模态表单创建一个新模板。

填写：

* **名称** — 用于标识模板的内部名称
* **标题** — 发布时将使用的投票标题
* **描述** — 标题下方显示的上下文说明
* **选项** — 每行一个选项

***

## /poll\_template from\_poll

将现有投票转换为可重复使用的模板。

| 选项   | 必填 | 描述        |
| ---- | -- | --------- |
| `id` | 是  | 要转换的投票 ID |

将投票的标题、描述和选项复制到一个新模板中。

***

## /poll\_template edit

编辑现有模板。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 模板 ID |

***

## /poll\_template delete

软删除一个模板（将其从列表中隐藏，但不销毁数据）。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 模板 ID |

***

## /poll\_template list

列出可用模板。

| 选项    | 必填 | 描述                            |
| ----- | -- | ----------------------------- |
| `筛选器` | 否  | `active` （默认）或 `all` （包括已删除的） |

***

## /poll\_template preview

预览模板投票的外观，而不实际发布它。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 模板 ID |

响应是临时的（只有你能看到）。

***

## /poll\_template use

根据模板创建并发布投票。

| 选项          | 必填 | 描述                  |
| ----------- | -- | ------------------- |
| `id`        | 是  | 模板 ID               |
| `频道`        | 否  | 要发布到的频道（默认为当前频道）    |
| `匿名`        | 否  | 隐藏投票者身份（默认：false）   |
| `max_votes` | 否  | 每位投票者最多可选项数（0 = 不限） |


---

# Agent Instructions: 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.vigila.augystudios.com/zh/shi-yong-fang-fa/poll-templates.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.