用户层级与继承

XAI XAPI 的账户系统被设计成一个强大的树状层级结构，这使得权限管理和资源分配变得异常灵活。理解这一结构是充分利用本平台的关键。

核心设计理念：全息子信息

我们的账户系统设计借鉴了"全息子信息"（Holographic Sub-information）的理念。这个概念源于全息摄影原理：全息照片的任何一个碎片都包含整个图像的信息，只是清晰度会有所降低。

在 XAI XAPI 中，每个子账户就像全息照片的碎片，它继承并包含了其父账户的核心"基因信息"。这种设计确保了：

• 信息的完整传递：关键配置和限制从根节点一直传递到叶子节点
• 去中心化管理：每个账户都可以独立运作，同时保持与整体系统的一致性
• 弹性和容错：即使中间层级账户被删除，子账户仍能基于继承的信息正常运行, 也依然被其更高级祖先账户管控

父账户与子账户

• 父账户 (Parent User): 可以创建和管理其下属账户的账户。
• 子账户 (Child User): 由父账户创建，其许多核心属性受到父账户的约束。

一个子账户本身也可以成为父账户，创建它自己的子账户，从而形成一个无限层级的树状结构。唯一的例外是系统顶级的 root 账户，它没有父账户。

遗传 DNA

为了清晰地追踪和管理这种树状关系，我们引入了 DNA 的概念。每个用户的 DNA 是一个字符串，记录了它从 root 账户到其直接父账户的所有祖先节点的ID路径。

例如，一个用户的 DNA 可能是 .1.3.12.，这表示：

• 1 是 root 账户的 ID。
• 3 是该用户的爷爷辈账户的 ID。
• 12 是该用户的父账户的 ID。

通过 DNA，系统可以快速判断账户间的层级关系，这在权限校验（如一个账户是否有权管理另一个账户）中至关重要。

权限与属性继承

创建子账户时，许多属性会从父账户继承或受到其约束。这正是"全息子信息"理念的体现——子账户包含了父账户的核心信息，但可能在某些方面有所限制或调整。

继承规则摘要：

关键用户字段解释

• Level: 用户等级，用于匹配对应 Level 的密钥池进行调用。
• Tier: 用户充值等级（0-10），根据累计充值额度自动计算。
• Gear: 漂移调度档位。决定在API调用失败时，系统的重试和故障转移策略。
  • 0: 不进行漂移调度。
  • 1: 优先使用当前 Level 的密钥重试，之后再尝试漂移到其他 Level。
  • 2: 优先进行跨 Level 的漂移调度，以最快速度找到可用服务。
• Role: 用户角色。Role=3 的用户拥有创建和管理包月用户的特殊权限。

设计优势

这种基于"全息子信息"理念的层级设计带来了多重优势：

1. 极致的灵活性：每一级都可以在继承的基础上进行精细化配置
2. 完美的隔离性：不同分支之间完全隔离，确保数据和配置的安全
3. 高效的管理性：通过树状结构，可以批量管理任意一个账户族群的配置
4. 天然的商业模式：支持多级分销、代理等复杂的商业场景

典型应用场景

场景一：AI 应用开发商

一个 AI 应用开发商可以：

• 为每个应用创建独立的子账户，隔离不同应用的 API 使用
• 为不同的开发环境（开发、测试、生产）创建对应的子账户
• 为应用带来多租户独立计费能力, 专注业务创新

场景二：企业IT部门

企业IT部门可以：

• 为不同部门创建子账户，精确控制各部门的 AI 使用预算
• 为各个子账户设置不同的模型访问权限，确保合规性
• 通过 IP 白名单，限制只能从公司网络访问

场景三：AI 服务代理商

代理商可以：

• 为每个客户创建独立的子账户
• 为大客户创建更深层级的账户结构，支持其内部管理需求

场景四：院校/教育培训机构

院校/教育培训机构可以：

• 为每个学员创建限额子账户，控制成本
• 限制可用模型，引导学员使用特定的 AI 模型
• 通过速率限制，防止资源滥用

通过这套精巧的层级和继承系统，XAI XAPI 不仅是一个技术平台，更是一个能够支撑复杂商业生态的基础设施。