# Fingerprints

## 生成新指纹（主机 OS）

`GET /fingerprint/new`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "生成新指纹（主机 OS）",
  "description": "返回**主机**操作系统完全唯一化的指纹，不保存。\n等价于以主机平台调用 `/fingerprint/new/{platform}`。\n",
  "responses": {
    "200": {
      "description": "唯一化的未保存指纹。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/FingerprintEnvelope"
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    },
    "404": {
      "description": "指纹库为空。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}
```

## 为指定平台生成新指纹

`GET /fingerprint/new/{platform}`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "为指定平台生成新指纹",
  "description": "从库中随机选取与 `platform` 匹配的指纹，然后进行唯一化：\n生成新的 `platform_version`（用于 Sec-CH-UA），\n`hardware_concurrency`/`device_memory` 受主机限制（不超过真实值），\n屏幕裁剪至真实显示器尺寸。\n返回时不保存; 请作为 `fingerprint` 传入创建端点。\n",
  "parameters": [
    {
      "name": "platform",
      "in": "path",
      "required": true,
      "description": "不区分大小写；接受别名 `win`/`osx`/`darwin`。",
      "schema": {
        "type": "string",
        "enum": [
          "Windows",
          "macOS",
          "Linux"
        ]
      }
    }
  ],
  "responses": {
    "200": {
      "description": "唯一化的未保存指纹。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/FingerprintEnvelope"
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    },
    "404": {
      "description": "未找到匹配指纹或库为空。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}
```

## 指纹库列表

`GET /fingerprints`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "指纹库列表",
  "description": "磁盘上的指纹库（GPU 预设），由启动器提供/导入。",
  "responses": {
    "200": {
      "description": "库条目。",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LibraryEntry"
            }
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    }
  }
}
```