Sửa lỗi ComfyUI Manager không nhận diện Custom Nodes đã cài đặt

Bạn đã cài đặt custom nodes trong ComfyUI, chúng nằm ngay đó trong thư mục custom_nodes của bạn, nhưng ComfyUI Manager cứng đầu hiển thị chúng là "chưa cài đặt". Bạn nhấp vào cài đặt lại và nó tạo ra bản sao. Hoặc bạn cố gắng cập nhật nhưng nó nói không có gì để cập nhật mặc dù bạn biết các phiên bản mới tồn tại.

Câu trả lời nhanh: ComfyUI Manager không nhận diện các nodes đã cài đặt thường do sự không đồng bộ cơ sở dữ liệu, phương pháp cài đặt không đúng, hoặc xung đột metadata được cache. Cách khắc phục thường bao gồm xóa cache cơ sở dữ liệu node của Manager, đảm bảo nodes được cài đặt qua Manager thay vì git clone thủ công, và xác minh cấu trúc thư mục phù hợp với kỳ vọng của Manager. Khởi động lại Manager hoặc xây dựng lại cơ sở dữ liệu giải quyết hầu hết các trường hợp trong vài phút.

Vấn đề này nằm trong số những sự thất vọng ComfyUI phổ biến nhất được người dùng báo cáo. Đặc biệt khó chịu vì các nodes của bạn hoạt động hoàn hảo trong workflows. Chúng tải tốt, thực thi không có lỗi, nhưng Manager nghĩ chúng không tồn tại. Hãy khắc phục điều này một cách có hệ thống.

Tại sao ComfyUI Manager không nhận diện được Nodes?

Hiểu nguyên nhân gốc rễ giúp bạn khắc phục đúng cách và ngăn ngừa tái diễn.

Cách Manager theo dõi các cài đặt

ComfyUI Manager không chỉ nhìn vào thư mục custom_nodes của bạn. Nó duy trì một cơ sở dữ liệu nội bộ theo dõi những gì nó đã cài đặt, từ đâu, và phiên bản nào. Cơ sở dữ liệu này nằm trong cấu trúc thư mục riêng của Manager.

Khi bạn clone thủ công một repository node bằng git, node hoạt động vì bản thân ComfyUI chỉ quét các tệp Python trong custom_nodes. Nhưng Manager không biết về nó vì không có gì cập nhật cơ sở dữ liệu của Manager.

Điều ngược lại cũng xảy ra. Nếu cơ sở dữ liệu của Manager nói rằng một thứ gì đó đã được cài đặt nhưng thư mục đã bị xóa hoặc di chuyển, Manager hiển thị nó là đã cài đặt trong khi nó thực sự đang thiếu.

Nguyên nhân phổ biến của sự không đồng bộ

Các thao tác git thủ công là nguyên nhân chính. Clone, pull, hoặc xóa các thư mục node mà không qua Manager phá vỡ việc theo dõi của nó.

Cài đặt thất bại có thể để lại các mục nhập cơ sở dữ liệu một phần. Manager đã cố cài đặt một thứ gì đó, thất bại giữa chừng, nhưng ghi nhận nó là đã cài đặt trước khi thất bại.

Di chuyển hoặc sao chép cài đặt ComfyUI thường để lại cơ sở dữ liệu của Manager trỏ đến các đường dẫn sai hoặc với thông tin cũ về hệ thống trước đó.

Cập nhật Manager đôi khi giới thiệu các thay đổi schema cơ sở dữ liệu. Các định dạng cơ sở dữ liệu cũ có thể không được phân tích chính xác sau khi cập nhật chính Manager.

Can thiệp của phần mềm diệt virus đôi khi xóa các tệp trong quá trình cài đặt nhưng sau khi Manager ghi nhận cài đặt là hoàn tất. Manager nghĩ rằng nó đã thành công nhưng các tệp đã biến mất.

Lớp Cache

Manager cũng cache metadata node như các bản cập nhật khả dụng và thông tin repository. Cache này có thể trở nên cũ hoặc bị hỏng, hiển thị trạng thái lỗi thời hoặc không chính xác ngay cả khi cơ sở dữ liệu bên dưới là đúng.

