OneClip 支持多种 AI 服务，包括智谱清言 AI 和 Ollama 本地 AI 模型，为您提供 OCR 文字识别、智能翻译、文本摘要等强大功能
🤖 支持的 AI 服务
智谱清言 AI（云端）
推荐智谱 AI 提供强大的云端 AI 能力，支持 OCR、翻译、摘要等多种功能
✅ 优势
- 无需本地部署，开箱即用
- 提供免费额度，新用户注册即可使用
- 性能强大，响应速度快
- 支持多种 AI 功能
Ollama 本地 AI
隐私优先Ollama 让您可以在本地运行大语言模型，数据完全私密，无需联网
✅ 优势
- 数据完全本地处理，隐私安全
- 无需 API Key，完全免费
- 支持多种开源模型（Llama、Mistral 等）
- 离线可用，不依赖网络
📋 前置要求
- 需要先安装 Ollama
- 下载并运行至少一个模型（如
ollama pull llama2） - 确保 Ollama 服务正在运行（默认端口 11434）
⚙️ 配置 AI 功能
方式一：配置智谱 AI（云端）
在 OneClip 中配置
打开 OneClip 设置 → 常规设置 → AI 功能卡片
- 开启"启用 AI 功能"开关
- AI 服务选择"智谱 AI"
- 点击"添加 API Key"按钮
- 粘贴您的 API Key
- 点击"保存"
方式二：配置 Ollama 本地 AI
步骤 1：安装 Ollama
访问 Ollama 官网 下载并安装 Ollama。
安装方式：
# macOS/Linux 快速安装
curl -fsSL https://ollama.ai/install.sh | sh
# 或访问官网下载安装包
# https://ollama.ai/download
步骤 2：下载 AI 模型
在终端中运行以下命令下载模型。推荐使用 qwen3:4b，体积小、速度快。
推荐模型配置：
# 1. 下载文本模型（必选，推荐）
ollama pull qwen3:4b
# 2. 下载视觉模型（可选，用于 OCR）
ollama pull llava:7b
# 3. 查看已安装的模型
ollama list
- qwen3:4b 文本处理模型（约 2.5GB）
- 用于：翻译、摘要、格式化等文本功能
- 特点：体积小、速度快、效果好
- llava:7b 视觉理解模型（约 4.5GB）
- 用于：OCR 文字识别、图像理解
- 特点：支持图像输入
注意：首次下载模型需要一定时间，请保持网络连接并耐心等待。
在 OneClip 中配置
打开 OneClip 设置 → AI 功能
- 开启"启用 AI 功能"开关
- 选择"本地 AI 模型"模式
- OneClip 会自动检测 Ollama 服务状态
- 在"文本模型"中选择
qwen3:4b - （可选）在"视觉模型"中选择
llava:7b用于 OCR - 配置完成后即可使用
OneClip 会自动检测 Ollama 服务和已安装的模型，无需手动配置服务地址。如果检测失败，请确保 Ollama 正在运行。
开始使用
配置完成！现在可以在剪贴板项目的右键菜单中使用 AI 功能了
• 使用 Ollama 本地 AI 时，请确保 Ollama 服务正在后台运行
• 首次使用时，模型加载可能需要几秒钟
• 本地模型的性能取决于您的硬件配置
• 如遇到问题，可以在终端运行 ollama serve 手动启动服务
✨ AI 功能详解
OCR 文字识别
图片专用从图片中智能提取文字内容，支持中文、英文等多种语言识别
🎯 使用场景
- 截图中的代码文本提取
- 照片中的文字识别
- 扫描文档数字化
- 图表、表格内容提取
📝 操作步骤
- 复制或截图包含文字的图片
- 在 OneClip 历史列表中找到该图片
- 右键点击 → 选择 "🤖 提取文字 (AI)"
- 等待 2-5 秒，文字自动提取并显示
- 提取的文字已自动复制到剪贴板
💡 最佳实践
- 图片质量越高，识别准确率越高
- 超大图片会自动压缩到 1024px
- 支持手写文字识别（中等准确率）
智能翻译
文本/代码高质量的中英文互译，保持原文格式和排版
🎯 使用场景
- 技术文档翻译（保持代码格式）
- 英文文章阅读理解
- 代码注释翻译
- 邮件内容翻译
📝 操作步骤
- 复制需要翻译的文本
- 在 OneClip 中找到该文本
- 右键点击 → 选择翻译选项：
- "🤖 翻译为中文 (AI)" - 英译中
- "🤖 翻译为英文 (AI)" - 中译英
- 翻译结果在编辑窗口显示
- 结果已自动复制到剪贴板
💡 翻译优势
- 保持原文格式（段落、缩进、列表）
- 代码块不翻译（智能识别）
- 支持长文本翻译
- 上下文理解更准确
智能摘要
长文本快速总结长文本内容，提取核心要点
🎯 使用场景
- 长文章快速阅读
- 会议记录提取要点
- 文档内容概述
- 新闻资讯速览
📝 操作步骤
- 复制长文本（建议超过 100 字）
- 在 OneClip 中找到该文本
- 右键点击 → "🤖 生成摘要 (AI)"
- 等待 AI 生成摘要
- 查看和编辑摘要结果
摘要功能会自动识别文章结构，提取关键信息点，生成简洁的总结。文本越长，摘要效果越明显。
代码解释
代码理解代码逻辑，获得详细的代码说明
🎯 使用场景
- 学习他人代码
- 快速理解复杂逻辑
- 代码审查参考
- 技术文档编写
📝 操作步骤
- 复制代码片段
- 在 OneClip 中找到该代码
- 右键点击 → "🤖 解释代码 (AI)"
- AI 会详细解释代码功能和逻辑
其他 AI 功能
📝 格式化文本
优化文本格式，调整段落结构，提升可读性（适用于 50+ 字文本）
🔤 拼写检查
检查英文文本的拼写错误并提供修正建议
🏷️ 关键词提取
从长文本中提取关键词和核心概念（适用于 100+ 字文本）
🔑 API Key 管理
您的 API Key 使用 macOS Keychain 加密存储，仅在本地使用，不会上传到任何服务器。
如何管理 API Key
- 查看余额：在您的API服务商网站查看
⚡ 性能与限制
响应速度
- OCR 文字识别：2-5 秒
- 文本翻译：1-3 秒
- 智能摘要：2-4 秒
- 代码解释：2-4 秒
内容限制
- 图片大小：自动压缩到 1024px
- 文本长度：建议不超过 10,000 字符
- 并发请求：单个 API Key 有频率限制
❓ 常见问题
云端 AI 和本地 AI 有什么区别？
☁️ 云端 AI（智谱 AI）：
- 需要 API Key 和网络连接
- 性能强大，响应快速
- 提供免费额度
- 不占用本地计算资源
🏠 本地 AI（Ollama）：
- 完全免费，无使用限制
- 数据完全本地处理，隐私安全
- 离线可用，不依赖网络
- 需要先安装 Ollama 和下载模型
为什么云端 AI 需要 API Key？
仅云端 AI 模式需要 API Key，本地 AI 模式不需要。使用您自己的 API Key 可以确保隐私安全，且您可以完全控制使用量和费用。新用户有免费额度，日常使用基本不会产生费用。
AI 功能是否会上传我的剪贴板内容？
取决于您选择的 AI 模式：
- 云端 AI：只有当您主动使用 AI 功能时，对应的内容才会发送到智谱 AI 进行处理。其他剪贴板内容完全保存在本地，不会上传。
- 本地 AI：数据完全在本地处理，不会上传任何内容，完全隐私保护。
隐私保护建议：如果您处理敏感数据，推荐使用 Ollama 本地 AI 模式。
AI 功能可以离线使用吗？
取决于您选择的 AI 模式：
- 云端 AI（智谱 AI）：需要网络连接，计算在云端完成，不占用本地计算资源。
- 本地 AI（Ollama）：完全离线可用，AI 计算在本地完成，数据不会离开您的设备。
注意：OneClip 的其他功能（剪贴板管理、搜索等）完全离线可用，不受 AI 模式影响。
Ollama 本地 AI 如何配置？
快速配置步骤：
- 访问 ollama.ai 下载并安装 Ollama
- 在终端运行：
ollama pull qwen3:4b（文本模型） - （可选）运行：
ollama pull llava:7b（视觉模型，用于 OCR） - 在 OneClip 设置 → AI 功能中选择"本地 AI 模型"模式
- OneClip 会自动检测 Ollama 服务和已安装的模型
查看上方的详细配置步骤了解更多。
如何提高 OCR 识别准确率？
建议：
1. 使用高分辨率图片
2. 确保文字清晰可见
3. 避免过度倾斜或变形
4. 充足的光线和对比度
智谱 AI 对 API 调用有频率限制。如果遇到"请求过于频繁"的错误，请稍后再试。建议合理使用 AI 功能，避免短时间内大量调用。