Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

## CHAPTER 5: CRITICAL FILE SYSTEM AND BLUEPRINT RE-ARCHITECTURING

未关闭
  • 哪里不对？
#2,855 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
30/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
技术栈
python, pytorch
领域
cli, data-engineering

调研方向

先阅读 train/dataset/extract_f0.py、extract_hubert_feature.py 和 train/preprocess.py，然后跟踪 audio-slicer 的输出如何变成 filelist.txt 并传递到 DataLoader。当数据集入口使用显式的 argparse 标志、安全地创建所需的嵌套目录，并且 filelist.txt 只包含 WAV、HuBERT 和 F0 文件全部存在的行时，即表示完成。

由索引模型根据 Issue 内容生成。

描述

Feature 13: Replacing Positional sys.argv with Robust argparse Flags in Dataset Tools
  • The Problem:
    Currently, standalone CLI modules like train/dataset/extract_f0.py and extract_hubert_feature.py rely on raw positional command-line arguments via sys.argv. Any slight deviation in the wrapper pipeline call logic or an attempt by a user to run the script directly via a shell causes fatal argument shifts. For instance, passing an unexpected extraction string causes the script to interpret a directory path as a hardware backend, resulting in a silent crash or a misleading ValueError: Unsupported F0 extraction mode.
  • Suggested Solution:
    Refactor all dataset processing entry points to utilize Python's native argparse library. Forcing explicit, named flags (e.g., --backend cuda, --input_dir ./logs/project) instead of brittle array indices will secure the interface from argument corruption across different OS shells and Python 3.12 subprocess configurations.
Bug 14: Fragile Directory Initialization and Safe Storage Isolation
  • The Problem:
    The pitch extraction core (extract_f0.py) assumes that its target directories (2a_f0, 2b-f0nsf, 3_feature768) already exist as physical folders on the drive. If a user shifts to a new custom experiment name (e.g., creating a separate model configuration profile), the pipeline immediately crashes with FileNotFoundError or NotADirectoryError (WinError 267). This happens because the framework fails to execute a recursive folder layout check and occasionally creates flat, broken meta-strings instead of actual physical directory nodes on Windows environments.
  • Suggested Solution:
    Implement an immutable, top-level initialization pass using os.makedirs(..., exist_ok=True) inside all feature extraction entry points. Before attempting to open loggers or stream tensor data, the framework must explicitly declare and force-verify that the required nested project folder branches physically exist as genuine directory objects.
Feature 15: Dynamic Validation-Driven filelist.txt Generation (Anti-Crash Mapping)
  • The Problem:
    The current dataset preprocessing utility (train/preprocess.py via audio-slicer) can occasionally skip indices or name sliced chunks non-sequentially based on the source voice profile's underlying envelope and silences (e.g., rendering files starting directly from 0_10.npy while omitting 0_1.npy). RVC's blueprint compiler generates the filelist.txt training map "blindly," assuming a perfect arithmetic index sequence. When the PyTorch DataLoader worker processes step one, it attempts to load missing baseline tensors, resulting in an unrecoverable FileNotFoundError that halts training.
  • Suggested Solution:
    Rework the blueprint compiling script to perform a dynamic, validation-driven directory scan. Instead of guessing file rows mathematically, the script should physically read the contents of the 3_feature768 and 2a_f0 folders on the SSD and map rows into filelist.txt only if all three required AI components (WAV, HuBERT features, and F0 pitch maps) are verified to coexist simultaneously on the drive. This failsafe mechanism will make the training engine completely bulletproof against irregular dataset slicing behaviors.
主要语言
Python
星标
38.9k
派生
5.3k
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

RVC-Project/Retrieval-based-Voice-Conversion-WebUI 的其他 Issue

查看 RVC-Project/Retrieval-based-Voice-Conversion-WebUI 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。