如何快速让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-clientAgent Client for Obsidian 是一款基于 Agent Client ProtocolACP的 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. 手动 提及笔记在输入框中输入会弹出模糊搜索下拉框匹配笔记名、路径和别名选择笔记即插入引用[[读书笔记]] 帮我总结这篇笔记的核心观点发送后插件会自动读取被引用笔记的完整内容发给 AIAI 就能基于你的真实笔记回答问题。一次可以 多篇笔记给 AI 更全面的上下文。2. 自动提及当前笔记开启设置 → Agent Client → Mentions → 自动提及活动笔记后你正在看的笔记会自动作为上下文。更妙的是选中笔记中的某几行文字AI 收到的就是精确到行号的选中片段如我的笔记:5-103. 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 助手。【免费下载链接】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），仅供参考
