ios_rule_script/script/testflight/README.md

# TestFlight

## 前言

TestFlight多账户共存与自动加入脚本，主要满足个人需要两个脚本共存的需求。

**感谢NobyDa、DecoAri、chouchoui、lodepuly等大佬的源代码。**

本脚本部分参考了上述大佬的脚本源代码。

相对于原版，做了以下改动：

**TestFlight 自动加入**

1. 支持NodeJS，含青龙面板
2. 支持多账户
3. 支持MITM Over HTTP/1.1 与 HTTP/2
4. 支持控制加入TF的并发数量
5. 支持Session失效检测
6. 支持满员的TF自动加入任务
7. 支持温和、标准和暴力三种加入模式
8. 标准模式下，支持指定账号检测TF可否加入

**TestFlight 多账户共存**

1. 支持多账户同步
2. 去除共享功能
3. 保留当前账户“以前测试过”的列表

## 部署

**Surge**

```ini
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.sgmodule
```

**Quantumult X**

```ini
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.snippet
```

**Loon**

```ini
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.lnplugin
```

**Stash**

```ini
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.stoverride
```

## 入门

安装对应的模块/重写/插件/覆写

### **TestFlight 多账户共存**

在AppStore中切换不同的账号，每切换一个账号需要重新打开TestFlight，直至弹出获取必要信息成功的通知。

随后即可在TestFlight App中查看所有共存账号的App。

### **TestFlight 自动加入**

在AppStore中登录需要加入TestFlight的账号，打开TestFlight，弹出获取必要信息成功的通知。

打开需要加入的TestFlight App链接，如果已满员会自动加入任务列表。

脚本主要运行平台为青龙面板，所以在默认的配置中不带有计划任务。需要根据运行平台不同，手动为脚本设置一个定时任务。

#### **Surge**

```ini
[Script]
TestFlight_自动加入 = type=cron,cronexp=0/5 * * * * *,script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js
```

#### **Quantumult X**

```ini
[task_local]
0/5 * * * * * https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js, tag=TestFlight_自动加入, enabled=true
```

#### **Loon**

```ini
[Script]
cron "0/5 * * * * *" script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js,timeout=5,TestFlight_自动加入
```

#### **Stash**

```yaml
cron:
  script:
    - name: testflight.js
      cron: '0/5 * * * * *'
      argument: ''
      timeout: 10
```

#### **青龙面板**

在Web界面中，选择“定时任务”，选择新增，定时规则为“*/5 * * * * *”，即5秒运行一次。

### **大功告成**

如果你不想太过折腾，那么到这来配置就结束了，不需要再往下阅读。

## 进阶

### TestFlight 多账户共存

#### 多设备互相同步

脚本支持通过青龙面板，将多账户共存的信息在不同设备、不同客户端间互相同步。

举个例子，你有几台iPhone、iPad，它们使用不同的客户端，但是都使用同个脚本，连接同个青龙面板。那么当开启“同步数据到青龙面板”时，TestFlight的账户数据会在多个设备间互相同步。

更具体地说，你在iPhone上，登录A、B两个账号；在iPad上，登录C、D两个账号。开启同步后，你的iPhone、iPad和青龙面板将同时存储A、B、C、D四个账号的信息。这样无论你打开哪台设备的TestFlight的App，它们的数据是完全一致的。

当然，你也可以一台iPhone登录国区账号，一台iPhone登录外区账号，两台间互相同步。

**特别说明**

1. 数据同步可能会影响TestFlight的加载速度，建议只在必要时开启。
2. 如果多设备间数据冲突时，以青龙面板中存储的数据为准。
3. 如果需要删除某个账号，需要在青龙面板的magic.json文件中删除，在iOS设备中删除无效，下次还会从青龙面板同步回来。

### TestFlight 自动加入

#### 手动编辑需要加入的AppId

通过`tf_app_id`变量来存储需要加入的AppId，以;分隔。你可以在BoxJS，或magic.json文件中编辑它。

**需要注意原版是以,分隔，此处配置不同。**

#### 同步至青龙面板

https://github.com/blackmatrix7/ios_rule_script/tree/master/script#readme

根据上述文档，配置青龙面板，然后在BoxJS中打开同步至青龙面板的开关。配置完成后，每次打开TestFlight，登录信息变化时都会同步到青龙面板中。同时，在打开已满员的Beta链接时，也会将App ID同步至青龙面板。

**特别说明**

1. TestFlight中的App ID与青龙面板的同步是单向的，只能从设备同步到青龙面板。
2. 青龙面板最终存储的App ID为所有设备同步数据的合集。

#### 并发数量

指当App的Beta为可加入状态时，**每个账户**并发多少个请求来尝试加入。默认为2个，并发数量并不是越高越好。

#### 三种模式的区别

#### 温和

查询App的Beta状态时，不携带用户信息，仅在App可加入时才会使用存储的用户信息发起申请，理论上可以极大减少AppleID被Ban的几率。缺点为ResponeBody较大，查询的速度相较标准模式可能会稍慢。

**此模式未经验证。**

#### 标准

默认采用标准模式。

同原版一致的逻辑，查询App的Beta状态时，会带入一个用户的信息进行查询。在App可加入时，使用存储的用户信息发起申请。缺点是每次查询都会携带用户信息，理论上有导致AppleID被Ban的风险，不过目前并无先例。

**你可以指定一个小号专门用于检测可用性，具体见后文。**

#### 暴力

