如何快速让AI读懂你的Obsidian笔记？Agent Client for Obsidian首个对话全攻略-迪斯科星球

如何快速让AI读懂你的Obsidian笔记？Agent Client for Obsidian首个对话全攻略

【免费下载链接】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 是一款基于 Agent Client Protocol（ACP）的 Obsidian AI 智能体插件，能把 Claude Code、Codex、Gemini CLI 等主流 AI Agent 直接装进你的笔记库。它最核心的能力就是：用@一键引用任意笔记，让 AI 真正读懂你的 Obsidian 笔记上下文——不用复制粘贴，AI 可以直接读取甚至修改你的笔记。本文将带你完成从安装到首个对话的全流程，10 分钟上手 Obsidian AI 聊天插件。

一、3分钟完成 Obsidian AI 插件安装

1. 从社区插件市场安装

打开 Obsidian：设置 → 第三方插件 → 浏览（Browse）
搜索Agent Client
点击安装（Install），然后启用（Enable）

📌 前提条件：需要Obsidian 1.11.4 及以上版本（插件用 Obsidian 密钥链安全存储 API Key）。详细要求见安装文档。

2. 配置你的 AI 智能体

插件内置了 7 个预设智能体：Claude Code、Codex、Gemini CLI、Mistral Vibe、OpenCode、Kiro、Hermes Agent，也支持任意 ACP 兼容的自定义智能体。每个智能体的安装与认证步骤见智能体配置总览。

配置完成后：

打开设置 → Agent Client
检查智能体路径 —— 点击Auto-detect（自动检测）通常就能找到
左侧边栏点击🤖 机器人图标，即可开始聊天

二、打开你的首个 AI 对话面板

点击左侧 Ribbon 栏的机器人图标，或通过命令面板（Cmd/Ctrl + P）搜索Open chat view，聊天面板就会出现在右侧边栏。

在输入框中键入问题，按Enter发送，AI 就会开始流式回复。整个过程和主流 AI 聊天工具一样自然，只是它"住"在了你的笔记库旁边。

💡 你还可以直接粘贴或拖拽图片到输入框，把图片作为上下文一并发给 AI（如截图、手稿照片），这是大多数聊天工具做不到的：

三、核心技巧：用 @ 让 AI 读懂你的笔记

这是整个插件最强大的功能——笔记引用（Note Mentions），也是"让 AI 读懂你的笔记"的关键。

1. 手动 @ 提及笔记

在输入框中输入@，会弹出模糊搜索下拉框（匹配笔记名、路径和别名），选择笔记即插入引用：

@[[读书笔记]] 帮我总结这篇笔记的核心观点

发送后，插件会自动读取被引用笔记的完整内容发给 AI，AI 就能基于你的真实笔记回答问题。一次可以 @ 多篇笔记，给 AI 更全面的上下文。

2. 自动提及当前笔记

开启设置 → Agent Client → Mentions → 自动提及活动笔记后，你正在看的笔记会自动作为上下文。更妙的是：选中笔记中的某几行文字，AI 收到的就是精确到行号的选中片段（如@我的笔记:5-10）：

3. Wikilink 上下文展开

你笔记里的[[双链]]对 AI 来说是"黑盒"。插件默认会把这些链接解析成真实文件路径一并发送，AI 就能自己决定该深入阅读哪篇关联笔记——相当于把整个知识网络地图交给了 AI。

完整规则与长度限制说明见笔记引用文档。

四、切换模型与模式，掌控回答质量

输入框下方有两个下拉菜单，可随时切换：

模型（Model）：在不同模型间权衡速度与能力，简单问答用快模型，复杂分析用强模型
模式（Mode）：如切换到Plan Mode，让 AI 先规划再动手，适合重构笔记结构等任务

选择会自动记忆，跨会话生效。详见模型选择与模式选择。

五、进阶玩法：多会话、笔记内嵌 AI 对话

当首个对话跑通后，这些能力会让你的 Obsidian AI 工作流真正起飞：

多会话并行：在侧边栏、编辑器标签页、浮动窗口中同时运行多个 AI 会话，各自独立会话与模型，还能一键向所有会话广播同一条提示词：

笔记内嵌 AI 对话：在任意笔记中插入一个代码块（内容设为type: chat），阅读视图里就会出现一个"活的" AI 对话区，紧挨着它正在讨论的内容；还可以插入一键触发的Agent 按钮：

可视化编辑：AI 修改笔记时，聊天区会显示词级 diff，你一眼就能看清改了哪里，每一步操作都有权限确认，拒绝或批准都在你手中

更多能力可继续探索：斜杠命令、会话管理、聊天导出为 Markdown 笔记、可嵌入块和 ACP 协议支持。

六、安全提示：把权限握在自己手里

AI 每次执行敏感操作（读写文件、跑命令）都会弹出权限确认横幅，可逐条批准或拒绝；"自动放行"默认关闭，请谨慎开启
API Key 存储在 Obsidian 系统密钥链中，不是明文
插件自身只通过 Obsidian 的 Vault API 读写笔记，文件系统仅用于"自动检测"路径的只读探测

架构层面的安全与分层设计可参考 ARCHITECTURE.md 及 ACP 通信层源码 src/acp/。

写在最后

从安装插件到 AI 读懂你的第一篇笔记，整个过程不到 10 分钟。现在打开 Obsidian，@ 一篇你珍藏的笔记，问出第一个问题吧——你的知识库，从此多了一位"读过所有笔记"的 AI 助手。🚀

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

企业官网建设流程全解析