Qiaomu Design

中文 | English

在 Obsidian 里，把笔记、想法和素材做成可以继续编辑的封面与海报。

Create editable covers and posters from your notes, ideas and images—inside Obsidian.

下载完整安装包 · 快速开始 · 功能导览 · 问题反馈

本文的蓝色与珊瑚色插图由内置 AI 生图能力制作，用来解释功能，不是软件截图或插件生成效果承诺。下方「真实模板输出」由本仓库模板代码实际渲染。配图来源与提示词见制作说明。

桌面端 Obsidian 1.11.4+ · MIT 开源 · 基础编辑无需账号 · AI 服务按需配置

原名 Qiaomu Cover Design，现名 Qiaomu Design。插件 ID 仍为 qiaomu-cover-design，设计格式仍为 .qcover；改名不会要求你迁移已有设计、模型配置或图片历史。本文按 0.2.4 实现整理。

AI 设计师遵循当前选区：选中元素时只调整选中的元素，多选同样有效；未选中时才调整整张画布。明确的改色指令直接采用指定颜色，生成期间切换选择不会改变本次调整对象。

安装 · AI 排版 · 平台模板 · 画布图层 · 字体素材 · 图库 · AI 生图 · 模型配置 · 导出 · 快捷键 · 备份隐私

Installation and usage

Qiaomu Design creates editable covers and posters inside Obsidian, with optional AI layout, image generation, an image gallery and freehand drawing. See the complete English guide.

Install the complete ZIP from GitHub Releases into your vault configuration folder under plugins/qiaomu-cover-design/, then enable Qiaomu Design in Community plugins. Desktop Obsidian 1.11.4+ is required. Preserve plugin settings, Gallery, image jobs, fonts and caches when upgrading. Open the designer from the command palette, choose a platform, add/edit elements and export PNG/JPEG/WebP. AI is optional and uses your own configured provider.

为什么在笔记里做设计

一篇文章写好后，你不必把标题、正文、配图反复搬进另一个设计工具。乔木设计把画布放进 Obsidian：从当前笔记起稿，选模板或让 AI 提出排版方案，调整文字、图片与图层，导出后再放回笔记。

它适合需要持续制作小红书封面、文章头图、视频缩略图、读书卡片、课程海报的创作者，也适合想把知识笔记变成可分享图片的 Obsidian 用户。

你会得到两份不同用途的文件：.qcover 留给下次编辑，PNG / JPEG / WebP 用于发布和分享。AI 是可选的辅助能力；手工排版、模板、图层、素材、绘制与导出不要求配置模型。

一眼看懂全部能力

快速开始：先做出第一张封面

1. 安装完整包

1. 安装或更新到桌面端 Obsidian 1.11.4 或更高版本。
2. 打开 GitHub Releases，下载 qiaomu-cover-design-版本号.zip。
3. 将 ZIP 中的 qiaomu-cover-design 文件夹放进你的库的 .obsidian/plugins/。
4. 重新加载 Obsidian，在「设置 → 第三方插件」启用 Qiaomu Design。

安装后应能看到：

你的库/
└── .obsidian/plugins/qiaomu-cover-design/
    ├── main.js
    ├── manifest.json
    ├── styles.css
    ├── fonts/
    ├── assets-pack.json.gz
    └── asset-licenses/

完整包含字体和许可文件，适合首次离线使用。只安装 main.js、manifest.json、styles.css 也能运行：贴纸与图标已嵌入 main.js，缺失的默认字体首次使用时下载，完成后可离线使用。

升级请合并替换发行文件，不要先删除整个插件目录。 保留 data.json、gallery/、image-jobs/、自定义字体和缓存。备份清单解释了各目录用途。

GitHub Release 可直接下载；社区目录审核、目录可见和客户端安装是不同状态。请以 Obsidian 社区目录实际结果为准，本页不把 GitHub 发布等同于已上架。

2. 不配置 AI，也能完成第一张

1. 打开一篇 Markdown 笔记，在命令面板运行「从当前笔记创建封面」，或右键笔记选择同名操作。
2. 选择目标平台和模板，填写标题、副标题。
3. 双击画布文字修改内容，在属性面板调整字号、颜色与间距。
4. 从顶部工具插入图片、贴纸或形状；拖动到合适位置。
5. 打开导出，选择格式、倍率和保存位置，得到第一张成品。
6. 重新打开库中的 .qcover，继续修改。

