安装

安装

uv tool install ageval-cli
ageval -V

• CPython 3.12+（uv 会自行准备解释器）
• 真实 coding agent 路径需要本机 ACP 入口与凭据。仅 ageval lock 不需要。
• 升级：uv tool upgrade ageval-cli

CLI 装好即可用：dataset 用 registry ref（<dataset_id>@<version>）从 Hub 获取，或指向任意本地 dataset 根目录。默认连公开 Hub（https://ageval.zjureal.com），不必先设 AGEVAL_REGISTRY_URL；自托管或 compose 再用该变量 / --registry-url 覆盖。

可选 extras

可选后端以 extras 提供，按需安装；同一命令重跑即升级（uv 有缓存，开销很小）：

uv tool install 'ageval-cli[all]'   # CLI 可选后端一次装全

terminus-2 没有 CLI extra。用 ageval plugin install plugins/terminus-2 安装。OpenHands 用 ageval plugin install plugins/openhands 安装，SDK 跑在 Attempt 环境里。

[all] 只装这些 CLI extra，不含自托管 Hub。要在本机跑 Registry 服务，用仓库里的 uv sync --extra registry。

缺 extras 或凭据时 lock/run 过不了，报错里会带安装命令。

从源码开发（贡献者）

修改 ageval 本体或运行仓库内示例时才需要 clone：

git clone https://github.com/ZJU-REAL/ageval.git
cd ageval
uv sync --frozen --all-packages
uv run ageval -V

Skills

给本机 coding agent 安装仓库技能：

npx skills add ZJU-REAL/ageval                      # 全部技能
npx skills add ZJU-REAL/ageval --skill ageval-cli   # 单个技能