Các vấn đề cache gây ra các triệu chứng như "cập nhật khả dụng" không bao giờ xuất hiện, hoặc số phiên bản không chính xác hiển thị trong giao diện Manager.

Bạn khắc phục các vấn đề nhận diện Node như thế nào?

Bắt đầu với các giải pháp đơn giản nhất và leo thang nếu cần thiết.

Giải pháp 1: Khởi động lại ComfyUI hoàn toàn

Đôi khi Manager chỉ cần một khởi tạo mới. Đóng ComfyUI hoàn toàn - không chỉ làm mới, mà dừng tiến trình Python.

Đợi vài giây để các handle tệp được giải phóng, sau đó khởi động ComfyUI lại. Manager khởi tạo lại khi khởi động và có thể phát hiện các nodes nó đã bỏ lỡ trong một phiên chạy dài.

Bước đơn giản này khắc phục vấn đề khoảng 20% thời gian với rủi ro bằng không.

Giải pháp 2: Buộc xây dựng lại cơ sở dữ liệu Manager

Manager có chức năng tích hợp để xây dựng lại cơ sở dữ liệu node của nó từ trạng thái hệ thống tệp.

Mở Manager trong ComfyUI bằng cách nhấp vào nút Manager. Điều hướng đến cài đặt hoặc tùy chọn nâng cao. Tìm tùy chọn có nhãn "Rebuild Database" hoặc "Rescan Nodes".

Nhấp vào đây buộc Manager quét thư mục custom_nodes mới và xây dựng lại các bản ghi cài đặt của nó. Bất kỳ nodes hiện có nào sẽ được phát hiện và đăng ký đúng cách.

Sau khi xây dựng lại, khởi động lại ComfyUI để các thay đổi có hiệu lực đầy đủ.

Giải pháp 3: Xóa cache cơ sở dữ liệu Node

Nếu xây dựng lại không giúp được, hãy xóa các tệp cache thủ công. Điều hướng đến thư mục cài đặt ComfyUI của bạn.

Tìm thư mục ComfyUI-Manager bên trong custom_nodes. Trong thư mục của Manager, tìm các tệp có tên như node_db.json, cache.json, hoặc các tệp cơ sở dữ liệu tương tự.

Xóa các tệp cache này. Đừng lo, chúng sẽ được tạo lại tự động khi Manager khởi động lại. Cơ sở dữ liệu mới sẽ phản ánh chính xác các cài đặt hiện tại của bạn.

Khởi động lại ComfyUI sau khi xóa các tệp cache. Manager sẽ mất thời gian lâu hơn một chút khi tải lần đầu vì nó xây dựng lại mọi thứ từ đầu.

Giải pháp 4: Cài đặt lại các Nodes có vấn đề qua Manager

Đối với các nodes bạn đã clone thủ công, cách khắc phục sạch nhất là cài đặt lại qua Manager.

Đầu tiên, xóa thư mục được clone thủ công khỏi custom_nodes. Đừng chỉ đổi tên nó vì điều đó có thể gây ra các vấn đề khác.

Sau đó sử dụng giao diện Install Custom Nodes của Manager để cài đặt cùng node đó. Manager sẽ clone nó đúng cách và đăng ký nó trong cơ sở dữ liệu của mình.

Cách tiếp cận này đảm bảo Manager có theo dõi đầy đủ và có thể xử lý cập nhật, dependencies, và gỡ bỏ đúng cách trong tương lai.

Giải pháp 5: Kiểm tra tên thư mục

Manager kỳ vọng các tên thư mục cụ thể khớp với tên repository. Nếu bạn đổi tên một thư mục node, Manager không thể khớp nó với mục nhập cơ sở dữ liệu của nó.

Kiểm tra rằng tên thư mục khớp với những gì Manager kỳ vọng. Repository ComfyUI-Impact-Pack nên có một thư mục có tên chính xác là ComfyUI-Impact-Pack, không phải Impact-Pack hoặc bất kỳ thứ gì được viết tắt.

Nếu bạn đã đổi tên thư mục, hãy đổi lại tên cũ hoặc cài đặt lại qua Manager để nhận tên đúng tự động.

