ComfyUI-Custom-Scripts中文本自动补全功能失效问题分析

问题背景

在使用ComfyUI-Custom-Scripts扩展时，用户报告在StableSwarmUI环境下文本自动补全功能无法正常工作。具体表现为：

1. 设置菜单中缺少文本自动补全选项
2. 自动补全功能完全失效
3. 其他自定义脚本功能正常

环境配置

问题出现在以下环境中：

• 操作系统：Windows 11
• Python版本：3.10.11
• 手动安装的ComfyUI（非便携版）
• 所有组件均为最新版本

问题分析

通过日志和浏览器开发者工具分析，发现以下关键错误信息：

1. 动态加载模块失败：autocompleter.js文件无法被正确获取
2. HTTP请求返回404状态码
3. 错误仅出现在StableSwarmUI环境下，独立ComfyUI工作正常

根本原因

深入分析后发现，问题源于autocompleter.js文件中的导入路径问题：

1. 文件中使用了相对路径../进行模块导入
2. 当ComfyUI作为StableSwarmUI的子目录运行时（位于/ComfyBackendDirect/下）
3. 这些相对路径会意外地指向父目录，导致模块加载失败

解决方案

该问题已通过以下方式修复：

1. 修正autocompleter.js中的导入路径
2. 移除不必要的../相对路径引用
3. 确保路径在不同部署环境下都能正确解析

技术启示

这个案例展示了Web应用开发中路径处理的重要性，特别是在以下场景中：

1. 当应用作为子目录部署时
2. 使用动态模块加载时
3. 跨不同运行环境时

开发者应当：

• 谨慎使用相对路径
• 考虑不同部署场景下的路径解析
• 实现更健壮的路径处理逻辑

总结

ComfyUI-Custom-Scripts中的文本自动补全功能在特定部署环境下失效的问题，揭示了Web应用中路径处理的重要性。通过修正模块导入路径，确保了功能在各种部署场景下的稳定性。这个案例也为类似项目的开发提供了有价值的参考。