# 消息、附件与运行卡

> 发送图片、文件和语音，查看运行过程，停止任务或领取结果。

来源：https://vonvon.cc/docs/messages/
更新时间：2026-11-04

Bot 在已连接的飞书群里接收任务。最稳妥的开始方式是在群主区明确 @ Bot，并说清要它做什么；选择「独立话题」（多会话）的群会为这条消息开新话题，后续在话题内继续。是否可以不 @，取决于群的聊天方式和「免 @」设置；智能模式还会判断该不该接话。

## 发送文字、图片、文件与语音

| 你发送的内容 | Bot 如何处理 | 遇到问题时 |
| --- | --- | --- |
| 文字或富文本 | 把消息正文交给当前会话。引用回复时，会尽力把被引用消息一并交给它。 | 先确认群已连接、Bot 已启用，并明确 @ 到这位 Bot；没有回复时查看「诊断」。 |
| 图片 | 读取直接发送的图片和富文本中的图片，作为图像输入交给 Provider；单条消息最多处理 9 张。 | 图片读不到时重发原图，或用文字描述关键信息。 |
| 文件附件 | 下载直接发送的附件，告诉 Provider 文件名和可读取的位置；单条消息最多 9 个，每个不超过 50 MB。能否读取还受 Provider 和群权限限制；Codex 的受限权限档不能读取该临时附件。 | 若附件下载失败或 Provider 读不到，重发、缩小文件，或粘贴文字；处理文件前先核对执行权限。 |
| 语音 | 开启「语音转文字」且识别可用时，先转成文字再交给 Provider；转写结果会随回复展示。未转写时会尝试把原音频交给 Provider，并说明转写失败。 | 听写不准或读不到音频时，改发文字；超过 20 MB 的语音不会转写。 |
| 合并转发 | 可读取转发消息中的文字；其中的图片会尽力获取。 | 飞书可能拒绝获取合并转发子消息里的图片或文件。需要 Bot 分析附件时，请把原文件或原图直接发到群里。 |

发送附件时，最好在同一条消息里说明任务，例如“请总结这份文件的三个结论”。文件下载与 Provider 读取都需要时间；文件很大时先确认它在上述限制内。

## 看运行卡、停止与重试

Bot 开始处理后，会在群里更新运行卡，显示正在进行的步骤和输出。任务结束后，卡片显示最终结果。运行卡上的「停止生成」可中止当前运行；只有任务发起人或 Bot 管理员能操作停止。若卡片显示可重试，先核对这一轮是否已产生副作用，再点「重试」；网络瞬断也可能由 Bot 自动重试。

当这位 Bot 的并发运行名额已满，Bot 会先显示「排队中」卡片和排队位置；多个群共用这位 Bot 的并发名额，上限在该 Bot 的「设置 → 运行上限 → 同时处理的任务」调整。在开始前可点「取消排队」。若 Bot 在排队或运行期间停止，未执行的消息会提示重发。要确认是否真的完成，请看最终卡片，而不是只看正在更新的文字。

## 运行中补充一句话

在同一会话运行时继续发消息，群设置里的「运行中来了消息」会决定处理方式：「插话」尝试把补充交给当前轮，适合纠正方向；「排队」等当前轮结束后再处理，适合下一件事。若当前 Provider 或这次运行无法接收插话，消息会按实际状态进入后续处理。发送后看 Bot 的回执和运行卡，避免因未见即时变化而重复发同一任务。

正在运行 `/goal` 自治目标的会话不接普通插话或排队任务。要停止目标，用运行卡上的「终止」；想让当前轮完成后结束，用「结束目标」。目标结束后再发新的任务。

![沟通方式页中的聊天方式可选独立话题、连续交谈和智能；群内响应单独控制免@；运行中来了消息可选插话或排队。](https://vonvon.cc/bot/docs/group-conversation.png)

沟通方式 · 三项设置分别影响上下文、触发和运行中消息

1.  **聊天方式**：独立话题对应多会话，连续交谈对应单会话；智能由 Bot 判断何时、在哪里回复。
2.  **群内响应**：决定不 @ 是否也能发起任务，不会替你改变聊天方式或权限。
3.  **运行中的新消息**：Codex 可插话或排队；Claude 使用排队。以当前 Provider 显示的选项为准。

## 领取 Bot 生成的文件

Bot 在回复里引用可领取的本地文件时，点击文件名称，Bot 会把它作为飞书附件发送到当前会话；发送成功后，该入口会指向附件消息。单个附件须是可读取的普通文件，非空且不超过 30 MB。

只有本群允许使用 Bot 的成员可以领取。领取时还会重新检查群当前的执行权限：如果文件不在当前允许访问的范围内、已移动或已改变，领取会被拒绝。看到「上次发送结果未确认」时先检查会话里有没有附件，再请 Bot 重新引用文件，避免重复发送。

## 在云文档评论里 @ Bot

拥有者或管理员可以在受支持的飞书文档评论中 @ Bot 并写明问题。Bot 会读取该条评论及其引用内容，在同一评论串里回复；同一评论串中的后续 @ 会接着此前会话。支持文档、电子表格和多维表格的评论。评论回复不是群运行卡，处理时可能只看到飞书的“正在输入”反馈。

评论任务使用单独的「云文档评论」配置，包括 Provider、模型、权限与回复规则，不直接沿用某个群的聊天设置。Bot 需要能读取评论且有对应飞书权限；知识库里的文档还可能需要知识库权限。没有回复时，先确认是管理员本人 @ 了 Bot、文档类型受支持、评论里有实际问题，再查看 Bot 的「诊断」和飞书权限。

私聊的用途

当前版本中，私聊 Bot 会打开管理卡片，供主人和管理员查看或调整设置；普通任务请发到已连接的群。群内不能用 `/settings` 改设置，相关入口在私聊管理卡片、Vonvon 客户端或命令行。