Memperbaiki ComfyUI Manager yang Tidak Mengenali Custom Nodes yang Terinstal

Anda telah menginstal custom nodes di ComfyUI, mereka ada tepat di sana di folder custom_nodes Anda, tetapi ComfyUI Manager dengan keras kepala menampilkannya sebagai "tidak terinstal". Anda mengklik instal lagi dan itu membuat duplikat. Atau Anda mencoba memperbarui tetapi dikatakan tidak ada yang perlu diperbarui meskipun Anda tahu versi baru ada.

Jawaban Cepat: ComfyUI Manager tidak mengenali nodes yang terinstal biasanya disebabkan oleh desinkronisasi database, metode instalasi yang tidak tepat, atau konflik metadata yang di-cache. Perbaikannya biasanya melibatkan membersihkan cache database node Manager, memastikan nodes diinstal melalui Manager bukan git clone manual, dan memverifikasi struktur folder sesuai dengan harapan Manager. Restart Manager atau rebuild database menyelesaikan sebagian besar kasus dalam hitungan menit.

Masalah ini termasuk di antara frustrasi ComfyUI paling umum yang dilaporkan oleh pengguna. Ini sangat menjengkelkan karena nodes Anda bekerja dengan sempurna di workflows. Mereka dimuat dengan baik, dieksekusi tanpa kesalahan, tetapi Manager berpikir mereka tidak ada. Mari kita perbaiki ini secara sistematis.

Mengapa ComfyUI Manager Gagal Mengenali Nodes?

Memahami akar penyebab membantu Anda memperbaiki ini dengan benar dan mencegah terulangnya masalah.

Bagaimana Manager Melacak Instalasi

ComfyUI Manager tidak hanya melihat folder custom_nodes Anda. Ia memelihara database internal yang melacak apa yang telah diinstal, dari mana, dan versi berapa. Database ini berada di struktur direktori Manager sendiri.

Ketika Anda secara manual meng-clone repository node menggunakan git, node bekerja karena ComfyUI sendiri hanya memindai file Python di custom_nodes. Tetapi Manager tidak mengetahuinya karena tidak ada yang memperbarui database Manager.

Kebalikannya juga terjadi. Jika database Manager mengatakan sesuatu terinstal tetapi foldernya dihapus atau dipindahkan, Manager menampilkannya sebagai terinstal padahal sebenarnya hilang.

Penyebab Umum Desinkronisasi

Operasi git manual adalah penyebab utama. Meng-clone, pull, atau menghapus folder nodes tanpa melalui Manager merusak pelacakannya.

Instalasi yang gagal dapat meninggalkan entri database parsial. Manager mencoba menginstal sesuatu, gagal di tengah jalan, tetapi mencatatnya sebagai terinstal sebelum kegagalan.

Memindahkan atau menyalin instalasi ComfyUI sering meninggalkan database Manager menunjuk ke path yang salah atau dengan informasi usang tentang sistem sebelumnya.

Pembaruan Manager kadang-kadang memperkenalkan perubahan skema database. Format database lama mungkin tidak di-parse dengan benar setelah memperbarui Manager itu sendiri.

Gangguan antivirus kadang-kadang menghapus file selama instalasi tetapi setelah Manager mencatat instalasi sebagai selesai. Manager berpikir berhasil tetapi file-file hilang.

Lapisan Cache

Manager juga meng-cache metadata node seperti pembaruan yang tersedia dan informasi repository. Cache ini dapat menjadi usang atau rusak, menampilkan status usang atau tidak benar bahkan ketika database yang mendasari benar.

Masalah cache menyebabkan gejala seperti "pembaruan tersedia" tidak pernah muncul, atau nomor versi yang salah ditampilkan di antarmuka Manager.

Bagaimana Anda Memperbaiki Masalah Pengenalan Node?

Mulai dengan solusi paling sederhana dan eskalasi jika diperlukan.

Solusi 1: Restart ComfyUI Sepenuhnya

Kadang-kadang Manager hanya perlu inisialisasi baru. Tutup ComfyUI sepenuhnya - bukan hanya refresh, tetapi hentikan proses Python.

Tunggu beberapa detik agar handle file dilepaskan, lalu mulai ComfyUI lagi. Manager menginisialisasi ulang saat startup dan mungkin mendeteksi nodes yang terlewat selama sesi yang berjalan lama.

Langkah sederhana ini memperbaiki masalah sekitar 20% dari waktu tanpa risiko.

