Terminal-Bench 项目启动与配置教程

1. 项目目录结构及介绍

Terminal-Bench 的目录结构如下所示：

.
├── adapters/
├── appworld
├── dashboard
├── datasets/
├── discord-bot
├── docker
├── resources/
│   └── img
├── scripts_bash
├── scripts_python
├── shared
├── tasks
│   └── ...
├── terminal_bench
├── tests
├── .env.template
├── .gitignore
├── .pre-commit-config.yaml
├── .python-version
├── LICENSE
├── README.md
├── conftest.py
├── pyproject.toml
└── uv.lock

• adapters/: 存放不同适配器的代码，用于连接不同的语言模型和终端环境。
• appworld: 应用世界目录，可能包含一些示例应用程序。
• dashboard: 仪表板相关的文件，用于展示任务执行结果和统计信息。
• datasets/: 数据集目录，包含任务的描述、测试脚本和参考解决方案。
• discord-bot: 与 Discord 机器人相关的代码。
• docker: Docker 相关的配置和脚本。
• resources/: 资源目录，可能包含图片和其他静态资源。
• scripts_bash 和 scripts_python: 包含用于不同操作的 Bash 和 Python 脚本。
• shared: 存放项目共用的代码和资源。
• tasks/: 包含具体任务的所有文件，包括描述、测试脚本和解决方案。
• terminal_bench: 核心代码，实现终端环境的连接和任务执行。
• tests: 测试代码，用于验证项目的功能和稳定性。
• .env.template: 环境变量模板文件。
• .gitignore: Git 忽略文件，指定哪些文件和目录不被 Git 跟踪。
• .pre-commit-config.yaml: pre-commit 配置文件，用于自动化代码风格检查和修复。
• .python-version: 指定项目使用的 Python 版本。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• conftest.py: pytest 配置文件。
• pyproject.toml: 项目元数据和依赖关系的配置文件。
• uv.lock: 可能是由 uvicorn 服务器生成的锁文件。

2. 项目的启动文件介绍

项目的启动主要依赖于 scripts_python/run_harness.py 脚本。这个脚本负责启动执行框架，连接语言模型到沙盒化的终端环境，并执行任务。

运行启动脚本的基本命令如下：

uv run scripts_python/run_harness.py

在运行之前，需要确保已经正确安装了项目依赖，包括 uv 和 Docker。

3. 项目的配置文件介绍

项目的主要配置文件是 .env.template，它是一个环境变量模板文件，用于设置项目运行时所需的环境变量。在正式运行项目前，需要将这个模板文件复制为 .env 文件，并根据实际情况填写相应的环境变量值。

例如，如果需要设置 API 密钥，可以在 .env 文件中添加以下内容：

ANTHROPIC_API_KEY=your_api_key

此外，项目还可能使用 pyproject.toml 文件来定义项目依赖和元数据。这个文件被 pip 等工具用来安装项目依赖。

在开始使用项目之前，确保已经仔细阅读了所有的配置文件，并根据需要进行了适当的修改。