Giải pháp 6: Xác minh trạng thái Git Repository

Manager sử dụng git để theo dõi các phiên bản và cập nhật. Nếu thư mục .git bên trong một node bị thiếu hoặc hỏng, Manager không thể xác định trạng thái cài đặt.

Điều hướng vào thư mục của một node có vấn đề và kiểm tra xem có thư mục .git không. Nếu nó bị thiếu, node sẽ không được theo dõi đúng cách.

Bạn có thể thử chạy git init sau đó thiết lập remote đến repository gốc, nhưng cài đặt lại qua Manager thường đơn giản hơn.

Giải pháp 7: Kiểm tra các cài đặt trùng lặp

Đôi khi cùng một node được cài đặt hai lần với các biến thể tên nhỏ. Manager có thể đang theo dõi một cái trong khi ComfyUI tải cái kia.

Tìm kiếm các bản sao trong thư mục custom_nodes của bạn. Tìm các thư mục có tên tương tự hoặc chức năng node giống hệt. Xóa các bản sao, chỉ giữ cái được cài đặt qua Manager.

Các mẫu trùng lặp phổ biến bao gồm có cả tên repository gốc và phiên bản đã đổi tên, hoặc cả nhánh release và nhánh development của cùng một node.

Phải làm gì nếu Nodes hiển thị số phiên bản sai?

Các vấn đề phát hiện phiên bản có liên quan nhưng khác với phát hiện cài đặt.

Cơ chế theo dõi phiên bản

Manager kiểm tra các tag và commit git để xác định phiên bản. Nếu một repository node không sử dụng gắn tag phiên bản đúng cách, Manager hiển thị phiên bản "không xác định" hoặc không chính xác.

Đây không phải là điều bạn có thể sửa cho các nodes bạn không tạo. Nhà phát triển node cần sử dụng git tags đúng cách.

Cache cũ

Phổ biến hơn, các phiên bản sai là kết quả từ metadata được cache. Xóa cache của Manager như mô tả ở trên để buộc kiểm tra phiên bản mới.

Sau khi xóa cache, Manager lấy trạng thái repository hiện tại từ GitHub hoặc GitLab. Điều này mất một lúc nhưng cung cấp thông tin phiên bản chính xác.

Vấn đề mạng

Nếu Manager không thể kết nối đến các máy chủ repository, nó hiển thị các phiên bản cũ. Kiểm tra kết nối mạng của bạn và bất kỳ quy tắc tường lửa nào chặn các thao tác git.

Mạng doanh nghiệp thường chặn các giao thức git. Nếu bạn đang ở trên mạng bị hạn chế, Manager không thể cập nhật kiến thức của nó về các phiên bản khả dụng.

Bạn ngăn ngừa vấn đề này trong tương lai như thế nào?

Các thực hành tốt giữ cho Manager và các nodes của bạn đồng bộ vĩnh viễn.

Luôn cài đặt qua Manager

Ngay cả khi bạn có URL GitHub và biết git, hãy sử dụng giao diện của Manager. Dán URL vào trường cài đặt tùy chỉnh của Manager thay vì clone thủ công.

Điều này đảm bảo đăng ký cơ sở dữ liệu đúng cách ngay từ đầu. Clone thủ công chỉ nên xảy ra khi debug hoặc phát triển nodes.

Sử dụng Manager cho cập nhật

Khi các nodes có cập nhật khả dụng, sử dụng chức năng cập nhật của Manager thay vì tự chạy git pull.

Cập nhật của Manager xử lý cập nhật dependencies, theo dõi phiên bản cơ sở dữ liệu, và các hook sau cập nhật mà pull thủ công bỏ qua.

Tránh thao tác thư mục trực tiếp

Đừng xóa, đổi tên, hoặc di chuyển các thư mục node thủ công. Sử dụng chức năng gỡ cài đặt của Manager để xóa nodes sạch sẽ.

Nếu bạn phải thao tác thư mục trực tiếp, hãy mong đợi sẽ phải xây dựng lại cơ sở dữ liệu của Manager sau đó.

Cập nhật Manager thường xuyên