成功标志：能在库中重新打开可编辑设计，并找到导出的图片。 默认设计目录为 Cover designs/，默认导出目录为 Cover designs/Exports/，都可在设置中修改。

3. 想让 AI 帮你起稿

在「设置 → 模型与服务」先添加排版模型，再在 AI 设计面板输入需求。例如：

把这篇关于 AI 写作的笔记做成小红书封面。标题突出“30 天学会 AI 写作”，副标题说明适合零基础；用清晰的杂志排版和蓝白配色，先不要生成图片。

比较候选方案，选择一张应用到画布，再按需要改字、换色或添加配图。排版模型和生图模型分别配置；只有排版模型也能使用 AI 排版。

功能导览

01 · 从一句话到可编辑版式

AI 设计面板接收主题、文章片段或修改要求，结合平台、模板和可用能力生成文案与版式建议。你可以先比较最多七个预览，再把选中的方案应用到画布。

• 从笔记开始：命令「用 AI 把当前笔记 / 选中文字做成封面」读取选文；没有选文时使用当前笔记内容。当前实现最多取前 6,000 个字符，长文建议先选出重点。
• 继续对话修改：要求调整配色、标题、字体或布局，随后检查画布结果。自然语言请求受当前指令协议与模型输出约束，复杂要求可拆成几步。
• 文字和布局先行：默认不生成图片。需要图片时，可用独立「AI 生图」生成并预览后插入。
• 仍然可以手改：通过排版指令建立的文字和形状保留各自的编辑能力。
• 对话互不干扰：「新对话」保留画布并隔离旧聊天上下文；点击标题旁的历史图标切换对话、重命名或删除，草稿随对话保存。当前编辑中，已应用消息下方的分支图标可从该次方案创建独立画布；「从空白画布开始」也会创建单独文件。
• 消息可管理：消息下方支持复制、重新编辑和删除整轮对话；删除只清理聊天上下文，保留画布。明确指定的文字颜色会保留，低对比度时可选择加描边或调深。
• 清晰的作用范围：输入区显示当前画布或选中元素。仅携带当前对话最近的成功轮次，不把失败回复作为后续指令；重开后恢复文字、状态及草稿，预览和历史画布快照限当前编辑会话。每个画布最多 30 段对话，每段保留最近 100 条消息。
• 不接模型的选择：离线助手可解释部分中英文指令，覆盖范围小于接入模型后的自然语言设计。

可以尝试：

区别请记住：AI 排版生成可编辑元素；AI 生图与改图产生像素图片。 在图片中画出来的字，不会自动变成可编辑文字。

02 · 多平台画幅、模板与系列风格

选择目标画幅后，模板会按对应尺寸构图。打开安全区参考，可避开产品预设的时长标签、头像、互动按钮等容易遮挡内容的位置。

以上是插件内置预设，不代表各平台永远不变的上传规范；发布时以目标平台要求为准。

换比例时如何处理内容？ 使用模板创建的封面，会重新计算标题、间距和锚点；手动添加的自由元素按比例适配。没有模板的纯手工画布采用缩放适配。切换后应检查长标题、边缘配图和安全区。

模板支持保留标题、副标题后换风格；另有不同方向的 A/B 候选。A/B 指设计方案比较，不包含线上流量分流、点击率统计或增长保证。

把满意的模板、配色和字体存为「系列」，后续内容可以复用。当前最多保留六套系列，第一套作为 AI 默认风格参考；系列保存外观配置，不是整张画布副本。

真实模板输出

上图使用本仓库 src/templates.ts 与实际字体渲染，三列依次为小红书、YouTube、公众号画幅；三行是编辑大标题、备忘录、瑞士网格。它是模板输出接触表，不是 AI 示意图，也不是 Obsidian 界面截图。复现方式

03 · 画布、图层和自由绘制

你可以在同一画布内混排文字、形状、图片、贴纸、图标和手绘路径。

分组保持元素独立。 给标题、装饰线和标签编成一组后，仍可继续编辑内部元素；分组本身不会把它们压成图片。

自由绘制：按 B 开关画笔，选择颜色与 1–100 px 粗细，按 Esc 退出。每一笔保存为独立路径，可移动、缩放、改色、删除，逐笔撤销和重做。实现支持触控笔压力输入，但实体触控笔尚未完成本项目的硬件验收；鼠标绘制使用均匀粗细。

