> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心概念

> Nonce 中的关键术语和概念

## 核心概念

<Info>
  本页面仍在完善中，更多概念和详细信息将陆续添加。
</Info>

### 工作区 (Workspace)

工作区是 Nonce 中的顶级组织单元，包含您所有的矿场、矿机和配置。

* 每个工作区都有唯一的 `workspace_id`（格式：`org_xxxxxxxxxxxxxxxxxxxxxxxxxxx`）
* API Key 的作用域限定于特定工作区

### 矿场 (Farm)

矿场代表矿机的物理或逻辑分组。

* 每个矿场都有唯一的 `farm_id`（UUID 格式）
* 矿场属于单个工作区
* 指标和 Task 在矿场级别进行组织

### 矿机 (Miner)

矿机代表单个挖矿设备。

* 每个矿机都有唯一的 `miner_id`
* 矿机属于单个矿场
* 矿机数据包括算力、功耗、温度和状态等...

### Agent

Agent 是矿机和 Nonce 平台之间的通信组件。

* Agent 注册到矿场
* 每个 Agent 可以管理特定矿场中的多个矿机

### Task

Task 代表要在一个或多个矿机上执行的操作。

* Task 可以单独创建或以 Task Batch 形式创建
* 常见的 Task 类型包括日志收集、功耗模式更改和矿池更新

<Card title="Task 文档" icon="list-check" href="/zh/api-guide/tasks">
  了解更多关于 Task 类型、参数和状态的信息
</Card>

### 操作者 (Actor)

<Note>
  **Beta 功能**：此功能目前处于测试阶段。
</Note>

操作者代表在系统中执行操作的实体。操作者用于跟踪谁创建或修改了资源。

* 三种操作者类型：`user`（用户）、`apikey`（API Key）和 `system`（系统）
* 用于审计追踪和 Task Batch 跟踪

<Card title="操作者文档" icon="user" href="/zh/api-guide/actor">
  了解更多关于操作者和操作追踪的信息
</Card>

***

## 通用参数

### 分页

大多数列表端点支持分页：

| 参数         | 类型     | 描述                    |
| ---------- | ------ | --------------------- |
| `page`     | number | 页码（默认：1）              |
| `pageSize` | number | 每页条目数（默认：10，最大：10000） |