# 投票

该 `/poll` 命令组允许工作人员创建和管理投票 —— 通常用于员工评估。投票支持匿名投票、每个用户的投票限制以及实时结果查看。

***

## /poll create

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

| 选项          | 必填 | 描述                     |
| ----------- | -- | ---------------------- |
| `频道`        | 否  | 发布投票的频道（默认为当前频道）       |
| `匿名`        | 否  | 在结果中隐藏投票者身份（默认：false）  |
| `max_votes` | 否  | 每位投票者可选择的最大选项数（0 = 不限） |

会打开一个模态窗口，供你填写：

* **标题** — 显示为嵌入标题
* **描述** — 显示在标题下方的上下文或说明
* **选项** — 每个选项单独占一行（最多 10 个）

机器人会将投票以带有投票按钮的嵌入消息形式发布。用户点击按钮即可投票。

***

## /poll edit

编辑一个正在进行中的投票内容。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 投票 ID |

打开一个模态窗口以更新标题、描述或选项。现有投票会被保留。

***

## /poll delete

关闭投票并禁用所有投票按钮。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 投票 ID |

投票嵌入消息会更新为已关闭状态，按钮也会被禁用。此操作无法撤销。

***

## /poll list

列出投票，并可使用可选筛选条件。

| 选项    | 必填 | 描述                   |
| ----- | -- | -------------------- |
| `筛选器` | 否  | `active` （默认）或 `all` |
| `频道`  | 否  | 按频道筛选                |
| `用户`  | 否  | 按创建者筛选               |

***

## /poll view

查看投票当前的实时结果。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `id` | 是  | 投票 ID |

返回一个嵌入消息，显示每个选项的票数以及指向原始投票消息的跳转链接。

对于匿名投票，单个投票者的身份会被隐藏；仅显示总票数。


---

# 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/polls.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.