From f423f8b57fe8b8e57e1206268d2f33f6cf98733d Mon Sep 17 00:00:00 2001 From: dengqichen Date: Sun, 16 Nov 2025 19:23:20 +0800 Subject: [PATCH] aaaaa --- QUICKSTART.md | 155 +++++++++++++++++++++++++++++ analyze-pattern.js | 98 ++++++++++++++++++ final-verification.js | 54 ++++++++++ src/tools/card-generator/config.js | 2 +- verify-generation.js | 48 +++++++++ 5 files changed, 356 insertions(+), 1 deletion(-) create mode 100644 QUICKSTART.md create mode 100644 analyze-pattern.js create mode 100644 final-verification.js create mode 100644 verify-generation.js diff --git a/QUICKSTART.md b/QUICKSTART.md new file mode 100644 index 0000000..f211c9f --- /dev/null +++ b/QUICKSTART.md @@ -0,0 +1,155 @@ +# 快速开始指南 + +## 🚀 5分钟上手 + +### 1. 基本使用 + +生成一张银联卡（默认）： +```bash +node src/cli.js card +``` + +输出： +``` +6228367546245545|08|29|783 +``` + +### 2. 常用命令 + +```bash +# 生成Visa卡 +node src/cli.js card -t visa + +# 批量生成10张银联卡 +node src/cli.js card -n 10 + +# JSON格式输出 +node src/cli.js card -f json + +# 美化格式 +node src/cli.js card -f pretty + +# 查看支持的卡类型 +node src/cli.js card list-types + +# 查看帮助 +node src/cli.js --help +``` + +### 3. 便捷脚本 + +也可以使用 npm scripts： + +```bash +# 生成一张卡 +npm run card + +# 使用自定义参数（需要加 -- ） +npm run card -- -t visa -n 5 +``` + +### 4. 批量生成并保存 + +```bash +# 生成100张银联卡并保存 +node src/cli.js card -n 100 > cards.txt + +# 生成CSV格式 +node src/cli.js card -n 50 -f csv > cards.csv + +# 生成JSON格式（每行一个JSON对象） +node src/cli.js card -n 20 -f json > cards.json +``` + +### 5. 编程使用 + +创建脚本 `test.js`： + +```javascript +const CardGenerator = require('./src/tools/card-generator/generator'); +const generator = new CardGenerator(); + +// 生成单张卡 +const card = generator.generate('unionpay'); +console.log(card); + +// 批量生成 +const cards = generator.generateBatch(10, 'visa'); +console.log(cards); +``` + +运行： +```bash +node test.js +``` + +## 📊 输出格式对比 + +| 格式 | 命令 | 输出示例 | +|------|------|---------| +| **Pipe** | `node src/cli.js card` | `6228367546245545\|08\|29\|783` | +| **JSON** | `node src/cli.js card -f json` | `{"number":"6228367546245545","month":"08","year":"29","cvv":"783","type":"中国银联 (UnionPay)"}` | +| **CSV** | `node src/cli.js card -f csv` | `6228367546245545,08,29,783` | +| **Pretty** | `node src/cli.js card -f pretty` | 多行美化格式 | + +## 🎯 常见使用场景 + +### 测试场景1: 支付系统测试 + +```bash +# 生成各种卡类型用于测试 +node src/cli.js card -t visa -n 5 +node src/cli.js card -t mastercard -n 5 +node src/cli.js card -t amex -n 5 +``` + +### 测试场景2: 前端表单测试 + +```bash +# 生成JSON格式用于mock数据 +node src/cli.js card -n 20 -f json > mock-cards.json +``` + +### 测试场景3: 数据库填充 + +```bash +# 生成CSV格式导入数据库 +node src/cli.js card -t unionpay -n 1000 -f csv > import.csv +``` + +## 🔧 运行示例代码 + +查看完整示例： +```bash +node examples/basic-usage.js +``` + +## ⚡ 性能提示 + +- 单次生成推荐不超过 10000 张卡 +- 大批量生成建议分批进行 +- 使用 pipe 格式性能最优 + +## ❓ 遇到问题？ + +1. 查看完整文档：`README.md` +2. 查看工具文档：`docs/tools/card-generator.md` +3. 运行示例：`node examples/basic-usage.js` + +## 📝 输出格式说明 + +**Pipe格式** (默认)：`卡号|月|年|CVV` +- 适合：文本处理、批量导入 +- 分隔符：`|` + +**JSON格式**：完整JSON对象 +- 适合：API测试、前端mock +- 包含：卡号、有效期、CVV、卡类型 + +**CSV格式**：逗号分隔 +- 适合：Excel、数据库导入 +- 分隔符：`,` + +**Pretty格式**：美化显示 +- 适合：人工阅读、展示 +- 多行格式化输出 diff --git a/analyze-pattern.js b/analyze-pattern.js new file mode 100644 index 0000000..2e64273 --- /dev/null +++ b/analyze-pattern.js @@ -0,0 +1,98 @@ +/** + * 分析原始卡号规律 + */ + +const { luhnCheck } = require('./src/shared/utils'); + +// 原始样本数据 +const samples = [ + '6228367546781457|11|27|792', + '6228367542738949|06|28|510', + '6228367542602400|09|28|574', + '6228367548575105|06|27|838', + '6228367546496080|09|26|918', + '6228367540057649|10|26|244', + '6228367549574719|04|26|751', + '6228367548435128|11|28|897', + '6228367542797374|01|26|837', + '6228367545956423|10|30|516', + '6228367547237848|08|30|391', + '6228367540385107|10|27|364', + '6228367544252006|03|27|342', + '6228367547562054|12|29|870' +]; + +console.log('=== 原始卡号规律分析 ===\n'); + +// 解析数据 +const cards = samples.map(line => { + const [number, month, year, cvv] = line.split('|'); + return { number, month, year, cvv }; +}); + +// 1. 分析卡号结构 +console.log('1. 卡号结构分析:'); +console.log(` 总数量: ${cards.length}`); +console.log(` 卡号长度: ${cards[0].number.length} 位`); + +// 检查前缀 +const prefixes = cards.map(c => c.number.substring(0, 9)); +const uniquePrefixes = [...new Set(prefixes)]; +console.log(` 共同前缀: ${uniquePrefixes[0]}`); +console.log(` 前缀一致性: ${uniquePrefixes.length === 1 ? '✓ 是' : '✗ 否'}`); + +// 2. 检查Luhn算法 +console.log('\n2. Luhn算法校验:'); +let luhnValid = 0; +cards.forEach((card, i) => { + const isValid = luhnCheck(card.number); + if (isValid) luhnValid++; + console.log(` 卡${i + 1}: ${card.number} - ${isValid ? '✓ 通过' : '✗ 不通过'}`); +}); +console.log(` 总结: ${luhnValid}/${cards.length} 通过Luhn校验`); + +// 3. 分析有效期 +console.log('\n3. 有效期分析:'); +const months = cards.map(c => parseInt(c.month)); +const years = cards.map(c => parseInt(c.year)); +console.log(` 月份范围: ${Math.min(...months)} - ${Math.max(...months)}`); +console.log(` 年份范围: ${Math.min(...years)} - ${Math.max(...years)}`); + +// 4. 分析CVV +console.log('\n4. CVV分析:'); +const cvvs = cards.map(c => parseInt(c.cvv)); +console.log(` CVV长度: ${cards[0].cvv.length} 位`); +console.log(` CVV范围: ${Math.min(...cvvs)} - ${Math.max(...cvvs)}`); + +// 5. 分析后7位数字 +console.log('\n5. 后7位数字分析:'); +const suffixes = cards.map(c => c.number.substring(9)); +console.log(` 示例后7位:`); +suffixes.slice(0, 5).forEach((suffix, i) => { + console.log(` ${i + 1}. ${suffix}`); +}); + +// 6. 检查是否有数字模式 +console.log('\n6. 数字分布分析:'); +const allDigits = suffixes.join('').split('').map(d => parseInt(d)); +const digitCounts = {}; +for (let i = 0; i <= 9; i++) { + digitCounts[i] = allDigits.filter(d => d === i).length; +} +console.log(' 各数字出现次数:'); +for (let i = 0; i <= 9; i++) { + const bar = '█'.repeat(Math.floor(digitCounts[i] / 2)); + console.log(` ${i}: ${bar} (${digitCounts[i]})`); +} + +console.log('\n=== 结论 ==='); +if (luhnValid === cards.length) { + console.log('✓ 所有卡号都通过Luhn算法校验'); + console.log('✓ 建议: 启用Luhn算法生成'); +} else if (luhnValid === 0) { + console.log('✗ 没有卡号通过Luhn算法校验'); + console.log('✓ 建议: 使用纯随机生成（当前实现）'); +} else { + console.log('⚠ 部分卡号通过Luhn算法校验'); + console.log('⚠ 需要进一步分析规律'); +} diff --git a/final-verification.js b/final-verification.js new file mode 100644 index 0000000..2fe97e0 --- /dev/null +++ b/final-verification.js @@ -0,0 +1,54 @@ +/** + * 最终验证 - 确认生成的卡号符合所有规律 + */ + +const { luhnCheck } = require('./src/shared/utils'); + +// 刚才生成的5张卡 +const newCards = [ + '6228367543886341|02|28|859', + '6228367547515052|03|26|649', + '6228367546095387|07|30|930', + '6228367544299692|04|30|852', + '6228367546840634|01|26|197' +]; + +console.log('=== 最终验证 ===\n'); +console.log('验证新生成的5张卡:\n'); + +let allValid = true; +newCards.forEach((cardStr, index) => { + const [number, month, year, cvv] = cardStr.split('|'); + const isValid = luhnCheck(number); + + // 检查各项规律 + const prefixOk = number.startsWith('622836754'); + const lengthOk = number.length === 16; + const monthOk = parseInt(month) >= 1 && parseInt(month) <= 12; + const yearOk = parseInt(year) >= 26 && parseInt(year) <= 30; + const cvvOk = cvv.length === 3; + + const allChecks = prefixOk && lengthOk && monthOk && yearOk && cvvOk && isValid; + allValid = allValid && allChecks; + + console.log(`卡 ${index + 1}: ${cardStr}`); + console.log(` ├─ 前缀 622836754: ${prefixOk ? '✓' : '✗'}`); + console.log(` ├─ 长度 16位: ${lengthOk ? '✓' : '✗'}`); + console.log(` ├─ 月份 01-12: ${monthOk ? '✓' : '✗'}`); + console.log(` ├─ 年份 26-30: ${yearOk ? '✓' : '✗'}`); + console.log(` ├─ CVV 3位: ${cvvOk ? '✓' : '✗'}`); + console.log(` └─ Luhn校验: ${isValid ? '✓' : '✗'}\n`); +}); + +console.log('=== 结论 ==='); +if (allValid) { + console.log('✓ 所有卡号完全符合规律！'); + console.log('✓ 工具已正确实现，可以使用！\n'); + + console.log('推荐测试卡号（任选一张）:\n'); + newCards.forEach((card, i) => { + console.log(`${i + 1}. ${card}`); + }); +} else { + console.log('✗ 存在不符合规律的卡号，需要修复'); +} diff --git a/src/tools/card-generator/config.js b/src/tools/card-generator/config.js index 2c6adb2..5b16335 100644 --- a/src/tools/card-generator/config.js +++ b/src/tools/card-generator/config.js @@ -9,7 +9,7 @@ const CARD_TYPES = { prefix: '622836754', length: 16, cvvLength: 3, - useLuhn: false // 可选：是否使用Luhn算法 + useLuhn: true // 使用Luhn算法校验 }, visa: { name: 'Visa', diff --git a/verify-generation.js b/verify-generation.js new file mode 100644 index 0000000..c251ee2 --- /dev/null +++ b/verify-generation.js @@ -0,0 +1,48 @@ +/** + * 验证生成的卡号是否符合规律 + */ + +const CardGenerator = require('./src/tools/card-generator/generator'); +const Formatter = require('./src/tools/card-generator/formatter'); +const { luhnCheck } = require('./src/shared/utils'); + +const generator = new CardGenerator(); +const formatter = new Formatter(); + +console.log('=== 生成卡号验证 ===\n'); + +// 生成10张银联卡 +console.log('生成10张银联卡进行验证:\n'); + +const cards = generator.generateBatch(10, 'unionpay'); + +cards.forEach((card, index) => { + const isValid = luhnCheck(card.number); + const status = isValid ? '✓' : '✗'; + const formatted = formatter.format(card, 'pipe'); + console.log(`${index + 1}. ${formatted} ${status}`); +}); + +console.log('\n=== 验证结果 ==='); +const validCount = cards.filter(card => luhnCheck(card.number)).length; +console.log(`Luhn校验: ${validCount}/${cards.length} 通过`); + +if (validCount === cards.length) { + console.log('✓ 所有卡号都通过Luhn校验，符合规律！'); + console.log('\n=== 提供测试卡号 ==='); + const testCard = cards[0]; + console.log('\n请使用以下卡号进行测试：'); + console.log(`\n${formatter.format(testCard, 'pipe')}\n`); + console.log('详细信息：'); + console.log(formatter.format(testCard, 'pretty')); +} else { + console.log('✗ 部分卡号未通过校验，需要修复'); +} + +// 对比格式 +console.log('\n=== 格式对比 ==='); +console.log('原始样本格式:'); +console.log(' 6228367546781457|11|27|792'); +console.log('\n生成的卡号格式:'); +console.log(` ${formatter.format(cards[0], 'pipe')}`); +console.log('\n格式一致性: ✓');