diff --git a/docs/FAQ/get-stoken-cookie-from-the-third-party.md b/docs/FAQ/get-stoken-cookie-from-the-third-party.md new file mode 100644 index 000000000..b97caa522 --- /dev/null +++ b/docs/FAQ/get-stoken-cookie-from-the-third-party.md @@ -0,0 +1,37 @@ +# 使用第三方工具获取有 Stoken 的 cookie + +::: warning +- 以下步骤中涉及的软件、开源项目等资源均来源于互联网，与 DGP-Studio 无关 +- 本说明文档仅提供有关的解决思路，仅供学习使用，具体操作与操作后果与本项目无关 +::: + +## Android + +Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie + +::: tip GetToken 开源项目 +- GitHub：[HolographicHat/GetToken](https://github.com/HolographicHat/GetToken) +::: + +- GetToken 项目的发布会包含两个 apk 文件，两者最终效果相同。根据你的设备情况选择适合你的版本即可 + - `app-release.apk` 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能 + - 名称以`lspatched`结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序 + - 你需要卸载官方版米游社以安装该版本的米游社 +- 启用插件或安装修改版米游社后打开米游社，在底栏点击"我的"，然后登录您的通行证 +- 在右上角点击形如🔑形状的按钮 +- 点击勾选 `Stoken` 选项 +- 点击`复制登录信息` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 + +## iOS + +iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie +- 从 App Store 下载 [Stream](https://apps.apple.com/cn/app/stream/id1312141691) +- 对域名 `api-takumi.mihoyo.com` 进行抓包分析 +- 找到并复制带有 `Stoken` 的数据 + - 形如`stuid=****;stoken=v2****;mid=****;` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 diff --git a/docs/FAQ/most-frequent-questions.md b/docs/FAQ/most-frequent-questions.md index 0dce2ce8b..f90277b3b 100644 --- a/docs/FAQ/most-frequent-questions.md +++ b/docs/FAQ/most-frequent-questions.md @@ -44,5 +44,13 @@ Start-Process shell:AppsFolder\7f0db578-026f-4e0b-a75b-d5d06bb0a74d_7jfyf5536hdr - 请 **使用管理员模式** 打开任意终端 - 输入如下代码并运行，以删除残留的计划任务 ``` - schtasks /delete /tn SnapHutaoDailyNoteRefreshTask -``` \ No newline at end of file +schtasks /delete /tn SnapHutaoDailyNoteRefreshTask +``` + +## 米游社帐号登录状态经常失效，添加的帐号消失 + +* 我们通过储存帐号的米游社 Cookie 来维持登录状态。 +* 但是当用户在浏览器或其它设备上**注销帐号**后， 维持登录状态的 Cookie 将**失效**。 +* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。 +* 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。 +* 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](https://hut.ao/FAQ/mihoyo-risk-tip.html)时亦会令Cookie无法被识别为有效状态 diff --git a/docs/features/mhy-account-switch.md b/docs/features/mhy-account-switch.md index 6dce4f4c9..9015e83da 100644 --- a/docs/features/mhy-account-switch.md +++ b/docs/features/mhy-account-switch.md @@ -8,85 +8,20 @@ headerDepth: 0 本文档所描述的帐号切换指的是用于获取游戏数据的米游社帐号，不是原神游戏内的帐号 ::: -## 添加一个新的米游社帐号 - -### 图片示例： -![登录](https://user-images.githubusercontent.com/96916320/207941286-56abb14e-5a6c-4a4d-9fb6-d8ce1a4c8226.png) - - -- 在程序主界面的左下角，设置的上方管理你的米游社帐号。在弹出的面板中你可以 +![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01tRs9NH1g6du1XgyDZ_!!1797064093.png) + +- 你可以在程序主界面的左下角，设置按钮的上方找到帐号菜单，以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以： - 点击`登录米哈游通行证`按钮 - 在弹出的内置浏览器中登录"米哈游通行证"账号 - - 您也可以通过点击`手动输入`按钮，直接输入`米游社 Cookie`来添加您的米游社帐号 - - 若您选择`手动输入`米游社Cookie，则该Cookie**必须包含Stoken等字段**，且为V2版本 - - 手动获取`含Stoken的V2版本Cookie`的方式：[请参考此条目](https://hut.ao/features/mhy-account-switch.html#%E5%A6%82%E4%BD%95%E8%87%AA%E8%A1%8C%E8%8E%B7%E5%8F%96%E5%90%AB%E6%9C%89stoken%E7%9A%84cookie) + - 您也可以通过点击`手动输入`按钮，直接输入米游社通行证 cookie 来添加您的帐号 + - 若您选择`手动输入`米游社 cookie，则该 cookie **必须包含 `Stoken` 字段** + - 手动获取含 `Stoken` 字段的 cookie 的方式可参考[使用第三方工具获取有 Stoken 的 cookie](../FAQ/get-Stoken-cookie-from-the-third-party.md)文档 - 在弹出的内置浏览器登陆成功后，点击右上角的"我已登陆"按钮 - - **部分杀毒软件**可能会对获取到的Cookie进行静默处理，导致Cookie不完整，如有此类错误提示，请自行关闭并重试 - 完成后，您就可以在帐号管理面板切换已登录的米游社帐号了 - - 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态 - - - -## 如何自行获取含有Stoken的Cookie - -- 若您目前**只需要登入一个**账号，则无需考虑本条目，直接在胡桃工具箱中登入自己的米游社通行证账号即可 - -- 如您在使用最新版本，在"胡桃工具箱"中正常添加了账号，则此时账号的Cookie中已经具有了Stoken字段，无需再进行此方法 - -- 若您有自行获取含有Stoken的Cookie的意愿，可参考以下思路： - -::: warning -- 请注意：Stoken、login_ticket等字段，均为敏感数据，使用时请自行斟酌 -- 以下步骤中涉及的软件、开源项目等资源均来源于互联网，与[DGP-Studio开发团队](https://github.com/DGP-Studio)无关 -- 本说明文档仅提供有关的解决思路，仅供学习使用，具体操作与操作后果与本项目无关 -::: - -### 安卓(Android)用户使用"GetToken"获取Stoken - -::: tip -- 项目名称：[HolographicHat/GetToken](https://github.com/HolographicHat/GetToken) - -- 下载地址：[网盘](https://cloud.06dn.com/api/v3/file/source/187740/GetToken.apk?sign=KpG5hzFpkjZtts-J2DHMWPewIu_aokl4fKD_U3XIJrQ%3D%3A0) / [Github](https://github.com/HolographicHat/GetToken/releases/download/2.42.1/miyoushe-361-lspatched.apk) -::: - -- 首先先下载安装上述名为"GetToken.apk"的Android安装包 - - 若在手机中安装，可能需要先卸载手机上原有的米游社App - - 您也可在电脑上的任意安卓模拟器或Android子系统中安装 - - 经测试，华为手机以及MuMu模拟器暂无法使用 - -- 安装后打开，在底栏点击"我的"，然后登录您的通行证 -- 在右上角点击`形如🔑形状的按钮` -- 点击勾选"Stoken"选项 -- 点击`复制登录信息` -- 将复制到的"Stoken"发送到已经安装了`胡桃工具箱`的电脑 -- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` - - 注意：您需要**已经**把您需要"升级Stoken状态"的米游社账号，在"胡桃"内登录完毕 -- 将之前获取到的"Stoken"输入，此时即可完成登录 - -::: tip -- 本文所提到的"Stoken"所指代的是含有"Stoken"字段的米游社Cookie，为了让用户更容易理解使用步骤，故对此表述做出了简化 -::: - -### 苹果(iOS)用户使用"stream"获取Stoken - -- 在应用商店中下载"stream"应用 - -- 对域名"api-takumi.mihoyo.com"进行抓包分析 -- 找到并复制带有Stoken的数据 - - 形如`stuid=****;stoken=v2****;mid=****;` - -- 将复制到的"Stoken"发送到已经安装了`胡桃工具箱`的电脑 -- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` - - 注意：您需要**已经**把您需要"升级Stoken状态"的米游社账号，在"胡桃"内登录完毕 -- 将之前获取到的"Stoken"输入，此时即可完成登录 - -- 若您在此过程中遇到困难，建议使用上一条中的"GetToken"方法获取Stoken - -## 常见问题：米游社帐号登录状态经常失效，添加的帐号消失 - -* 我们通过储存帐号的米游社 Cookie 来维持登录状态。 -* 但是当用户在浏览器或其它设备上**注销帐号**后， 维持登录状态的 Cookie 将**失效**。 -* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。 -* 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。 -* 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](https://hut.ao/FAQ/mihoyo-risk-tip.html)时亦会令Cookie无法被识别为有效状态 - + - 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态 + - 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号 + +::: danger 安全提示 +- `Stoken` 是一个安全敏感的 cookie 字段，你不应该在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。 +- 从胡桃工具箱中复制获得的 cookie 中包含该字段，请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。 +:::