Elton AI
就住在你的库里的语音与文字助手。它能搜索你的笔记，并根据笔记回答问题，还能创建笔记、归档笔记——可以用语音、打字，也可以在手机上使用。
⚡ 快速开始——四步
- 安装插件：在 Obsidian 的插件目录中操作：第三方插件 → 浏览 → 搜索“Elton AI” → 安装 → 启用。
- 接上“大脑”——粘贴一个 AI API 密钥（Elton AI 提供商、OpenRouter、OpenAI 或本地模型均可）。
- 连接 Telegram 机器人——可选，用于在手机上给助手发消息。
- 打开 Connector——同样可选：打开后，你就能通过手机应用访问你的库，无需应用商店，也无需同步。
这样就可以用了。其余的由你决定：为智能搜索建立索引、语音、场景。
💰 费用
插件本身免费且开源。你只需为“大脑”——AI 模型——付费：
- Elton AI——自家的提供商，490 ₽ 起（约 1 点数 ≈ 1 ₽），密钥可直接从 Telegram 机器人获取；
- 你自己的密钥，用于 OpenRouter 或 OpenAI——直接向它们付费；
- 本地模型——免费，一切都在你的电脑上运行。
为智能搜索建立索引的费用只需几分钱。
不是聊天机器人——而是你的库里的智能体。
它能听懂你的需求，自己找到合适的笔记，把事情做完——并附上来源链接展示结果。
插件本身不附带任何密钥：每个请求都直接发给你选择的提供商。使用本地模型时，则完全不会有任何数据外传。
完整演示——两分钟看完全部：语音、库内搜索、对笔记的操作。
📺 YouTube 视频演示
下面是完整指南
按顺序讲解一切：安装、每一项设置、场景、Telegram 机器人、付款与隐私。如果你赶时间，上面的快速开始就够了。想了解细节，请顺着目录往下看。
它是什么，适合谁
Elton AI 是 Obsidian 的一个插件。插件是嵌入程序的小型附加组件，能让程序多出一项新功能。
它位于笔记旁边的侧边栏中。你说话或打字，它就会搜索你的库，并按你的要求去做。
不确定 Obsidian 是什么？
先看看“Obsidian 全解”板块——基础知识都在那里：笔记、链接、文件夹。装好程序之后再回到这里。
插件是免费的。你只需为“大脑”——替它思考的 AI 模型——付费。提供商由你自己选择，共有四种选择，详见连接一节。
它同时支持桌面端和手机。唯一的例外是 Telegram 标签页：它只能在电脑上设置。
工作原理——写给新手
没有技术背景也别担心？展开你需要的那一块 👇。如果你已经清楚基于文件的笔记和模型是什么——直接跳到安装。
📄 笔记就是磁盘上的文件
Obsidian 的库就是你电脑上的一个普通文件夹，里面的每条笔记都是一个文本文件，用记事本都能打开。它不是云服务，也不是数据库。所以助手读取的是和你一样的文件，而不是“连接到你的账号”——隐私保障正源于此。
🔗 链接与图谱——为什么笔记不是杂物抽屉
[[双括号]]能把一个词变成指向另一条笔记的链接，这些链接汇聚起来就成了图谱——你思考的地图。助手会顺着链接把整个主题收集起来，而不是只根据随便某一个文件作答。哪怕嫌麻烦，也请多加链接——每个链接都在告诉它：这些笔记是相关的。
🧠 按含义搜索，而不是按字词
普通搜索找的是字符：搜“productivity”找不到“efficiency”。按含义搜索则会把每条笔记转换成一串数字——即嵌入向量（embedding）——比较的是含义，而不是拼写。所以搜“how to stop putting things off”就能找到“fighting procrastination”。字词搜索也仍然保留——始终开启，而且免费。
⚙️ 什么是索引（为什么只要几分钱）
要让智能搜索生效，每条笔记的这些数字都得先算一遍——这就是索引。只需做一次，之后只会补充新增和修改过的笔记。费用方面只需几分钱：文本只发送给提供商一次，成本真的只有几分钱。正因为这是一次性的外发，按含义搜索默认是关闭的。
🤖 模型都有哪些类型
模型就是“大脑”：它读你的问题并写出回答（插件本身不是模型，它是去调用模型）。模型在聪明程度、速度和价格上各不相同——通常三者只能占其二。聪明的（
claude-sonnet、gpt-5.5）能搞定复杂任务；又快又便宜的（claude-haiku、gemini-flash）很适合日常琐事。插件可以同时配两个：聪明的负责回答，快的负责搜索。
🔊 为什么声音差别这么大
语音是一个独立的“文字 → 声音”程序，共有三种——选择时总要有所取舍。云端的听起来最自然，但每一句话都要外发并消耗 token。系统自带的免费且可离线使用，但很机械。Piper 居中：它直接在你的 CPU 上合成语音，免费且不外发任何内容，听起来也比系统语音更像真人。
🔒 哪些会外发，哪些绝不会
为了回答问题，助手只会把它需要的笔记片段发给提供商——而不是整个库。随之一起发送的还有文件夹结构图，以及你设置的上下文笔记（如果有的话）。你的私密文件夹里的内容绝不会外发：对助手来说，它们根本不存在。想要完全零外发——请使用本地模型。
⏱️ 为什么需要等一会儿是正常的
从你提问到出现第一个字符之间，大约要等一秒半：这段时间里，助手要理解请求、进入你的库读取笔记，然后才开始写。普通聊天只做最后一步，所以显得更快。库的大小几乎没有影响——作者的实测数据：只有一条笔记时是 1.25 秒，带上约 1.2 万字符的内容时是 1.36 秒。停顿一段时间后的第一次回答总是慢一倍——那是连接在预热。
三步安装
插件已上架 Obsidian 官方目录
你可以像安装其他插件一样安装它——直接在应用内完成，无需手动下载任何东西。
视频中——完整流程一步到底：第三方插件 → 浏览 → 搜索 → 安装 → 启用：
这个插件目录与 Obsidian 中所有其他第三方插件在同一个位置打开。
首次运行向导
启用插件后，它会自动打开向导，一共四个简短的界面：介绍、服务商、助手名称、权限。
走一遍向导比手动翻设置更快，而且在这里选的内容之后都可以改。
视频中，按顺序演示向导的全部四步：
你可以随时重新打开向导
在插件设置里，每个标签页上方都有一张 “从哪开始”（С чего начать） 卡片，上面有一个 “打开分步设置” 按钮。这是新手最快的上手路径：服务商、名称、权限，两分钟搞定。
除了图标，插件还会在 Obsidian 命令面板中添加这些命令：“打开面板”、“开始对话”、“打开分步设置”、“运行场景”，以及 “就选中的文本提问”。
只要你用鼠标选中了一段文字，编辑器的右键菜单里还会出现 “询问助手” 这一项。
面板：反应堆与文本
面板有两种视图。你可以随时用标题栏里的按钮在两者之间切换，对话不会丢失。底层引擎是同一个：相同的工具、相同的权限、相同的搜索。
视频中，演示两种模式以及切换按钮：
这是同一场对话
切换不会重置对话：先在反应堆里用语音聊起来，再切到文本，就能读到它刚才说的话。
麦克风模式（自由说话，或按住按钮说话）是在 面板自己的标题栏 里切换的，而不是在设置里，不必再去设置里翻找。
按顺序看设置：全部八个标签页
设置项大约有六十个，但它们被分在八个标签页里，每个标签页只负责一件事。顺序如下：
连接 → 助手 → 语音 → 库 → 任务 → Telegram → 连接器 → 界面 (Подключение → Ассистент → Голос → Хранилище → Задания → Telegram → Интерфейс)
下面就严格按这个顺序，逐项讲解：它是什么、有什么作用、该设成什么，以及为什么。
就在这里点一点
这不是一张图片。点击左侧的标签页，你就能看到每个标签页上实际有什么。
1. 连接 (Подключение)
第一个标签页。插件就是在这里得知该向谁要答案的。没有它，一切都无法运行。
AI 服务商 (Провайдер ИИ)
请求发往哪里。一个下拉菜单,共四个选项,默认是 Elton AI。
| 服务商 | 你需要什么 | 适合谁 |
|---|---|---|
| Elton AI | 从 Telegram 机器人获取的密钥 | 立即可用:无需自己的账号,无需外国银行卡,无需额外工具 |
| OpenRouter | 你自己的密钥 | 数百种模型,按用量付费 |
| 本地模型 | 你电脑上的 Ollama 或 LM Studio | 注重隐私:任何内容都不会离开设备 |
| OpenAI | 你自己的密钥 | 直连源头 |
视频里依次演示了这四个服务商:各自需要什么,适合谁:
四者使用同一套协议,所以切换服务商时,其余设置都会保留。
切换服务商会改变相邻的字段
选择 Elton AI 时,地址字段会完全消失。选择本地模型时,密钥字段会消失,并出现一个“语音云端”区块。之前从旧地址拉取的模型列表会被重置,这是正常现象。
💡 四个选项里,为什么大家会选 Elton AI
- 立即可用。 机器人一分钟就能发给你一个密钥,模型也已经选好并测试过,不需要比较、挑选或配置。
- 用卢布付款,无需 VPN。 没有外国账号,没有海外银行卡,任何一步都不需要 VPN。
- 一个余额通用。 插件、Telegram 机器人、手机应用和网站都花同一个余额。这不是订阅制:用多少扣多少,剩下的不会过期。
- 回答你的人,就是写它的人。 服务商和插件出自同一位作者。出了问题,没人会对你说“这是插件开发者的事”,因为开发者就是同一个人。
- 新用户有优惠码。 它会给你一些额度,让你先试用再决定,不用先充值。
什么时候选别的才是诚实的做法。 如果你已经在付费使用 OpenRouter 或 OpenAI 的密钥,那就继续用,插件对它们的支持完全一样。如果你要求一个字都不能离开你的电脑,那只能用本地模型,任何服务商都帮不上忙。
该怎么选。 如果你不想注册外国账号,选 Elton AI。如果你在意一个字都不能离开电脑,选本地模型。
API 密钥 (API-ключ)
一个用圆点遮住的字段。密钥是一长串密码式的字符,用来告诉服务商这是谁发来的请求,该向哪个账户计费。
插件里的提示很坦诚:密钥会以明文保存在这个库的插件文件夹里,和任何 Obsidian 插件一样。这不是加密,只是一个普通文件。
不要把密钥放在会公开分享的库里
如果你的库同步到了共享仓库或共享文件夹,密钥也会一起被带过去。更多内容见隐私一节。
本地模型没有这个字段:它不需要密钥。
服务器地址 (Адрес сервера)
到底该往哪里“敲门”。一个普通的文本字段。
Elton AI 服务商没有这个字段,地址已经内置在服务里,无需修改。
其他服务商都预先填好了默认值:OpenRouter 是 https://openrouter.ai/api/v1,OpenAI 是 https://api.openai.com/v1,本地模型是 http://localhost:11434/v1。
使用本地模型时
Ollama 的默认地址是
http://localhost:11434/v1,LM Studio 的是http://localhost:1234/v1。如果你没有改过端口,就保持原样。
模型 (Модель)
负责撰写回答和调用工具的那个模型。一个下拉菜单加一个刷新按钮。
模型必须支持工具调用
“工具调用”指模型不只是会说话,还能去“按按钮”:搜索、阅读、创建笔记。没有这项能力,助手只能聊天,根本看不到你的库。
视频里一眼就能看出区别:没有工具的模型只会推理,有工具的模型会走进库里:
下面目录中的每个模型都支持工具调用。只有你通过“其他模型……”自己输入的,或者在本地启动的模型,才需要你手动检查。
Elton AI 和 OpenRouter 的目录是一样的:
| 模型 | 列表中的标签 |
|---|---|
anthropic/claude-sonnet-4.6 | 聪明,平衡性最佳 |
anthropic/claude-sonnet-4.5 | 久经验证,稍便宜一些 |
anthropic/claude-haiku-4.5 | 快速且便宜 |
openai/gpt-5.5 | 聪明 |
openai/gpt-4.1-mini | 快速且便宜 |
google/gemini-3.5-flash | 最快 |
google/gemini-2.5-pro | 上下文很大 |
deepseek/deepseek-chat | 最便宜 |
OpenAI 有自己的一组模型:gpt-5.5、gpt-4.1、gpt-4.1-mini、gpt-4o-mini。
本地模型完全没有目录,只有一个输入框和一个“刷新”按钮,点击后会向 Ollama 本身请求模型列表。默认值是 qwen2.5:3b。
该怎么选。 Elton AI 和 OpenRouter 默认使用 anthropic/claude-sonnet-4.5,这是个不错的起点。想要更好的效果,选 claude-sonnet-4.6。想省钱,选 claude-haiku-4.5。
模型标识符 (Идентификатор модели)
只有当你在列表中选择“其他模型……”时才会出现,或者在完全没有目录的情况下出现。
请严格按照服务商那里的模型名称来写,例如 anthropic/claude-sonnet-4.6。
用于搜索的快速模型 (Быстрая модель для поиска)
找到合适的笔记,需要做很多细小的判断。快速模型做这些判断并不比聪明的模型差,而且大约快三倍。最终的回答仍然由你在上面选定的模型来写。
默认值是**“自动”**。也就是说,Elton AI 和 OpenRouter 使用 google/gemini-2.5-flash,OpenAI 使用 gpt-4.1-mini。
本地模型没有这个设置:反正一张显卡也跑不动第二个模型。
该怎么选。 保持“自动”即可。“关闭,所有任务使用同一个模型”这个选项,只适用于你希望行为完全可预测的情况。
显示费用 (Показывать стоимость)
一个开关,默认开启。每条回答下面会出现一行不显眼的小字:从你的余额里扣了多少,消耗了多少 token。
至少在第一周保持开启,这样你就能知道长对话实际花了你多少钱。
测试连接 (Проверить связь)
一个按钮。它会发送一条简短的请求,然后如实告诉你“连接正常”,或者显示错误信息。
粘贴完密钥后马上点一下。这比猜测助手为什么没反应要快得多。
边写边显示回答 (Показывать ответ по мере написания)
藏在可折叠的**“高级”标题下面,默认开启**。
回答会一个词一个词地出现,而不是等到最后一次性全部显示。如果服务商不支持这种方式,插件会自动回退到普通模式。
语音云端 (Облако для голоса)
一个单独的区块,只在选择“本地模型”服务商时才会出现。默认关闭。
本地模型既不能识别语音,也不能合成语音,它只处理文本。打开这个区块并填入云端密钥:语音功能就能用了,而文本仍然留在本地。
里面有两个字段:服务商(除本地模型之外的任意一个)和它的 API 密钥。
本地模型:用硬件换隐私
本地模型是一个完全在你电脑上运行的“大脑”。你需要用一个单独的程序来启动它:Ollama 或 LM Studio。
它不需要密钥,没有账单,也不需要联网。你笔记里的任何内容都不会离开设备。
代价是:它靠你的显卡来思考。因此有一些限制,回答更慢,质量也不如大型云端模型。
视频里做了一个诚实的对比:你得到了什么,又付出了什么:
小模型更不擅长调用工具
模型越小,就越常只用文字回答而不去行动。如果你的本地助手只会“描述它打算做什么”,却不去碰你的库,那就换一个更大的模型。
适合谁。 笔记里有绝不能外泄的内容,而且机器性能足够强的人。
不适合谁。 只想打开就用的人:光是配置 Ollama,就够你折腾一个晚上了。
2. 助手 (Ассистент)
第二个标签页讲的是它认为自己是谁,以及它如何与你交谈。共有五个字段,全部可选。
它叫什么名字? (Как его будут звать?)
一个文本字段,默认值是 Assistant。它会用这个名字回应你,也会用它来做自我介绍。
选一个简短、好念的名字。名字太长,到第三天你就念烦了。
它该怎么称呼你? (Как обращаться к вам?)
填你的名字,这样它就不会那么冷冰冰。留空则保持匿名。默认为空。
角色性格（Характер）
一个下拉菜单，有四个选项：冷静精确（默认）、温暖健谈、简短直接、自定义。
每个预设都会往系统提示词里插入一句现成的话，这句话决定了每条回答的语气。
自定义性格（Свой характер）
一个四行的大输入框。只有当”角色性格”选为**“自定义”**时才会出现。
这里的文字会完全取代预设。用大白话写就行：“回答要简短，不要开场白，总是给出下一步建议”。
回答长度（Длина ответа）
一个下拉菜单，有三个选项：简短（几段话）、正常（完整的讲解，默认）、详细（细致而透彻）。
这是预算，不是硬性截断
如果一条回答放不下，剩下的部分会被补充进来并衔接上去，句子绝不会在半个词处断掉。只是长回答会消耗更多 token，而 token 就是钱。
上下文笔记（Заметка с контекстом）
一个填写库内路径的输入框，旁边有一个**“创建这篇笔记”**按钮。
助手会在每次回答之前先读这篇笔记：你的项目、你的目标、你习惯怎样的措辞。有这样一篇笔记，能省掉一半的追问。
每次请求都会发送给服务商
插件会在输入框正上方用红字提醒这一点。千万不要在里面写密码、密钥、财务或医疗数据，也不要写别人的信息。
别把它和”关于你的系统，还有什么值得一提”这个字段混淆——那个字段在库标签页上，描述的是你的文件夹如何组织，而不是你这个人。
3. 语音（Голос）
第三个标签页。在这里决定它是否能听到你说话，以及是否开口回答。
语音回复（Ответы голосом）
一个开关，默认开启。决定是否把回答大声读出来。
如果关掉，从”语音引擎”往下的所有内容都会从屏幕上消失。但语音语言和快捷键会保留：即使助手不对你说话，你也可以对它说话。
你说话使用的语言（Язык, на котором вы говорите）
一个下拉菜单：“与界面相同”（留空，默认）、俄语、英语。
只有一种情况需要改：你用一种语言阅读插件，却用另一种语言说话。
按住按键说话（Зажать клавишу и говорить）
这是一个分区标题，下面是快捷键。默认未设置。
它在 Obsidian 的任何地方、任何笔记里都能用。按住，说话，松开——如果面板是关着的，它会自己打开。
插件是直接监听快捷键的，所以你不用输入，而是要按下它：点”设置”按钮，然后按下你想要的组合键。旁边的垃圾桶图标可以把它关掉。
视频演示实际效果：按住、说话、松开：
这是这个标签页里最有用的设置
它排在语音引擎之前，是因为即使关闭语音回复它也能用。选一个还没被占用的修饰键组合即可。
语音引擎（Движок озвучки）
一个下拉菜单，有三个选项：
- 云端语音——音质最好，会消耗 token。默认选项。
- Piper——本地运行，声音逼真，直接在 CPU 上合成语音。免费。
- 系统语音——免费且可离线使用，但听起来有机械感。没有自己的设置项。
Piper 服务器地址（Адрес сервера Piper）
只有选择 Piper 引擎时才会出现。默认是 http://localhost:5000。
Piper 以一个小型本地 HTTP 服务器的形式运行。除非你改过端口，否则保持原样即可。
云端语音（Облачный голос）
只有选择云端引擎时才会出现。可选的声音列表取决于你的服务商——这一点很重要。
对于 Elton AI、OpenRouter 和本地模型（通过”语音云端”区块），可用的有：Puck（默认）、Charon、Kore、Fenrir、Aoede、Leda、Orus、Zephyr。
OpenAI 则是完全不同的一组：alloy、echo、fable、onyx、nova、shimmer。
切换服务商时，插件会在加载时自动修正不兼容的声音，不必慌张。
怎么设置。 选 Puck。它很有活力，读俄语也很好。
语速（Скорость речи）
一个滑块，范围 0.6 到 1.6，默认 1.1。比日常说话稍快一点，这样回答不会拖沓。
试听声音（Проверить голос）
一个按钮。无需开始对话，就能听到所选的声音。
“高级”选项下
| 设置 | 作用 | 默认值 |
|---|---|---|
| 允许打断 | 它回答时你开口说话——它会安静下来并开始倾听 | 关 |
| 打断灵敏度 | 数值越低，它越快让出话头。如果背景噪音总是打断它，就调高一些 | 8（范围 3–25） |
| 等待提示音 | 回答准备期间发出轻柔的提示音，让沉默不会被当成卡死 | 开 |
| 等待提示音音量 | 一个滑块加一个”播放”按钮 | 0.28 |
| 自定义等待提示音 | 来自你的库的 .wav 文件。要短一些：它每隔几秒就会重复一次 | 空 |
为什么"允许打断"默认关闭
它说话时，麦克风是一直开着的。如果用扬声器（而不是耳机），它会听到自己的声音，在第一句话就安静下来。戴耳机的话可以打开。
无论如何，你随时都可以点击反应堆图标来打断它。
4. 库（Хранилище）
第四个标签页是最重要的。在这里决定助手可以做什么、把笔记放在哪里、它对笔记了解多少，以及去哪里搜索。
这里不是一排开关，而是四块方形卡片。每块卡片上显示名称和表示当前状态的”标签”。点击卡片会打开一个单独的窗口。
“它可以做什么”窗口（Что ему можно）
窗口顶部有一段值得一读的提示：“关闭的权限并不是请助手自觉遵守：对它来说，这个工具就是不存在了。你没法说服它做任何事。”
“笔记”部分
| 设置 | 作用 | 默认值 |
|---|---|---|
| 读取笔记 | 搜索和阅读。没有它，助手只能聊天——看不到你的库 | 开 |
| 创建笔记 | 新建笔记 | 开 |
| 编辑笔记 | 修改已有的笔记。每次编辑前都会先备份一份，所以”撤销”永远有效 | 开 |
| 删除笔记 | 即使开启，每次删除也都要等你在键盘上确认 | 关 |
| 每次编辑都确认 | 在任何写入之前都询问，而不只是删除前。更安全，但更慢 | 关 |
想掌控一切——就开启，而不是关闭
如果把编辑交给助手让你不放心，正确的做法是打开**“每次编辑都确认”**，而不是关掉”编辑笔记”。这样它什么都能做，但没有你的同意什么也不会做。
“你的屏幕”部分
管理标签页和窗口——默认开启。它让助手可以并排打开笔记、直接在你的库里打开网页，以及关闭你用完的标签页。它不会动自己的面板，而且关闭多个标签页仍然需要确认。
这是所有权限中范围最广的一个
除了标签页，它还让助手能够运行任何 Obsidian 命令，包括其他插件的命令。很方便——但也值得弄清楚你同意的是什么。
如果这项权限开着，而 Obsidian 内置的”网页浏览器”插件是关着的，插件会立刻提醒你：网页将在你平时用的浏览器中打开，而不是在库里打开。
“私密文件夹”部分——单独在隐私一节中介绍。它是这个页面上唯一最重要的设置。
“它可以在哪里工作”部分
一个下拉菜单：整个库（默认）、仅这些文件夹、除这些文件夹之外的全部。后两项会显示一个”文件夹”输入框——每行一个路径。
这个问题比隐私更窄：它日常在库的哪一部分工作。无论你在这里怎么选，私密文件夹都会保持隐藏。
这个范围限制对搜索同样有效：范围之外的笔记甚至不会出现在结果里。
「存放位置」窗口(Где что лежит)
窗口里的提示:“如果这几项留空,助手就只能靠猜——而猜测恰恰是项目笔记最后落在根目录、没有任何链接指向它的原因。“
| 设置 | 作用 | 默认值 |
|---|---|---|
| 新笔记文件夹 | 助手没想出更合适的位置时,新建的笔记会放在这里 | 留空 = 根目录 |
| 每日笔记文件夹 | 让它能回答”我昨天做了什么”。留空则取自 Obsidian 的日记设置 | 留空 |
| 模板文件夹 | 创建笔记之前,它会先读取匹配的模板。留空则向”模板”插件或 Templater 询问文件夹位置 | 留空 |
| 普通笔记的模板 | 助手在每次请求中都会看到它——所以它写出的笔记会带上你的属性和标题,而不是一段光秃秃的文字 | ”自行决定” |
“普通笔记的模板”只有在模板文件夹里找到内容时才会出现。窗口底部,插件会列出它找到的内容:“可用于创建笔记的模板:N 个”,以及这些模板的名称。
填好这三项,回答质量立刻提升
项目或书籍有各自的模板,它会自己找到。但对于”普通”笔记,如果没有提示,它就会按自己的方式来写。
在现成模板里,这一切都已经填好并配置到位。
「它对库了解多少」窗口(Что он знает о хранилище)
了解库的结构——一个开关,默认开启。它会把你的库的地图放进每一次请求:有哪些文件夹、里面放了什么、有哪些模板。
正是这一点,避免了它把项目笔记扔进根目录、再自己胡乱编一个格式。这张地图是根据 Obsidian 的文件列表生成的——不需要向模型询问任何内容。
窗口里会显示地图本身,以文本形式呈现——和随请求发出去的内容完全一致。值得至少看一次。
关于你的体系,还有什么值得让它知道的 — 一个五行的大输入框,默认为空。
看看上面的地图,把文件夹名称无法体现的内容补充进去。比如一句”项目放在 1. Projects 里,每个项目一篇笔记,并且总是从某个 MOC 链接过去”,就能省下十几次错误的猜测。
如果关闭地图,窗口里其余的内容都会消失。
这个插件是基于"系统"编写和测试的——也就是我现成的 Obsidian 库。
每一项功能,都先在那里用真实的笔记跑过,然后才进入正式版本。所以在"系统"里,助手一开始就是配置好的:
- 文件夹的命名正合它的查找习惯。库的地图一次就能读对——项目、书籍和收件箱放在哪里,根本不用再解释。
- 模板就位并已接好。它创建的笔记会带上你的属性和标题,而不是一段光秃秃的文字。
- 场景和自动化不是从零开始。晨间回顾、每周总结、收件箱清理——全都是为这套结构写的。
- 更新与支持。插件的每个新版本都会先在"系统"里验证,有问题可以在私密聊天里得到解答。
这个插件在空库和你自己的库上都能完美运行——"系统"只是帮你省去了配置的工夫和反复猜测。
来看看"系统" →「搜索与网络」窗口(Поиск и интернет)
“在你的笔记中”部分。 提示:“字词搜索始终可用:索引会在一秒内建好,不花钱,也不需要密钥。”
同时按语义搜索——一个开关,默认关闭。它能找到用不同的措辞表达了同一想法的笔记。
开启后,会把你整个库的文本发送给服务商
这是唯一一种成批外发所有内容的操作:每篇笔记都会向服务商发送一次,以便纳入索引。这一遍处理会消耗 token,也就是花钱。
详情以及应对办法——见隐私部分。
开启后,会出现一大段说明”什么是索引,用大白话讲”,下面是索引面板:索引中有多少篇笔记、排队中的有多少篇,以及一个**“为新笔记建立索引:N”**按钮。运行期间,这个按钮会变成”停止”。
“在笔记之外”部分
网络搜索——一个开关,默认开启。它可以上网查找:新闻、事实,以及一切不在你库里的内容。不过它仍会优先从你的笔记中作答。
结果数量——滑块,范围 1 到 10,默认 5。结果越多,回答越完整,每次搜索的价格也略高一些。
并非所有人都能联网
如果服务商既不是 Elton AI 也不是 OpenRouter,这两项都不会显示。插件会改为提示你需要在”连接”标签页切换到其中之一。
“不建立索引”部分——只有在开启语义搜索时才会出现。一个三行的大输入框。
填入不纳入索引的文件夹。如果你按名称提出要求,助手仍然会打开这类笔记——只是它们不会被成批发送出去。私密文件夹本来就会被排除,不必在这里重复填写。
“高级”下方——同样只在开启语义搜索时出现:
- 嵌入模型——默认是
baai/bge-m3。除非你清楚为什么要改,否则不要动它。 - 索引文件——已经有来自其他脚本的索引了?把路径指向那个
.json文件,它会原样被采用,无需重新建立索引,也不花钱。如果有其他程序在维护这个文件,插件只会追加新笔记,不会改写任何内容。
5. 任务(Задания)
第五个标签页。它包含两个子标签页:“按短语”(По фразе)和”按计划”(По расписанию)。
“按短语”——场景
场景就是藏在一句短语背后的一长段指令。 你说出这句短语,助手收到的就是整段指令,而不只是你说的那两个词。
短语是这样识别的:
- 单个词的触发词,只有你说的恰好就是它时才会触发;
- 两个词或以上的触发词,即使出现在较长的句子里也能被识别——“我在想什么”可以匹配到”嘿,我昨天在想什么”;
- 触发词前后说的其他内容,都会作为补充说明交给助手。
每个场景是一行,包含自己的 emoji、名称、触发词列表和三个按钮:▶ 立即运行、🗑 删除,以及开/关开关。点击该行会打开编辑窗口。
编辑窗口里有什么:
| 字段 | 说明 |
|---|---|
| 名称 | emoji 加文字。按钮上和机器人的菜单里就用这个名字 |
| 触发短语 | 用逗号分隔。说出其中任何一个,这个场景就会运行 |
| 它要做什么 | 指令本身,十行。就像你会大声提出请求那样,完整地写下来 |
| 显示为按钮 | 它会出现在反应器下方和空白聊天里——适合那些点一下比开口说更方便的日子。开启 |
如果机器人已连接,这里还会有一行:“在 Telegram 中,这个场景响应 /name”。
三个场景会自动创建
首次安装时,插件里已经有三个场景——已启用,并固定为按钮。
"我在想什么"
把你最近几天的日记笔记整理成一段连贯的叙述。触发词:想法、我在想什么、最近的想法。
"今天有什么安排"
今天的计划,加上昨天没做完的事。触发词:今天有什么安排、今日计划。
"解释这篇笔记"
用大白话解释当前打开的笔记。触发词:解释、总结笔记。
如果你把所有场景都删掉,它们不会自己回来——不过你随时可以从下面的列表里重新添加。
十六个现成的预设
点击 “添加场景” 按钮会打开列表。已经添加过的会标上“· 已添加”。
| 场景 | 触发词 | 它做什么 |
|---|---|---|
| ✨ 自定义场景 | — | 空白场景，所有内容都由你自己来写 |
| 📋 创建项目 | 创建项目、新项目、开始一个项目 | 先看看你的项目是怎么搭建的，读取模板，照着其他项目的样子创建一个新项目，并加到看板上 |
| ✍️ 整理这篇笔记 | 整理笔记、帮我整理一下 | 编辑当前打开的笔记：调整结构、标题，修复失效链接 |
| 🧭 接下来做什么 | 接下来做什么、我该做点什么 | 最多给出三个具体的下一步行动，并附上理由 |
| 📚 带我了解情况 | 带我了解情况、我对……了解多少 | 把与指定主题有关的所有内容汇总成一份连贯的简报 |
| 💭 我在想什么 | 想法、我在想什么 | 复述你最近几天的日记 |
| 📅 今天有什么安排 | 今天有什么安排、今日计划 | 今天的计划，外加昨天没做完的事 |
| 🌙 今日收尾 | 今日收尾、总结今天 | 一份今天的总结，外加一个值得思考的问题 |
| 📊 本周收尾 | 本周收尾、这周过得怎么样 | 回顾这七天，并给出下一周要做的一件事 |
| 📥 整理收件箱 | 收件箱、整理我的收件箱 | 把收件箱里的内容分成“丢掉 / 归档 / 真正的想法”三类。它自己不会移动任何东西 |
| 🧵 未完成的事 | 未完成的事、我有什么没做完 | 找出开了头却被搁置的事 |
| 📖 讲讲这篇笔记 | 讲讲、总结这篇笔记 | 用通俗的话解释当前打开的笔记 |
| 🔗 寻找关联 | 寻找关联、这和什么有关 | 找出那些讲的是同一件事、只是措辞不同的笔记 |
| 🎓 考考我 | 考考我、我还记得什么 | 一次只问一个问题，等你回答后再继续 |
| 🕸 被遗忘的笔记 | 我忘了什么、被遗忘的笔记 | 与当前主题相关、但你很久没碰过的笔记 |
| ✍️ 起草初稿 | 起草初稿、收集素材 | 把某个主题的素材汇集成一份草稿，并标出缺口 |
“整理收件箱”——效果如下
它会读完所有堆积的内容，并把它们分成三堆。它自己不会移动任何东西——决定权在你手里。
“按计划执行”——自动化
这类任务会在你设定的时间自动往库里写入内容。每一项都是助手在回答一条保存好的请求。
自动化列表中的每一行会显示 ⏰ 和名称，下面是时间、星期、✈️（如果会发送到 Telegram）以及状态：“已关闭”“今天已运行”“时间到了——一分钟内运行”“等待中”。
编辑窗口里有什么：
| 字段 | 说明 | 默认值 |
|---|---|---|
| 名称 | 它在列表中的显示名称 | 取自预设 |
| 时间 | 时和分 | 09:00 |
| 星期 | 七个按钮，周一到周日。一个都不选表示每天 | 每天 |
| 写入位置 | 写入今天的日记，或写入一篇新笔记 | 写入日记 |
| 章节标题 | 写在日记中的这个标题下面。仅在写入日记时有效 | 取自预设 |
| 文件夹 | 新笔记存放的位置。仅在写入新笔记时有效 | 空 |
| 请求 | 助手要做的事。使用的工具与普通聊天相同 | 取自预设 |
| 在窗口中显示结果 | 完成后在窗口中打开回答。对于在你睡觉时运行的任务，可以关掉 | 开 |
| 完成后通知 | 弹出一条通知 | 开 |
| 同时发送到 Telegram | 结果会发到聊天里，同时仍会写入库中 | 关 |
新建的自动化默认是关闭的
你需要手动用开关把它启用。“为什么什么都没收到”常常就是这个原因。
另外：在连接机器人之前，“同时发送到 Telegram”是无法使用的。
三个现成的预设：
| 预设 | 时间 | 写入位置 | 它做什么 |
|---|---|---|---|
| 晨间摘要 | 每天 08:30 | 写入日记 | 根据昨天的笔记和最近 2–3 天的记录，生成一份简短的早晨简报 |
| 近期想法汇总 | 周一 09:00 | 写入新笔记 | 连贯地复述最近几天的内容：想法、点子、任务、话题 |
| 自定义自动化 | 每天 09:00 | 写入日记 | 空白请求，所有内容都由你自己来写 |
6. Telegram
第六个标签页。在这里可以连接你自己的机器人，这样你就能用手机给助手发消息。
这个标签页在手机上不能用
它不会显示设置，而是显示“请在电脑上设置”。这样做是对的：机器人是由存放你库的那台电脑来回复的。
标签页顶部有一张 “连接机器人” 卡片，上面有一个 “设置 Telegram” 按钮。这是一个四步向导，比手动填写各个字段更简单。完整说明见下方单独的一节。
| 设置 | 说明 | 默认值 |
|---|---|---|
| 回复消息 | 总开关。仅在这台电脑上的 Obsidian 保持打开时才有效 | 关 |
| 机器人令牌 | BotFather 给你的那个。它相当于密码：谁拿到它，谁就能给你的机器人发消息 | 空 |
| 已绑定账号 | 机器人唯一会回复的那个 Telegram 账号 | 空 |
| 思考时显示动画 | 图片会立刻出现，配文会说明它在忙什么：搜索、阅读、写作 | 开 |
| 自定义动画 | 一个 .gif 或 .mp4 的链接。位于“高级”下 | 空 |
令牌旁边有两个按钮：“检查令牌” 和 “给我发一条测试消息”。它们之间有一行实时状态——“还没有令牌”“等待 /start”“正在监听。已绑定到你的 Telegram 账号”“未运行——请重启库”。
清空已绑定账号等于把机器人送给别人
如果你把这个字段清空，机器人就会归下一个发送
/start的人所有。只有在那个人就是你自己的时候才这样做。
机器人能做什么、不能做什么：
- 它可以像面板一样搜索、读取、创建和编辑笔记；
- 它不能删除——删除需要按键确认，而聊天里没有人可以按；
- 语音消息由你的服务商转写；
- 在聊天中发送
/new会清除这段对话的记忆； - 只能在一台电脑上设置，否则两台电脑会各回复一半；
- Obsidian 关闭期间收到的消息，会等到库下次启动时再处理。
7. Connector（Коннектор）
第七个标签页，也是最新的一个：它在 2.2.0 版本中加入。这是插件中负责响应手机上的应用的部分。
思路很简单：用任意浏览器访问你的库。在手机上打开这个地址，输入一次代码，就可以像在面板里一样往笔记里写内容。而且回应你的不是服务器，也不是云端——就是这台电脑。
默认关闭，而且是有意为之
Connector 会让外部访问你的笔记。在你打开它之前，没有人能访问到。
| 设置 | 说明 |
|---|---|
| 通过浏览器应答 | 主开关。仅在这台电脑上的 Obsidian 保持打开时才有效 |
| 连接码 | 手机用来表明身份的密码。有“生成”和“重置”按钮 |
| 检查连接 | 询问中继服务是否能连上这台电脑，以及队列里有多少条消息在等待 |
| 已连接的设备 | 手机列表：名称、最后在线时间、是否已加密。每一项都有“断开连接”按钮 |
标签页和主开关：
接下来需要一个代码。点击 “生成”——插件会生成一个代码，并显示一张卡片，上面有地址 app.eltonlabs.org 和代码本身。手机需要的就是这些。
按钮、带地址和代码的卡片，以及状态行：
这个代码就是通往你笔记的钥匙
任何拿到它的人都可以往你的库里写内容。不要在直播或截图中展示它。重置会清除代码，并一次性断开所有手机。
代码只需要用一次
连接时，手机会用这个代码换成它自己的密钥。之后你就可以重置代码了——已连接的手机仍可正常使用，而新的手机没有代码就无法加入。
快速记录——给手机按钮用的密钥
这是一把只能做一件事的独立密钥：新建笔记。不能阅读、不能搜索、不能编辑、不能删除——通过它发出的消息在到达助手之前就被分流了。
它只有一个用途：不用打开应用就能记下一个想法。锁屏上的一个按钮，一个小输入框，搞定。
完整流程视频——设置部分、按钮和密钥：
这把密钥本身就是一台设备
它会在已连接设备列表中单独显示为一行，断开方式与手机相同，都是同一个按钮。泄露了——撤销即可，就这么简单。
它发送的内容没有端到端加密
快捷指令和小组件无法推导出共享密钥——那需要浏览器才能做到。所以这把密钥被精简到只能执行一个动作：即使落入他人之手，它也只能把笔记丢进你的收件箱，永远读不到你的库。
关于队列。 如果 Obsidian 关着或电脑关机，你从手机发出的内容不会丢失——它会进入队列，等你下次打开库时再处理。所以电脑关机的夜里也可以随手记录。
关于加密。 一切都是端到端加密的：手机和电脑通过中继交换公钥，各自在本地推导出共享密钥，从不通过网络发送。中继传输的是它无法读取的密文。每台设备都有自己的密钥——手机读不到平板的消息。
关于私密文件夹。 权限是一样的。助手在电脑上看不到的内容，在手机上同样看不到：不存在单独的“移动端访问权限”。
完整的应用指南是另一篇文章
这一部分只讲插件的这个标签页。如何把应用添加到主屏幕、为什么禁止在浏览器标签页中登录、如何付款以及它能做什么——都在应用指南里。
8. 界面（Интерфейс）
第七个标签页。这些小细节决定了日常使用是否顺手。
| 设置 | 作用 | 默认值 |
|---|---|---|
| 面板的打开方式 | 反应堆（语音优先）或文本（可阅读的对话）。也可以通过标题栏中的按钮切换 | 反应堆 |
| 面板的打开位置 | 右侧边栏、左侧边栏，或作为标签页在主区域打开 | 右侧 |
| 启动时打开 | Obsidian 一启动就显示面板 | 关 |
| 语言 | 跟随 Obsidian、俄语、英语。它不影响回答所用的语言——你用什么语言和它说话，它就用什么语言回复 | 跟随 Obsidian |
| 显示回答文本 | 关——文本与语音同步出现。开——整段回答一次性显示 | 关 |
| 显示它正在做什么 | 在对话中打印每一次搜索和编辑，让你看到它是怎么得出答案的 | 开 |
| 保存对话 | 每次对话都会变成一篇可以通过搜索找到的笔记 | 开 |
| 对话文件夹 | 每次对话一篇笔记，标题里包含助手的名字和时间 | 空 |
对话默认会被保存
如果“对话文件夹”为空，对话会存入名为“与助手的对话”的文件夹，首次保存时会自动创建。
不想留下任何痕迹——就关闭“保存对话”：这样对话会随着面板的关闭而消失。
界面会立即切换，但已经打开的窗口会保持旧语言，直到你重启 Obsidian。
标签页底部有一个页脚，显示插件版本（2.2.0）和网站链接。
它能在你的库里做什么
能力列表是动态生成的。关闭一项权限不是“拒绝请求”，而是该工具直接消失了：你没法说服助手去使用它，因为对它来说这个工具根本不存在。
如果允许读取：
- 搜索你的笔记——按字词和按含义搜索；
- 读取整篇笔记；
- 在屏幕上显示一篇笔记；
- 列出某个文件夹中的笔记（文件夹名可以说得模糊一些）；
- 列出库中的所有文件夹；
- 按名称或路径模式查找笔记（
*budget*、MOC*）； - 在笔记中查找精确文本，并给出行号；
- 查看最近 N 天写入或修改了什么——这是回答“最近几天”和“这周”这类问题的唯一办法；
- 打开某个日期的日记——并用 Obsidian 自带的命令创建今天的日记，这样你的模板就会运行。
**如果允许创建：**新建带内容的笔记；读取库中的模板；创建带列和卡片的真正的看板。
如果允许编辑：向笔记追加内容（可选择追加到某个标题下）；替换一段精确的文本；整篇重写笔记；创建文件夹；移动或重命名笔记——链接会自动更新；用“撤销刚才的操作”或“恢复原样”来撤销上一次编辑。
**如果允许删除：**删除笔记——始终需要在键盘上确认，文件会进入系统回收站。
**如果允许控制标签页：**查看当前打开了什么；在库内打开网页；关闭一个或全部标签页；同时打开多篇笔记；在当前笔记旁边打开一篇笔记；运行任意 Obsidian 命令。
**如果开启了网络搜索：**在线搜索并附上来源链接。
实际示例：按需生成看板
“给这个项目做一个看板”——它就会以真正的看板形式出现，而不是一段关于看板的文字。
它能理解哪些 Obsidian 格式
插件内部有九份关于格式的简短说明——也就是“技能”。助手只会获得那些对应插件确实已安装在你的库里的技能。
| 格式 | 简介 | 需要的插件 |
|---|---|---|
| Obsidian 笔记 | 属性、链接、标注、任务、嵌入 | — |
| 看板 | 看板的精确文件格式 | Kanban |
| Dataview | 跨整个库的实时列表和表格 | Dataview |
| Bases | .base——Obsidian 自带的数据库 | — |
| Templater | 带动态值的模板：日期、查询、文件名 | Templater |
| Excalidraw | 以笔记形式存在的绘图和图表 | Excalidraw |
| 图表 | 笔记中的柱状图、折线图和饼图 | Obsidian Charts |
| Meta Bind | 绑定到笔记属性的按钮、开关和字段 | Meta Bind |
| Mermaid | 图表：流程图、时序图、甘特图、思维导图、时间线 | — |
插件不支持 Canvas
.canvas白板是 Obsidian 的另一种独立格式，插件没有内置对它的了解，也没有专门用于创建.canvas文件的工具。它用 Excalidraw 和 Mermaid 来绘制图表。
缺少的插件该如何安装，请看第三方插件一节。插件还会自动找到你的日记文件夹、模板文件夹和标准笔记模板——只有没找到时才会来问你。
Telegram 机器人：完整说明
这个机器人将是你自己的。你只需一分钟就能创建它，回复你的不是别人的服务器，而是装着你的库的那台电脑。
第 1 步：在 @BotFather 中创建机器人
BotFather 是 Telegram 官方用来发放其他机器人的机器人。它是免费的。
bot 结尾，并且没被占用。例如 elton_my_helper_bot。令牌就是你机器人的密码
谁拿到它，谁就能给你的机器人发消息。不要转发给任何人，也不要让它出现在截图里。
第 2 步：把令牌粘贴到插件里
第 3 步：给机器人发送 /start
用你实际要使用的那部手机在 Telegram 里打开你的机器人，并发送 /start。
谁先发，就归谁
机器人会绑定第一个向它发送
/start的账号，此后只回应这个账号，对其他人一律不作声。所以你一定要抢在第一个。如果弄错了，请清空 Telegram 标签页里的“已关联账号”字段，然后重新发送
/start。
状态栏会变成“正在监听。已关联到你的 Telegram 账号”。点击**“给我发一条测试消息”**按钮来确认一下。
现在你可以直接在手机上打字、录语音消息了——助手会在电脑上处理你的库。
关于 Telegram 连接的说明
插件会在 Telegram 标签页上直接提醒你这一点：
在某些运营商网络下，与 Telegram 的连接可能不稳定
发给机器人的消息可能会延迟到达，或者根本收不到。
实际意味着什么：你电脑上的 Obsidian 需要自己连接到 Telegram 的服务器，才能获取消息并把回答发回去。
如果你的运营商到 Telegram 的连接不稳定，机器人也会出现同样的情况：消息延迟到达或者收不到。这是网络本身的特性，并不是插件的问题。
先说句让你放心的话：这只涉及可选的 Telegram 部分。Obsidian 面板里的助手本身照常工作——Elton AI 服务商就是专门为此设计的，你不需要额外准备任何东西。
如何获取密钥并付款
只有选择了 Elton AI 服务商时才需要这一步。OpenRouter 和 OpenAI 的密钥要从它们那里获取，本地模型则完全不需要密钥。
由机器人发放密钥
带有密钥的消息会在 2 分钟后自动删除
这样更安全。你随时都可以通过“My key”按钮再次获取密钥——不会弄丢的。
只有在你有订阅或试用权限时才会发放密钥。如果账户是空的，就没有东西可以用来支付模型费用，所以也不会有密钥。
密钥就像密码一样
谁拿到它，谁就会花掉你的额度。不要给任何人看——包括插件作者本人。如果泄露了，点击“🔄 New key”，旧密钥会立即失效。
“Gift”优惠码——免费试用
给机器人发送单词 gift（trial 和俄语的 подарок 也可以），或者点击 🎁 Try it free 按钮。
也可以什么都不用输入：带着优惠码打开机器人——优惠码会在你点击 Start 时一并发送。
你将获得 3 天内有效的 200 点额度，无需绑卡。每人仅限一次，并且仅限从未有过试用权限或订阅的用户。
试用额度恰好在三天后过期，这一点和购买的额度不同。
套餐
订阅并不会解锁功能，而是给你的账户充入额度，助手的工作会从中扣费。
所有套餐的功能都一样
不存在“顶级套餐有更好的模型”或者“Medium 起才有自动化”这种事。插件本身在所有套餐下完全一致——套餐之间只有额度数量和客服优先级的区别。
| 套餐 | 额度 | 价格 | 期限 | 客服 |
|---|---|---|---|---|
| 🥉 Lite | 490 | 490 ₽ | 30 天 | 标准 |
| 🥈 Medium | 990 | 990 ₽ | 30 天 | 优先 |
| 🥇 Maximum | 1990 | 1 990 ₽ | 30 天 | 最高优先 |
一点额度大致相当于充值一卢布。这项服务还很年轻，机器人也坦率地说明：套餐仍在调整中，可能会有变化——最新的套餐信息请始终以机器人里显示的为准。
付款通过 Telegram 官方服务 @tribute 完成：点击“Pay”，付款，然后回到机器人里。额度通常几秒钟内到账，机器人会自动发来“Payment received”的消息。
未用完的额度不会过期
月底不会过期，取消订阅后也不会。剩余的额度会保留下来继续使用——而且你仍然会拿到密钥。
会花多少
一个简短的问题——几乎不花什么。处理一篇很长的笔记，或者语音回答——消耗会更明显。请求和回答越长，扣费越多。
视频里讲的是：额度是什么，以及一次回答的价格取决于什么：
有三样东西花费最多：很长的回答、语音，以及拖了很多条消息的长对话——之前的整段对话都会随新问题一起发送出去。
新问题——开启新对话
这是避免多花钱最简单的办法：全新的对话不会拖着一长串旧消息。
想查看还剩多少，可以用 📊 Status 按钮或者 /status 命令：套餐、余额、到期日期。另外，在连接标签页里打开“显示花费”——这样每条回答下面都会显示金额。
机器人命令
| 命令 | 作用 |
|---|---|
/start | 注册并进入主菜单 |
/status | 套餐、余额、到期日期 |
/api_token | 显示当前密钥 |
/new_api_token | 发放新密钥；旧密钥立即失效 |
/subscribe | 套餐和付款 |
/guide | 分步指南，共五屏 |
/help | 要点汇总，一屏显示 |
/language | 在俄语和英语之间切换 |
已经有 Obsimind AI 的密钥了？
同一个密钥在这里也能用——粘贴到密钥字段即可，不需要再去获取新的。只要是同一个 Telegram 账号，密钥和余额是共用的。
隐私
插件会处理你的笔记，所以这里坦诚地说明：哪些内容会发送出去，哪些不会。
基本规则是：为了给出回答，助手会把回答所需的笔记片段发送给服务商。不是整个库——只发送问题检索到的那部分。使用本地模型时，什么都不会发送出去。
私密文件夹——最关键的设置
它位于库标签页的**“允许它做什么”**窗口里。这是一个大的输入框：每行一个文件夹，路径从库的根目录算起。嵌套的子文件夹同样会被屏蔽。
私密文件夹里的内容，对助手来说就不存在
它不会读取、搜索、索引，也不会向任何地方发送这些笔记——即使这篇笔记正开着显示在你的屏幕上。
适合放在这里的：病历、财务信息、密码、其他人的信息，以及任何受保密协议约束的内容。
输入框下方，插件会显示当前有多少篇笔记被隐藏。这项设置优先于所有其他设置生效——无论是搜索、索引还是工作范围，都绕不开它。
输入框为空，就表示没有任何内容被隐藏。安装完成后，请马上花两分钟设置一下。
按含义搜索会发送整个库
在你按下开关之前，必须先了解这一点。
坦白说，毫不含糊
打开**“同时按含义搜索”，意味着你库里每一篇笔记**的文本都会发送给服务商一次，用来建立索引。这是唯一一个会批量发送全部内容的操作。而且这是要花钱的。
正因如此，它默认是关闭的。
与此同时，关键词搜索始终可用，免费且不需要密钥——索引会在本地一秒钟内建好。
如果你确实需要按含义搜索，有两道过滤手段：
- 私密文件夹——完全自动地排除在外；
- “不建立索引”——这些文件夹不会被批量发送出去。不过，如果你按名称要求助手打开其中的某篇笔记，它仍然会打开。很适合用来放归档和日记。
还有哪些内容会发出去
| 内容 | 何时发送 | 如何限制 |
|---|---|---|
| 上下文笔记 | 每次请求都完整发送 | 不要往里面放任何不必要的内容 |
| 库结构图 | 每次请求都发送——只有文件夹和名称，不含正文 | 关闭“了解库的结构” |
| 网络搜索查询 | 开启“网络搜索”时（默认是开启的） | 把开关关掉 |
| 找到的笔记片段 | 每次回答用到了库中内容时 | 私密文件夹和工作范围 |
密钥以明文形式保存在文件里
API 密钥和 Telegram 机器人令牌以普通文本的形式，存放在你库里的插件文件夹中。所有 Obsidian 插件都是这样工作的。
如果你的库同步到了公开的地方
密钥会随之一起传过去。不要把带有可用密钥的正式库放在公开仓库或共享文件夹里。
没有任何统计分析
你的笔记留在你的库里。只有回答问题所需的文本才会发给服务商——如果用本地模型，则完全不会向外发送任何东西。
源码是公开的
插件完整地托管在 GitHub 上：github.com/swayinfo/elton-ai。
在你的 Obsidian 中运行的所有代码都在 src/ 里，每个版本的
main.js 都由仓库的工作流据此构建，并附有构建来源证明。你可以阅读代码，与你安装的版本对比，也可以自己动手构建。
关于哪些公开、哪些不公开以及原因，详见应用页面上的 为什么它不是开源的。
常见问题
它在我的笔记里什么都找不到
请在“允许它做什么”窗口中检查**“读取笔记”**权限。没有这个权限，你的库对它来说就不存在。然后再看看你是否缩小了“工作范围”，以及该文件夹是否被加进了私密列表。
它不出声，或者提示连接出错
进入“连接”标签页 → 点击**“测试连接”**按钮。它会立刻告诉你问题出在密钥、地址还是模型上。
它要想好几秒，这正常吗？
正常。到第一个字出现需要一秒半是很普通的，长时间停顿后的第一次回答会因为预热而慢大约一倍。原因请看工作原理下面的“为什么等待是正常的”一节。
它只会说，不会动手
很可能是你选的模型不能调用工具。从目录里随便选一个就行——它们都可以。
说话说到一半它就不出声了
在“语音”标签页的“高级”下关闭**“允许打断”**——用扬声器播放时，它会听到自己的声音。或者戴上耳机。
自动化没有运行
新建的自动化默认是关闭的。请在列表中用开关把它启用。
机器人不回复
按常见程度排序有三个原因：电脑上的 Obsidian 没有打开；“回复消息”开关是关着的；你的运营商到 Telegram 的连接不稳定——详见。
它删错东西了
说一句“撤销”或“恢复原样”就行——每次修改之前都会先做一份副本。而且删除操作无论如何都会要求你通过键盘确认，文件会被移到系统回收站。
如何把它限制在一个文件夹里
打开“允许它做什么”窗口 → “可以在哪里工作” → “仅限这些文件夹”，然后填入路径。这同样适用于搜索：其余内容它根本看不到。
获取插件
Elton AI 是我知识体系的一部分。在现成的 Obsidian 模板 里它已经配置好了：文件夹已定义，模板已就位，各个场景也都与知识库、项目和 Book Reader 连在了一起。
如果你从没用过 Obsidian，请先从“Obsidian 全攻略”栏目开始，基础知识都按顺序放在那里。