auto-account-machine/QUICKSTART.md

快速开始指南

🚀 5分钟上手

1. 基本使用

生成一张银联卡（默认）：

node src/cli.js card

输出：

6228367546245545|08|29|783

2. 常用命令

# 生成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：

# 生成一张卡
npm run card

# 使用自定义参数（需要加 -- ）
npm run card -- -t visa -n 5

4. 批量生成并保存

# 生成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：

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);

运行：

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: 支付系统测试

# 生成各种卡类型用于测试
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: 前端表单测试

# 生成JSON格式用于mock数据
node src/cli.js card -n 20 -f json > mock-cards.json

测试场景3: 数据库填充

# 生成CSV格式导入数据库
node src/cli.js card -t unionpay -n 1000 -f csv > import.csv

🔧 运行示例代码

查看完整示例：

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格式：美化显示

• 适合：人工阅读、展示
• 多行格式化输出