用符号让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-clientAgent 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 步读取被引用笔记的完整内容将内容随你的消息一起发送给 AIAI 即可直接引用、分析或修改这些内容一条消息中可以 多篇笔记为 AI 提供更广阔的上下文。其解析逻辑实现在 src/utils/mention-parser.ts下拉选择界面则由 src/ui/SuggestionPopup.tsx 渲染。方式二自动引用当前笔记——正在看什么就聊什么开启设置 → Agent Client → Mentions → Auto-mention active note后插件会自动把你当前打开的笔记附带到每条消息中。输入框上方会出现一个紫色徽章如我的笔记提醒你 AI 已经看到了这篇笔记⚠️一个小细节自动引用只把笔记的文件路径告诉 AI而非全文AI 觉得需要时会主动用 Read 工具去读文件——更省 token也更灵活。只想临时关掉某一条消息的自动引用点击徽章旁的×按钮即可点击恢复。这个开关只影响当前这一条消息后续消息依然自动引用方式三选中文字引用——只发高亮的那几行如果笔记很长但你想让 AI 关注某一段选中那部分文字再发送即可。此时徽章会显示行号范围如我的笔记:5-10AI 会同时收到文件路径和选中的具体内容这是处理长篇笔记最省心的技巧AI 的注意力精准落在你高亮的内容上。让 AI 读懂笔记里的[[双链]]扩展 Wikilink 上下文你的笔记里往往还有[[双链]]指向其他笔记但 AI 看到[[竞品分析]]并不知道它对应哪个文件。开启Expand wikilink context默认开启后插件会在笔记内容旁附带一个精简的obsidian_note_links块把每条[[链接]]解析为真实文件路径并标记resolvedtrue/false——解析成功 → AI 看到笔记的真实路径和 URI需要时主动读取未匹配到 → 标记resolvedfalseAI 不会读错文件注意它只发送链接指针不发送被链接笔记的内容由 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 真正看见你的第二大脑吧 【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考