使用说明
游戏王卡数据库CLI
搜索游戏的命令行工具哦！本地卡数据库，包含完整的日本卡数据。
特性
CLI命令
- ygo_搜索 -使用灵活过滤器搜索卡片
- ygo_bk_search -高效的批量搜索（最多50个查询）
- ygo_text -从文本中提取卡片图案
- ygo_replace -提取图案并用卡片ID或名称替换
- ygo_seek -获取随机或特定范围的卡信息
- ygo_cvert -转换文件格式（JSON、CSV、TSV、JSONL）
- ygo_faq_search -搜索官方FAQ数据库
卡片搜索功能
卡片名称样式
{card-name}-使用通配符（*）和规范化进行灵活搜索《card-name》-具有归一化的精确搜索{{card-name|cardId}}-按卡ID搜索
智能标准化
自动处理：
- 空格和符号（★☆等）
- 全角/半角字符
- 大写/小写
- 平假名/片假名转换
- Kanji variants (竜→龙）
高级搜索功能
- 通配符：使用
*在名称和文本字段中（例如。，{text: "*destroy*monster*"}) - 否定搜索：不包括以下卡片
-"phrase"（例如。，{text: "summon -\"negate\""}) - 批量搜索：一次最多搜索50张卡
- 模式提取：自动检测
{flexible},《exact》,{{name|id}}模式
常见问题搜索
- 搜索官方FAQ数据库（12578条）
- 按常见问题ID、卡ID、卡名称模式过滤
- 按卡规格（种族、级别、类型等）搜索
- 使用通配符搜索问题/答案文本
安装
# Clone repository
git clone https://github.com/TomoTom0/YuGiOh-Search-CLI.git
cd YuGiOh-Search-CLI
# Install dependencies
bun install
# Build project (required!)
bun run build
# Download data files (37.6MB total)
bash scripts/setup/setup-data.sh
# Optional: Install CLI commands globally
bun link
用法
全局CLI命令
之后 bun link，您可以全局使用这些命令：
# Search cards by name
ygo_search '{"name":"青眼の白龍"}' cols=name,cardId
# Wildcard search
ygo_search '{"name":"ブルーアイズ*"}' cols=name,atk
# Bulk search
ygo_bulk_search '[{"filter":{"name":"青眼"}}]'
# Extract patterns from text
ygo_extract "Use {ブルーアイズ*} and 《青眼の白龍》"
# Replace patterns with card IDs
ygo_replace "{青眼の白龍}を召喚" --raw
ygo_replace "{青眼の白龍}を召喚" --mount-par --raw
# Get random cards
ygo_seek --max 5
ygo_seek --range 4000-5000 --max 20
ygo_seek --range 4000-4100 --all --format csv
# Search FAQ database
ygo_faq_search cardId=6808 limit=5
ygo_faq_search cardName="青眼*" limit=10
ygo_faq_search question="*シンクロ召喚*"
# Convert file formats
ygo_convert input.json:output.jsonl
直接节点执行
node dist/cli/ygo_search.js '{"name":"青眼"}' cols=name,cardId
node dist/cli/ygo_extract.js "{青眼の白龍}"
node dist/cli/ygo_replace.js "{青眼}を召喚" --raw
node dist/cli/ygo_convert.js input.json:output.csv
数据库
数据文件
- cards-all.tsv （8.6MB）：13754张卡的卡基本信息
- detail-all.tsv （13MB）：详细的卡片信息（统计数据、效果等）
- faq-all.tsv （16MB）：官方FAQ数据库，包含12578条条目
卡信息
- 卡片总数：13754
- 常见问题总数：12578
- 格式：TSV（制表符分隔值）
- 语言：日语
- 包括：怪物、法术、陷阱卡，包括全文、统计数据和补充信息
文档
- BUILD_AND_RUN.md -构建和开发指南
- SHELL_COMMANDS.md -详细的CLI命令参考
- 用法.md -使用示例和配置
- 更改日志.md -发行说明和版本历史
许可证
麻省理工学院
数据源
卡片数据是从官方Yu Gi Oh收集的！OCG卡数据库。
