# 工具列表 API

该接口用于让 API 调用方获知服务端“工具分类”与“每个分类下的工具名称”。

鉴权：需要 `Authorization: Bearer <TOKEN>`

---

## GET `/api/v1/tools`

成功响应（200）：

```json
{
  "success": true,
  "categories": [
    {
      "id": "network",
      "label": "网络检索",
      "default_enabled": true,
      "silent_when_disabled": false,
      "tools": ["web_search", "extract_webpage", "save_webpage"]
    },
    {
      "id": "terminal_command",
      "label": "终端指令",
      "default_enabled": true,
      "silent_when_disabled": false,
      "tools": ["run_command", "run_python"]
    }
  ]
}
```

字段说明：

- `categories[].id`：工具分类 id（服务端内部标识）
- `categories[].label`：分类展示名
- `categories[].tools`：该分类下具体工具名称列表（用于前端渲染/筛选/白名单提示）
- `default_enabled/silent_when_disabled`：用于 UI/策略展示（并不等于“你一定能调用到该工具”，真实可用性仍取决于服务端策略与运行时环境）