Solusi 2: Paksa Rebuild Database Manager

Manager memiliki fungsi bawaan untuk membangun ulang database node-nya dari status filesystem.

Buka Manager di ComfyUI dengan mengklik tombol Manager. Navigasi ke pengaturan atau opsi lanjutan. Cari opsi berlabel "Rebuild Database" atau "Rescan Nodes".

Mengklik ini memaksa Manager untuk memindai direktori custom_nodes dari awal dan membangun ulang catatan instalasinya. Semua nodes yang ada akan terdeteksi dan terdaftar dengan benar.

Setelah membangun ulang, restart ComfyUI agar perubahan berlaku penuh.

Solusi 3: Bersihkan Cache Database Node

Jika membangun ulang tidak membantu, bersihkan file cache secara manual. Navigasi ke direktori instalasi ComfyUI Anda.

Temukan folder ComfyUI-Manager di dalam custom_nodes. Di dalam folder Manager, cari file bernama seperti node_db.json, cache.json, atau file database serupa.

Hapus file cache ini. Jangan khawatir, mereka akan dibuat ulang secara otomatis ketika Manager restart. Database baru akan secara akurat mencerminkan instalasi Anda saat ini.

Restart ComfyUI setelah menghapus file cache. Manager akan membutuhkan waktu sedikit lebih lama pada pemuatan pertama karena membangun ulang semuanya dari awal.

Solusi 4: Instal Ulang Nodes Bermasalah Melalui Manager

Untuk nodes yang Anda clone secara manual, perbaikan paling bersih adalah menginstal ulang melalui Manager.

Pertama, hapus folder yang di-clone secara manual dari custom_nodes. Jangan hanya mengganti namanya karena itu dapat menyebabkan masalah lain.

Kemudian gunakan antarmuka Install Custom Nodes Manager untuk menginstal node yang sama. Manager akan meng-clone-nya dengan benar dan mendaftarkannya di database-nya.

Pendekatan ini memastikan Manager memiliki pelacakan penuh dan dapat menangani pembaruan, dependensi, dan penghapusan dengan benar ke depannya.

Solusi 5: Periksa Penamaan Folder

Manager mengharapkan nama folder tertentu yang cocok dengan nama repository. Jika Anda mengganti nama folder node, Manager tidak dapat mencocokkannya dengan entri database-nya.

Periksa bahwa nama folder cocok dengan yang diharapkan Manager. Repository ComfyUI-Impact-Pack harus memiliki folder bernama persis ComfyUI-Impact-Pack, bukan Impact-Pack atau sesuatu yang disingkat.

Jika Anda mengganti nama folder, ganti kembali ke nama asli atau instal ulang melalui Manager untuk mendapatkan nama yang benar secara otomatis.

Solusi 6: Verifikasi Status Repository Git

Manager menggunakan git untuk melacak versi dan pembaruan. Jika folder .git di dalam node hilang atau rusak, Manager tidak dapat menentukan status instalasi.

Navigasi ke dalam folder node yang bermasalah dan periksa direktori .git. Jika hilang, node tidak akan dilacak dengan benar.

Anda dapat mencoba menjalankan git init diikuti dengan mengatur remote ke repository asli, tetapi menginstal ulang melalui Manager biasanya lebih sederhana.

Solusi 7: Periksa Instalasi Duplikat

Kadang-kadang node yang sama terinstal dua kali dengan variasi nama sedikit. Manager mungkin melacak satu sementara ComfyUI memuat yang lain.

Cari duplikat di folder custom_nodes Anda. Cari folder dengan nama serupa atau fungsionalitas node identik. Hapus duplikat, simpan hanya yang diinstal melalui Manager.

Pola duplikat umum termasuk memiliki nama repository asli dan versi yang diganti namanya, atau branch release dan branch development dari node yang sama.

Bagaimana Jika Nodes Menampilkan Nomor Versi Salah?

Masalah deteksi versi terkait tetapi berbeda dari deteksi instalasi.

Mekanisme Pelacakan Versi

Manager memeriksa tag dan commit git untuk menentukan versi. Jika repository node tidak menggunakan penandaan versi yang tepat, Manager menampilkan versi "tidak diketahui" atau salah.

Ini bukan sesuatu yang dapat Anda perbaiki untuk nodes yang tidak Anda buat. Pengembang node perlu menggunakan tag git dengan benar.

Keusangan Cache

Lebih umum, versi yang salah dihasilkan dari metadata yang di-cache. Bersihkan cache Manager seperti dijelaskan di atas untuk memaksa pemeriksaan versi baru.

