SuperCoder是什么？

SuperCoder 是一款在終端運行的編碼助手，能幫開發者簡化開發流程。它有這些功能：快速搜索代碼、查看項目結構、用自然語言指令修改代碼，還能修復 Bug。安裝很簡單，從官網下載 ZIP 包，解壓后把相關文件路徑加入系統 PATH，就能在終端用命令啟動。它支持多種開發環境，像 Python 和一些常見框架都能用，很方便。

SuperCoder主要功能

• 代碼搜索：可以在項目中執行復雜的代碼搜索，快速定位特定的代碼模式。

• 項目結構探索：提供項目文件夾和文件的組織結構視圖，方便用戶進行項目導航。

• 代碼編輯：支持通過自然語言命令無縫修改代碼庫。

• Bug 修復：根據用戶的詳細請求自動修復代碼中的錯誤并進行改進。

• 支持 Cursor 規則：利用 Cursor 規則智能理解并在精確位置修改代碼。

• 文件讀取：讀取并顯示指定文件的內容。

• 命令執行：根據需要運行 shell 命令。

工具支持

• CodeSearchTool：用于在項目中搜索特定的代碼模式。

• CodeEditTool：允許在項目中編輯文件。

• FileReadTool：讀取并顯示文件內容。

• ProjectStructureTool：提供項目文件夾和文件的概述。

• CommandExecutionTool：根據代理的評估執行 shell 命令

適用人群

• 喜歡終端操作的程序員。

• 需要快速開發和部署軟件系統的企業和開發人員。

SuperCoder使用方法

安裝步驟

1. 從 Release 頁面下載 ZIP 包。

2. 將 ZIP 包解壓到計算機上的某個文件夾，并確保 bin/supercoder 或 bin/supercoder.bat 二進制文件可在系統的 PATH 中訪問。

3. 在終端中，從任何想要工作的文件夾運行 supercoder 命令。

配置代理

使用 Openai API

在運行代理之前，需要配置 OPENAI_API_KEY 環境變量。可以通過在 OpenAI 上注冊來獲取 API 密鑰。

export OPENAI_API_KEY=export OPENAI_MODEL= # 默認值為 "o3-mini"，請注意費用

使用本地模型或任何 OpenAI 兼容的 API

如果有本地模型或其他 OpenAI 兼容的 API，可以通過設置以下環境變量來配置 SuperCoder 使用它：

export SUPERCODER_BASE_URL=export SUPERCODER_API_KEY=export SUPERCODER_MODEL=

如果使用 Google Gemini，還需要設置 SUPERCODER_GEMINI_MODE=true。需要注意的是，使用的模型應支持工具調用。

運行編碼代理

構建項目后，提取并運行生成的二進制文件。運行后，可以輸入自然語言命令，例如：

"Search for usage of function XYZ"
"Edit file path/to/file.scala to add a new method"
"Show me the project structure"

代理將解釋這些命令并調用相應的工具。

開發環境設置

先決條件

• Java 8 或更高版本

• SBT（Scala 構建工具）

步驟

1. 克隆倉庫：

git clone cd SuperCoder

2. 使用 SBT 構建項目：

sbt compile

3. 運行測試以確保一切正常：

sbt test

項目地址

GitHub倉庫：https://github.com/huytd/supercoder