从文字到图像：用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 社区插件，安装非常简单：
- 打开 Obsidian，进入「设置 → 第三方插件」
- 关闭「安全模式」，点击「浏览」搜索AVA
- 安装后点击「启用」，侧边栏会出现 AVA 的魔法帽图标
- 打开 AVA 设置页，点击Login完成账号连接（生成图像与改写功能都需要登录）
如果无法在线安装，也可以克隆仓库后手动放置插件目录：
git clone https://gitcode.com/gh_mirrors/ob/obsidian-ava
最快配置方法：三步完成准备工作
安装完成后，只需确认三件事即可开始生成 AI 插图：
- 确认已登录：设置页右上角显示 Logout 即代表连接成功
- 选中文字：在任意笔记中，用鼠标选中一段你想转成插图的文字
- 调用命令：按下
Cmd/Ctrl + P，输入并选择Generate Image
设置页还提供了使用量进度条、Links 智能链接开关以及高级参数，供进阶用户按需调整，具体实现可参考 Settings.tsx 与 LegacySettings.tsx。
从文字到图像：生成 AI 插图的详细步骤
这是本教程的核心流程，仅需 4 步：
- 打开一篇笔记，选中描述场景的文字，例如「一只在火星动物园参观的长颈鹿群」
- 按
Cmd/Ctrl + P打开命令面板，输入Generate Image并回车 - AVA 会调用后端 AI 服务，将你的文字转换为提示词并生成图像
- 生成完成后，图片会自动以
![[文件名.jpg]]的形式插入到选中文字下方
生成的原图会保存在当前笔记所在目录，文件名为时间戳加提示词缩写，方便日后检索。整个调用逻辑可查看 main.tsx 中的ava-generate-image命令，以及负责图像生成的 stableDiffusion.ts。
提升 AI 插图质量的实用技巧
想让生成的插图更贴合想象？试试这些经验：
- 描述越具体越好：包含主体、场景、风格、光线等细节，如「黄昏时分的海边灯塔，油画风格」
- 控制篇幅：建议选中文字不超过一两句话，过于冗长的描述容易稀释重点
- 生成后立即查看：如果效果不理想，修改文字再次运行即可，成本极低
- 利用改写先润色：先用Rewrite Selection让 ChatGPT 优化你的描述，再生成图像，效果往往更好
进阶玩法：用 Templater 将「文字转图像」自动化
如果你安装了 Templater 插件，还可以把 AVA 当做一个库来调用，实现模板化的一键图像生成。官方文档 USING_AS_API.md 提供了完整示例：
- 在 Templater 设置中，将模板目录设为
Templates/Templater，脚本目录设为Templates/Scripts
- 在脚本目录中创建
descriptionToArt.js，调用 AVA 暴露的createImageAPI，把选中文字转为提示词并生成图像
- 在模板中写入
<% 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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
