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

# 设置并使用 Voido 的 AI 助手

> 为 Voido 的 AI 助手选择命令行助手、ChatGPT 账号或自己的 API，设置工具操作的审批方式，在项目文件夹中对话，并审阅和撤销 AI 提出的改动。

Voido 的 AI 助手可以读取你的日程、任务、项目和笔记，帮你找空闲时间、安排计划。它想改动任何内容时，都会先给出建议卡片，由你确认。AI 助手目前只能在桌面 App 中使用。

## 连接一个助手

打开「设置 → AI → 模型与账号」，选择下面任意一种。还没有连接时，AI 面板会显示「先连接一个 AI 助手」，点「去设置 AI」可以直接跳转。

> [tab] 助手服务
>
> 使用已经安装并登录在这台 Mac 上的命令行助手，支持 Claude Code、Codex、OpenCode、Cursor、Kimi CLI、CodeBuddy、Qwen Code、GitHub Copilot 和 Google Antigravity。
>
> * 点「使用」选中一个助手，「测试」检查它能否正常工作。
> * 刚安装的助手没有出现时，点「重新检测」。
> * 还没登录时，点「在终端登录」，按命令行助手自己的流程登录。
>
> 使用 Claude 订阅时，需要通过 Claude Code 登录。

> [tab] 订阅账号
>
> 如果设置中显示「通过 ChatGPT 继续」，可以用 ChatGPT 账号登录。请求会使用你的 ChatGPT 套餐额度，与 Voido Pro 无关。登录后可以「管理用量」或「退出登录」。

> [tab] 自定义接口
>
> 使用你自己的 API key。
>
> 1. 在「接口类型」中选择「OpenAI 兼容」或「Anthropic」。
> 2. 填写接口地址、模型和 API key。
> 3. 点「保存并测试」，再点「使用 BYOK」。
>
> API key 加密保存在本机，不同的 Voido 账号分开保存。

列表中的「Void 托管 AI」使用你的 Voido 账号和 AI 额度，需要带 AI 额度的付费订阅，目前只支持文字对话。

## 审阅和撤销改动

AI 提出的改动会显示为「建议的日程」或「建议的改动」卡片。你可以「全部加入日历」「确认这些改动」「逐个调整」或「放弃」。较大的计划会显示「审阅计划」，可以「全部接受」、只应用勾选的部分，或「重新规划」。

改动生效后，对话中的「操作记录」栏提供「撤销全部」「保留全部」和「查看变更」，每一项也可以单独撤销。撤销的规则见 [连接日历](https://docs.voido.ai/calendars.md) 中的「撤销 AI 的日历改动」。

## 工具操作的审批方式

使用助手服务或自定义接口时，可以决定助手的工具操作如何批准。在输入框的权限菜单中切换，或在「设置 → AI → 对话与权限 → 助手权限（高级）」中设置默认值。修改从下一次发送起生效。

| 档位 | 效果 |
| - | - |
| 每次询问 | 除读取工作文件夹内的文件外，每个操作都等你批准。 |
| 只问风险操作 | 新建和修改本地日程会自动执行；删除、笔记正文和外部日历的改动仍需在卡片上确认。 |
| 全部放行 | 所有操作直接执行，可不受限制地访问互联网和你电脑上的文件，Voido 自己的应用数据除外。Qwen Code 和 GitHub Copilot 不提供此选项。 |

需要你批准时，可以选择「允许一次」「始终允许」「拒绝」或「始终拒绝」。

## 在项目文件夹中对话

在对话列表中「添加项目」，再「关联文件夹」，之后这个项目里的对话会让命令行助手在该文件夹中工作。

* 文件夹的关联只保存在当前设备，不会上传。在其他设备上会显示「此设备未关联文件夹」，需要在那台设备上重新关联。
* 「移除项目」不会删除对话，原来的对话会移到「无项目」。

## Online Agent

Online Agent 是常驻云端的助手：关掉 Voido 它也会回复你，对话同步到你的所有设备。需要登录 Voido 账号，并且会员包含 AI 额度；桌面 App 和网页版都可以使用。

1. 在对话列表中点「项目」上方的「Online」，再点右上角的「+」。
2. 起个名字（最多 40 个字），选一只猫和一种颜色，点「创建」。
3. 在列表里选中它，就能在右侧和它聊天。它在思考时，列表和对话里会显示「正在思考…」。

* 每个账号最多 10 个 Online Agent。一个 Online Agent 一次回答一条消息，最多再排队 4 条；排满时稍等几秒再发。
* 它只能读取你已同步的日程、任务、项目和笔记。想改日程或截止日期时，会先给出建议卡片，由你确认。
* 在列表中右键可以修改名称和头像，或删除。删除后它不再回复，聊天记录保留为只读。
* 按 Esc 或左上角的返回按钮回到对话列表。

## 回复进行中继续发送

助手回复时：

* 按 Enter 把新消息加入队列，在当前回复结束后发送。
* 按 Shift+Enter「引导」正在进行的回复。只有自定义接口和 ChatGPT 登录支持引导，引导消息不能带附件。
* 按 Alt+Enter 换行。

## 附件、记忆和语音

* 图片支持 PNG、JPEG、WebP 和 GIF，每张不超过 5 MB。部分助手不支持图片。
* 长期记忆最多保存 20 条。AI 建议的记忆要你确认后才会保存。
* 语音输入使用 Apple 设备端语音识别，音频不会离开你的 Mac。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.