顶部插入工具默认用图标呈现，悬停可看名称；在「设置 → 常规 → 界面 → 顶部插入工具」可以改为图标加文字。文字和素材插入后弹层关闭，按住 Shift 可连续插入。

04 · 字体、配色与离线素材

默认字库提供 34 个开源字体文件，包括不同字重与中英文字体；模板和 AI 可使用 12 套字体搭配。这里的 34 指文件数，不是 34 个互不重复的字体家族。

支持本机字体，以及导入 TTF / OTF / WOFF / WOFF2。系统字体换设备后可能缺失；希望设计可移植时，优先使用默认字库或一并备份导入字体。

默认字库的两种安装方式：完整 ZIP 自带字体；三文件安装会从 qiaomu-cover-fonts 经 jsDelivr 下载，GitHub 地址兜底，下载后按内置大小与 SHA-256 清单校验。完整库约 31 MB；未下载完成时使用系统字体，完成后可离线使用。

贴纸与图标离线可用：Fluent Emoji Flat 贴纸和 Lucide 线性图标压缩后嵌入 main.js，三文件安装也不依赖额外素材下载。字体采用 SIL OFL，素材许可与来源见 THIRD_PARTY.md。示意图中的装饰只用于说明，不代表素材目录逐项截图。

05 · 一个图库，管理四类来源

从顶部「图库」进入，统一预览与选取素材。一次最多插入 24 张图片，整批插入可以一步撤销。

本地文件夹不递归扫描、不跟随符号链接；插入时才把图片内嵌到设计。移除文件夹引用不会删除文件夹。

图库上传支持按钮和拖放：单张上限 30 MB、36 MP；本地文件夹单张读取上限 30 MB。直接向画布导入走另一条路径，上限 25 MB，并可能压缩大图。图库接收成功不等于任何大图都能不经处理直接插入画布。

批量删除前会显示数量并确认；失败项目保留选中，便于重试。编辑任务提示词只是填入表单，再次确认生成才请求模型。Unsplash 是可按其许可免费使用的摄影图库，不包含 Unsplash+ 付费照片。在应用管理页创建应用后，从 Keys 复制 Access Key（AK）；不要填写 Application ID 或 Secret Key（SK）。设置中有直接申请链接和步骤，代理地址默认收起。

Unsplash 插入会保留摄影师和来源链接，并调用其下载跟踪接口。

06 · AI 生图、参考图编辑与继续创作

独立生图：打开「AI 生图」，先选模型、比例与可用参数，再写提示词、添加参考图，确认提交。默认留在弹窗等待并显示计时，完成后先预览；你也可以主动放到后台，继续编辑其他设计。

后台完成后通过通知查看结果，或从「图库 → 生图任务」找回。关闭弹窗不会自动丢弃已完成结果，也不会自动把生成图塞进画布。任务按返回结果保留图片，多图结果可以选取后插入。

选区改图：选中图片、文字、形状、分组或多个元素，右键「AI 编辑」或在属性面板选择「用 AI 编辑」，输入修改要求。

单图替换保留位置、大小、旋转、镜像、裁剪、遮罩和层序，并支持撤销。如果生成期间原选区被修改或删除，插件会拒绝直接替换，仍可插入副本。

替换文字或矢量选区会失去这部分原有的文字 / 矢量编辑能力，因为结果是一张位图。 可通过撤销恢复原元素；如果还需要逐字修改，优先插入副本或保留源设计。

内置生成与改图提示词可点击填入草稿，支持保存自己的提示词。预设包括极简背景、纸艺海报、产品摄影、编辑插画，以及换背景、水彩、卡通、素描、清晰修复等。纯色背景不等于透明抠图。

配置模型与服务

在「设置 → 模型与服务」分别管理排版模型和生图模型：添加服务、接口地址、密钥、模型 ID，设置默认项。支持搜索和别名；别名只改变显示名称，不会改变真实请求的模型 ID。编辑非默认模型不会自动切换当前模型。

Seedream 的参考图数量、组图、分辨率、透明编辑和拆层随版本变化；即梦编辑使用独立 compositions 协议。详细能力与限制见 AI 模型说明。模型出现在列表里不代表你的账户已开通。

