在使用 ComfyUI 进行图像生成实验时,你是否也遇到过这样的情况?
- 某个检查点模型配合特定采样器效果极佳,但下次再用时已经记不清参数;
- 一组提示词在某个 LoRA 下表现优异,却找不到当时的记录;
- 想给复杂节点写个使用说明,但懒得每次都翻文档。
开发者 jfcantu 遇到了同样的问题。于是他开发了 ComfyUI-AutoNotes ——一个专为 ComfyUI 设计的智能笔记扩展,能够根据当前工作流的上下文,自动显示相关的笔记内容。
这不是一个通用备忘录工具,而是一个与工作流深度集成的知识助手。它不打扰你,只在你需要的时候出现。

核心功能一览
实时可见,随时可改
笔记以侧边栏形式嵌入 ComfyUI 界面右侧,打开即见。点击任意笔记即可编辑,无需跳转外部应用或重启界面。
支持将重要笔记“固定”显示,例如快捷键列表或常用配置参考,始终保持可见。
上下文感知,精准触发
AutoNotes 的核心价值在于:只展示当前场景需要的信息。
你可以设置多种触发条件,让笔记在满足特定条件时自动弹出。避免在大量文本中手动查找。
目前支持以下几种触发方式:
| 触发类型 | 说明 |
|---|---|
| 节点被选中 | 当选中某类节点(如 LoraLoader)时显示笔记 |
| 节点属性匹配 | 仅当该节点具有指定属性值时才显示(如加载了 myFavoriteModel.safetensors 的 CheckpointLoader) |
| 工作流中存在节点 | 只要画布上存在某类节点即显示(无论是否选中) |
| 工作流名称包含关键词 | 当前工作流文件名包含设定关键词时触发 |
📌 示例:创建一条关于
realisticVision模型的笔记,设置触发条件为ckpt_name == realisticVision_v5.safetensors。当你切换到这个模型时,最佳提示词和推荐参数就会自动出现在侧边栏。
结构化管理,易于组织
笔记支持分类管理:
- 创建多个文件夹(如“模型文档”、“工作流模板”、“故障排查”)
- 添加标签,方便后续搜索与筛选
所有数据结构清晰,便于后期维护和迁移。
如何安装?
方法一:通过 ComfyUI-Manager 安装(推荐)
- 打开 ComfyUI Manager
- 搜索 “AutoNotes”
- 点击安装
- 重启 ComfyUI
安装完成后,右侧将出现 AutoNotes 侧边栏。
方法二:手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/jfcantu/ComfyUI-AutoNotes.git
重启 ComfyUI 即可。
开始使用:创建第一条笔记
方式 1:快速添加
点击侧边栏的「添加」按钮 → 命名笔记 → 选择存放文件夹 → 开始输入内容。
方式 2:从节点智能创建
有两种便捷入口:
- 在画布上右键点击任意节点,选择「为此节点创建 AutoNote」
- 或选中节点后,点击侧边栏的「从当前节点添加」
系统会自动生成基于该节点类型和当前配置的初始触发条件,减少手动设置成本。
显示模式切换
通过顶部下拉菜单可切换两种显示模式:
- 全部:列出所有笔记,适合浏览或整理
- 自动:仅显示当前上下文匹配的笔记,保持界面干净
典型使用场景
| 场景 | 应用方式 |
|---|---|
| 模型文档化 | 为每个检查点或 LoRA 创建专属笔记,记录推荐参数、触发词、适用风格等。切换模型时自动提示。 |
| 复杂节点指南 | 给不常用的高级节点(如 ControlNet、KSampler Advanced)添加操作说明,选中即显。 |
| 工作流检查清单 | 固定常见任务的工作流程步骤,如人像精修、超分放大等,作为执行对照表。 |
| 问题排查提醒 | 记录已知冲突组合或错误配置,当下次使用类似结构时自动提醒。 |
| 通用参考信息 | 固定显示快捷键、色彩空间设置、常用正负提示词等高频信息。 |
技术细节(供进阶用户参考)
数据存储位置
所有笔记按用户隔离,保存在 ComfyUI 用户目录下:
ComfyUI/user/<username>/autonotes/
├── notes.json # 笔记内容及元数据
└── folders.json # 文件夹结构
支持多用户环境下的独立配置。
提供 REST API 接口
扩展内置轻量级 API,可用于外部工具集成或自动化脚本调用:
| 方法 | 路径 | 功能 |
|---|---|---|
| GET | /autonotes/notes | 获取过滤后的笔记列表 |
| POST | /autonotes/notes | 创建新笔记 |
| PUT | /autonotes/notes/{uuid} | 更新指定笔记 |
| DELETE | /autonotes/notes/{uuid} | 删除笔记 |
| GET | /autonotes/folders | 获取文件夹列表 |
| POST / PUT / DELETE | /autonotes/folders/{uuid} | 文件夹增删改 |
可用于构建更复杂的知识管理系统或同步至外部数据库。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...















