處理問題

我製作了explainer.js，一個用於處理檔案並輸出程式碼區塊和解釋的 CLI 工具。如果您不知道文件中發生了什麼，那麼這可能會有所幫助。
使用 Commander.js 和 Groq SDK 建置！
看看@ https://github.com/aamfahim/explainer.js

即時回應

為了進行程式碼審查，我和我的合作夥伴 @sych_andrii 又名 Andrii 使用了不和諧的通話功能。通常，對於程式碼審查，我更喜歡同步方法。跳上視訊通話和螢幕共享並即時進行可以幫助快速追蹤流程，而不是在 git 問題中非同步進行。雖然如果有很多細節，非同步也是可行的，但這種情況很少見。所以，如果可能的話，我更喜歡同步進行。

這不是我們的第一次牛仔競技表演

我們都非常熟悉程式碼審查。我們倆都審查過彼此的程式碼。我認為評論部分容易多了，因為我們事先就認識了。

我先做你的，然後你做我的

如標題所示。我的伙伴首先檢查了我的程式碼。由於我的大部分問題都與 README.md 有關，所以他有很多問題。我讓他使用我的工具。正如他所希望的，最初的問題是他嘗試使用 OpenAI API 金鑰，但 Groq 拋出錯誤。因此，我們使用 Groq 產生的 API 金鑰進行了嘗試，結果成功了。然後我們嘗試了 OpenAI 基本 URL，該 URL 可以正常工作（技術上），但回應表明提供的基本 URL 不正確。然後我們嘗試了不同的模型，發現只能使用 Groq 支援的模型。

這些是他在我的儲存庫上提交的問題

在我的儲存庫上提交的問題

1. https://github.com/aamfahim/explainer.js/issues/9 README.md 產生的比較倉促，所以有很多不準確的資訊，也有一些地方不正確。
2. https://github.com/aamfahim/explainer.js/issues/10 Andrii 嘗試使用 gpt-4o 模型，但我認為 Groq 不支援該模型。然後我們嘗試了一個支援內容安全的模型，這為他提供了有關該問題的輸出。所以，我也不得不提到 README.md 中的限制。
3. https://github.com/aamfahim/explainer.js/issues/11 --outout 尚未實現，但已在 README.md 和幫助說明中。
4. https://github.com/aamfahim/explainer.js/issues/12 -t 標誌未正確解析
5. https://github.com/aamfahim/explainer.js/issues/13 描述不清楚預期的參數是檔案路徑。

WSL 還是 Powershell？

那麼，接下來就輪到我複習了。第一個障礙是安裝。最初我使用預設終端 WSL 和 Ubuntu 作為我的發行版。老實說，我不常使用 python，而且我的版本也很舊。我什至不記得安裝過python。因此，由於版本問題，我無法安裝依賴項，並且由於某種原因無法更新我的版本。所以我切換到 cmd，我知道我的 Windows 筆記型電腦上安裝了 python。因此，我必須使用 cmd，但問題是在每個命令之後我都必須提及 --python 版本。為此，我還必須傳遞檔案目錄中某處的檔案路徑。設定好後運行起來效果非常好。我沒有發現任何錯誤，但我確實有關於自述文件結構的回饋。我還請求了 .env 支持，因為為了運行該工具，我每次都必須複製貼上 API 金鑰，這有點乏味。他也是用Python來做的。真是個瘋子！

在 Andrii 的儲存庫上提交的問題

1. https://github.com/SychAndrii/infusion/issues/8 我發現 README.md 有點難以理解，所以我添加了一些建議。
2. https://github.com/SychAndrii/infusion/issues/9 請求 .env 支持，這樣我就不必每次使用時都貼上 api。
3. https://github.com/SychAndrii/infusion/issues/10 幫助部分的特定部分需要進行一些重構。
4. https://github.com/SychAndrii/infusion/issues/11 如果文件有不相關的內容，有時會拋出錯誤，有時則不會。

一切都解決了嗎？

我解決了所有問題。沒花太多時間，因為問題很簡單。大部分工作是瀏覽 Commander.js 文件。中間也進行了一些重構。

通過測試和審核的過程您學到了什麼？

經驗教訓

有時在開發過程中很容易迷失在醬汁中。我非常專注於讓程式碼更乾淨，所以我把 README.md 作為第二個想法。我認為與程式碼一樣，文件也應該受到同樣的重視。另外，在 Node 中使用純 JS 和 ESM 並不有趣。學到了很多關於純 JS 的東西，這些東西我從來不知道或忘記，例如 + 是將 sting 轉換為適當資料類型的簡寫，而參數在箭頭方法中不可用。我完全同意這個評論。

以上是處理問題的詳細內容。更多資訊請關注PHP中文網其他相關文章！