obsidian-agent-client
在Obsidian笔记软件中直接集成并对话AI智能体。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:obsidian-agent-client。 它的用途是:在Obsidian笔记软件中直接集成并对话AI智能体。 完整的 Skill 内容见:https://321skill.com/skills/obsidian-agent-client/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析当前Vault中关于‘神经网络’的笔记,并生成一份知识结构摘要。” 它会读取你提到的笔记内容,并整理出一份清晰的脉络图。 或者,在编写代码时,你可以说:“@project_spec.md 中提到需求A,请根据这个需求写一个Python函数原型。” AI会结合你引用的笔记上下文,生成更准确的代码。
介绍
Agent Client Plugin for Obsidian 是一款将AI智能体直接引入笔记软件Obsidian的插件。它基于Agent Client Protocol (ACP),允许用户在笔记环境中无缝调用Claude Code、Codex、Gemini CLI等AI助手进行对话和协作。
该插件通过在Obsidian中创建一个聊天界面来使用。用户需要先在本地终端安装并配置好相应的AI智能体及其ACP适配器,然后在插件设置中指定Node.js路径和智能体路径。配置完成后,即可在Obsidian侧边栏或浮动窗口中与AI进行对话,并利用其强大的功能。
它非常适合那些深度使用Obsidian作为知识管理或工作中心,并希望将AI能力深度集成到工作流中的用户。无论是开发者、研究人员还是内容创作者,都可以利用它来辅助思考、编写代码或处理文档。
使用前请确保已正确安装Node.js环境。由于需要运行本地智能体进程,请留意系统资源占用。初次配置路径时需仔细核对,错误的路径会导致连接失败。建议从社区插件商店安装以获取稳定版本。
核心特点
核心区别在于它并非直接调用云API,而是通过标准化的ACP协议桥接本地运行的、功能更强大的命令行AI智能体(如Claude Code),从而在Obsidian中获得了接近原生终端的强大AI能力,包括终端命令执行、MCP工具调用等。
注意事项
不适合仅需简单问答、不希望进行本地命令行配置或对系统资源敏感的用户。
常见问题
如何安装Claude Code智能体?
在终端运行命令:`curl -fsSL https://claude.ai/install.sh | bash` 安装Claude Code,然后运行 `npm install -g @agentclientprotocol/claude-agent-acp` 安装其ACP适配器。
插件支持哪些AI模型?
主要支持需要本地运行的智能体,如Claude Code、Codex、Gemini CLI,也支持自定义配置其他符合ACP协议的智能体。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/obsidian-agent-client/raw/index.md 读取 obsidian-agent-client 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/obsidian-agent-client/raw/index.md(查看排版版本)