常见问题¶

API 与提供商¶

可以。每个提供商支持多个命名密钥。点按单选按钮切换活跃密钥。适合在工作/个人密钥之间切换或保留备用密钥。详见 API 提供商。

前往设置 → 提供商 → + 添加自定义提供商。输入名称和 Base URL。任何兼容 OpenAI 的端点都可以使用。详见自定义提供商。

Agora 支持 GGUF 格式的聊天和嵌入模型。聊天模型需要能装入设备内存（1–8B 参数量，取决于 RAM）。嵌入模型更小（100–500 MB）。详见本地模型。

通过设置 → 提供商 → Local → 导入 GGUF 模型 导入 GGUF 聊天模型。如需完全离线的语义搜索，还需要导入 GGUF 嵌入模型。无需网络连接。

本地推理在设备 CPU 上运行，天然比云端 API 慢。建议：使用较小的模型（1–3B 参数）、较低量化（Q4_K_M）、较短的上下文窗口、关闭后台应用。

常见原因：

关键词搜索匹配精确文本。RAG（语义搜索）按含义匹配 — "数据库设置" 可以找到 "Room 配置"，即使没有共同词语。RAG 需要嵌入模型和已缓存的消息。详见对话搜索。

活跃记忆 是随每次 API 调用一同发送的单一持久上下文 —— 模型始终能看到它。已保存记忆 是一组命名文件，模型按需搜索和检索。活跃记忆用于持久事实；已保存记忆用于参考资料。详见记忆与缓存。

可以，如果你在设置 → 记忆中启用了 访问已保存记忆 和/或 访问活跃记忆。模型可以通过工具调用创建、读取、编辑和删除记忆。所有权限默认关闭。

在目标机器上部署 Conch 服务器，然后在设置 → Shell 中添加设备，填入 URL 和 API 密钥。详见远程 Shell。

是的。Conch 使用 ECDH 密钥交换 + AES-256-GCM 加密 + HMAC-SHA256 签名。Agora 与 Conch 服务器之间的所有流量均为端到端加密。

前往设置 → 数据控制 → 导出数据。选择类别并导出为 .agora 文件。将其保存在安全的地方。详见数据迁移。

可以。从 ChatGPT 或 Claude 导出数据（它们提供 .zip 文件），然后在设置 → 数据控制 → 第三方 中导入。支持合并和替换两种策略。详见数据迁移。

可选。导出界面允许你切换是否包含 API 密钥。启用时会有警告提示。密钥以明文形式存储在 .agora 文件中，因此仅在完全设备迁移且信任目标时包含。

所有数据存储在 Android 设备的 Room 数据库中。Agora 没有服务器、没有云同步、没有遥测。消息直接从你的设备发送到你配置的 AI 提供商。

支持。应用 UI 支持 English 和中文。设置 → 语言。切换后需要重启。

在 GitHub 上提交 issue。贡献方式见 README 的 Contributing 部分。