# DiCloud Mihoyo Tools（米哈游辅助工具箱）

> 米哈游游戏公开数据库与个人战绩站。主站：https://mihoyo-tools.dicloud.work/ 。已上线崩坏：星穹铁道（HSR）多语言数据；战绩需登录，不公开。

前端是 SPA，页面 HTML 几乎无正文。公开数据是 CDN 上的静态 JSON，直接 GET，无需爬页面、无需鉴权。

文件清单与字段类型见 [gacha-game-types](https://github.com/SwingCosmic/gacha-game-types)。用下方 JSON 根替换其 README 中的 `{dataRoot}`。

## 数据 CDN

- JSON：https://cdn2.dicloud.work/static/apps/hkstarrail
  - 根级：`elements.json`、`paths.json`、`properties.json`、`version.json`
  - 语言目录 `{lang}/`：`CHS` `CHT` `EN` `JP` `KR` `DE` `ES` `FR` `ID` `PT` `RU` `TH` `VI`
  - 例：https://cdn2.dicloud.work/static/apps/hkstarrail/CHS/avatars/index.json
- 游戏图：与 JSON 同根（`spriteoutput/`、`bookimg/`、`dicecombat/`、`rogue/`、`cardfigure/`）
- 站点 UI：https://cdn2.dicloud.work/static/mihoyo-tools/hsr/

## 全文检索 API

对应页面 `/game/HonkaiStarRail/textsearch`。基址 `https://api.dicloud.work/`，**必须登录**。

认证：请求头 `Authorization: Bearer <access_token>`。`access_token` 由 DiCloud SSO（`https://www.dicloud.work/oauth/external-sso/...`）登录后在回调 query 带回，站点存在 `localStorage.accessToken`。`refresh_token` 只用于刷新，检索请求不带。未带 token 会 401。

当前页面调用 v2：

```
POST https://api.dicloud.work/game/hsr/textmap/searchv2?limit=20
Content-Type: application/json
Authorization: Bearer <access_token>

{
  "query": "开拓",
  "languages": ["CHS"],
  "tags": [],
  "skipIds": [],
  "searchMethod": 1
}
```

- `query` 至少 2 字；`languages` 最多 3 个
- `searchMethod`：`0` 精准 / `1` 模糊 / `2` 全文。`2` 仅支持 `CHS` `CHT` `EN` `JP`
- `tags` 可选：`noun` `book` `skill` `item` `avatar` `lightcone` `servant` `skilltree` `rank` `relic` `monster`
- 翻页：把已返回的 `id` 放入 `skipIds` 再请求
- 响应 `data.data` 为 `{ id, lang, text, tags, weight }[]`，`data.time` 为服务端耗时（秒）

详情（各语言字段 `textCHS` 等）：

```
GET https://api.dicloud.work/game/hsr/textmap/detail/{id}
Authorization: Bearer <access_token>
```