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

# 线上系统

> 账号注册、登录与排行榜

## 账号注册登录

1. 在选曲页面点击右上角 Mod 按钮旁按钮可以打开登录和注册页面。

   <Frame caption="登录入口">
     <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/image-20260105145259489.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=a4a60d2942a6b1ba851d088b3ef623c3" alt="Login Entry" width="1922" height="1082" data-path="images/cachi/image-20260105145259489.png" />
   </Frame>

2. 可以选择使用用户名或者邮箱进行登录，没有账号时点击下方 **注册** 按钮打开主页页面进行注册。

   <Frame caption="登录界面">
     <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/login.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=e67386adc517a339b12bfd29ae288770" alt="Login Page" width="1922" height="1080" data-path="images/cachi/login.png" />
   </Frame>

3. 注册时需要提供一个可以收取验证码的邮箱以用于验证身份。

   * **用户名**：只能允许大小写英文字符、数字以及部分符号 `[] - _`，长度在 3-10 之间。
   * **密码**：长度在 8-16 个字符之间。

   <Frame caption="注册界面">
     <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/register.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=ab5f097cead4fe52fcc20204151cf94c" alt="Register Page" width="1922" height="1080" data-path="images/cachi/register.png" />
   </Frame>

4. 登录过一次后，后续进入游戏在没有切换 IP 与登录设备的情况下，会自动登录账号。登录后点击右上角会显示玩家的一些统计信息，以及登出按钮。

   <Frame caption="用户信息">
     <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/pinfo.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=3eb2fb479e1ac0e773192d5302c1dfe2" alt="User Info" width="1922" height="1080" data-path="images/cachi/pinfo.png" />
   </Frame>

## 头像修改

本游戏使用 [Cravatar](https://cravatar.com/) 作为头像服务。根据玩家注册时的邮箱对头像进行匹配。

除 Cravatar 自有头像源外，Cravatar 还整合了 QQ 和 Gravatar 头像。请求头像时，会按以下顺序分三级返回准确的头像：`Cravatar -> Gravatar -> QQ`。

如果之前使用过同样使用 Cravatar 或 Gravatar 作为头像源的站点，注册账号后可能会自带头像。如需要修改头像，请在 [Cravatar](https://cravatar.com/) 或 [Gravatar](https://gravatar.com/) 官网使用注册 Cachi 时同一个邮箱地址注册账号后，即可上传新的头像。

## 上传分数

在玩家登录后，本作支持 OSU! CTB 模式和 Malody Catch 模式的 **上传到对应官网上** 的 **所有谱面** 的分数上传。

* 只要在对应官网可以搜索到的谱面，无论是 Rank 还是 Unrank 谱均可以上传分数。
* 开启**任何 Mod** 都可以上传分数。
* 如果是在对应官网上查找不到记录的谱面（如 Mapper 删除或者未上传的谱面），上传分数时会被**拒绝**。
* 对于官网上的 Unrank 谱面的成绩上传，请尽量保证谱面是**最新版本**。如果某一天谱师更新了谱面，旧版本谱面可能会遇到成绩**上传失败**的问题。

## 排行榜

游戏内的谱面分数排行榜一共有 4 种：

1. **本地排行榜**：当前谱面玩家在游玩后本地的分数记录。
2. **Rank 排行榜**：只开启 Rank 相关 Mod（如倍速、镜像等）上传分数后的分数排行榜。
3. **Unrank 排行榜**：开启 Unrank 相关 Mod（如 DTB、Relax 等）上传分数后的分数排行榜。
4. **Any 排行榜**：Rank 与 Unrank 排行榜的混合排行榜，取分数最高值显示。
