lol-ban-cli 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# 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：本机开发链接（在项目目录内）
+
+```bash
+npm link
+```
+
+完成后任意终端输入 `lol` 即可。卸载：`npm unlink -g lol-ban-cli`
+
+### 方式 B：打 tarball 拷到别的电脑
+
+在本机：
+
+```bash
+npm pack
+# 产出 lol-ban-cli-0.1.0.tgz
+```
+
+把 `.tgz` 拷到其他电脑，在那台电脑上：
+
+```bash
+npm install -g ./lol-ban-cli-0.1.0.tgz
+```
+
+### 方式 C：发布到 npm 公共仓库（任何人可装）
+
+```bash
+npm login                # 没账号去 npmjs.com 注册
+npm publish --access public
+```
+
+之后任何人都能：
+
+```bash
+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 包基本不会冲突）。
+
+## 用法
+
+```bash
+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

package/bin/lol.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { startRepl, handleQQ, showHelp } = require('../src/repl');
+
+function getVersion() {
+  try {
+    return require(path.join(__dirname, '..', 'package.json')).version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+(async function main() {
+  const args = process.argv.slice(2);
+  const state = { verbose: false };
+
+  if (args.includes('-h') || args.includes('--help')) {
+    showHelp();
+    process.exit(0);
+  }
+  if (args.includes('-v') || args.includes('--verbose')) {
+    state.verbose = true;
+  }
+
+  const qq = args.find(a => /^\d{5,12}$/.test(a));
+  if (qq) {
+    await handleQQ(qq, state);
+    process.exit(0);
+  }
+
+  startRepl(getVersion(), state);
+})();

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "lol-ban-cli",
+  "version": "0.1.0",
+  "description": "LOL 封号查询 CLI - 终端输入 lol 即可查询英雄联盟账号封禁状态",
+  "bin": {
+    "lol": "bin/lol.js"
+  },
+  "main": "src/api.js",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "lol",
+    "league-of-legends",
+    "ban",
+    "封号",
+    "cli",
+    "qq"
+  ],
+  "license": "MIT"
+}

package/src/api.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const { API_BASE, REFERER, UA, FALLBACK_TOKEN } = require('./config');
+const { resolveToken, sniffToken, saveCache } = require('./token');
+const c = require('./colors');
+
+async function callApi(qq, token) {
+  const url = `${API_BASE}?token=${token}&qq=${encodeURIComponent(qq)}&_=${Date.now()}`;
+  const resp = await fetch(url, {
+    headers: { Referer: REFERER, 'User-Agent': UA, Accept: '*/*' },
+  });
+  const text = await resp.text();
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new Error(`非 JSON 响应 (HTTP ${resp.status}): ${text.slice(0, 200)}`);
+  }
+}
+
+async function queryQQ(qq, verbose) {
+  let token = await resolveToken(verbose);
+  let j = await callApi(qq, token);
+
+  if (!j || j.code !== 200) {
+    if (verbose) console.error(`${c.dim}[首次失败 code=${j && j.code}，刷新 token 重试]${c.reset}`);
+    const fresh = await sniffToken(verbose);
+    if (fresh && fresh !== token) {
+      saveCache(fresh);
+      j = await callApi(qq, fresh);
+      token = fresh;
+    } else if (token !== FALLBACK_TOKEN) {
+      j = await callApi(qq, FALLBACK_TOKEN);
+      token = FALLBACK_TOKEN;
+    }
+  }
+  return { json: j, tokenUsed: token };
+}
+
+module.exports = { callApi, queryQQ };

package/src/colors.js

@@ -0,0 +1,17 @@
+'use strict';
+
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+
+const palette = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+module.exports = useColor ? palette : new Proxy({}, { get: () => '' });

package/src/config.js

@@ -0,0 +1,16 @@
+'use strict';
+
+const path = require('path');
+const os = require('os');
+
+module.exports = {
+  PRIMARY_PAGE: 'https://vba.hzmxm.top/user/ban/check',
+  REFERER: 'https://vba.hzmxm.top/',
+  API_BASE: 'https://yun.4png.com/api/query.html',
+  FALLBACK_TOKEN: '22fd19520d851dea',
+  UA: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36',
+
+  CACHE_DIR: path.join(os.homedir(), '.lol-ban-cli'),
+  CACHE_FILE: path.join(os.homedir(), '.lol-ban-cli', 'token.json'),
+  CACHE_TTL: 24 * 60 * 60 * 1000,
+};

package/src/format.js

