smsbower-phone-fill-tool/README.md

SMS/Luban/5SIM Phone Fill Tool

用途：点击扩展图标后，在当前网页右上角打开一个常驻悬浮窗。支持 SMSBower、Luban SMS、5SIM 三个接码平台；点一次“获取并填入”会获取手机号，自动填入当前页面最像手机号的输入框、复制到剪贴板，并自动点击页面上的下一步/发送验证码按钮。再次获取会先释放上一个激活/订单，再拿新号替换页面输入框并自动提交。

已集成功能：

• 接码平台可选：SMSBower / Luban SMS / 5SIM
• 自动保存 API Key、平台、服务、价格、国家/产品等配置到 chrome.storage.local
• SMSBower：按多个国家 + 价格范围查询库存，价低优先获取号码
• Luban SMS：按 service_id 获取号码，支持 service 列表价格过滤
• 5SIM：按 country/operator/product 获取号码，使用 Bearer Token 鉴权，支持 maxPrice
• 自动取消/释放旧号码后获取新号码
• 自动填入当前页面手机号输入框
• 自动复制手机号到剪贴板
• 自动点击下一步/继续/发送验证码/提交按钮
• 自动检测页面号码错误并按当前号码自动切换下一个号
• 验证码查询轮询：按钮点一次后每秒自动查，拿到验证码后停止
• 一键复制验证码
• 手动“检测报错换号”“已使用换号”“取消当前”兜底

接码平台配置：

1. SMSBower

• API Key：SMSBower key
• SMSBower API 地址：默认 https://smsbower.app/stubs/handler_api.php
• SMSBower 项目：默认 dr
• 国家顺序：选择一个或多个国家
• 最低价/最高价：可空

2. Luban SMS

• API Key：Luban apikey
• Luban API 地址：默认 https://lubansms.com/v2/api
• Luban service_id：必填，从 Luban 控制台或 List 接口查询
• 最低价/最高价：可空；如果 List 能查到 service_id cost，会按范围过滤

3. 5SIM

• API Key：5SIM token，插件会用 Authorization: Bearer
• 5SIM API 地址：默认 https://5sim.net
• 5SIM 国家：默认 vietnam；可填官方 country slug，也可填 any
• 5SIM 运营商：默认 any
• 5SIM 产品：默认 openai
• 最高价：可空；对应官方 buy activation 接口 maxPrice
• 最低价：5SIM 官方购买接口不支持最低价；使用 5SIM 时请留空

5SIM API 对应关系：

• 买号：GET /v1/user/buy/activation/{country}/{operator}/{product}?maxPrice=...
• 查码：GET /v1/user/check/{id}
• 取消：GET /v1/user/cancel/{id}
• 拉黑：GET /v1/user/ban/{id}

自动切号逻辑：

• 默认开启“自动切号：开”
• 页面出现“该电话已被使用 / 手机号已绑定 / 无法向此电话号码发送验证码”等错误时，插件会自动释放当前号码、获取下一个号码、填入、复制并自动提交
• 判定按当前号码进行：新号码触发相同错误文案也会继续切号
• 同一号码重复触发同一轮错误时不会并发重复切号

安装/更新：

1. 打开 chrome://extensions/
2. 开启“开发者模式”
3. 加载已解压的扩展程序，选择本目录
4. 已安装旧版时，点“重新加载”，然后刷新目标网页

测试： node --check background.js node --check content.js node --check popup.js python3 -m json.tool manifest.json node --test tests/provider.test.js