New translations hutao-API.md (English)

docs/en/features/hutao-API.md

@@ -0,0 +1,49 @@
+---
+headerDepth: 0
+category:
+  - 功能
+  - 教程
+order: 6
+---
+
+# 胡桃数据库/深渊统计
+
+胡桃工具箱提供两个主要的深境螺旋挑战统计的功能
+- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能
+- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能
+  - 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集
+
+::: tabs
+@tab 角色使用率 ![character-usage-rate](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01VNtgaU1g6du5Mh1Oo_!!1797064093.png) @tab 角色出场率 ![character-held-n-usage-rate](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01AKGIZn1g6du8k0Rhb_!!1797064093.png) @tab 队伍出场次数 ![hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01ZRakBS1g6duBCh0c1_!!1797064093.png) @tab 角色持有率 ![character-held-rate](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01EUjFsJ1g6du8k0NYy_!!1797064093.png) @tab 个人数据统计 ![personal-record-stat](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01xMLXhn1g6du6lPUDD_!!1797064093.png) @tab 个人数据详情 ![personal-record-details](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01xtWJfr1g6dtvjZLWZ_!!1797064093.png)
+:::
+## 查看深渊数据
+
+::: warning
+所有计算数据都基于**已上传至胡桃数据库中的玩家数据**，无法代表全部原神玩家的平均数据，数据仅做参考用途
+:::
+
+::: info 数据刷新周期
+1. 深境螺旋统计数据（角色使用率、角色出场率、队伍出场）在北京时间每月1日和16日的4点自动清理。
+   - 点击界面右上角的信息按钮你可以查看当前实时已上传的总数据
+2. 同时，若用户在30天内没有重新上传记录以更新数据，则其的角色持有数据将被清理
+:::
+
+- 在主界面点击左侧菜单栏进入`深渊统计`页面
+- 点击`角色使用`以查看角色使用率数据
+  - 角色使用率 = 角色在当前层数出场次数 / 持有该角色的玩家在该层数的总记录数
+- 点击`角色出场`以查看角色出场率数据
+  - 角色出场率 = 角色在当前层数出场次数 / 当前层数总记录数
+- 点击`角色持有`以查看角色持有率数据[^first]
+  - 角色持有率[^second] = 所有拥有该角色的玩家数量 / 全部玩家数量
+- 点击`队伍出场`以查看队伍组合出场次数数据
+  - 各种角色组队情况下出场次数的排名
+
+## 上传深境螺旋数据
+
+- 在主界面点击左侧菜单栏进入`深渊记录`功能页面
+- 点击右上角的`刷新数据`以确保胡桃工具箱客户端已经获取到最新的个人深境螺旋数据
+- 点击右上角的`上传数据`以上传你的深境螺旋数据
+  - 这可能需要花费数秒，上传成功后你将会看到如下图的成功提示 ![upload-hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Zt7yQp1g6duBDALeX_!!1797064093.png)
+
+[^first]: 角色持有数据与深境螺旋记录独立
+[^second]: 只要拥有该角色，即使没有在深境螺旋中登场，也会被计入拥有的状态； 只要上传过深境螺旋记录，即会被计入全部玩家的数据中。