不查询App的Beta状态，直接使用存储的用户信息申请加入，如果无法加入会引发409的异常。优点是没有查询过程，抢App的Beta测试员成功率可能会更高。缺点是会持续不断的产生异常的请求，理论上被Ban的风险最大。

**此模式未经过验证。慎选，建议使用新注册的账号试验。**

#### 多账户自动加入

可以通过在iOS的设置中，切换AppStore账户，再打开TestFlight App来实现多账户加入。

多账户并不能提高加入的成功率，相反因为需要尝试加入的账户数量变多，反而会降低成功率。

多账户存储的数据格式如下，其中类似"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"为AccountId，非常重要，务必记牢。

```json
"tf_session_info": {
  "magic_session": true,
  "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx": {
    "X-Session-Id": "xxxxxxxxxxxxxxxx",
    "X-Session-Digest": "xxxxxxxxxxxxxx",
    "X-Request-Id": "xxxxxxxxxxxxx"
  },
  "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxoo": {
    "X-Session-Id": "xxxxxxxxxxxxx",
    "X-Session-Digest": "xxxxxxxxxxxxxx",
    "X-Request-Id": "xxxxxxxxxxxxx"
  }
}
```

**不同账户加入不同的App Beta测试员**

脚本通过`tf_joined_app_id`存储的数据来判断哪些账户需要加入哪些AppID。

tf_joined_app_id的数据格式如下：

```json
"tf_joined_app_id": {
  "magic_session": true,
  "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx": [
    "*",
    "PTbaSXrf",
    "J3awzdqd",
    "aL5ZWE8A",
    "iSTXkF4K"
  ],
  "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxoo": [
    "*"
  ]
}
```

magic_session 不可修改和删除，xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx为你的账户AccountId，对应的数组则是已经加入成功的AppId。

假设不想让AccountId为xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的账户加入PTbaSXrf的测试，在对应的数组中写入AppId即可。此时如果存在其他账户，则其他账户依旧会尝试加入PTbaSXrf的测试，直至成功。

如果某个账户，不希望它加入任何TF，则给它加一个"*"，表示任何APP的测试都不加入。

#### 专用账户检查TF

在标准模式下，可以指定一个账号专门用于检查App的TestFlight是否可加入。在BoxJS或magic.json中，为`tf_check_account_id`这个变量分配一个account id，将这个账户用来检查App的Beta成员是否已满。只有当Beta可加入时，才会用真正的账户来尝试加入，以达到保护主账号的目的。

举个例子，你可以注册一个新的账号，专门用于检查TF可否加入，当可以加入时，再用你的主账号尝试加入。

需要注意的是以下几点:

1. 专门用于检查的账号也需要获取Session，同时这个账号也会尝试加入TF，除非你根据上一条的`tf_joined_app_id`配置，排除掉。
2. 不用于检查的主账号，最好隔段时间就刷新一下Session，以免会话过期。

#### 连续运行

配置`tf_loop_count`来设置脚本每次启动时，执行多少次任务再退出，每次任务间隔固定800毫秒。通过配置连续运行次数，可以减少青龙面板的脚本执行频次，避免因为日志过多导致青龙面板没有响应。

如果是NodeJS环境(非青龙面板)，可以设置为0，脚本将持续运行不会终止。

不要在手机上将`tf_loop_count`设置为0，否则脚本会一直运行直到超时，或被手动中止。

#### Session检测

因为脚本的主要运行环境是青龙面板，所以可能存在Session因为长期未更新导致失效的情况。为此加入每2小时检测一次Session有效期的功能，如果失效会推送通知到手机，需要再手动获取信息，并同步到青龙面板。

检测间隔可以通过变量`tf_check_session_time_diff`配置，单位秒，不要配置过短，以免影响脚本正常功能。

## 其他

如果有问题欢迎反馈。

### Loon暂不支持MITM Over HTTP/2

已经和作者反馈，需要等待Loon更新。

### Shadowrocket未经验证

Shadowrocket未经验证，不确保能够正常使用

## 脚本变量

当前脚本使用的变量，你可以根据这些Key，在magic.json中配置数据。

| 名称                       | 类型   | 默认值 | 说明                                                         |
| -------------------------- | ------ | ------ | ------------------------------------------------------------ |
| tf_session_info            | Json   | 无     | 由脚本自动获取的Session信息，如需修改请整个删除重新获取      |
| tf_app_id                  | String | 无     | 需要加入Beta的AppId，多个以;分隔                             |
| tf_join_mode               | Int    | 1      | 执行默认 0 温和 1 标准 2 暴力                                |
| tf_join_concurrency        | Int    | 2      | 每个账户并发加入TestFlight Beta测试员的请求数                |
| tf_joined_app_id           | Json   | 无     | 存储每个账户已经成功加入的AppId                              |
| tf_check_account_id        | String | 无     | 专门用于检查TF可用性的Id，如果为空则从已登录的账户中随机选择 |
| tf_loop_count              | Int    | 1      | 每次运行脚本时循环多少次，每次循环间隔800毫秒，NodeJS(非青龙面板)可设置为0，表示持续运行 |
| tf_check_session_time_diff | Int    | 7200   | 每间隔多少秒检查一次账户的有效性，默认7200秒                 |
| tf_check_session_time      | Int    | 无     | 上次检查账户有效期的时间，自动生成，不需要配置               |
| tf_invalid_app_id          | Json   | 无     | 验证无效的AppId，自动生成，不需要配置                        |