> ## 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.

# 简易教程

> 快速上手 Cachi

<Steps>
  <Step title="准备工作">
    请按照 **[文件导入](/cachi/import)** 章节预先导入谱面、皮肤等文件。
  </Step>

  <Step title="进入选曲">
    进入游戏后，点击屏幕即可进入选曲页面。

    左侧为选曲页面，提供诸如**歌曲标题、谱面难度区间、谱面来源**等基本信息，点击任意歌曲按钮后可以选择谱面。目前难度星级计算算法参考OSU! CTB模式，新的移动端算法正在制作中。
  </Step>

  <Step title="搜索与收藏">
    点击歌曲按钮前面的星号键可以**添加收藏**，上半眉头部分提供基本的**搜索、排序**等功能。

    <Frame caption="选曲界面">
      <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/QQ20251121-160737.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=256812799ea9911c4a54f859d38917ee" alt="选曲界面" width="1922" height="1082" data-path="images/cachi/QQ20251121-160737.png" />
    </Frame>
  </Step>

  <Step title="Mod 设置">
    选择谱面后，点击右侧橙色开始按钮，会弹出 Mod 设置菜单，可以自行调整自定义各种设置。
  </Step>

  <Step title="开始游戏">
    调整完设置后点击 Mod 面板最下方 **Start 按钮** 即可开始游戏，点击 **机器人按钮** 为 **AUTO** 演示。

    <Frame caption="Mod 设置与开始">
      <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/QQ20251121-161952.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=a281edb154d0e067c6e098fa0514a139" alt="Mod 设置" width="1922" height="1080" data-path="images/cachi/QQ20251121-161952.png" />
    </Frame>
  </Step>

  <Step title="系统设置">
    点击选曲页面搜索框旁边的 **齿轮按钮**，可以打开系统设置侧边栏，可以调整一些系统设置。

    <Frame caption="系统设置侧边栏">
      <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/image-20251123161048921.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=fa7cb778d95b044a5de9fb9475aee746" alt="系统设置" width="541" height="466" data-path="images/cachi/image-20251123161048921.png" />
    </Frame>
  </Step>
</Steps>

## 实机截图

<Frame caption="游戏截图 1">
  <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/QQ20251121-180226.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=f98bc5cac6bee8704ea1311c4f80cf98" alt="Screenshot 1" width="1765" height="990" data-path="images/cachi/QQ20251121-180226.png" />
</Frame>

<Frame caption="游戏截图 2">
  <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/QQ20251121-180356.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=2b45706c251253e1fdc864807add0faf" alt="Screenshot 2" width="1767" height="998" data-path="images/cachi/QQ20251121-180356.png" />
</Frame>

<Frame caption="游戏截图 3">
  <img src="https://mintcdn.com/irisugame/zl-5DKXn93kATmfm/images/cachi/image-20251123151438107.png?fit=max&auto=format&n=zl-5DKXn93kATmfm&q=85&s=fbce6ae3cace496992eb1b43bbb7544b" alt="Screenshot 3" width="1768" height="989" data-path="images/cachi/image-20251123151438107.png" />
</Frame>
