![[Question] matrix sharing feature](https://www.chat-gpts.plus/wp-content/uploads/2026/06/2753-158f0beb.jpg)
[Question] matrix sharing feature
快速结论:这个警告在 ComfyUI-Manager 启动时出现,提示 matrix-nio 依赖未安装,导致 Matrix 共享功能被禁用。该功能为可选特性,绝大多数用户不需要安装,忽略此警告即可。
问题场景
用户启动 ComfyUI(含 ComfyUI-Manager 插件)时,控制台输出一行以 [ComfyUI-Manager] 开头的黄色或提示性信息,内容涉及 matrix sharing feature 和 matrix-nio 依赖缺失。该提示纯粹是软警告,不会阻止程序运行。
报错原文
[ComfyUI-Manager] The matrix sharing feature has been disabled because the `matrix-nio` dependency is not installed.
To use this feature, please run the following command:
D:\ComfyUI\.venv\Scripts\python.exe -m pip install matrix-nio
原因分析
该警告是正常行为,并非 Bug。ComfyUI-Manager 的开发者在最近版本中新增了一个可选功能:允许用户将生成的工作流和图像直接分享到 Matrix(一款开源的、去中心化的即时通信协议,类似于 Discord)的聊天室中。由于需要安装额外的 Python 包 matrix-nio,且绝大多数用户并不使用 Matrix 进行分享,因此 ComfyUI-Manager 默认不安装此依赖,仅在启动时打印一条软警告。该提示无错误级别,不影响任何核心功能。
环境排查
- 此问题与 Python、CUDA、PyTorch 版本无关。
- 与显卡型号、节点配置无关。
- 仅与 ComfyUI-Manager 插件版本有关(包含该可选功能的版本均可能触发)。
解决步骤
根据 Issue 讨论,您不需要做任何操作。若您希望消除该提示或需要使用 Matrix 共享功能,可按以下步骤安装依赖:
- 确认 ComfyUI 虚拟环境已激活(通常位于
ComfyUI/.venv/目录下)。 - 在终端中执行命令(根据您的实际 Python 路径调整):
D:\ComfyUI\.venv\Scripts\python.exe -m pip install matrix-nio - 重新启动 ComfyUI,该警告将不再出现。
如果不打算使用 Matrix 共享功能,直接无视该警告即可,不会对工作流生成或管理功能造成任何负面影响。
验证方法
重新启动 ComfyUI,检查控制台或者日志输出中是否仍包含 matrix sharing feature has been disabled 提示。如果该行消失,说明已成功安装依赖;如果依然出现,说明依赖未正确安装或路径不对,但功能仍无影响。



