ComfyUI-AutoNotes:专为 ComfyUI 设计的智能笔记插件,根据当前工作流的上下文,自动显示相关的笔记内容

插件2个月前发布 小马良
110 0

在使用 ComfyUI 进行图像生成实验时,你是否也遇到过这样的情况?

  • 某个检查点模型配合特定采样器效果极佳,但下次再用时已经记不清参数;
  • 一组提示词在某个 LoRA 下表现优异,却找不到当时的记录;
  • 想给复杂节点写个使用说明,但懒得每次都翻文档。

开发者 jfcantu 遇到了同样的问题。于是他开发了 ComfyUI-AutoNotes ——一个专为 ComfyUI 设计的智能笔记扩展,能够根据当前工作流的上下文,自动显示相关的笔记内容。

这不是一个通用备忘录工具,而是一个与工作流深度集成的知识助手。它不打扰你,只在你需要的时候出现。

ComfyUI-AutoNotes:专为 ComfyUI 设计的智能笔记插件,根据当前工作流的上下文,自动显示相关的笔记内容

核心功能一览

实时可见,随时可改

笔记以侧边栏形式嵌入 ComfyUI 界面右侧,打开即见。点击任意笔记即可编辑,无需跳转外部应用或重启界面。

支持将重要笔记“固定”显示,例如快捷键列表或常用配置参考,始终保持可见。

上下文感知,精准触发

AutoNotes 的核心价值在于:只展示当前场景需要的信息

你可以设置多种触发条件,让笔记在满足特定条件时自动弹出。避免在大量文本中手动查找。

目前支持以下几种触发方式:

触发类型说明
节点被选中当选中某类节点(如 LoraLoader)时显示笔记
节点属性匹配仅当该节点具有指定属性值时才显示(如加载了 myFavoriteModel.safetensors 的 CheckpointLoader)
工作流中存在节点只要画布上存在某类节点即显示(无论是否选中)
工作流名称包含关键词当前工作流文件名包含设定关键词时触发

📌 示例:创建一条关于 realisticVision 模型的笔记,设置触发条件为 ckpt_name == realisticVision_v5.safetensors。当你切换到这个模型时,最佳提示词和推荐参数就会自动出现在侧边栏。

结构化管理,易于组织

笔记支持分类管理:

  • 创建多个文件夹(如“模型文档”、“工作流模板”、“故障排查”)
  • 添加标签,方便后续搜索与筛选

所有数据结构清晰,便于后期维护和迁移。

如何安装?

方法一:通过 ComfyUI-Manager 安装(推荐)

  1. 打开 ComfyUI Manager
  2. 搜索 “AutoNotes”
  3. 点击安装
  4. 重启 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}文件夹增删改

可用于构建更复杂的知识管理系统或同步至外部数据库。

© 版权声明

相关文章

暂无评论

none
暂无评论...