Menangani isu

Saya membuat explainer.js, alat CLI untuk memproses fail dan mengeluarkan blok kod bersama penjelasan. Jadi sesuatu yang boleh membantu jika anda tidak tahu apa yang berlaku dalam fail.
Dibina menggunakan Commander.js dan Groq SDK!
Lihatlah @ https://github.com/aamfahim/explainer.js

Respons Segera

Untuk semakan kod, saya dan pasangan saya @sych_andrii aka Andrii menggunakan ciri panggilan discord. Biasanya, untuk semakan kod saya lebih suka pendekatan penyegerakan. Melompat pada panggilan video dan perkongsian skrin dan melakukannya secara langsung boleh membantu menjejaki proses dengan pantas berbanding melakukannya secara tidak segerak dalam isu git. Walaupun asynchronous juga boleh berdaya maju jika terdapat banyak butiran tetapi itu jarang berlaku. Jadi, kalau boleh saya lebih suka melakukannya secara serentak.

Bukan rodeo pertama kami

Kami berdua sangat biasa dengan semakan kod. Kami berdua telah menyemak kod masing-masing. Saya rasa bahagian semakan lebih mudah kerana kami mengenali antara satu sama lain sebelum ini.

Saya akan buat awak dulu, awak buat saya selepas

Seperti tajuknya. Rakan kongsi saya menyemak kod saya dahulu. Memandangkan kebanyakan isu saya berkaitan README.md, dia mempunyai banyak soalan. Dan saya biarkan dia menggunakan alat saya. Seperti yang dia mahu, isu awalnya ialah dia cuba menggunakan kunci API OpenAI, tetapi Groq membuat kesilapan. Jadi, kami mencubanya dengan kunci API yang dijana Groq dan ia berjaya. Kemudian kami mencuba URL asas OpenAI yang berfungsi (secara teknikal) tetapi respons menunjukkan url asas yang disediakan tidak betul. Kemudian kami mencuba model yang berbeza dan mendapati kami hanya boleh menggunakan model yang disokong Groq.

Ini adalah isu yang dia failkan pada repo saya

Isu yang difailkan pada repo saya

1. https://github.com/aamfahim/explainer.js/issues/9 README.md dijana dengan tergesa-gesa jadi ia mempunyai banyak maklumat yang tepat dan ia juga tidak betul di beberapa tempat.
2. https://github.com/aamfahim/explainer.js/issues/10 Andrii cuba menggunakan model gpt-4o tetapi saya tidak fikir Groq menyokongnya. Kemudian kami mencuba model yang disokong yang bertujuan untuk keselamatan kandungan yang memberikannya output mengenai isu tersebut. Jadi, saya terpaksa menyebut batasan dalam README.md juga.
3. https://github.com/aamfahim/explainer.js/issues/11 --outout belum dilaksanakan lagi tetapi terdapat dalam README.md dan penerangan bantuan.
4. https://github.com/aamfahim/explainer.js/issues/12 -t bendera tidak dihuraikan dengan betul
5. https://github.com/aamfahim/explainer.js/issues/13 Penerangan tidak jelas tentang hujah yang dijangkakan ialah laluan fail.

WSL atau Powershell?

Jadi, selepas itu giliran saya untuk mengulangkaji. Sekatan jalan pertama ialah pemasangan. Pada mulanya saya menggunakan terminal lalai saya, WSL dengan Ubuntu sebagai distro saya. Dan saya akan jujur ​​saya tidak menggunakan python banyak dan versi saya agak lama. Dan saya tidak ingat memasang python. Jadi kerana versi saya tidak dapat memasang dependencies dan saya tidak dapat mengemas kini versi saya atas sebab tertentu. Jadi saya beralih kepada cmd dan saya tahu saya telah memasang python pada komputer riba windows saya. Jadi, saya terpaksa menggunakan cmd tetapi masalahnya ialah selepas setiap arahan saya perlu menyebut --python version. Dan untuk melakukan itu saya juga perlu melepasi laluan fail yang berada di suatu tempat dalam direktori fail. Selepas menjalankan persediaan ia cukup bagus. Saya tidak menemui sebarang pepijat tetapi saya mempunyai maklum balas tentang struktur readme. Saya juga meminta sokongan .env kerana untuk menjalankan alat saya perlu menyalin tampal kunci API setiap kali yang agak membosankan. Juga dia melakukannya dalam ular sawa. Sungguh gila!

Isu difailkan pada repo Andrii

1. https://github.com/SychAndrii/infusion/issues/8 Saya mendapati README.md agak sukar untuk diikuti, jadi saya menambah beberapa cadangan.
2. https://github.com/SychAndrii/infusion/issues/9 Meminta sokongan .env supaya saya tidak perlu menampal api setiap kali saya menggunakannya.
3. https://github.com/SychAndrii/infusion/issues/10 Bahagian khusus bahagian bantuan memerlukan sedikit pemfaktoran semula.
4. https://github.com/SychAndrii/infusion/issues/11 Jika fail mempunyai kandungan yang tidak berkaitan kadangkala ia akan membuang ralat kadangkala tidak.

Adakah semuanya telah ditetapkan?

Saya membetulkan semua masalah saya. Ia tidak mengambil banyak masa kerana isunya agak mudah. Kebanyakan kerja itu melalui commander.js docs. Adakah beberapa pemfaktoran semula di antaranya juga.

Apakah yang anda pelajari melalui proses melakukan ujian dan semakan?

Pengajaran yang dipelajari

Kadang-kadang mudah tersesat dalam sos semasa berkembang. Saya sangat fokus untuk membuat kod lebih bersih, saya meletakkan README.md sebagai pemikiran kedua. Saya fikir bersama-sama dengan kod, dokumentasi harus juga diberikan kepentingan yang sama. Juga, menggunakan JS Tulen dalam Node dengan ESM TIDAK menyeronokkan. Mempelajari banyak perkara tentang JS tulen yang saya tidak pernah tahu atau lupa seperti, adalah singkatan untuk menukar sengatan kepada jenis data yang sesuai dan hujah tidak tersedia dalam kaedah anak panah. Dan saya sepenuh hati bersetuju dengan ulasan ini.

Atas ialah kandungan terperinci Menangani isu. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!