云端请求可能收费。插件不自动重新提交失败的付费生成请求；重载可能中断连接，但本机中断不代表服务商已经取消生成或退款。已完成结果可恢复，失败后由你决定是否新建请求。

07 · 保存源文件，导出适合发布的图片

导出时先确认尺寸、格式、质量和预计体积，再决定保存位置与是否回写笔记。

例如，默认文件名模板 {name}-{platform} 可以把「AI 写作」的小红书设计导出成带 xhs 标记的文件。重复导出会选择新文件名，避免直接覆盖已有成品。

只导出某个元素：选中一个或多个元素，右键下载选区透明 PNG。按选区边界裁切、保留层序，最长边限制为 4096 px；选择保存位置后写入，取消则不写入。

保存设计和导出成品是两件事：.qcover 用于继续编辑，图片用于发布。插件不自动登录或发布到小红书、公众号、YouTube 等平台。

快捷键与高频操作

以下快捷键在设计画布获得焦点时使用；编辑文字时会保留正常输入行为。macOS 使用 ⌘，Windows / Linux 对应 Ctrl。

文件、备份和隐私

你的数据存在哪里

自动保存有写入冲突保护，但不能代替备份。不要在两个设备上同时改同一个设计文件。升级插件前保留上述数据；卸载或手工删除插件目录可能一并丢失图库、任务与配置。

乔木 Home 集成可显示最近设计、创建入口和设计搜索；没有安装 Home 也可以正常使用设计插件。

哪些操作会联网

基础画布编辑不上传设计，插件不收集客户端遥测。以下功能有各自的网络或本机访问边界：

模型密钥不写入 .qcover 设计文件；AI 服务配置位于本地插件设置中，不应将 data.json 当作可公开分享的无敏感文件。自定义端点与代理由你选择，请根据服务条款判断是否提交私人笔记和图片。

插件免费，赞助是自愿行为，不解锁额外功能；模型服务、网络图片与字体各自遵守对应服务条款和许可。

常见问题

开发、验证与项目结构

推荐使用 Node.js 22（与仓库 CI 一致）和 npm。

git clone https://github.com/joeseesun/qiaomu-cover-design.git
cd qiaomu-cover-design
npm ci --ignore-scripts
npm run check

check 依次运行 ESLint、测试、TypeScript 检查和生产构建。产物为根目录的 main.js；开发安装还需要 manifest.json 与 styles.css。基础构建不需要完整字体二进制；打包完整 ZIP 则需要校验通过的字体及许可文件。

运行时以 Obsidian FileView、Fabric.js 7 和 perfect-freehand 实现；不打包 React 或 Next.js，不加载远程可执行代码。AI 输出通过有限画布指令应用，模型不获得任意导出或文件读写指令。

验证范围

本次文档核验基于 0.2.1 源码，并于 2026-10-10 运行 npm run check：104 项测试中 103 通过、1 跳过、0 失败，ESLint、TypeScript 与生产构建通过；生产依赖审计当次为 0 漏洞。跳过项为缺少原生 Canvas 二进制的全模板布局检查；本文另通过浏览器渲染了 3 个模板 × 3 种尺寸，不替代全量宿主验收。

0.2.1 验收记录另记录了真实 Obsidian 1.14.4 的图库、绘制、工具栏等测试，以及 Seedream 5.0 Lite 和即梦 4.5 生图 / 参考编辑实测。这些是既有版本验收记录，不是本次写文档重新执行的付费模型测试。

Windows / Linux、实体触控笔、Codex 图片编辑、弹出窗口尚未完成记录中的验收；其他图片模型版本有协议与参数测试，不等于逐版本实际付费输出认证。更多细节见验证记录。

来源、贡献与作者

本项目由同一作者的 cover4xiaohongshu 改造，保留其 Git 历史；插件运行时使用 Obsidian FileView 与 Fabric 独立实现。原项目分析说明功能映射，第三方声明列明字体、贴纸、图标和代码许可。

欢迎提交问题与改进 PR。复现信息应包含插件版本、Obsidian 版本、系统、操作步骤及不含敏感内容的截图。开发协作见 CONTRIBUTING.md，安全报告见 SECURITY.md，交流遵循行为准则。

向阳乔木 · 个人站 · 博客 · 乔木推荐 · X @vista8 · GitHub @joeseesun · 公众号「向阳乔木推荐看」

MIT License © 向阳乔木。第三方字体、素材保留各自许可。