Giữ cho Manager luôn được cập nhật. Các phiên bản mới hơn sửa các lỗi xử lý cơ sở dữ liệu và cải thiện phát hiện node.

Cập nhật Manager trước khi khắc phục sự cố node vì bản sửa có thể đã tồn tại trong phiên bản Manager mới hơn.

Đối với người dùng muốn có khả năng ComfyUI mà không cần quản lý các chi tiết kỹ thuật này, Apatero.com cung cấp cơ sở hạ tầng được duy trì chuyên nghiệp. Nodes luôn được cài đặt, cập nhật và cấu hình đúng cách mà không có bất kỳ vấn đề đồng bộ hóa nào.

Còn các vấn đề nhận diện Node cụ thể thì sao?

Một số nodes có các vấn đề nhận diện độc đáo đáng được giải quyết cụ thể.

Nhận diện Impact Pack

ComfyUI-Impact-Pack phức tạp với nhiều dependencies. Các vấn đề nhận diện thường bắt nguồn từ các vấn đề submodule.

Đảm bảo thư mục impact_pack_models tồn tại và chứa các tệp cần thiết. Impact Pack sẽ không hiển thị là được cài đặt đúng cách nếu các tệp model của nó bị thiếu ngay cả khi code có mặt.

Sử dụng trình cài đặt tích hợp của Impact Pack cho các dependencies của nó thay vì cài đặt chung của Manager. Điều này xử lý các tệp model đúng cách.

Vấn đề ControlNet Preprocessor

ComfyUI-ControlNet-AUX yêu cầu tải model sau khi cài đặt. Manager đánh dấu nó là đã cài đặt ngay lập tức, nhưng nó không thực sự sẵn sàng cho đến khi các model được tải xuống.

Nếu các nodes preprocessing bị lỗi, chạy các script tải model hoặc để chúng tải xuống khi sử dụng lần đầu. Node được cài đặt theo Manager, chỉ là chưa hoàn chỉnh.

Nhận diện Video Helper Suite

VideoHelperSuite có các dependencies ffmpeg cụ thể ảnh hưởng đến nhận diện. Nếu ffmpeg không thể truy cập đúng cách, Manager có thể hiển thị trạng thái cài đặt một phần.

Xác minh ffmpeg nằm trong PATH hệ thống của bạn và có thể truy cập từ dòng lệnh. Sau đó xây dựng lại cơ sở dữ liệu của Manager.

Câu hỏi thường gặp

Tại sao Manager hiển thị "Update" cho một node tôi vừa cài đặt?

Điều này xảy ra khi bạn cài đặt từ nhánh development nhưng Manager kiểm tra nhánh chính để cập nhật. Số phiên bản không khớp, vì vậy Manager thấy có cập nhật khả dụng. Thường an toàn để bỏ qua hoặc bạn có thể cập nhật để đồng bộ với nhánh chính.

Tôi có thể sử dụng cả Manager và git clones thủ công cùng nhau không?

Về mặt kỹ thuật có, nhưng các clone thủ công sẽ không xuất hiện trong giao diện của Manager. Chúng sẽ hoạt động trong ComfyUI nhưng Manager sẽ không theo dõi chúng. Để có trải nghiệm sạch nhất, chọn một phương pháp và tuân theo nó.

Xây dựng lại cơ sở dữ liệu có làm hỏng workflows của tôi không?

Không, xây dựng lại cơ sở dữ liệu chỉ ảnh hưởng đến việc theo dõi của Manager. Workflows, prompts đã lưu, và cấu hình node của bạn vẫn không bị ảnh hưởng. Mọi thứ sẽ hoạt động chính xác như trước, chỉ với trạng thái Manager chính xác.

Tại sao một số nodes xuất hiện nhiều lần trong danh sách của Manager?

Điều này chỉ ra nhiều cài đặt, thường từ các nỗ lực cài đặt thất bại để lại các mục nhập cơ sở dữ liệu một phần. Xóa cơ sở dữ liệu, xóa tất cả các bản sao của node trùng lặp, sau đó cài đặt lại một lần qua Manager.

Làm sao tôi biết nếu một node được cài đặt qua Manager hay thủ công?

