AI-RVC / tools /character_models.py
mason369's picture
Upload folder using huggingface_hub
22e90f1 verified
# -*- coding: utf-8 -*-
"""
角色模型管理 - 从 HuggingFace 下载 RVC 角色模型
"""
import os
import json
import re
import zipfile
import shutil
from pathlib import Path
from typing import Optional, List, Dict, Callable
try:
from huggingface_hub import hf_hub_download, list_repo_files
HF_AVAILABLE = True
except ImportError:
HF_AVAILABLE = False
# HuggingFace 仓库配置
HF_REPO_ID = "trioskosmos/rvc_models"
_VERSION_NOTE_CACHE: Dict[str, Optional[str]] = {}
_VERSION_NOTE_CACHE_LOADED = False
def _get_hf_token() -> Optional[str]:
"""获取 HuggingFace Token(支持 HF_TOKEN / HUGGINGFACE_HUB_TOKEN / HUGGINGFACE_TOKEN)"""
return (
os.environ.get("HF_TOKEN")
or os.environ.get("HUGGINGFACE_HUB_TOKEN")
or os.environ.get("HUGGINGFACE_TOKEN")
)
# 作品归类(用于 UI 分类筛选)
SERIES_ALIASES = {
"Love Live!": "Love Live!",
"Love Live! Sunshine!!": "Love Live!",
"Love Live! Superstar!!": "Love Live!",
"Love Live! 虹咲学园": "Love Live!",
"Love Live! 虹咲学園": "Love Live!",
"Love Live! 莲之空女学院学园偶像俱乐部": "Love Live!",
"Love Live! Sunshine!! / 幻日夜羽": "Love Live!",
"Hololive Japan": "Hololive",
"Hololive English": "Hololive",
"Hololive Indonesia": "Hololive",
"崩坏:星穹铁道": "崩坏系列",
"崩坏3rd": "崩坏系列",
"偶像大师 灰姑娘女孩": "偶像大师",
}
def normalize_series(source: str) -> str:
"""将来源归类到系列"""
if not source:
return "未知"
for key, series in SERIES_ALIASES.items():
if source.startswith(key):
return series
return source
def _get_display_name(info: Dict, fallback: str) -> str:
"""拼接中文名 / 英文名 / 日文名用于展示"""
zh_name = info.get("zh_name") or info.get("description") or fallback
en_name = info.get("en_name")
jp_name = info.get("jp_name")
parts = [zh_name]
if en_name and en_name != zh_name:
parts.append(en_name)
if jp_name and jp_name != zh_name and jp_name != en_name:
parts.append(jp_name)
display = " / ".join(parts)
variant = info.get("variant")
if variant:
display = f"{display} - {variant}"
variant_note = _get_version_note(fallback, info)
if variant_note:
display = f"{display} ({variant_note})"
return display
def _find_index_file(pth_file: Path) -> Optional[Path]:
"""尝试找到对应的索引文件"""
candidate = pth_file.with_suffix(".index")
if candidate.exists():
return candidate
index_files = list(pth_file.parent.glob("*.index"))
if not index_files:
return None
for idx in pth_file.parent.glob("*.index"):
if idx.stem.lower() == pth_file.stem.lower():
return idx
if len(index_files) == 1:
return index_files[0]
def _normalize_name(text: str) -> str:
return re.sub(r"[^a-z0-9]+", "", text.lower())
def _tokenize_name(text: str) -> List[str]:
return [token for token in re.split(r"[^a-z0-9]+", text.lower()) if len(token) >= 2]
model_norm = _normalize_name(pth_file.stem)
model_tokens = set(_tokenize_name(pth_file.stem))
best_match = None
best_score = -1
for idx in index_files:
idx_norm = _normalize_name(idx.stem)
idx_tokens = set(_tokenize_name(idx.stem))
score = 0
if idx_norm == model_norm:
score += 1000
if model_norm and (model_norm in idx_norm or idx_norm in model_norm):
score += 300
shared_tokens = len(model_tokens & idx_tokens)
score += shared_tokens * 40
if "added" in idx.stem.lower():
score += 10
if score > best_score:
best_score = score
best_match = idx
if best_match is not None and best_score > 0:
return best_match
return None
def _safe_print(message: str):
"""避免控制台编码问题导致的输出异常"""
try:
print(message)
except UnicodeEncodeError:
print(message.encode("utf-8", "backslashreplace").decode("utf-8"))
def _load_version_note_cache():
global _VERSION_NOTE_CACHE_LOADED
if _VERSION_NOTE_CACHE_LOADED:
return
_VERSION_NOTE_CACHE_LOADED = True
try:
cache_path = get_character_models_dir() / "_version_notes.json"
if cache_path.exists():
with open(cache_path, "r", encoding="utf-8") as f:
data = json.load(f)
if isinstance(data, dict):
_VERSION_NOTE_CACHE.update(data)
except Exception:
pass
def _save_version_note_cache():
try:
cache_path = get_character_models_dir() / "_version_notes.json"
cache_path.parent.mkdir(parents=True, exist_ok=True)
with open(cache_path, "w", encoding="utf-8") as f:
json.dump(_VERSION_NOTE_CACHE, f, ensure_ascii=False, indent=2)
except Exception:
pass
def _normalize_note(note: str) -> Optional[str]:
if not note:
return None
# 取首行,移除链接与多余空白
line = note.strip().splitlines()[0].strip()
if not line:
return None
line = re.sub(r"https?://\S+", "", line).strip()
line = re.sub(r"\s+", " ", line).strip()
if not line:
return None
if len(line) > 60:
return line[:57] + "..."
return line
def _note_from_metadata(path: Path) -> Optional[str]:
try:
with open(path, "r", encoding="utf-8") as f:
data = json.load(f)
except Exception:
return None
parts = []
title = str(data.get("title") or "")
desc = str(data.get("description") or "")
type_val = str(data.get("type") or data.get("version") or "")
text = f"{title}\n{desc}"
epoch_match = re.search(r"(\d+)\s*epoch", text, re.IGNORECASE)
if epoch_match:
parts.append(f"{epoch_match.group(1)} epochs")
if type_val:
t = type_val.lower()
if t.startswith("v"):
parts.append(f"RVC {type_val}")
elif "rvc" in t:
parts.append(type_val)
if parts:
return " · ".join(dict.fromkeys(parts))
# fallback to title/description first line
return _normalize_note(desc) or _normalize_note(title)
def _note_from_pth(path: Path) -> Optional[str]:
try:
import torch
except Exception:
return None
try:
obj = torch.load(path, map_location="cpu", weights_only=False)
except Exception:
return None
if not isinstance(obj, dict):
return None
parts = []
info = obj.get("info")
if isinstance(info, str):
match = re.search(r"(\d+)\s*epoch", info, re.IGNORECASE)
if match:
parts.append(f"{match.group(1)} epochs")
sr = obj.get("sr")
if sr:
if isinstance(sr, (int, float)):
sr_note = f"{int(sr/1000)}k" if sr >= 1000 else str(int(sr))
else:
sr_note = str(sr)
parts.append(sr_note)
if parts:
return " · ".join(dict.fromkeys(parts))
return None
def _note_from_filename(name: str) -> Optional[str]:
if not name:
return None
lower = name.lower()
parts = []
if "rmvpe" in lower:
parts.append("RMVPE")
if "ov2" in lower or "ov2super" in lower:
parts.append("OV2")
if "pre-anime" in lower or "preanime" in lower:
parts.append("预TV")
# 训练轮次与步数
epoch_match = re.search(r"(?:^|[_-])e(\d{2,5})(?:[_-]|$)", lower)
if epoch_match:
parts.append(f"e{epoch_match.group(1)}")
step_match = re.search(r"(?:^|[_-])s(\d{3,7})(?:[_-]|$)", lower)
if step_match:
parts.append(f"s{step_match.group(1)}")
if parts:
return " · ".join(dict.fromkeys(parts))
return None
def _get_version_note(name: str, info: Dict) -> Optional[str]:
_load_version_note_cache()
note = info.get("variant_note")
if note:
return _normalize_note(note)
cached = _VERSION_NOTE_CACHE.get(name)
if cached is not None:
return cached
# 1) 读取本地模型目录中的 metadata / info
char_dir = get_character_models_dir() / name
if char_dir.exists():
for candidate in ("metadata.json", "model_info.json", "info.json"):
path = char_dir / candidate
if path.exists():
note = _note_from_metadata(path)
if note:
_VERSION_NOTE_CACHE[name] = note
_save_version_note_cache()
return note
# 2) 尝试从本地权重读取 info/版本
pth_files = sorted(char_dir.glob("*.pth"))
if pth_files:
note = _note_from_pth(pth_files[0]) or _note_from_filename(pth_files[0].name)
if note:
_VERSION_NOTE_CACHE[name] = note
_save_version_note_cache()
return note
index_files = sorted(char_dir.glob("*.index"))
if index_files:
note = _note_from_filename(index_files[0].name)
if note:
_VERSION_NOTE_CACHE[name] = note
_save_version_note_cache()
return note
# 3) 未下载时,从配置文件名解析
file_name = info.get("file") or ""
note = _note_from_filename(Path(str(file_name)).name)
if not note:
files = info.get("files") or []
if files:
note = _note_from_filename(Path(str(files[0])).name)
if not note and info.get("variant"):
note = "未提供版本说明"
_VERSION_NOTE_CACHE[name] = note
_save_version_note_cache()
return note
def refresh_version_notes(force: bool = False) -> Dict[str, Optional[str]]:
"""批量读取本地模型的版本说明,写入缓存文件"""
if force:
_VERSION_NOTE_CACHE.clear()
# 避免读取旧缓存文件
global _VERSION_NOTE_CACHE_LOADED
_VERSION_NOTE_CACHE_LOADED = True
notes = {}
for name in CHARACTER_MODELS.keys():
notes[name] = _get_version_note(name, CHARACTER_MODELS.get(name, {}))
return notes
def _get_confirm_token(response) -> Optional[str]:
"""获取 Google Drive 下载确认 token"""
import re
for key, value in response.cookies.items():
if key.startswith("download_warning"):
return value
try:
# 兼容通过页面确认下载的场景
match = re.search(r"confirm=([0-9A-Za-z_]+)", response.text)
if match:
return match.group(1)
except Exception:
pass
return None
def _download_gdrive_file(file_id: str, dest_path: Path) -> bool:
"""下载 Google Drive 文件(支持大文件确认)"""
import requests
dest_path.parent.mkdir(parents=True, exist_ok=True)
url = "https://drive.google.com/uc?export=download"
session = requests.Session()
response = session.get(url, params={"id": file_id}, stream=True, timeout=30)
token = _get_confirm_token(response)
if token:
response = session.get(
url, params={"id": file_id, "confirm": token}, stream=True, timeout=30
)
if response.status_code != 200:
print(f" 下载失败: HTTP {response.status_code}")
return False
content_type = response.headers.get("content-type", "")
if "text/html" in content_type:
print(" 下载失败: 需要手动确认或无访问权限")
return False
total_size = int(response.headers.get("content-length", 0))
downloaded = 0
with open(dest_path, "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
downloaded += len(chunk)
# 简单进度输出
if total_size > 0:
percent = downloaded * 100 / total_size
if int(percent) % 10 == 0:
print(f" 下载进度: {percent:.0f}%")
return dest_path.exists() and dest_path.stat().st_size > 0
# 角色模型列表
CHARACTER_MODELS = {
"Aimi": {
"file": "Aimi.zip",
"zh_name": "爱美",
"en_name": "Aimi",
"jp_name": "愛美",
"source": "原创角色"
},
"hanayo": {
"file": "kubotayurika.zip",
"zh_name": "小泉花阳",
"en_name": "Hanayo Koizumi",
"jp_name": "小泉花陽",
"source": "Love Live!"
},
"rin": {
"file": "rin.zip",
"zh_name": "星空凛",
"en_name": "Rin Hoshizora",
"jp_name": "星空凛",
"source": "Love Live!"
},
"umi": {
"file": "umi.zip",
"zh_name": "园田海未",
"en_name": "Umi Sonoda",
"jp_name": "園田海未",
"source": "Love Live!"
},
"nozomi": {
"file": "nozomi.zip",
"zh_name": "东条希",
"en_name": "Nozomi Tojo",
"jp_name": "東條希",
"source": "Love Live!"
},
"dia": {
"file": "dia.zip",
"zh_name": "黑泽黛雅",
"en_name": "Dia Kurosawa",
"jp_name": "黒澤ダイヤ",
"source": "Love Live! Sunshine!!"
},
"ayumu": {
"file": "ayumu.zip",
"zh_name": "上原步梦",
"en_name": "Ayumu Uehara",
"jp_name": "上原歩夢",
"source": "Love Live! 虹咲学园"
},
"chika": {
"file": "TakamiChika.zip",
"zh_name": "高海千歌",
"en_name": "Chika Takami",
"jp_name": "高海千歌",
"source": "Love Live! Sunshine!!",
"repo": "Icchan/LoveLive"
},
"riko": {
"file": "SakurauchiRiko.zip",
"zh_name": "樱内梨子",
"en_name": "Riko Sakurauchi",
"jp_name": "桜内梨子",
"source": "Love Live! Sunshine!!",
"repo": "Icchan/LoveLive"
},
"mari": {
"file": "Mari Ohara (Love Live! Sunshine!!) - Weights.gg Model.zip",
"zh_name": "小原鞠莉",
"en_name": "Mari Ohara",
"jp_name": "小原鞠莉",
"source": "Love Live! Sunshine!!",
"repo": "ChocoKat/Mari_Ohara"
},
"yohane": {
"file": "Yoshiko Tsushima.zip",
"zh_name": "津岛善子(夜羽)",
"en_name": "Yoshiko Tsushima (Yohane)",
"jp_name": "ヨハネ",
"source": "Love Live! Sunshine!! / 幻日夜羽",
"repo": "HarunaKasuga/YoshikoTsushima"
},
"nico": {
"url": "https://huggingface.co/Zurakichi/RVC/resolve/main/Models/Love%20Live/V2/%C2%B5%27s/NicoYazawa.zip",
"filename": "NicoYazawa.zip",
"zh_name": "矢泽妮可",
"en_name": "Nico Yazawa",
"jp_name": "矢澤にこ",
"source": "Love Live!",
"repo": "Zurakichi/RVC"
},
"kanata": {
"file": "Models/Love Live/V2/Nijigasaki/KanataKonoe.zip",
"zh_name": "近江彼方",
"en_name": "Kanata Konoe",
"jp_name": "近江彼方",
"source": "Love Live! 虹咲学园",
"repo": "Zurakichi/RVC"
},
"setsuna_yuki_nana": {
"file": "Models/Love Live/V2/Nijigasaki/SetsunaYuki.zip",
"zh_name": "优木雪菜",
"en_name": "Setsuna Yuki",
"jp_name": "優木せつ菜",
"variant": "Zurakichi v2",
"source": "Love Live! 虹咲学园",
"repo": "Zurakichi/RVC"
},
"hanamaru_zurakichi": {
"file": "Models/Love Live/V2/Aqours/HanamaruKunikida.zip",
"zh_name": "国木田花丸",
"en_name": "Hanamaru Kunikida",
"jp_name": "国木田花丸",
"variant": "Zurakichi v2",
"source": "Love Live! Sunshine!!",
"repo": "Zurakichi/RVC"
},
"kanan": {
"gdrive_id": "16dPSDGb3ciLsy1HtEXG2OSPhU7BuCty_",
"filename": "Kanan_Matsuura.zip",
"zh_name": "松浦果南",
"en_name": "Kanan Matsuura",
"jp_name": "松浦果南",
"source": "Love Live! Sunshine!!"
},
"yu_takasaki": {
"gdrive_id": "1xjIG_bsBzOTOwghGaLSMnO_vL2GgMPNw",
"filename": "Yu_Takasaki.zip",
"zh_name": "高咲侑",
"en_name": "Yu Takasaki",
"jp_name": "高咲侑",
"source": "Love Live! 虹咲学园"
},
"shizuku_osaka": {
"url": "https://mega.nz/file/UbZDEaRY#YnxExpDIJzh-rEDfEo2khTPAH1p6GZ5FzaMCfWdUQ34",
"zh_name": "樱坂雫",
"en_name": "Shizuku Osaka",
"jp_name": "桜坂しずく",
"source": "Love Live! 虹咲学园"
},
"sarah_kazuno": {
"file": "SarahKazuno2.zip",
"zh_name": "鹿角圣良",
"en_name": "Sarah Kazuno",
"jp_name": "鹿角聖良",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "thebuddyadrian/RVC_Models"
},
"leah_kazuno": {
"file": "LeahKazuno2.zip",
"zh_name": "鹿角理亚",
"en_name": "Leah Kazuno",
"jp_name": "鹿角理亞",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "thebuddyadrian/RVC_Models"
},
"eli": {
"file": "AyaseEli.zip",
"zh_name": "绚濑绘里",
"en_name": "Eli Ayase",
"jp_name": "絢瀬絵里",
"source": "Love Live!",
"repo": "Icchan/LoveLive"
},
"you": {
"file": "WatanabeYou.zip",
"zh_name": "渡边曜",
"en_name": "You Watanabe",
"jp_name": "渡辺曜",
"source": "Love Live! Sunshine!!",
"repo": "Icchan/LoveLive"
},
"honoka": {
"files": ["weights/Honoka.pth", "weights/honoka.index"],
"zh_name": "高坂穗乃果",
"en_name": "Honoka Kosaka",
"jp_name": "高坂穂乃果",
"source": "Love Live!",
"repo": "trioskosmos/rvc_models"
},
"kotori": {
"files": ["weights/Kotori.pth", "weights/kotori.index"],
"zh_name": "南小鸟",
"en_name": "Kotori Minami",
"jp_name": "南ことり",
"source": "Love Live!",
"repo": "trioskosmos/rvc_models"
},
"maki": {
"files": ["weights2/Maki.pth", "weights2/maki.index"],
"zh_name": "西木野真姬",
"en_name": "Maki Nishikino",
"jp_name": "西木野真姫",
"source": "Love Live!",
"repo": "trioskosmos/rvc_models"
},
"ruby": {
"files": ["weights2/Ruby.pth", "weights2/ruby.index"],
"zh_name": "黑泽露比",
"en_name": "Ruby Kurosawa",
"jp_name": "黒澤ルビィ",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"kasumi": {
"files": ["weights/Kasumi.pth", "weights/kasumi.index"],
"zh_name": "中须霞",
"en_name": "Kasumi Nakasu",
"jp_name": "中須かすみ",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"karin": {
"files": ["weights/Karin.pth", "weights/karin.index"],
"zh_name": "朝香果林",
"en_name": "Karin Asaka",
"jp_name": "朝香果林",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"rina": {
"files": ["weights2/Rina.pth", "weights2/rina.index"],
"zh_name": "天王寺璃奈",
"en_name": "Rina Tennoji",
"jp_name": "天王寺璃奈",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"lanzhu": {
"files": ["weights/Lanzhu.pth", "weights/lanzhu.index"],
"zh_name": "钟岚珠",
"en_name": "Lanzhu Zhong",
"jp_name": "鐘嵐珠",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"keke": {
"files": ["weights/Keke.pth", "weights/keke.index"],
"zh_name": "唐可可",
"en_name": "Keke Tang",
"jp_name": "唐可可",
"source": "Love Live! Superstar!!",
"repo": "trioskosmos/rvc_models"
},
"ai_miyashita": {
"file": "AiMiyashitaV2.zip",
"zh_name": "宫下爱",
"en_name": "Ai Miyashita",
"jp_name": "宮下愛",
"source": "Love Live! 虹咲学园",
"repo": "0xMifune/LoveLive"
},
"emma_verde": {
"file": "EmmaVerdeV2.zip",
"zh_name": "艾玛·维尔德",
"en_name": "Emma Verde",
"jp_name": "エマ・ヴェルデ",
"source": "Love Live! 虹咲学园",
"repo": "0xMifune/LoveLive"
},
"shioriko_mifune": {
"file": "ShiorikoMifuneV2.zip",
"zh_name": "三船栞子",
"en_name": "Shioriko Mifune",
"jp_name": "三船栞子",
"source": "Love Live! 虹咲学园",
"repo": "0xMifune/LoveLive"
},
"chisato_arashi": {
"file": "ChisatoArashiV2.zip",
"zh_name": "岚千砂都",
"en_name": "Chisato Arashi",
"jp_name": "嵐千砂都",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"ren_hazuki": {
"file": "RenHazukiV2.zip",
"zh_name": "叶月恋",
"en_name": "Ren Hazuki",
"jp_name": "葉月恋",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"sumire_heanna": {
"file": "SumireHeannaV2.zip",
"zh_name": "平安名堇",
"en_name": "Sumire Heanna",
"jp_name": "平安名すみれ",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"kinako_sakurakoji": {
"file": "SakurakojiKinakoV2.zip",
"zh_name": "樱小路希奈子",
"en_name": "Kinako Sakurakoji",
"jp_name": "桜小路きな子",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"mei_yoneme": {
"file": "MeiYonemeV2.zip",
"zh_name": "米女芽衣",
"en_name": "Mei Yoneme",
"jp_name": "米女芽衣",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"shiki_wakana": {
"file": "ShikiWakanaV2.zip",
"zh_name": "若菜四季",
"en_name": "Shiki Wakana",
"jp_name": "若菜四季",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"natsumi_onitsuka": {
"file": "NatsumiOnitsukaV2.zip",
"zh_name": "鬼塚夏美",
"en_name": "Natsumi Onitsuka",
"jp_name": "鬼塚夏美",
"source": "Love Live! Superstar!!",
"repo": "0xMifune/LoveLive"
},
"sayaka_murano": {
"file": "SayakaMuranoV2.zip",
"zh_name": "村野纱香",
"en_name": "Sayaka Murano",
"jp_name": "村野さやか",
"source": "Love Live! 莲之空女学院学园偶像俱乐部",
"repo": "0xMifune/LoveLive"
},
"tsuzuri_yugiri": {
"file": "TsuzuriYugiri.zip",
"zh_name": "夕雾缀理",
"en_name": "Tsuzuri Yugiri",
"jp_name": "夕霧綴理",
"source": "Love Live! 莲之空女学院学园偶像俱乐部",
"repo": "0xMifune/LoveLive"
},
"hanamaru": {
"file": "Aqours_Hanamaru-Kunikida-RMVPE-Ov2.zip",
"zh_name": "国木田花丸",
"en_name": "Hanamaru Kunikida",
"jp_name": "国木田花丸",
"source": "Love Live! Sunshine!!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"setsuna_yuki_og": {
"file": "Nijigasaki_Setsuna-Yuki-OG-RMVPE-Ov2.zip",
"zh_name": "优木雪菜",
"en_name": "Setsuna Yuki",
"jp_name": "優木せつ菜",
"variant": "OG",
"source": "Love Live! 虹咲学园",
"repo": "Swordsmagus/Love-Live-RVC"
},
"setsuna_yuki_coco": {
"file": "setsuna-yuki-coco-hayashi-ver-555epochs.zip",
"zh_name": "优木雪菜",
"en_name": "Setsuna Yuki",
"jp_name": "優木せつ菜",
"variant": "林鼓子版",
"source": "Love Live! 虹咲学园",
"repo": "Swordsmagus/Love-Live-RVC"
},
"hanayo_pre_anime_v0": {
"file": "Hanayo-Pre-Anime-v0.zip",
"zh_name": "小泉花阳",
"en_name": "Hanayo Koizumi",
"jp_name": "小泉花陽",
"variant": "预TV v0",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"hanayo_pre_anime_v1": {
"file": "Hanayo-Pre-Anime-v1.zip",
"zh_name": "小泉花阳",
"en_name": "Hanayo Koizumi",
"jp_name": "小泉花陽",
"variant": "预TV v1",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"kotori_pre_anime": {
"file": "Kotori-Pre-Anime.zip",
"zh_name": "南小鸟",
"en_name": "Kotori Minami",
"jp_name": "南ことり",
"variant": "预TV",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"kotori_pre_anime_v2": {
"file": "Kotori-Pre-Anime-v2.zip",
"zh_name": "南小鸟",
"en_name": "Kotori Minami",
"jp_name": "南ことり",
"variant": "预TV v2",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"wien_margarete": {
"file": "Liella_Wien-Margarete-RMVPE-Ov2.zip",
"zh_name": "维恩·玛格丽特",
"en_name": "Wien Margarete",
"jp_name": "ウィーン・マルガレーテ",
"source": "Love Live! Superstar!!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"mia_taylor": {
"file": "Mia-Taylor-SIFAS-Lines-Only.zip",
"zh_name": "米娅·泰勒",
"en_name": "Mia Taylor",
"jp_name": "ミア・テイラー",
"source": "Love Live! 虹咲学园",
"repo": "Swordsmagus/Love-Live-RVC"
},
"anju_yuki_arise": {
"file": "A-RISE_Anju-Yuki-RMVPE.zip",
"zh_name": "优木安朱",
"en_name": "Anju Yuki",
"jp_name": "優木あんじゅ",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"erena_todo_arise": {
"file": "A-RISE_Erena-Todo-RMVPE.zip",
"zh_name": "统堂英玲奈",
"en_name": "Erena Todo",
"jp_name": "統堂英玲奈",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"tsubasa_kira_arise": {
"file": "A-RISE_Tsubasa-Kira-RMVPE.zip",
"zh_name": "绮罗翼",
"en_name": "Tsubasa Kira",
"jp_name": "綺羅ツバサ",
"source": "Love Live!",
"repo": "Swordsmagus/Love-Live-RVC"
},
"kanon": {
"file": "ShibuyaKanonRVC.zip",
"zh_name": "涩谷香音",
"en_name": "Kanon Shibuya",
"jp_name": "渋谷かのん",
"source": "Love Live! Superstar!!",
"repo": "Phos252/RVCmodels"
},
"setsuna": {
"files": ["weights2/Setsuna.pth", "weights2/setsuna.index"],
"zh_name": "优木雪菜",
"en_name": "Setsuna Yuki",
"jp_name": "優木せつ菜",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"setsuna_v2": {
"files": ["weights2/Setsuna2.pth", "weights2/setsuna2.index"],
"zh_name": "优木雪菜",
"en_name": "Setsuna Yuki",
"jp_name": "優木せつ菜",
"variant": "v2",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"chika_v2": {
"files": ["weights/Chika2.pth", "weights/chika2.index"],
"zh_name": "高海千歌",
"en_name": "Chika Takami",
"jp_name": "高海千歌",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"dia_v2": {
"files": ["weights/Dia2.pth", "weights/dia2.index"],
"zh_name": "黑泽黛雅",
"en_name": "Dia Kurosawa",
"jp_name": "黒澤ダイヤ",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"hanamaru_v2": {
"files": ["weights/Hanamaru2.pth", "weights/hanamaru2.index"],
"zh_name": "国木田花丸",
"en_name": "Hanamaru Kunikida",
"jp_name": "国木田花丸",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"honoka_v2": {
"files": ["weights/Honoka2.pth", "weights/honoka2.index"],
"zh_name": "高坂穗乃果",
"en_name": "Honoka Kosaka",
"jp_name": "高坂穂乃果",
"variant": "v2",
"source": "Love Live!",
"repo": "trioskosmos/rvc_models"
},
"ayumu_v2": {
"files": ["weights/Ayumu2.pth", "weights/ayumu2.index"],
"zh_name": "上原步梦",
"en_name": "Ayumu Uehara",
"jp_name": "上原歩夢",
"variant": "v2",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"ayumu_v3": {
"files": ["weights/Ayumu3.pth", "weights/ayumu3.index"],
"zh_name": "上原步梦",
"en_name": "Ayumu Uehara",
"jp_name": "上原歩夢",
"variant": "v3",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"ayumu_v4": {
"files": ["weights/Ayumu4.pth", "weights/ayumu4.index"],
"zh_name": "上原步梦",
"en_name": "Ayumu Uehara",
"jp_name": "上原歩夢",
"variant": "v4",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"karin_v2": {
"files": ["weights/Karin2.pth", "weights/karin2.index"],
"zh_name": "朝香果林",
"en_name": "Karin Asaka",
"jp_name": "朝香果林",
"variant": "v2",
"source": "Love Live! 虹咲学园",
"repo": "trioskosmos/rvc_models"
},
"keke_v2": {
"files": ["weights/Keke2.pth", "weights/keke2.index"],
"zh_name": "唐可可",
"en_name": "Keke Tang",
"jp_name": "唐可可",
"variant": "v2",
"source": "Love Live! Superstar!!",
"repo": "trioskosmos/rvc_models"
},
"riko_v2": {
"files": ["weights2/Riko2.pth", "weights2/riko2.index"],
"zh_name": "樱内梨子",
"en_name": "Riko Sakurauchi",
"jp_name": "桜内梨子",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"umi_v2": {
"files": ["weights2/Umi2.pth", "weights2/umi2.index"],
"zh_name": "园田海未",
"en_name": "Umi Sonoda",
"jp_name": "園田海未",
"variant": "v2",
"source": "Love Live!",
"repo": "trioskosmos/rvc_models"
},
"wien_v2": {
"files": ["weights2/Wien2.pth", "weights2/wien.index"],
"zh_name": "维恩·玛格丽特",
"en_name": "Wien Margarete",
"jp_name": "ウィーン・マルガレーテ",
"variant": "v2",
"source": "Love Live! Superstar!!",
"repo": "trioskosmos/rvc_models"
},
"yohane_trios": {
"files": ["weights2/Yohane.pth", "weights2/yohane.index"],
"zh_name": "津岛善子(夜羽)",
"en_name": "Yoshiko Tsushima (Yohane)",
"jp_name": "ヨハネ",
"variant": "trios",
"source": "Love Live! Sunshine!! / 幻日夜羽",
"repo": "trioskosmos/rvc_models"
},
"yoshiko_trios": {
"files": ["weights2/yoshiko.pth", "weights2/yoshiko.index"],
"zh_name": "津岛善子",
"en_name": "Yoshiko Tsushima",
"jp_name": "津島善子",
"variant": "trios",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"yoshiko_v2": {
"files": ["weights2/Yoshiko2.pth", "weights2/yoshiko2.index"],
"zh_name": "津岛善子",
"en_name": "Yoshiko Tsushima",
"jp_name": "津島善子",
"variant": "v2",
"source": "Love Live! Sunshine!!",
"repo": "trioskosmos/rvc_models"
},
"tokai_teio": {
"file": "Tokai Teio (Uma Musume) - Weights Model.zip",
"zh_name": "东海帝皇",
"en_name": "Tokai Teio",
"jp_name": "トウカイテイオー",
"source": "赛马娘",
"repo": "kohaku12/RVC-MODELS"
},
"focalors": {
"file": "Focalors.zip",
"zh_name": "芙卡洛斯",
"en_name": "Focalors",
"jp_name": "フォカロルス",
"source": "原神",
"repo": "makiligon/RVC-Models"
},
"essex": {
"file": "Essex.zip",
"zh_name": "埃塞克斯",
"en_name": "Essex",
"jp_name": "エセックス",
"source": "碧蓝航线",
"repo": "makiligon/RVC-Models"
},
"ellie": {
"file": "ellie.zip",
"zh_name": "艾莉",
"en_name": "Ellie",
"jp_name": "エリー",
"source": "社区模型",
"repo": "megaaziib/my-rvc-models-collection"
},
"furina": {
"file": "Furina.zip",
"zh_name": "芙宁娜",
"en_name": "Furina",
"jp_name": "フリーナ",
"source": "原神",
"repo": "makiligon/RVC-Models"
},
"ayaka": {
"file": "Ayaka.zip",
"zh_name": "神里绫华",
"en_name": "Kamisato Ayaka",
"jp_name": "神里綾華",
"source": "原神",
"repo": "makiligon/RVC-Models"
},
"takane_shijou": {
"file": "TakaneShijou.zip",
"zh_name": "四条贵音",
"en_name": "Takane Shijou",
"jp_name": "四条貴音",
"source": "偶像大师",
"repo": "makiligon/RVC-Models"
},
"kobo": {
"file": "kobo.zip",
"zh_name": "可波·卡娜埃露",
"en_name": "Kobo Kanaeru",
"jp_name": "こぼ・かなえる",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"kaela": {
"file": "kaela.zip",
"zh_name": "卡埃拉·科瓦尔斯基亚",
"en_name": "Kaela Kovalskia",
"jp_name": "カエラ・コヴァルスキア",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"pekora": {
"file": "pekora.zip",
"zh_name": "兔田佩克拉",
"en_name": "Usada Pekora",
"jp_name": "兎田ぺこら",
"source": "Hololive Japan",
"repo": "megaaziib/my-rvc-models-collection"
},
"kizuna_ai": {
"file": "kizuna-ai.zip",
"zh_name": "绊爱",
"en_name": "Kizuna AI",
"jp_name": "キズナアイ",
"source": "虚拟主播",
"repo": "megaaziib/my-rvc-models-collection"
},
"fuwawa": {
"file": "fuwawa.zip",
"zh_name": "软软·阿比斯加德",
"en_name": "Fuwawa Abyssgard",
"jp_name": "フワワ・アビスガード",
"source": "Hololive English",
"repo": "megaaziib/my-rvc-models-collection"
},
"mococo": {
"file": "mococo.zip",
"zh_name": "茸茸·阿比斯加德",
"en_name": "Mococo Abyssgard",
"jp_name": "モココ・アビスガード",
"source": "Hololive English",
"repo": "megaaziib/my-rvc-models-collection"
},
"vo_furina_kr": {
"file": "vo_furina_kr.zip",
"zh_name": "芙宁娜",
"en_name": "Furina",
"jp_name": "フリーナ",
"variant": "韩语",
"lang": "韩文",
"source": "原神",
"repo": "jarari/RVC-v2"
},
"silverwolf_kr": {
"file": "silverwolf_kr.zip",
"zh_name": "银狼",
"en_name": "Silver Wolf",
"jp_name": "銀狼",
"variant": "韩语",
"lang": "韩文",
"source": "崩坏:星穹铁道",
"repo": "jarari/RVC-v2"
},
"sparkle_e40": {
"file": "sparkle_e40.zip",
"zh_name": "花火",
"en_name": "Sparkle",
"jp_name": "花火",
"variant": "日语",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"ranko": {
"file": "ranko.zip",
"zh_name": "神崎兰子",
"en_name": "Ranko Kanzaki",
"jp_name": "神崎蘭子",
"source": "偶像大师 灰姑娘女孩"
},
"yumemiriamu": {
"file": "yumemiriamu.zip",
"zh_name": "梦见莉亚梦",
"en_name": "Riamu Yumemi",
"jp_name": "夢見りあむ",
"source": "偶像大师 灰姑娘女孩"
},
# ===== VOCALOID =====
"hatsune_miku": {
"file": "infamous_miku_v2.zip",
"zh_name": "初音未来",
"en_name": "Hatsune Miku",
"jp_name": "初音ミク",
"source": "VOCALOID",
"repo": "javinfamous/infamous_miku_v2"
},
# ===== 原神 (更多角色) =====
"nahida": {
"file": "Nahida JP (VA_ Yukari Tamura) - Weights.gg Model.zip",
"zh_name": "纳西妲",
"en_name": "Nahida",
"jp_name": "ナヒーダ",
"source": "原神",
"repo": "kohaku12/RVC-MODELS"
},
"nilou": {
"file": "Nilou%20JP%20(Kanemoto%20Hisako)%20-%20Weights.gg%20Model.zip",
"zh_name": "妮露",
"en_name": "Nilou",
"jp_name": "ニィロウ",
"source": "原神",
"repo": "kohaku12/RVC-MODELS"
},
# ===== 崩坏:星穹铁道 (更多角色) =====
"herta_hsr": {
"file": "Herta JP (VA_ Haruka Yamazaki) (Honkai_ Star Rail) - Weights.gg Model.zip",
"zh_name": "黑塔",
"en_name": "Herta",
"jp_name": "ヘルタ",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"the_herta": {
"file": "The Herta -Honkai Star Rail - Weights Model.zip",
"zh_name": "大黑塔",
"en_name": "The Herta",
"jp_name": "マダム・ヘルタ",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"firefly_hsr": {
"file": "Firefly _ Honkai_ Star Rail - Weights.gg Model.zip",
"zh_name": "流萤",
"en_name": "Firefly",
"jp_name": "ホタル",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"tingyun_hsr": {
"file": "Tingyun (Honkai_ Star Rail) (VA_ Yuuki Takada) - Weights.gg Model.zip",
"zh_name": "停云",
"en_name": "Tingyun",
"jp_name": "停雲",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"yunli_hsr": {
"file": "Yunli (Japanese Voice) Honkai Star Rail - Weights.gg Model.zip",
"zh_name": "云璃",
"en_name": "Yunli",
"jp_name": "雲璃",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"tribbie_hsr": {
"file": "Tribbie _ Honkai Star Rail JP (CV_ Hikaru Tono) - Weights Model.zip",
"zh_name": "缇宝",
"en_name": "Tribbie",
"jp_name": "トリビー",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"huohuo_hsr": {
"file": "huohuo2.zip",
"zh_name": "藿藿",
"en_name": "Huohuo",
"jp_name": "フォフォ",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
"castorice_hsr": {
"file": "Castorice (Honkai_ Star Rail, Japanese - CV_ Chiwa Saito) [Preliminary] - Weights Model.zip",
"zh_name": "遐蝶",
"en_name": "Castorice",
"jp_name": "キャストリス",
"source": "崩坏:星穹铁道",
"repo": "kohaku12/RVC-MODELS"
},
# ===== 崩坏3rd =====
"seele_hi3": {
"file": "Seele (Honkai impact 3rd) - Weights.gg Model.zip",
"zh_name": "希儿",
"en_name": "Seele",
"jp_name": "ゼーレ",
"source": "崩坏3rd",
"repo": "kohaku12/RVC-MODELS"
},
"herrscher_ego_hi3": {
"file": "Herrscher of Human_ Ego (Honkai Impact 3rd) - Weights.gg Model.zip",
"zh_name": "真我·人之律者",
"en_name": "Herrscher of Human: Ego",
"jp_name": "真我・人の律者",
"source": "崩坏3rd",
"repo": "kohaku12/RVC-MODELS"
},
# ===== 绝区零 =====
"miyabi_zzz": {
"file": "hoshimi miyabi (Zenless Zone Zero)JP - Weights Model.zip",
"zh_name": "星见雅",
"en_name": "Hoshimi Miyabi",
"jp_name": "星見雅",
"source": "绝区零",
"repo": "kohaku12/RVC-MODELS"
},
# ===== Project SEKAI =====
"nene_kusanagi": {
"file": "Nene Kusanagi (Project Sekai) - Weights Model.zip",
"zh_name": "草薙宁宁",
"en_name": "Nene Kusanagi",
"jp_name": "草薙寧々",
"source": "Project SEKAI",
"repo": "kohaku12/RVC-MODELS"
},
# ===== Hololive (更多角色) =====
"miko_sakura": {
"file": "miko.zip",
"zh_name": "樱巫女",
"en_name": "Sakura Miko",
"jp_name": "さくらみこ",
"source": "Hololive Japan",
"repo": "megaaziib/my-rvc-models-collection"
},
"subaru_oozora": {
"file": "subaru.zip",
"zh_name": "大空昴",
"en_name": "Oozora Subaru",
"jp_name": "大空スバル",
"source": "Hololive Japan",
"repo": "megaaziib/my-rvc-models-collection"
},
"moona_hoshinova": {
"file": "moona.zip",
"zh_name": "穆娜・霍希诺瓦",
"en_name": "Moona Hoshinova",
"jp_name": "ムーナ・ホシノヴァ",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"risu_ayunda": {
"file": "risu.zip",
"zh_name": "阿云达·莉苏",
"en_name": "Ayunda Risu",
"jp_name": "アユンダ・リス",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"reine_pavolia": {
"file": "reine.zip",
"zh_name": "帕沃莉亚・蕾妮",
"en_name": "Pavolia Reine",
"jp_name": "パヴォリア・レイネ",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"zeta_vestia": {
"file": "zeta.zip",
"zh_name": "贝斯蒂亚・泽塔",
"en_name": "Vestia Zeta",
"jp_name": "ヴェスティア・ゼータ",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"anya_melfissa": {
"file": "anya.zip",
"zh_name": "安亚・梅尔菲莎",
"en_name": "Anya Melfissa",
"jp_name": "アーニャ・メルフィッサ",
"source": "Hololive Indonesia",
"repo": "megaaziib/my-rvc-models-collection"
},
"luna_himemori": {
"file": "luna.zip",
"zh_name": "姬森露娜",
"en_name": "Himemori Luna",
"jp_name": "姫森ルーナ",
"source": "Hololive Japan",
"repo": "megaaziib/my-rvc-models-collection"
},
# ===== 碧蓝航线 =====
"boothill": {
"file": "Boothill.zip",
"zh_name": "波提欧",
"en_name": "Boothill",
"jp_name": "ブートヒル",
"source": "崩坏:星穹铁道",
"repo": "makiligon/RVC-Models"
},
# ===== 明日方舟 =====
"shiroko_rosmontis": {
"file": "ShirokoRosmontis.zip",
"zh_name": "白子/迷迭香",
"en_name": "Shiroko / Rosmontis",
"jp_name": "シロコ / ロスモンティス",
"source": "蔚蓝档案 / 明日方舟",
"repo": "makiligon/RVC-Models"
},
# ===== 赛马娘 (更多角色) =====
"rice_shower": {
"file": "RiceShowerSinging.zip",
"zh_name": "米浴",
"en_name": "Rice Shower",
"jp_name": "ライスシャワー",
"source": "赛马娘",
"repo": "makiligon/RVC-Models"
},
}
def get_project_root() -> Path:
"""获取项目根目录"""
return Path(__file__).parent.parent
def get_character_models_dir() -> Path:
"""获取角色模型目录"""
return get_project_root() / "assets" / "weights" / "characters"
def list_available_characters() -> List[Dict]:
"""
列出可用的角色模型
Returns:
list: 角色信息列表
"""
result = []
for name, info in CHARACTER_MODELS.items():
source = info.get("source", "未知")
display = _get_display_name(info, name)
result.append({
"name": name,
"description": info.get("description", display),
"display": display,
"source": source,
"series": normalize_series(source),
"file": info.get("file"),
"files": info.get("files"),
"url": info.get("url"),
"repo": info.get("repo", HF_REPO_ID)
})
return result
def list_downloaded_characters() -> List[Dict]:
"""
列出已下载的角色模型
Returns:
list: 已下载的角色信息
"""
models_dir = get_character_models_dir()
if not models_dir.exists():
return []
downloaded = []
seen = set()
# 递归搜索 .pth,优先使用顶层目录名作为角色名
for pth_file in models_dir.rglob("*.pth"):
rel_path = pth_file.relative_to(models_dir)
parts = rel_path.parts
if len(parts) == 1:
char_name = pth_file.stem
else:
char_name = parts[0]
if char_name in seen:
continue
seen.add(char_name)
info = CHARACTER_MODELS.get(char_name, {})
source = info.get("source", "未知")
display = _get_display_name(info, char_name)
index_file = _find_index_file(pth_file)
downloaded.append({
"name": char_name,
"description": info.get("description", display),
"display": display,
"source": source,
"series": normalize_series(source),
"model_path": str(pth_file),
"index_path": str(index_file) if index_file else None
})
return downloaded
def get_character_model_path(name: str) -> Optional[Dict]:
"""
获取角色模型路径
Args:
name: 角色名称
Returns:
dict: 包含 model_path 和 index_path 的字典,或 None
"""
models_dir = get_character_models_dir()
char_dir = models_dir / name
# 1) 标准目录结构: characters/<name>/*.pth
if char_dir.exists():
pth_files = list(char_dir.glob("*.pth"))
if pth_files:
index_file = _find_index_file(pth_files[0])
return {
"model_path": str(pth_files[0]),
"index_path": str(index_file) if index_file else None
}
# 2) 允许直接放在 characters 目录
direct_pth = models_dir / f"{name}.pth"
if direct_pth.exists():
index_file = _find_index_file(direct_pth)
return {
"model_path": str(direct_pth),
"index_path": str(index_file) if index_file else None
}
# 3) 兜底:在 characters 目录递归查找同名模型
for pth_file in models_dir.rglob("*.pth"):
if pth_file.stem.lower() == name.lower():
index_file = _find_index_file(pth_file)
return {
"model_path": str(pth_file),
"index_path": str(index_file) if index_file else None
}
return None
def download_character_model(
name: str,
progress_callback: Optional[Callable[[str, float], None]] = None
) -> bool:
"""
下载角色模型
Args:
name: 角色名称
progress_callback: 进度回调 (message, progress)
Returns:
bool: 是否成功
"""
if name not in CHARACTER_MODELS:
_safe_print(f"未知角色: {name}")
return False
char_info = CHARACTER_MODELS[name]
repo_id = char_info.get("repo", HF_REPO_ID)
zip_file = char_info.get("file")
file_list = char_info.get("files")
direct_url = char_info.get("url")
gdrive_id = char_info.get("gdrive_id")
pattern = char_info.get("pattern")
# 检查是否已下载
char_dir = get_character_models_dir() / name
if char_dir.exists() and list(char_dir.glob("*.pth")):
_safe_print(f"角色模型已存在: {name}")
return True
if progress_callback:
progress_callback(f"正在下载 {name} 模型...", 0.1)
hf_token = _get_hf_token()
try:
# Google Drive 下载
if gdrive_id:
filename = char_info.get("filename") or f"{name}.zip"
temp_dir = get_project_root() / "temp" / "downloads"
temp_dir.mkdir(parents=True, exist_ok=True)
temp_path = temp_dir / filename
_safe_print(f"正在从 Google Drive 下载: {filename}")
if not _download_gdrive_file(gdrive_id, temp_path):
return False
char_dir.mkdir(parents=True, exist_ok=True)
if temp_path.suffix.lower() == ".zip":
if progress_callback:
progress_callback(f"正在解压 {name} 模型...", 0.6)
with zipfile.ZipFile(temp_path, 'r') as zip_ref:
zip_ref.extractall(char_dir)
_flatten_extracted_dir(char_dir)
else:
shutil.copy(str(temp_path), str(char_dir / temp_path.name))
# 直链下载(可用于非 HuggingFace 源)
elif direct_url:
if "mega.nz" in direct_url:
_safe_print("Mega 下载暂不支持,请手动下载并放入角色目录")
return False
from tools.download_models import download_file
filename = char_info.get("filename") or Path(direct_url).name
temp_dir = get_project_root() / "temp" / "downloads"
temp_dir.mkdir(parents=True, exist_ok=True)
temp_path = temp_dir / filename
_safe_print(f"正在下载: {direct_url}")
if not download_file(direct_url, temp_path, name):
return False
char_dir.mkdir(parents=True, exist_ok=True)
if temp_path.suffix.lower() == ".zip":
if progress_callback:
progress_callback(f"正在解压 {name} 模型...", 0.6)
with zipfile.ZipFile(temp_path, 'r') as zip_ref:
zip_ref.extractall(char_dir)
_flatten_extracted_dir(char_dir)
else:
shutil.copy(str(temp_path), str(char_dir / temp_path.name))
# HuggingFace 多文件下载
elif file_list:
if not HF_AVAILABLE:
raise ImportError("请安装 huggingface_hub: pip install huggingface_hub")
_safe_print(f"正在从 HuggingFace 下载: {repo_id} (files)")
char_dir.mkdir(parents=True, exist_ok=True)
total = len(file_list)
for idx, hf_file in enumerate(file_list, start=1):
if progress_callback and total > 0:
progress_callback(
f"正在下载 {name} 文件 {idx}/{total}...",
0.1 + 0.8 * (idx / total)
)
downloaded_path = hf_hub_download(
repo_id=repo_id,
filename=hf_file,
cache_dir=str(get_project_root() / "temp" / "hf_cache"),
token=hf_token
)
target_name = Path(hf_file).name
shutil.copy(str(downloaded_path), str(char_dir / target_name))
# HuggingFace: 根据 pattern 自动选择文件
elif pattern:
if not HF_AVAILABLE:
raise ImportError("请安装 huggingface_hub: pip install huggingface_hub")
_safe_print(f"正在从 HuggingFace 下载: {repo_id} (auto)")
files = list_repo_files(repo_id, token=hf_token)
if isinstance(pattern, str):
patterns = [pattern]
else:
patterns = list(pattern)
candidates = []
for f in files:
for p in patterns:
if p in f or (p == ".zip" and f.lower().endswith(".zip")):
candidates.append(f)
break
if not candidates:
_safe_print(f"未找到匹配文件: {pattern}")
return False
# 优先 zip
zip_candidates = [c for c in candidates if c.lower().endswith(".zip")]
selected = zip_candidates[0] if zip_candidates else candidates[0]
if selected.lower().endswith(".zip"):
zip_file = selected
downloaded_path = hf_hub_download(
repo_id=repo_id,
filename=zip_file,
cache_dir=str(get_project_root() / "temp" / "hf_cache"),
token=hf_token
)
if progress_callback:
progress_callback(f"正在解压 {name} 模型...", 0.6)
char_dir.mkdir(parents=True, exist_ok=True)
with zipfile.ZipFile(downloaded_path, 'r') as zip_ref:
zip_ref.extractall(char_dir)
_flatten_extracted_dir(char_dir)
else:
# 多文件下载
file_list = candidates
char_dir.mkdir(parents=True, exist_ok=True)
total = len(file_list)
for idx, hf_file in enumerate(file_list, start=1):
if progress_callback and total > 0:
progress_callback(
f"正在下载 {name} 文件 {idx}/{total}...",
0.1 + 0.8 * (idx / total)
)
downloaded_path = hf_hub_download(
repo_id=repo_id,
filename=hf_file,
cache_dir=str(get_project_root() / "temp" / "hf_cache"),
token=hf_token
)
target_name = Path(hf_file).name
shutil.copy(str(downloaded_path), str(char_dir / target_name))
# HuggingFace zip 下载
else:
if not HF_AVAILABLE:
raise ImportError("请安装 huggingface_hub: pip install huggingface_hub")
_safe_print(f"正在从 HuggingFace 下载: {repo_id}/{zip_file}")
downloaded_path = hf_hub_download(
repo_id=repo_id,
filename=zip_file,
cache_dir=str(get_project_root() / "temp" / "hf_cache"),
token=hf_token
)
if progress_callback:
progress_callback(f"正在解压 {name} 模型...", 0.6)
char_dir.mkdir(parents=True, exist_ok=True)
with zipfile.ZipFile(downloaded_path, 'r') as zip_ref:
zip_ref.extractall(char_dir)
_flatten_extracted_dir(char_dir)
if progress_callback:
progress_callback(f"{name} 模型下载完成", 1.0)
# 下载完成后更新版本说明缓存
_get_version_note(name, char_info)
_safe_print(f"角色模型已下载: {name}")
return True
except Exception as e:
_safe_print(f"下载失败: {e}")
if progress_callback:
progress_callback(f"下载失败: {e}", 0)
return False
def _flatten_extracted_dir(char_dir: Path):
"""
处理解压后可能的嵌套目录结构
"""
# 检查是否有嵌套的单一目录
items = list(char_dir.iterdir())
if len(items) == 1 and items[0].is_dir():
nested_dir = items[0]
# 移动内容到上级目录
for item in nested_dir.iterdir():
shutil.move(str(item), str(char_dir / item.name))
nested_dir.rmdir()
def delete_character_model(name: str) -> bool:
"""
删除角色模型
Args:
name: 角色名称
Returns:
bool: 是否成功
"""
char_dir = get_character_models_dir() / name
if char_dir.exists():
shutil.rmtree(char_dir)
print(f"已删除角色模型: {name}")
return True
return False
def check_hf_available() -> bool:
"""检查 huggingface_hub 是否可用"""
return HF_AVAILABLE
def list_available_series() -> List[str]:
"""
获取可用的作品/系列列表(去重)
"""
series_set = set()
for info in CHARACTER_MODELS.values():
source = info.get("source", "未知")
series_set.add(normalize_series(source))
return sorted(series_set)
def download_all_character_models(
series: Optional[str] = None,
progress_callback: Optional[Callable[[str, float], None]] = None
) -> Dict[str, List[str]]:
"""
批量下载角色模型
Args:
series: 仅下载指定系列(如 "Love Live!"),None 表示全部
progress_callback: 进度回调 (message, progress)
Returns:
dict: { "success": [...], "failed": [...] }
"""
targets = list_available_characters()
if series and series != "全部":
targets = [c for c in targets if c.get("series") == series]
success = []
failed = []
total = max(len(targets), 1)
for idx, char in enumerate(targets, start=1):
if progress_callback:
progress_callback(
f"正在下载 {char['name']} ({idx}/{total})...",
idx / total
)
ok = download_character_model(char["name"])
if ok:
success.append(char["name"])
else:
failed.append(char["name"])
return {
"success": success,
"failed": failed
}
def get_character_choices() -> List[str]:
"""
获取角色选择列表 (用于 UI 下拉框)
Returns:
list: 角色名称列表
"""
downloaded = list_downloaded_characters()
return [c["name"] for c in downloaded]