笔记提及
直接在 AI agent 的对话中引用你的 Obsidian 笔记。
自动提及活动笔记
启用后,插件会自动将当前活动的笔记包含在你的消息中。当你想讨论或处理正在查看的笔记时,这很有用。
在 设置 → Agent Client → 提及 → 自动提及活动笔记 中启用。
自动提及的工作原理
与手动提及不同,自动提及只将笔记的文件路径传递给 agent — 而不是其完整内容。Agent 然后可以使用其读取工具在需要时检查文件。
当自动提及处于活动状态时,输入框上方会显示一个徽章,显示当前笔记名称(如 @我的笔记)。
临时禁用
你可以通过点击徽章旁边的 × 按钮为单条消息临时禁用自动提及。点击 + 按钮重新启用。此切换仅影响当前消息 — 自动提及将在后续消息中再次激活。

选区上下文
如果你在笔记中选择文本,选中的行将作为上下文传递给 agent。徽章会显示行范围(如 @我的笔记:5-10),agent 会收到文件路径和选中的内容。

手动提及
使用 @ 语法引用特定笔记:
@[[我的笔记]]当你输入 @ 时,会显示一个下拉菜单,其中包含库中匹配的笔记。选择一个笔记以插入提及。
手动提及的工作原理
当你发送带有手动提及的消息时:
- 插件读取被提及笔记的内容
- 笔记内容包含在发送给 agent 的消息中
- Agent 然后可以引用、分析或修改笔记内容
长度限制
为防止消息过大,插件限制了包含的内容量:
| 设置 | 默认值 | 描述 |
|---|---|---|
| 最大笔记长度 | 10,000 字符 | 每个被提及笔记的最大字符数 |
| 最大选区长度 | 10,000 字符 | 自动提及中文本选择的最大字符数 |
在 设置 → Agent Client → 提及 中配置这些设置。
TIP
超过限制的内容会被截断,并附带说明原始长度的注释。
提示
- 使用手动提及将特定笔记作为上下文包含
- 提及多个笔记可以让 agent 获得更广泛的理解
- 对于大型笔记,考虑选择相关部分并改用自动提及