Các nodes được cài đặt bởi Manager xuất hiện trong danh sách Installed Nodes với thông tin phiên bản và cập nhật đúng. Các nodes được clone thủ công hoặc không xuất hiện hoàn toàn hoặc hiển thị phiên bản "Unknown" mà không có khả năng cập nhật.

Điều này có ảnh hưởng đến khả năng sử dụng nodes trong workflows của tôi không?

Không, các vấn đề nhận diện node hoàn toàn là vấn đề của Manager. Bản thân ComfyUI quét thư mục custom_nodes độc lập và tải những gì nó tìm thấy. Workflows của bạn sẽ hoạt động bất kể trạng thái nhận diện của Manager.

Tại sao Manager nói "không có nodes được cài đặt" khi tôi có hàng chục?

Điều này chỉ ra hỏng hoặc mất hoàn toàn cơ sở dữ liệu. Các nodes của bạn ổn và đang hoạt động. Xóa hoàn toàn các tệp cache của Manager và xây dựng lại cơ sở dữ liệu từ đầu. Mọi thứ sẽ được phát hiện.

Tôi có thể sao lưu cơ sở dữ liệu của Manager trước khi khắc phục sự cố không?

Có, sao chép các tệp json từ thư mục của Manager trước khi xóa chúng. Nếu có gì sai bạn có thể khôi phục chúng. Tuy nhiên, vì các tệp này chính xác là những gì bạn đang khắc phục sự cố, khôi phục chúng cũng sẽ khôi phục vấn đề.

Phải làm gì nếu cùng một vấn đề cứ tái diễn?

Các vấn đề tái diễn thường chỉ ra một vấn đề workflow như cài đặt lại nodes thủ công giữa các lần xây dựng lại Manager. Kiểm tra thói quen của bạn và đảm bảo bạn đang sử dụng Manager một cách nhất quán cho tất cả các thao tác node.

Tôi có nên báo cáo lỗi nhận diện đến GitHub của Manager không?

Nếu bạn đã thử tất cả các giải pháp và vấn đề vẫn tồn tại, có. Bao gồm phiên bản ComfyUI, phiên bản Manager, hệ điều hành, và các nodes cụ thể bị ảnh hưởng. Các nhà phát triển có thể xác định liệu đó là lỗi đã biết hay vấn đề mới.

Kết luận và Chiến lược Phòng ngừa

Các vấn đề nhận diện node của ComfyUI Manager gần như hoàn toàn bắt nguồn từ sự không đồng bộ giữa cơ sở dữ liệu của nó và hệ thống tệp thực tế của bạn. Cách khắc phục rất đơn giản vì bạn cần buộc đồng bộ hóa thông qua xây dựng lại cơ sở dữ liệu và xóa cache.

Bắt đầu với khởi động lại đơn giản. Nếu điều đó không hiệu quả, xây dựng lại cơ sở dữ liệu. Đối với các vấn đề dai dẳng, xóa tất cả các tệp cache và để Manager tạo lại chúng mới.

Từ nay trở đi, cam kết sử dụng Manager cho tất cả các thao tác node. Cài đặt qua Manager, cập nhật qua Manager, và gỡ bỏ qua Manager. Điều này giữ cho mọi thứ được đồng bộ hóa vĩnh viễn.

Vài phút dành cho việc khắc phục sự cố bây giờ tiết kiệm hàng giờ thất vọng trong tương lai. Một khi cơ sở dữ liệu Manager của bạn phản ánh chính xác các cài đặt của bạn, cập nhật hoạt động trơn tru, dependencies được giải quyết chính xác, và bạn có thể tin tưởng các chỉ báo trạng thái của Manager.

Đối với người dùng không muốn xử lý các tác vụ quản lý kỹ thuật này, Apatero.com xử lý tất cả việc cài đặt và bảo trì node tự động. Bạn có quyền truy cập vào các nodes được cấu hình đúng cách mà không có lo ngại về đồng bộ hóa cơ sở dữ liệu hoặc khắc phục sự cố thủ công.

Giữ Manager được cập nhật, sử dụng nó một cách nhất quán, và các vấn đề nhận diện này trở thành quá khứ.