SuperCoder:终端编码助手
SuperCoder是什么?
SuperCoder 是一款在终端运行的编码助手,能帮开发者简化开发流程。它有这些功能:快速搜索代码、查看项目结构、用自然语言指令修改代码,还能修复 Bug。安装很简单,从官网下载 ZIP 包,解压后把相关文件路径加入系统 PATH,就能在终端用命令启动。它支持多种开发环境,像 Python 和一些常见框架都能用,很方便。
SuperCoder主要功能
代码搜索:可以在项目中执行复杂的代码搜索,快速定位特定的代码模式。
项目结构探索:提供项目文件夹和文件的组织结构视图,方便用户进行项目导航。
代码编辑:支持通过自然语言命令无缝修改代码库。
Bug 修复:根据用户的详细请求自动修复代码中的错误并进行改进。
支持 Cursor 规则:利用 Cursor 规则智能理解并在精确位置修改代码。
文件读取:读取并显示指定文件的内容。
命令执行:根据需要运行 shell 命令。
工具支持
CodeSearchTool:用于在项目中搜索特定的代码模式。
CodeEditTool:允许在项目中编辑文件。
FileReadTool:读取并显示文件内容。
ProjectStructureTool:提供项目文件夹和文件的概述。
CommandExecutionTool:根据代理的评估执行 shell 命令
适用人群
喜欢终端操作的程序员。
需要快速开发和部署软件系统的企业和开发人员。
SuperCoder使用方法
安装步骤
从 Release 页面下载 ZIP 包。
将 ZIP 包解压到计算机上的某个文件夹,并确保 bin/supercoder 或 bin/supercoder.bat 二进制文件可在系统的 PATH 中访问。
在终端中,从任何想要工作的文件夹运行 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