AB
AiBoss
チュートリアル

Elephas

チュートリアル

用 Elephas 建立本地知识库并让回答引用原文

Elephas 是一款运行在 Mac 上的知识库问答工具:把 PDF、Word、文本、Markdown 拖进工作区,它会在本机建立索引,回答问题并给出可点击跳转的原文引用。本文按安装、选择 AI 处理模式、创建工作区、导入文档、提问、跨应用调用 Super Command 的顺序,讲清从零到跑通一条引用链的完整流程,并说明离线模式、自带密钥、索引与配额等需要注意的地方。

Elephas 解决的是一个很具体的问题:手头有一堆 PDF、Word、文本和 Markdown 文件,想直接对它们提问,并且希望答案能指回原文的哪一段。它把文档索引放在本机完成,回答时检索相关段落再生成内容,并附上可点击的引用。适合在 Mac 上做资料整理、项目调研、会议记录归档的人,也适合需要把个人文档变成可检索问答库的用户。站内工具页见 Elephas。

下面按实际操作顺序展开:安装并激活、选择 AI 处理模式、创建工作区、导入文档、提问并验证引用,最后用一个完整示例把整条链路跑通。文中涉及价格、配额、版本与功能可用性的部分,请以官网当前信息为准。

准备工作

设备与系统

Elephas 是 Mac 应用,从 Mac App Store 或官网下载安装。离线 AI 模式对硬件有明确要求:需要 Apple Silicon 芯片(M1 或更新)。如果你用的是 Intel 机型,离线模式不可用,只能走云端模式或自带密钥模式。

账号与授权

安装后打开应用,先完成一段简短的引导流程。如果你是通过官网直接购买授权,需要手动激活:打开偏好设置(齿轮图标,或快捷键 Cmd + ,),进入 License 一栏,填入欢迎邮件中的授权密钥。通过 App Store 订阅的版本一般随账号生效,不需要单独填密钥。

决定用哪种 AI 处理模式

这一步建议在导入文档之前想清楚,因为它决定了数据流向。Elephas 提供三种模式,可以在设置中随时切换:

  • 离线 AI(Offline AI):在 Mac 本地运行模型,数据不离开设备。需要 Apple Silicon(M1 或更新)。
  • 云端 AI(Cloud AI):通过安全反向代理调用 OpenAI 或 Claude 的 API,数据不会被用于训练。
  • 自带密钥(Bring Your Own Key):直接接入你自己的 OpenAI、Claude 或 Gemini API 密钥,由你的账号承担调用。

三种模式的差别不只是隐私,还包括可用模型、响应速度与费用归属。自带密钥模式下,API 用量计费发生在你自己的服务商账号上;云端模式的额度与套餐绑定。具体额度与计费规则以官网当前信息为准。

准备好要导入的资料

支持的文件类型包括 PDF、Word 文档、纯文本和 Markdown。导入前把文件按主题归拢好,后面建工作区时会省事很多。如果资料分散在 Apple Notes、Notion 或 Obsidian 里,也可以先不导出文件,改用集成面板连接。

操作步骤

第一步:安装并打开

从 Mac App Store 或官网下载 Elephas,打开应用,按提示走完引导流程。如果是直接购买授权,接着进入偏好设置激活:

打开偏好设置:齿轮图标,或 Cmd + ,
进入 License
粘贴欢迎邮件中的授权密钥

激活成功后,主界面左侧会出现侧边栏,这是后续所有操作的入口。

第二步:选择 AI 处理模式

在设置中找到 AI 服务商配置区域,选择离线、云端或自带密钥之一。选择自带密钥时,需要填入对应服务商的 API 密钥;选择云端时,按提示完成账号侧的准备。切换模式不需要重建工作区,已导入的文档仍然可用。

如果资料涉及敏感内容,优先考虑离线模式;如果机器不是 Apple Silicon,则只能在云端与自带密钥之间选择。

第三步:创建工作区

在侧边栏点击 New Brain,创建一个工作区(Super Brain)。名字要能一眼看出内容范围,例如「Project Research」或「Meeting Notes」。工作区是文档、对话与上下文的边界:提问时 Elephas 只在这个工作区的资料里检索。

因此按主题拆分工作区比把所有文件堆在一个里面更有效。项目调研、会议记录、个人笔记各建一个,检索精度和回答质量都会更稳定。

第四步:导入文档

把 PDF、Word、文本或 Markdown 文件直接拖进工作区。Elephas 会在你的 Mac 上本地完成索引。索引需要一点时间,文件越多、越大,等待越久;索引完成前提问,可能检索不到刚导入的内容。

除了拖拽文件,还可以从集成面板连接外部来源:

  • Apple Notes
  • Notion
  • Obsidian

