AI 浮条设置与首次使用
从第一次配置到完成请求，学习如何在云贴中选择 AI 服务商、连接和模型，检查发送内容并使用回答。继续设置自定义指令与外部搜索动作，了解 API 费用、权限、商店地区和数据发送边界。
本页目录6 个章节
AI 浮条设置可以分成两件事：先让云贴连上你选择的服务，再决定每次让它做什么。如果还不确定用途，可以先回到 AI 浮条介绍，了解翻译、润色、总结和图片分析。
开始前，确认可用范围
中国大陆 App Store 商店区，以及暂时无法确认商店地区时，AI 功能与外部搜索动作不可用；升级完整版不会解除限制。其他地区还需确认所选服务商本身可用。具体依据见AI 可用范围。
准备好服务商要求的连接信息和授权方式。API 用量由服务商单独计费，不包含在云贴的买断价格中；API Key 保存在 macOS 钥匙串。不要把密钥当作普通文字复制到共享文档或示例提示词里。
配置服务商、连接和模型
- 打开云贴设置中的 AI 相关设置，选择准备使用的服务商。
- 按服务商要求配置连接和授权信息；需要自定义端点时，确认 Base URL 指向预期服务。
- 选择该服务支持的模型。文字任务先用文本模型；需要直接理解图片时，确认模型支持视觉输入。
- 检查数据发送与动作设置，再用一段不敏感的短文本尝试请求。
设置界面的服务商、连接、模型和动作是不同层级：服务商决定内容发送给谁，模型决定由哪个模型处理，动作决定本次处理要求。初次使用先保持简单，不必马上创建自定义指令。
当前支持 OpenAI、Anthropic Claude、Google Gemini、OpenRouter、SiliconFlow、Kimi、DeepSeek、MiniMax、Zhipu GLM、Alibaba Qwen、Volcano Ark，以及通用 OpenAI-compatible 服务。连接地址和可用模型以你选择的服务为准。
完成第一次请求
选中一段短文本，通过设置中的 AI 触发快捷键唤起浮条；也可以使用云贴里的文本条目。选择翻译或润色，明确目标语言或语气。发送时检查确认对话框中的服务商、地址和数据类别，得到回答后再复制或替换。
本地检查可能阻止或提示含有密钥、令牌等高风险内容的请求，但不能识别所有敏感信息。API 请求会将内容发送给所选服务，不是在本机完成 AI 推理。
读取其他应用的选区和替换原文需要辅助功能权限。如果只能得到回答但无法替换，先复制后手动粘贴，再检查目标选区与授权。
把常用要求保存成自定义指令
先写清一个重复任务，例如“将这段回复改得更简短、礼貌，保留原有数字和日期”。在指令编辑器中填写名称、提示词，并按界面提供的变量插入当前内容。用两三段不同文字测试，再决定是否长期使用。
在支持的商店地区，内置指令在试用后仍可使用；新增或编辑自定义指令需要完整版，删除自定义项不受限制。
需要网页搜索时，使用外部动作
预设动作可以把选中文本交给 ChatGPT Search、Google、Claude 或 Perplexity 等网页。自定义动作的 URL 模板必须使用 HTTPS，并通过 {{query}} 接收编码后的查询。例如，使用你信任的网站所支持的搜索地址，而不是把整个问题固定写在模板中。
执行后会关闭浮条，并在默认浏览器打开目标页面。这条路径不调用已配置的 AI 服务，不使用 API Key，也不适用 AI 数据发送授权或隐私扫描。查询可能进入浏览器历史、同步记录、目标网站日志或账户历史，不应包含密钥或不适合披露的信息。
预设搜索动作在试用后仍可添加、排序和使用；新增或编辑自定义网页动作需要完整版，删除始终允许。它们同样受商店地区限制。
遇到问题，按所在环节检查
| 现象 | 先检查什么 |
|---|---|
| AI 入口不可用 | App Store 商店区是否支持、是否已经确认 |
| 快捷键没有唤起浮条 | 云贴是否运行、快捷键是否冲突、选区与辅助功能权限 |
| 请求失败 | 服务商、授权信息、Base URL、模型与服务商用量状态 |
| 图片没有按预期分析 | 模型是否支持视觉；非视觉模型使用 OCR 与二维码文字上下文 |
| 回答可以看到，但不能替换 | 目标应用是否提供有效文本选区、辅助功能权限是否就绪 |
常见问题
购买完整版包含 AI API 费用吗？
不包含。服务商的 API 用量单独计费。升级云贴也不会解除 App Store 商店区对 AI 和外部搜索的限制。
配置好了却无法读取选中文字怎么办？
先检查辅助功能权限和目标应用的有效选区，再检查 AI 触发快捷键是否冲突。复制内容到云贴条目后处理，可以帮助区分选区读取问题与服务连接问题。