@@ -0,0 +1,84 @@
+'use strict';
+
+const c = require('./colors');
+
+function parseBanMsg(banmsg) {
+  const r = { deadline: null, remaining: null, reason: null };
+  if (!banmsg) return r;
+
+  const m1 = banmsg.match(/封禁至\s*([\d\- :]+?)(?:[，,。]|$)/);
+  if (m1) r.deadline = m1[1].trim();
+
+  const m2 = banmsg.match(/距离解封还有\s*([^，,。]+)/);
+  if (m2) r.remaining = m2[1].trim();
+
+  const reasonPatterns = [
+    /(?:封号|封禁|处罚)原因[：:]\s*([^，,。\n]+)/,
+    /原因[：:]\s*([^，,。\n]+)/,
+  ];
+  for (const p of reasonPatterns) {
+    const m = banmsg.match(p);
+    if (m) { r.reason = m[1].trim(); break; }
+  }
+  return r;
+}
+
+function extractReason(data) {
+  const fields = ['reason', 'ban_reason', 'punish_reason', 'cause', 'type', 'category', 'punish_type'];
+  for (const k of fields) {
+    const v = data[k];
+    if (typeof v === 'string' && v.trim()) return v.trim();
+  }
+  return parseBanMsg(data.banmsg || '').reason;
+}
+
+function divider(char = '═', len = 36) {
+  return char.repeat(len);
+}
+
+function printResult(qq, j, tokenUsed, verbose) {
+  console.log();
+  if (!j || j.code !== 200 || !j.data) {
+    console.log(`${c.red}查询失败：接口返回异常${c.reset}`);
+    console.log(`${c.gray}原始响应：${JSON.stringify(j)}${c.reset}\n`);
+    return;
+  }
+
+  const d = j.data;
+  const status = (d.return || '').trim();
+
+  console.log(`${c.bold}${c.cyan}${divider()}${c.reset}`);
+  console.log(`${c.bold}${c.cyan}  查询结果${c.reset}`);
+  console.log(`${c.bold}${c.cyan}${divider()}${c.reset}`);
+  console.log(`  ${c.gray}QQ 号    :${c.reset} ${c.cyan}${qq}${c.reset}`);
+
+  if (status === '封禁') {
+    const parsed = parseBanMsg(d.banmsg || '');
+    const reason = extractReason(d);
+
+    console.log(`  ${c.gray}账号状态 :${c.reset} ${c.red}${c.bold}✖ 已封禁${c.reset}`);
+    console.log(`  ${c.gray}解封时间 :${c.reset} ${c.yellow}${parsed.deadline || '—'}${c.reset}`);
+    console.log(`  ${c.gray}剩余时间 :${c.reset} ${c.yellow}${parsed.remaining || d.rammsg || '—'}${c.reset}`);
+    if (reason) {
+      console.log(`  ${c.gray}封号原因 :${c.reset} ${c.red}${reason}${c.reset}`);
+    } else {
+      console.log(`  ${c.gray}封号原因 :${c.reset} ${c.dim}（接口未单独返回原因字段，详见下方完整信息）${c.reset}`);
+    }
+    console.log(`  ${c.gray}详细信息 :${c.reset} ${d.banmsg || '—'}`);
+  } else {
+    console.log(`  ${c.gray}账号状态 :${c.reset} ${c.green}${c.bold}✔ 状态正常${c.reset}`);
+    console.log(`  ${c.gray}         ${c.reset} ${c.dim}该账号暂无封禁记录${c.reset}`);
+  }
+
+  if (verbose) {
+    console.log(`  ${c.gray}─── 详细数据 ───${c.reset}`);
+    console.log(`  ${c.gray}token  :${c.reset} ${tokenUsed.slice(0, 8)}...`);
+    console.log(`  ${c.gray}原始 JSON:${c.reset}`);
+    const raw = JSON.stringify(j, null, 2).split('\n').map(s => `    ${c.gray}${s}${c.reset}`).join('\n');
+    console.log(raw);
+  }
+
+  console.log(`${c.bold}${c.cyan}${divider()}${c.reset}\n`);
+}
+
+module.exports = { parseBanMsg, extractReason, printResult, divider };