Setelah membersihkan cache, Manager mengambil status repository saat ini dari GitHub atau GitLab. Ini membutuhkan waktu sebentar tetapi memberikan informasi versi yang akurat.

Masalah Jaringan

Jika Manager tidak dapat menjangkau host repository, ia menampilkan versi usang. Periksa konektivitas jaringan Anda dan aturan firewall yang memblokir operasi git.

Jaringan perusahaan sering memblokir protokol git. Jika Anda berada di jaringan terbatas, Manager tidak dapat memperbarui pengetahuannya tentang versi yang tersedia.

Bagaimana Anda Mencegah Masalah Ini ke Depan?

Praktik yang baik menjaga Manager dan nodes Anda tetap sinkron secara permanen.

Selalu Instal Melalui Manager

Bahkan ketika Anda memiliki URL GitHub dan mengetahui git, gunakan antarmuka Manager. Tempel URL ke bidang instalasi kustom Manager daripada meng-clone secara manual.

Ini memastikan pendaftaran database yang tepat dari awal. Cloning manual seharusnya hanya terjadi saat men-debug atau mengembangkan nodes.

Gunakan Manager untuk Pembaruan

Ketika nodes memiliki pembaruan yang tersedia, gunakan fungsi pembaruan Manager daripada menjalankan git pull sendiri.

Pembaruan Manager menangani pembaruan dependensi, pelacakan versi database, dan hook pasca-pembaruan yang dilewati oleh pull manual.

Hindari Manipulasi Folder Langsung

Jangan menghapus, mengganti nama, atau memindahkan folder node secara manual. Gunakan fungsi uninstall Manager untuk menghapus nodes dengan bersih.

Jika Anda harus memanipulasi folder secara langsung, harapkan untuk membangun ulang database Manager setelahnya.

Pembaruan Manager Reguler

Jaga Manager sendiri tetap diperbarui. Versi yang lebih baru memperbaiki bug penanganan database dan meningkatkan deteksi node.

Perbarui Manager terlebih dahulu saat memecahkan masalah node karena perbaikan mungkin sudah ada di versi Manager yang lebih baru.

Untuk pengguna yang ingin kemampuan ComfyUI tanpa mengelola detail teknis ini, Apatero.com menyediakan infrastruktur yang dipelihara secara profesional. Nodes selalu terinstal dengan benar, diperbarui, dan dikonfigurasi tanpa sakit kepala sinkronisasi ini.

Bagaimana dengan Masalah Pengenalan Node Spesifik?

Beberapa nodes memiliki masalah pengenalan unik yang layak ditangani secara khusus.

Pengenalan Impact Pack

ComfyUI-Impact-Pack kompleks dengan banyak dependensi. Masalah pengenalan sering berasal dari masalah submodule.

Pastikan folder impact_pack_models ada dan berisi file yang diperlukan. Impact Pack tidak akan ditampilkan sebagai terinstal dengan benar jika file modelnya hilang meskipun kodenya ada.

Gunakan installer bawaan Impact Pack untuk dependensinya daripada instalasi generik Manager. Ini menangani file model dengan benar.

Masalah ControlNet Preprocessor

ComfyUI-ControlNet-AUX memerlukan unduhan model setelah instalasi. Manager menandainya sebagai terinstal segera, tetapi tidak benar-benar siap sampai model diunduh.

Jika nodes preprocessing error, jalankan skrip unduhan model atau biarkan mereka mengunduh pada penggunaan pertama. Node terinstal menurut Manager, hanya tidak lengkap.

Pengenalan Video Helper Suite

VideoHelperSuite memiliki dependensi ffmpeg spesifik yang mempengaruhi pengenalan. Jika ffmpeg tidak dapat diakses dengan benar, Manager mungkin menampilkan status instalasi parsial.

Verifikasi ffmpeg ada di PATH sistem Anda dan dapat diakses dari baris perintah. Kemudian bangun ulang database Manager.

Pertanyaan yang Sering Diajukan

Mengapa Manager menampilkan "Update" untuk node yang baru saya instal?

Ini terjadi ketika Anda menginstal dari branch development tetapi Manager memeriksa branch utama untuk pembaruan. Nomor versi tidak cocok, jadi Manager melihat pembaruan tersedia. Biasanya aman untuk diabaikan atau Anda dapat memperbarui untuk sinkron ke branch utama.

Bisakah saya menggunakan Manager dan git clones manual bersama?

