从文字到图像：用AVA在Obsidian中生成AI插图的完整教程

从文字到图像：用AVA在Obsidian中生成AI插图的完整教程

【免费下载链接】obsidian-avaQuickly format your notes with ChatGPT in Obsidian项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-ava

想为你的 Obsidian 笔记快速配上 AI 插图，却不想离开笔记软件来回切换工具？AVA 这款专为 Obsidian 打造的 AI 助手插件，能把「选中文字 → 生成图像」的流程压缩到一次快捷键操作，让你在 Obsidian 中生成 AI 插图就像写一行笔记一样简单。本教程将带你从零开始，完成安装、配置、生成图像与进阶玩法的完整上手，新手也能轻松掌握。

为什么选择在 Obsidian 中生成 AI 插图

写作时，一张贴切的配图能大幅提升笔记的可读性与传播力。AVA 的核心价值在于无缝衔接：

• 不离开编辑器：生成结果自动插入当前笔记，无需复制粘贴
• 从选中文字直接生成：你写下的描述即是提示词，所见即所得
• 与 ChatGPT 生态打通：同一插件还能完成改写、续写、智能链接等功能，一站式满足 AI 辅助写作需求

AVA 一键安装步骤

AVA 是一款 Obsidian 社区插件，安装非常简单：

1. 打开 Obsidian，进入「设置 → 第三方插件」
2. 关闭「安全模式」，点击「浏览」搜索AVA
3. 安装后点击「启用」，侧边栏会出现 AVA 的魔法帽图标
4. 打开 AVA 设置页，点击Login完成账号连接（生成图像与改写功能都需要登录）

如果无法在线安装，也可以克隆仓库后手动放置插件目录：git clone https://gitcode.com/gh_mirrors/ob/obsidian-ava

最快配置方法：三步完成准备工作

安装完成后，只需确认三件事即可开始生成 AI 插图：

1. 确认已登录：设置页右上角显示 Logout 即代表连接成功
2. 选中文字：在任意笔记中，用鼠标选中一段你想转成插图的文字
3. 调用命令：按下Cmd/Ctrl + P，输入并选择Generate Image

设置页还提供了使用量进度条、Links 智能链接开关以及高级参数，供进阶用户按需调整，具体实现可参考 Settings.tsx 与 LegacySettings.tsx。

从文字到图像：生成 AI 插图的详细步骤

这是本教程的核心流程，仅需 4 步：

1. 打开一篇笔记，选中描述场景的文字，例如「一只在火星动物园参观的长颈鹿群」
2. 按Cmd/Ctrl + P打开命令面板，输入Generate Image并回车
3. AVA 会调用后端 AI 服务，将你的文字转换为提示词并生成图像
4. 生成完成后，图片会自动以![[文件名.jpg]]的形式插入到选中文字下方

生成的原图会保存在当前笔记所在目录，文件名为时间戳加提示词缩写，方便日后检索。整个调用逻辑可查看 main.tsx 中的ava-generate-image命令，以及负责图像生成的 stableDiffusion.ts。

提升 AI 插图质量的实用技巧

想让生成的插图更贴合想象？试试这些经验：

• 描述越具体越好：包含主体、场景、风格、光线等细节，如「黄昏时分的海边灯塔，油画风格」
• 控制篇幅：建议选中文字不超过一两句话，过于冗长的描述容易稀释重点
• 生成后立即查看：如果效果不理想，修改文字再次运行即可，成本极低
• 利用改写先润色：先用Rewrite Selection让 ChatGPT 优化你的描述，再生成图像，效果往往更好

进阶玩法：用 Templater 将「文字转图像」自动化

如果你安装了 Templater 插件，还可以把 AVA 当做一个库来调用，实现模板化的一键图像生成。官方文档 USING_AS_API.md 提供了完整示例：

1. 在 Templater 设置中，将模板目录设为Templates/Templater，脚本目录设为Templates/Scripts

2. 在脚本目录中创建descriptionToArt.js，调用 AVA 暴露的createImageAPI，把选中文字转为提示词并生成图像

3. 在模板中写入<% tp.user.descriptionToArt() %>，以后插入模板即可自动将选区文字生成插图

这种方式的优势在于可批量、可复用，非常适合需要固定配图风格的博客或知识库场景。

常见问题与解决方案

提示「You need to login」怎么办？说明尚未连接账号，请到 AVA 设置页点击 Login 完成登录。

生成了图片但看不到？检查生成时是否选中了文字；确认图片文件已保存到笔记所在目录，并在预览模式下查看。

想要更高分辨率？AVA 的图像生成支持指定尺寸参数，在自定义脚本中可通过size字段调整（默认 512）。

结语

从今天起，你可以在 Obsidian 中生成 AI 插图，让每一篇笔记都图文并茂。AVA 把「文字描述」与「图像生成」之间的距离压缩到一次快捷键，配合改写、续写、智能链接等能力，称得上 Obsidian 用户的得力 AI 助手。现在就选中一段文字，体验从文字到图像的奇妙旅程吧！

【免费下载链接】obsidian-avaQuickly format your notes with ChatGPT in Obsidian项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-ava