用@符号让AI瞬间看懂你的笔记：Agent Client for Obsidian的Note Mentions完全指南-创锋一号

用@符号让AI瞬间看懂你的笔记：Agent Client for Obsidian的Note Mentions完全指南

【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client

Agent Client for Obsidian 是一款把 Claude Code、Codex、Gemini CLI 等 AI Agent 接入 Obsidian 的插件。它的Note Mentions功能让你用一个@符号，就能把任意笔记的内容直接"喂"给 AI——不用复制粘贴，AI 即刻理解你笔记里的上下文，帮你总结、改写、分析。本文将带你快速掌握 Note Mentions 的全部玩法。

什么是 Note Mentions？连接 AI 与你的笔记库

想象一下这个场景：你正在写一篇"产品规划"笔记，想让它顺便参考"竞品分析"和"用户调研"两篇笔记的内容。传统做法是反复复制粘贴，而 Note Mentions 只需在对话框里输入：

对比 @[[竞品分析]] 和 @[[用户调研]]，帮我找出产品规划中的差距

插件会自动读取这两篇笔记的完整内容，附在消息中一起发送给 AI。整个过程只需一个@。

3种方式让 AI 看懂你的笔记

Note Mentions 提供手动引用、自动引用和选中文本引用三种方式，覆盖不同场景。

方式一：手动 @ 引用——精确指定某篇笔记

在输入框中输入@，插件会立刻弹出一个下拉列表，展示库中匹配的笔记（支持键盘上下键选择或鼠标点击）：

选中笔记后，输入框会自动插入标准格式的引用：

@[[我的笔记]]

手动引用时插件做了什么？共 3 步：

读取被引用笔记的完整内容
将内容随你的消息一起发送给 AI
AI 即可直接引用、分析或修改这些内容

一条消息中可以 @ 多篇笔记，为 AI 提供更广阔的上下文。其解析逻辑实现在 src/utils/mention-parser.ts，下拉选择界面则由 src/ui/SuggestionPopup.tsx 渲染。

方式二：自动引用当前笔记——正在看什么就聊什么

开启设置 → Agent Client → Mentions → Auto-mention active note后，插件会自动把你当前打开的笔记附带到每条消息中。输入框上方会出现一个紫色徽章（如@我的笔记），提醒你 AI 已经"看到"了这篇笔记：

⚠️一个小细节：自动引用只把笔记的文件路径告诉 AI（而非全文），AI 觉得需要时会主动用 Read 工具去读文件——更省 token，也更灵活。

只想临时关掉某一条消息的自动引用？点击徽章旁的×按钮即可，点击+恢复。这个开关只影响当前这一条消息，后续消息依然自动引用：

方式三：选中文字引用——只发高亮的那几行

如果笔记很长，但你想让 AI 关注某一段，选中那部分文字再发送即可。此时徽章会显示行号范围（如@我的笔记:5-10），AI 会同时收到文件路径和选中的具体内容：

这是处理长篇笔记最省心的技巧：AI 的注意力精准落在你高亮的内容上。

让 AI 读懂笔记里的[[双链]]：扩展 Wikilink 上下文

你的笔记里往往还有[[双链]]指向其他笔记，但 AI 看到[[竞品分析]]并不知道它对应哪个文件。开启Expand wikilink context（默认开启）后，插件会在笔记内容旁附带一个精简的<obsidian_note_links>块，把每条[[链接]]解析为真实文件路径，并标记resolved="true/false"——

解析成功 → AI 看到笔记的真实路径和 URI，需要时主动读取
未匹配到 → 标记resolved="false"，AI 不会读错文件

注意它只发送链接指针，不发送被链接笔记的内容，由 AI 自行决定要不要深入阅读（每篇笔记最多解析 50 条链接）。实现见 src/utils/wikilink-formatter.ts。

长度限制：防止消息过于庞杂

为避免超长笔记撑爆上下文，插件对引用内容有字符上限：

设置项	默认值	说明
Max note length（单篇笔记上限）	10,000 字符	每篇被引用笔记的最大字符数
Max selection length（选中文本上限）	10,000 字符	自动引用时选中文字的最大字符数

超出限制的内容会被自动截断，并附上原始长度的说明，AI 不会一脸懵地处理半篇文档。

Note Mentions 设置速查表 📋

所有选项都在设置 → Agent Client → Mentions页面（源码：src/ui/SettingsTab.ts）：

设置项	作用	建议
Auto-mention active note	自动引用当前打开的笔记	✅ 日常使用强烈建议开启
Expand wikilink context	把笔记内`[[双链]]`解析为文件路径	✅ 默认开启，保持即可
Max note length	单篇引用笔记的字符上限	上下文紧张的模型可调小
Max selection length	选中文本的字符上限	一般无需修改

新手实用技巧 💡

多篇笔记综合问答：一条消息里 @ 多篇笔记，AI 能横向对比分析
超长笔记：优先选中相关段落用自动引用，而不是手动 @ 全文
引用不生效？确认笔记真实存在于库中——插件按文件名匹配，找不到就静默跳过
AI 回复中出现 [[笔记名]]：那是另一个功能（Prompt injection → Wikilink formatting），它让 AI写双链，而 Note Mentions 是让 AI读笔记，两者互补

更多细节可查阅官方文档：docs/usage/mentions.md、消息组装逻辑：src/services/message-sender.ts。

现在，打开 Obsidian，试试用@让 AI 真正"看见"你的第二大脑吧 🚀

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析