Secara teknis ya, tetapi clones manual tidak akan muncul di antarmuka Manager. Mereka akan bekerja di ComfyUI tetapi Manager tidak akan melacaknya. Untuk pengalaman paling bersih, pilih satu metode dan tetap dengan itu.

Apakah membangun ulang database akan merusak workflows saya?

Tidak, membangun ulang database hanya mempengaruhi pelacakan Manager. Workflows, prompts tersimpan, dan konfigurasi node Anda tetap tidak tersentuh. Semuanya akan bekerja persis seperti sebelumnya, hanya dengan status Manager yang akurat.

Mengapa beberapa nodes muncul beberapa kali di daftar Manager?

Ini menunjukkan beberapa instalasi, sering dari percobaan instalasi yang gagal yang meninggalkan entri database parsial. Bersihkan database, hapus semua salinan node duplikat, kemudian instal ulang sekali melalui Manager.

Bagaimana saya tahu jika node diinstal melalui Manager atau secara manual?

Nodes yang diinstal Manager muncul di daftar Installed Nodes dengan informasi versi dan pembaruan yang tepat. Nodes yang di-clone secara manual tidak muncul sama sekali atau menampilkan versi "Unknown" tanpa kemampuan pembaruan.

Apakah ini mempengaruhi kemampuan saya untuk menggunakan nodes di workflows?

Tidak, masalah pengenalan node murni masalah Manager. ComfyUI sendiri memindai folder custom_nodes secara independen dan memuat apa yang ditemukannya. Workflows Anda akan berfungsi terlepas dari status pengenalan Manager.

Mengapa Manager mengatakan "tidak ada nodes terinstal" padahal saya punya puluhan?

Ini menunjukkan kerusakan atau kehilangan database lengkap. Nodes Anda baik-baik saja dan bekerja. Bersihkan file cache Manager sepenuhnya dan bangun ulang database dari awal. Semuanya akan terdeteksi.

Bisakah saya backup database Manager sebelum troubleshooting?

Ya, salin file json dari folder Manager sebelum menghapusnya. Jika ada yang salah Anda dapat memulihkannya. Namun, karena file-file ini persis yang Anda troubleshoot, memulihkannya juga akan memulihkan masalahnya.

Bagaimana jika masalah yang sama terus berulang?

Masalah berulang biasanya menunjukkan masalah workflow seperti menginstal ulang nodes secara manual antara rebuild Manager. Periksa kebiasaan Anda dan pastikan Anda menggunakan Manager secara konsisten untuk semua operasi node.

Haruskah saya melaporkan bug pengenalan ke GitHub Manager?

Jika Anda telah mencoba semua solusi dan masalah tetap ada, ya. Sertakan versi ComfyUI, versi Manager, sistem operasi, dan nodes spesifik yang terpengaruh. Pengembang dapat mengidentifikasi apakah itu bug yang diketahui atau masalah baru.

Kesimpulan dan Strategi Pencegahan

Masalah pengenalan node ComfyUI Manager hampir seluruhnya berasal dari desinkronisasi antara database-nya dan filesystem aktual Anda. Perbaikannya langsung karena Anda perlu memaksa sinkronisasi melalui pembangunan ulang database dan pembersihan cache.

Mulai dengan restart sederhana. Jika itu tidak berhasil, bangun ulang database. Untuk masalah yang persisten, bersihkan semua file cache dan biarkan Manager membuatnya kembali dari awal.

Ke depan, berkomitmen untuk menggunakan Manager untuk semua operasi node. Instal melalui Manager, perbarui melalui Manager, dan hapus melalui Manager. Ini menjaga semuanya tetap tersinkronisasi secara permanen.

Beberapa menit yang dihabiskan untuk troubleshooting sekarang menghemat jam-jam frustrasi di masa depan. Setelah database Manager Anda secara akurat mencerminkan instalasi Anda, pembaruan bekerja dengan lancar, dependensi diselesaikan dengan benar, dan Anda dapat mempercayai indikator status Manager.

Untuk pengguna yang lebih memilih tidak berurusan dengan tugas manajemen teknis ini, Apatero.com menangani semua instalasi dan pemeliharaan node secara otomatis. Anda mendapatkan akses ke nodes yang dikonfigurasi dengan benar tanpa kekhawatiran sinkronisasi database atau troubleshooting manual.

Jaga Manager tetap diperbarui, gunakan secara konsisten, dan masalah pengenalan ini menjadi hal masa lalu.