Qiaomu Agent — AI skill for Claude Code

Qiaomu Agent

**把 AI 放进 Obsidian 笔记旁边。**

**中文** | [English](#english) · [下载 0.3.2](https://github.com/joeseesun/qiaomu-agent/releases/tag/0.3.2) · [安装方法](#安装) · [反馈问题](https://github.com/joeseesun/qiaomu-agent/issues)

读笔记时直接提问，选中一段话请 Agent 改写，再检查改动并决定是否保留。你可以接入本机已有的 Codex、Claude Code 等 Agent，也可以使用自己的模型 API Key；对话、资料和修改都留在 Obsidian 的工作流里。

*Ask questions about your notes, rewrite a selection, and review changes inside Obsidian. Bring a local agent or your own model API key.*


真实 Obsidian 桌面截图：左侧是测试笔记，右侧是按选区改写的对话。截图拍摄于安装了 0.2.1 的 Obsidian 测试库。

一分钟看懂它能做什么

你想做的事	在乔木 Agent 中怎么做
理解眼前的笔记	打开侧边栏直接提问；当前笔记和编辑器选区可以作为上下文。
汇总散落的资料	用 @ 引用库内文件或文件夹，也可附加网页、图片；回复中的库内链接可点开。
把草稿变成可用笔记	让 Agent 改写选区或修改文件；按轮查看变更与 diff，需要时撤销。默认文件权限为只读。
用自己熟悉的模型	在同一入口切换本机 Agent 与模型 API；支持 OpenAI、Anthropic、Google、DeepSeek、Kimi、Ollama 等来源及兼容地址。
把回答留下来	复制回复，或追加到今日日记、指定笔记；Markdown、表格和 Mermaid 使用 Obsidian 渲染。
扩展 Agent 的能力	读取 Agent Skills；本机 Agent 可使用配置的 MCP 工具连接。搜索可走模型自带能力或你配置的 Brave Search。
从起点页直接提问	装了乔木Home时，在主页搜索框输入问题按 ⌘↵ 就会开一个新对话发出；主页也显示最近对话，点击回到原对话。

实机演示：只改选中的两行

下面是测试笔记中的一次实际操作，截图展示了对话结果。写入前需把文件权限切到「可修改当前库」，本机 Agent 的审批设置也会影响执行。

1. 在笔记里选中要处理的文字，打开乔木 Agent。
2. 输入：把我选中的这段改得更正式一些，直接改文件。
3. Agent 修改选区，并在回复里说明改了什么；你可以查看这一轮的文件变更，必要时撤销。

修改前：这个东西挺好用的，大家都说不错。我觉得可以试试。
修改后：该工具使用体验良好，用户评价普遍积极。建议可以试用。

开头和结尾的未选中行在这次测试中保持不变。这是一个演示结果，具体措辞取决于所选模型。

模型从哪里来


真实 Obsidian 0.2.1 桌面截图。模型列表取决于你的本机安装和账户配置；检测到 CLI 不等于已经登录或能够调用。

0.3.1 优化了模型列表加载、本机 CLI 检测与连接预热；实测数据和适用范围见[启动性能报告](docs/startup-performance.md)。0.3.2 让空白对话按你正在看的内容（选中文字、正在阅读、今天的日记、当前笔记）给出贴合场景的 Prompt，`/` 菜单内置一套可搜索的中文 Prompt，并打磨了手机端的触控细节。

安装

当前公开版本为 **0.3.2**，要求 Obsidian **1.11.4 或更新版本**。社区目录的审核与可安装状态以[官方插件页面](https://community.obsidian.md/plugins/qiaomu-agent)为准；在目录可