连接后这些来源的内容会进入工作区,参与检索。集成是否可用、支持的范围,以官网当前信息为准。

第五步:提问并核对引用

在聊天区输入问题。Elephas 会先在你的文档里检索,找到相关段落,再基于这些段落生成回答,并在答案中标注来源。点击任意引用,可以跳转到原始文件中的对应段落。

这一步的关键动作是点开引用核对。引用机制的价值在于可验证:答案里的每个论断都应该能落到某一段原文上。如果某个说法点不到对应段落,就把它当作待确认内容,而不是结论。

第六步:用 Super Command 跨应用调用

Super Command 让你不切换窗口就能用上工作区的上下文。默认快捷键是 Ctrl + Space,也可以在设置里改成自己习惯的组合。在任何应用里按下快捷键,输入问题,Elephas 会用工作区的内容作答。

Super Command 还能反向使用:把当前内容添加进某个 Brain。这样在写文档、读网页、整理笔记的过程中,可以随手把材料归入对应工作区,不必回到主界面操作。

第七步:按需开启 Agentic Mode

Agentic Mode 是一个可切换的选项。开启后,Elephas 会针对一个提问检索已连接的来源、执行内部查询,并进行多步推理,而不是只做一次检索加一次生成。适合问题需要跨多个来源拼合答案的场景。关闭时则是常规的单轮检索问答。

一个完整示例

下面用一个最小可跑通的场景走完全流程:把三份项目资料变成可引用问答的知识库。

场景设定

  • 机器:Apple Silicon Mac
  • 资料:requirements.pdf、meeting-notes.docx、decisions.md
  • 目标:问出「项目最终确定了哪些范围变更」,并让答案指回原文

操作过程

  1. 安装 Elephas,打开应用,走完引导。若为直接购买,进入偏好设置 → License,填入授权密钥。
  2. 在设置中选择 AI 处理模式。本例选离线 AI,数据不出本机;若机器不是 Apple Silicon,改选云端或自带密钥。
  3. 侧边栏点击 New Brain,命名为 Project Research。
  4. 把三个文件拖入 Project Research,等待本地索引完成。
  5. 在聊天区输入:项目最终确定了哪些范围变更?请列出并注明出处。
  6. 阅读回答,逐条点击引用,确认每条变更都能跳到 requirements.pdf 或 decisions.md 中的对应段落。
  7. 发现 meeting-notes.docx 里有一条讨论未被引用,追加提问:会议记录里关于范围变更还有哪些未决讨论?
  8. 在写周报时,按 Ctrl + Space 唤起 Super Command,直接问:用三句话总结 Project Research 里的范围变更结论。

结果检查

跑完后应该得到三样东西:一个只包含本项目资料的工作区、一组带可点击引用的回答、一个能在任意应用里调用的快捷入口。如果引用点不开或指向错误段落,先检查索引是否完成,再确认文件是否真的进入了当前工作区。

注意事项

离线模式的硬件门槛

离线 AI 需要 Apple Silicon(M1 或更新)。Intel Mac 无法使用该模式,这是硬性限制,不是设置问题。

索引在本机完成,但需要时间

文档索引在 Mac 本地进行。刚拖入文件就提问,可能检索不到新内容。批量导入大量 PDF 时尤其要留出索引时间。如果长期检索异常,可参考官方的索引问题排查思路:确认文件已进入正确的工作区、索引是否完成、文件格式是否受支持。

配额与额度

云端模式与套餐额度相关,可能出现「超出当前配额」的提示。遇到这类提示时,检查套餐状态与用量,或切换到自带密钥模式由自己的 API 账号承担调用。具体配额数值与套餐内容以官网当前信息为准。

自带密钥的费用归属

使用自己的 OpenAI、Claude 或 Gemini 密钥时,调用费用计入你自己的服务商账号,与 Elephas 的订阅是两套计费。切换模式前先确认这一点,避免误判成本。

数据存储与敏感内容

三种模式的数据路径不同:离线模式数据不离开设备;云端模式通过安全反向代理调用 API,数据不用于训练;自带密钥模式则取决于你所用服务商的政策。处理敏感资料前,先确认当前处于哪种模式。

工作区边界要清楚

提问只在当前工作区内检索。资料放错工作区,就会出现「明明导入过却答不出来」的情况。按主题拆分工作区,并在提问前确认当前选中的是哪一个。

跨设备同步

Elephas 在 iPhone 与 iPad 上也有对应版本,Mac 与 iPhone/iPad 之间通过 iCloud 同步。若出现同步异常,属于已知的排查类别,需要单独处理,不要与索引问题混为一谈。

版本差异

Elephas 存在新旧两代平台,界面与文档可能不同。安装前确认自己用的是哪一版,按对应版本的说明操作。功能、界面与可用性以官网当前信息为准。