数据提供模块
- 从官方接口获取最新游戏数据并支持本地缓存
- 提供丰富的数据查询API，如获取羁绊下的棋子、棋子的羁绊详情等
- 高效的数据处理与缓存机制
阵容推荐模块
- 根据用户指定的人口、必须羁绊、必选棋子自动生成阵容
- 支持多种约束条件组合，如指定多个羁绊、多个棋子等
- 智能选择最佳棋子组合，最大化羁绊效果
阵容评分模块
- 综合考虑羁绊数量、等级、棋子费用等因素
- 可配置的评分权重，支持自定义评分策略
- 多维度评估阵容强度，提供量化的阵容分析
- 支持通过外置配置文件为特定羁绊或棋子设置自定义权重
接口模块
- 提供编程接口，方便集成到其他应用中
- 交互式命令行界面，便于直接使用
- 支持自定义评分参数

环境与依赖

Python版本: Python 3.8+
主要依赖:
- requests: 用于获取在线数据
- pandas: 用于数据处理
- pyyaml: 用于配置文件解析
- pytest: 用于单元测试

项目安装

克隆项目代码

git clone https://github.com/username/TFT-Strategist.git
cd TFT-Strategist

安装依赖

pip install -r requirements.txt

快速开始

查看帮助信息

运行以下命令查看主程序的帮助信息：

python main.py --help

输出结果会显示所有可用的子命令和选项。

数据提供模块演示

运行以下命令启动数据提供模块的演示程序：

python main.py data

演示程序将展示以下功能：

加载最新的游戏数据
显示当前版本职业、特质和棋子的基本信息
提供交互式查询界面，可以查询羁绊的棋子、棋子的羁绊等信息

阵容推荐模块演示

运行以下命令启动阵容推荐模块的演示程序：

python main.py recommend

演示程序将提供以下功能：

指定人口数量生成最佳阵容
指定必选羁绊生成阵容
指定必选棋子生成阵容
综合多种条件生成最优阵容

评分系统演示

运行以下命令启动评分系统的演示程序：

python main.py scoring

演示程序将展示以下功能：

使用默认权重进行阵容评分
使用配置文件中的自定义权重进行评分
通过代码动态设置特定羁绊和棋子的权重
比较不同权重设置下的评分差异
动态修改配置文件并重新加载

您还可以指定自定义配置文件：

python main.py scoring --config path/to/custom_config.yaml

命令行界面

运行以下命令启动交互式命令行界面：

python main.py cli

命令行界面提供以下功能：

指定阵容人口和评分参数
交互式添加必选羁绊和等级
交互式添加必选棋子
展示详细的阵容推荐结果，包括棋子信息和激活的羁绊

您还可以使用命令行参数自定义配置：

python main.py cli --population 8 --results 5 --level-weight 1.2 --count-weight 0.7 --cost-weight 0.2

参数说明：

--population：阵容人口数量，范围1-10，默认为9
--results：推荐结果数量，默认为3
--level-weight：羁绊等级权重，默认为1.0
--count-weight：羁绊数量权重，默认为0.5
--cost-weight：棋子费用权重，默认为0.1

项目结构

TFT-Strategist/
├── data/                      # 数据存储目录
│   ├── chess.json             # 棋子数据
│   ├── job.json               # 职业数据
│   ├── race.json              # 特质数据
│   └── weights_config.yaml    # 自定义权重配置文件
├── src/                       # 源代码
│   ├── data_provider/         # 数据提供模块
│   │   ├── __init__.py
│   │   ├── data_loader.py     # 数据加载器
│   │   └── data_query_api.py  # 数据查询API
│   ├── recommendation/        # 阵容推荐模块
│   │   ├── __init__.py
│   │   └── recommendation_engine.py  # 阵容推荐引擎
│   ├── scoring/               # 阵容评分模块
│   │   ├── __init__.py
│   │   ├── scoring_system.py  # 阵容评分系统
│   │   └── config_loader.py   # 配置加载器
│   ├── interface/             # 接口模块
│   │   ├── __init__.py
│   │   ├── api.py             # 编程接口
│   │   └── cli.py             # 命令行界面
│   ├── __init__.py
│   ├── data_provider_demo.py  # 数据提供模块演示
│   ├── recommendation_demo.py # 阵容推荐模块演示
│   ├── scoring_demo.py        # 评分系统演示
│   └── test_scoring.py        # 评分测试模块
├── tests/                     # 测试代码
│   ├── test_data_provider.py  # 数据提供模块测试
│   ├── test_recommendation.py # 阵容推荐模块测试
│   └── test_interface.py      # 接口模块测试
├── main.py                    # 主程序入口
├── requirements.txt           # 项目依赖
└── README.md                  # 项目文档

