lol-ban-cli

LOL（英雄联盟）封号查询 CLI 工具。在终端输入 lol 即可查询账号封禁状态。

功能

• 交互模式：输入 QQ 号回车查询，连续查多个账号
• 单次模式：lol 2234310998 直接出结果后退出
• 详细模式：-v 打印 token、原始 JSON、耗时
• 自动嗅探 token：每次启动从源站抓取最新 token，失效自动重试，全部失败用预设兜底
• token 本地缓存于 ~/.lol-ban-cli/token.json，24 小时过期

前提条件

• Node.js >= 18（自带原生 fetch）
• 关闭 Clash / V2Ray 等代理软件——否则会被 fake-ip 拦截连不上 API

安装方式

方式 A：本机开发链接（在项目目录内）

npm link

完成后任意终端输入 lol 即可。卸载：npm unlink -g lol-ban-cli

方式 B：打 tarball 拷到别的电脑

在本机：

npm pack
# 产出 lol-ban-cli-0.1.0.tgz

把 .tgz 拷到其他电脑，在那台电脑上：

npm install -g ./lol-ban-cli-0.1.0.tgz

方式 C：发布到 npm 公共仓库（任何人可装）

npm login                # 没账号去 npmjs.com 注册
npm publish --access public

之后任何人都能：

npm install -g lol-ban-cli

⚠️ lol-ban-cli 这个包名 npm 上可能被占。npm publish 前先 npm view lol-ban-cli，如显示 404 表示可用；如被占，改 package.json 里 name 字段，例如 @your-name/lol-ban-cli（scope 包基本不会冲突）。

用法

lol                       # 交互模式
lol 2234310998            # 单次查询
lol -v 2234310998         # 详细模式（带 token 与原始 JSON）
lol -h                    # 帮助

交互模式内命令：

| 命令 | 作用 | |------|------| | <QQ号> | 查询 | | q / quit / exit | 退出 | | -v | 切换详细模式 | | -h | 显示帮助 |

数据来源

接口：yun.4png.com/api/query.html，由 vba.hzmxm.top 间接付费维持。token 自动从 vba.hzmxm.top/user/ban/check 抓取，失败兜底使用预设值。

接口不稳定，会失效。 失效时可手动改 src/config.js 里的 FALLBACK_TOKEN。

目录结构

.
├── bin/
│   └── lol.js          # 入口，处理 argv，分发到 REPL 或单次查询
├── src/
│   ├── config.js       # 常量（URL、token、UA、缓存）
│   ├── colors.js       # ANSI 颜色（无紫色，NO_COLOR/非 TTY 自动剥离）
│   ├── token.js        # 自动嗅探 + 缓存 + 兜底
│   ├── api.js          # 4png 接口调用 + 失败 token 重试
│   ├── format.js       # 解析 banmsg + 提取原因 + 渲染输出
│   └── repl.js         # 交互模式
├── package.json
├── README.md
└── .gitignore

License

MIT