# yaolingyao

**Repository Path**: jizuiba/yaolingyao

## Basic Information

- **Project Name**: yaolingyao
- **Description**: 基础的英雄联盟辅助工具
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-29
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 妖灵妖 (YaoLingYao)

<div align="center">

![Logo](public/logo.ico)

**一个拥有基础功能的英雄联盟辅助工具**

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](package.json)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Vue](https://img.shields.io/badge/Vue-3.5.17-4FC08D.svg)](https://vuejs.org/)
[![Electron](https://img.shields.io/badge/Electron-37.2.4-47848F.svg)](https://electronjs.org/)
[![Node.js](https://img.shields.io/badge/Node.js-18+-339933.svg)](https://nodejs.org/)

</div>

## 📖 项目简介

妖灵妖是一个基于 **Vue.js + Node.js + Electron** 技术栈开发的英雄联盟辅助工具桌面应用，通过集成英雄联盟客户端（LCU）API，提供战绩查询、自动操作、游戏状态监控等功能，为玩家提供更好的游戏体验。

> **后端功能依赖于管理员权限。**

## ✨ 核心功能

- **战绩查询** - 查看详细的对局记录和统计数据
- **实时数据** - 直接从英雄联盟客户端获取最新数据
- **英雄信息** - 完整的英雄数据库和头像显示
- **自动接受对局** - 自动接受匹配到的游戏
- **自动英雄选择** - 预设英雄自动选择和禁用
- **生涯背景替换**

## 🚀 快速开始

### 📋 环境要求

- **Node.js >= 18.0.0**
- **npm >= 8.0.0**
- **英雄联盟客户端**（用于LCU集成）

### 📦 安装与开发

1. 克隆项目并安装依赖：
   ```bash
   git clone https://github.com/jizuiba/yaolingyao.git
   cd yao-ling-yao
   npm install
   ```

2. 一键启动开发环境（推荐桌面预览）：
   ```bash
   npm run start:desktop
   ```
   > 同时启动前端、后端及 Electron 桌面端

3. 分步调试：
   ```bash
   npm run server       # 启动后端
   npm run dev          # 启动前端
   npm run electron:wait # 启动Electron桌面客户端
   ```

### 🏗️ 打包与发布

1. 仅前端静态包
   ```bash
   npm run build
   ```
2. Electron测试版目录包（开发自测）
   ```bash
   npm run electron:test
   ```
3. 正式安装包打包（推荐）
   ```bash
   npm run electron:dist
   ```

> 打包结果请查看 `release/` 目录下的 Win 安装包与未打包版本。

---

## 📡 核心API列表

- `/api/summoner/current`           | 获取当前召唤师信息
- `/api/summoner/by-puuid/:puuid`   | 根据PUUID获取召唤师信息
- `/api/summoner/profile`           | 获取/设置生涯背景
- `/api/match-history/:puuid`       | 获取对局历史

> 详细API见源码注释或与后端调试工具自测

## ⚒️ 常见问题

- 开服/日志问题请以**管理员权限**运行
- 英雄联盟客户端未开启无法获取数据

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

---

<div align="center">

**如果这个项目对您有帮助，请给个 ⭐ Star 支持一下！**

Made with ❤️ by jizuiba

</div>