数据提供模块详解

数据提供模块是整个阵容推荐系统的基础，负责从官方接口获取最新的游戏数据，并提供丰富的查询功能。

主要组件

DataLoader: 负责数据获取与缓存
- 支持从本地或网络加载数据
- 实现数据缓存机制，避免频繁请求
- 自动处理数据更新
DataQueryAPI: 提供丰富的数据查询接口
- 获取所有职业/特质/棋子数据
- 根据ID或名称查询具体数据
- 查询羁绊下的棋子、棋子的羁绊
- 获取羁绊等级信息
- 查询棋子费用分布

使用示例

from src.data_provider import DataQueryAPI

# 初始化API
api = DataQueryAPI()

# 获取所有职业
jobs = api.get_all_jobs()

# 查询特定羁绊的棋子
heavy_warrior = api.get_job_by_name("重装战士")
if heavy_warrior:
    chess_list = api.get_chess_by_job(heavy_warrior['jobId'])
    print(f"重装战士棋子: {[chess['displayName'] for chess in chess_list]}")

# 查询棋子的羁绊
brand = api.get_chess_by_name("布兰德")
if brand:
    synergies = api.get_synergies_of_chess(brand['chessId'])
    print(f"布兰德的羁绊: {[synergy['name'] for synergy in synergies]}")

阵容推荐模块详解

阵容推荐模块是系统的核心，能够根据用户需求生成最优阵容。

主要组件

RecommendationEngine: 阵容推荐引擎
- 支持多种约束条件组合（人口、羁绊、棋子）
- 智能选择最佳棋子组合
- 内置多种推荐策略
TeamComposition: 阵容组合类
- 表示一个完整的云顶之弈阵容
- 包含棋子列表、羁绊统计等信息
- 提供阵容分析功能

使用示例

from src.data_provider import DataQueryAPI
from src.recommendation import RecommendationEngine
from src.scoring import TeamScorer

# 初始化API和推荐引擎
api = DataQueryAPI()
engine = RecommendationEngine(api=api)

# 指定人口推荐
teams = engine.recommend_team(population=9)

# 指定羁绊推荐
required_synergies = [
    {'name': '刺客', 'level': 4},
    {'name': '忍者', 'level': 1}
]
teams = engine.recommend_team(
    population=8,
    required_synergies=required_synergies
)

# 指定棋子推荐
required_chess = [
    {'name': '阿卡丽'},
    {'name': '劫'}
]
teams = engine.recommend_team(
    population=7,
    required_chess=required_chess
)

# 查看推荐结果
for team in teams:
    print(f"推荐阵容评分: {team.score}")
    print(f"阵容棋子: {[chess['displayName'] for chess in team.chess_list]}")

阵容评分模块详解

阵容评分模块是系统的核心评估组件，负责为推荐的阵容提供量化的评分指标。

主要组件

TeamScorer: 阵容评分器
- 综合考虑羁绊数量、等级、棋子费用等因素
- 支持自定义权重配置
- 提供灵活的评分API
ScoringConfig: 评分配置类
- 定义评分所需的各项权重参数
- 提供默认配置值
- 支持通过外部配置文件进行定制
ConfigLoader: 配置加载器
- 从YAML或JSON文件加载评分配置
- 支持热重载配置
- 提供丰富的配置访问API

配置文件详解

系统支持通过YAML配置文件（data/weights_config.yaml）来自定义评分权重：

# 基础权重配置
base_weights:
  synergy_level_weight: 1.0   # 羁绊等级权重
  synergy_count_weight: 0.5   # 羁绊数量权重
  chess_cost_weight: 0.1      # 棋子费用权重

# 羁绊权重配置
synergy_weights:
  重装战士: 1.5    # 特定羁绊权重
  魔法师: 1.2
  # 其他羁绊...

# 棋子权重配置
chess_weights:
  亚索: 1.5       # 特定棋子权重
  艾希: 1.2
  # 其他棋子...