package/src/repl.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const readline = require('readline');
+const { queryQQ } = require('./api');
+const { printResult, divider } = require('./format');
+const c = require('./colors');
+
+function isValidQQ(s) { return /^\d{5,12}$/.test(s); }
+
+async function handleQQ(qq, state) {
+  process.stdout.write(`${c.dim}查询中...${c.reset}`);
+  const t0 = Date.now();
+  try {
+    const { json, tokenUsed } = await queryQQ(qq, state.verbose);
+    process.stdout.write(`\r${' '.repeat(60)}\r`);
+    if (state.verbose) console.log(`${c.gray}（耗时 ${Date.now() - t0}ms）${c.reset}`);
+    printResult(qq, json, tokenUsed, state.verbose);
+  } catch (e) {
+    process.stdout.write(`\r${' '.repeat(60)}\r`);
+    console.log(`${c.red}请求失败：${e.message}${c.reset}`);
+    console.log(`${c.dim}请检查：1) 已关闭 Clash/代理   2) 网络通畅   3) 接口未失效${c.reset}\n`);
+  }
+}
+
+function showHelp() {
+  console.log(`
+LOL 封号查询 CLI
+
+用法：
+  ${c.cyan}lol${c.reset}                  进入交互模式
+  ${c.cyan}lol <QQ号>${c.reset}           直接查询单个 QQ 后退出
+  ${c.cyan}lol -v <QQ号>${c.reset}        详细模式：打印 token 与原始 JSON
+  ${c.cyan}lol -h${c.reset}               显示此帮助
+
+交互模式内命令：
+  ${c.gray}q / quit / exit${c.reset}      退出
+  ${c.gray}-v${c.reset}                   切换详细模式
+  ${c.gray}-h${c.reset}                   显示帮助
+`);
+}
+
+function banner(version) {
+  console.log();
+  console.log(`${c.bold}${c.cyan}${divider()}${c.reset}`);
+  console.log(`${c.bold}${c.cyan}  LOL 封号查询 CLI${c.reset}  ${c.gray}v${version}${c.reset}`);
+  console.log(`${c.bold}${c.cyan}${divider()}${c.reset}`);
+  console.log(`  ${c.gray}输入 QQ 号回车查询  │  q 退出  │  -v 切换详细模式${c.reset}`);
+  console.log();
+}
+
+function startRepl(version, state) {
+  banner(version);
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  rl.on('SIGINT', () => {
+    console.log(`\n${c.dim}已退出${c.reset}`);
+    rl.close();
+    process.exit(0);
+  });
+
+  const ask = () => {
+    rl.question(`${c.cyan}QQ > ${c.reset}`, async (input) => {
+      const cmd = input.trim();
+      if (!cmd) return ask();
+      if (['q', 'quit', 'exit', ':q'].includes(cmd.toLowerCase())) {
+        console.log(`${c.dim}再见~${c.reset}`);
+        rl.close();
+        return;
+      }
+      if (cmd === '-v' || cmd === '--verbose') {
+        state.verbose = !state.verbose;
+        console.log(`${c.dim}详细模式：${state.verbose ? '已开启' : '已关闭'}${c.reset}\n`);
+        return ask();
+      }
+      if (cmd === '-h' || cmd === '--help' || cmd === '?') {
+        showHelp();
+        return ask();
+      }
+      if (!isValidQQ(cmd)) {
+        console.log(`${c.red}❗ 输入不合法（QQ 号应为 5-12 位数字）${c.reset}\n`);
+        return ask();
+      }
+      await handleQQ(cmd, state);
+      ask();
+    });
+  };
+
+  ask();
+}
+
+module.exports = { startRepl, handleQQ, showHelp, isValidQQ };

package/src/token.js

@@ -0,0 +1,59 @@
+'use strict';
+
+const fs = require('fs');
+const { PRIMARY_PAGE, UA, FALLBACK_TOKEN, CACHE_DIR, CACHE_FILE, CACHE_TTL } = require('./config');
+const c = require('./colors');
+
+function loadCache() {
+  try {
+    return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function saveCache(token) {
+  try {
+    if (!fs.existsSync(CACHE_DIR)) fs.mkdirSync(CACHE_DIR, { recursive: true });
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({ token, ts: Date.now() }, null, 2));
+  } catch {
+    /* ignore */
+  }
+}
+
+async function sniffToken(verbose) {
+  try {
+    const resp = await fetch(PRIMARY_PAGE, {
+      headers: { 'User-Agent': UA, Accept: 'text/html,*/*' },
+    });
+    if (!resp.ok) return null;
+    const html = await resp.text();
+    const m = html.match(/token=([a-f0-9]{8,32})/i);
+    return m ? m[1] : null;
+  } catch (e) {
+    if (verbose) console.error(`${c.dim}[嗅探异常: ${e.message}]${c.reset}`);
+    return null;
+  }
+}
+
+async function resolveToken(verbose) {
+  const cache = loadCache();
+  if (cache && cache.token && Date.now() - cache.ts < CACHE_TTL) {
+    if (verbose) console.error(`${c.dim}[使用缓存 token: ${cache.token.slice(0, 8)}...]${c.reset}`);
+    return cache.token;
+  }
+  const fresh = await sniffToken(verbose);
+  if (fresh) {
+    saveCache(fresh);
+    if (verbose) console.error(`${c.dim}[嗅探到最新 token: ${fresh.slice(0, 8)}...]${c.reset}`);
+    return fresh;
+  }
+  if (cache && cache.token) {
+    if (verbose) console.error(`${c.dim}[嗅探失败，使用过期缓存 token]${c.reset}`);
+    return cache.token;
+  }
+  if (verbose) console.error(`${c.dim}[使用预设兜底 token]${c.reset}`);
+  return FALLBACK_TOKEN;
+}
+
+module.exports = { sniffToken, resolveToken, saveCache, loadCache };