1. New API 渠道迁移脚本（Tampermonkey）

这是一个油猴脚本，用来在 */console/channel* 页面：

• 导出：把渠道列表和配置导出成一个 JSON 文件
• 导入：把这个 JSON 文件导入到另一个实例里（用于迁移）

你只要会“点按钮 + 选文件”，就能用。

1.1 版本约束（很重要）

我这边验证过的环境是：

• new-api：v0.11.5
• 模式：自用模式

如果你的版本/模式不一样：

• 页面还能打开，但接口可能不一样
• 最直接的现象：导入失败、导出 key 失败、或者提示没权限

---

2. 你需要准备什么

1. 浏览器：Chrome / Edge / Firefox 都行
2. 插件：Tampermonkey（油猴）
3. 你已经能正常登录到 new-api 的控制台

如果你想 导出 key（密钥），还需要：

4. 账号提前开启 2FA（二步验证）

---

3. 安装脚本

3.1 方式 A（推荐）：点链接安装

1. 先装好 Tampermonkey
2. 在浏览器打开这个链接（会弹出安装确认）：
   • https://raw.githubusercontent.com/GreenHatHG/new-api-monkey-scripts/refs/heads/main/new-api-channel-migrator.user.js
3. 点安装 / 更新

3.2 方式 B：手动复制粘贴

1. 打开 Tampermonkey 的管理面板
2. 新建脚本，把仓库里的 new-api-channel-migrator.user.js 内容粘进去
3. 保存

---

4. 怎么用（最常用）

4.1 打开渠道页面

打开你的实例里的渠道页面：

• https://你的域名/console/channel

页面右侧会出现一个小黑面板，能看到版本号（比如 v0.3.4）。

4.2 导出 JSON

1. 点右侧面板：导出 JSON
2. 勾选你要导出的渠道
3. 选择导出内容：
   • 只要配置（推荐）：会自动去掉 id/用量/余额 这种“搬家没用”的字段
   • 全部字段：把接口返回的字段尽量都带上
4. 点 开始导出
5. 浏览器会下载一个文件：channels_xxx_时间.json

4.3 导出 key（可选）

如果你勾选了 导出 key（可能需要验证码）：

• 脚本会先调用接口做一次“安全验证”
• 会弹出输入框让你输入 2FA 验证码（一般 6 位）
• 验证成功后，会去拿每个渠道的 key，并写进导出的 JSON

重要说明：

• 没有开 2FA：导出 key 这一步大概率会失败（key 会为空）
• 开了 2FA：你需要输入一次验证码，脚本会尽量在有效期内批量拿完 key
• 如果接口返回 429：脚本会提示你“等一会再试”，避免一直刷导致更难成功

脚本不会把你的 2FA 验证码写进文件，也不会长期保存到本地。

4.4 导入 JSON（迁移到另一个实例）

1. 先在目标实例登录（要有创建渠道权限）
2. 打开目标实例的：/console/channel
3. 点右侧面板：导入 JSON
4. 选择你之前导出的 channels_*.json
5. 勾选你要导入的渠道
6. 点 开始导入

导入规则：

• 允许重复：开（不查重，直接新增）
• 如果某条渠道在 JSON 里没有 key：会按“空 key”去导入

导入完成后：

• 脚本会自动刷新页面，让你马上看到新建的渠道

---

5. 常见问题

5.1 Q1：为什么导出的 JSON 里 key 是空的？

常见原因：

• 你没勾选“导出 key”
• 你没开 2FA（或没输入验证码 / 验证过期）
• 服务器限制了查看 key（需要先验证，或者限流 429）

5.2 Q2：导入失败了怎么办？

看脚本弹出的失败提示（一般会包含服务端返回的错误信息）。
最常见的是：

• 没登录 / 没权限
• 缺必填字段（比如有些版本要求必须有 key）

---

6. 安全提醒

• key 属于敏感信息。导出含 key 的 JSON 文件，请你自己保管好。
• 不要把 2FA 的 secret 给任何脚本/任何人（很危险）。