# 羁绊等级权重
synergy_level_weights:
  '1': 1.0        # 1级羁绊权重
  '2': 1.2        # 2级羁绊权重
  # 其他等级...

# 棋子费用权重
cost_weights:
  '1': 1.0        # 1费棋子权重
  '2': 1.2        # 2费棋子权重
  # 其他费用...

配置文件中的权重设置将直接影响阵容评分结果。权重值越大，对应的因素在评分中的影响越大。

使用示例

from src.scoring import TeamScorer
from src.data_provider import DataQueryAPI
from src.recommendation import RecommendationEngine

# 初始化评分器（自动加载配置文件）
scorer = TeamScorer()

# 或者指定配置文件路径
scorer = TeamScorer(config_path="path/to/custom_config.yaml")

# 动态修改权重
scorer.set_synergy_weight("忍者", 2.0)  # 提高"忍者"羁绊的权重
scorer.set_chess_weight("劫", 1.8)      # 提高"劫"的权重

# 重新加载配置文件
scorer.reload_config()

# 为阵容评分
api = DataQueryAPI()
engine = RecommendationEngine(api)
teams = engine.recommend_team(population=8)

for team in teams:
    score = scorer.score_team(team)
    print(f"阵容评分: {score}")
    print(f"棋子: {[chess['displayName'] for chess in team.chess_list]}")
    print(f"羁绊: {team.synergy_levels}")

接口模块详解

接口模块提供了便捷的方式与阵容推荐器进行交互，包括编程接口和命令行界面。

主要组件

TFTStrategistAPI: 编程接口类
- 提供完整的数据查询功能
- 提供阵容推荐和评分功能
- 支持自定义评分参数
TFTCommandLine: 命令行界面类
- 交互式用户界面
- 支持添加必选羁绊和棋子
- 详细展示阵容推荐结果

编程接口使用示例

from src.interface import TFTStrategistAPI, get_api

# 使用单例模式获取API实例
api = get_api()

# 或者创建新的API实例
# api = TFTStrategistAPI(use_local_data=True)

# 获取游戏版本
version = api.get_version()
print(f"当前游戏版本: {version}")

# 自定义评分参数
api.customize_scoring(
    synergy_level_weight=1.2,
    synergy_count_weight=0.6,
    chess_cost_weight=0.15
)

# 获取职业和特质信息
jobs = api.get_all_jobs()
races = api.get_all_races()

# 推荐阵容
required_synergies = [{'name': '超频战士', 'level': 3}]
required_chess = [{'name': '薇古丝'}]

teams = api.recommend_team(
    population=8,
    required_synergies=required_synergies,
    required_chess=required_chess,
    max_results=3
)

# 处理推荐结果
for i, team in enumerate(teams, 1):
    print(f"\n推荐阵容 #{i} (评分: {team['score']:.2f})")
    print(f"棋子: {[chess['displayName'] for chess in team['chess_list']]}")

命令行界面使用

直接通过main.py运行命令行界面：

python main.py cli [参数]

可选参数：

--population: 阵容人口数量，默认为9
--results: 返回结果数量，默认为3
--level-weight: 羁绊等级权重，默认为1.0
--count-weight: 羁绊数量权重，默认为0.5
--cost-weight: 棋子费用权重，默认为0.1

在交互界面中，您可以：

添加必选羁绊并指定等级
添加必选棋子
获取详细的阵容推荐结果

开发计划

数据提供模块
阵容推荐模块
阵容评分模块
接口模块

未来展望

图形用户界面(GUI)开发
基于历史数据的胜率分析
支持装备推荐
多语言支持
基于机器学习的个性化推荐

贡献指南

欢迎贡献代码、报告问题或提出新功能建议！请先fork本仓库，然后提交拉取请求。

许可证

MIT

联系方式

如有任何问题或建议，请提交issue或联系项目维护者。

README.md Unescape Escape

云顶之弈阵容推荐器

项目概述

主要功能

环境与依赖

项目安装

快速开始

查看帮助信息

数据提供模块演示

阵容推荐模块演示

评分系统演示

命令行界面

项目结构

数据提供模块详解

主要组件

使用示例

阵容推荐模块详解

主要组件

使用示例

阵容评分模块详解

主要组件

配置文件详解

使用示例

接口模块详解

主要组件

编程接口使用示例

命令行界面使用

开发计划

未来展望

贡献指南

许可证

联系方式

README.md