03 — 仓库结构

Vocal10n/
├── README.md                  # 面向用户的快速开始。
├── LICENSE                    # MIT。
├── pyproject.toml             # `vocal10n` 包元数据。
├── setup_env.ps1              # 创建 venv_main + venv_tts 并安装依赖。
├── start.ps1 / start.bat      # 启动 GPT-SoVITS 子进程 + 主程序。
├── initialplan.md             # 原始项目规划（中英）。
├── promptfile.md              # Prompt 历史 / 草稿。
├── simple_ui_plan.md          # Simple/Pro 模式设计文档。
├── simple_ui_validation.md    # Simple 模式手工 QA 清单。
├── current.logs               # 最近一次运行日志（临时文件）。
│
├── config/
│   ├── default.yaml           # 运行时配置唯一事实源。
│   ├── context_gaming.txt     # 翻译用领域上下文示例。
│   └── filters.txt            # 幻觉过滤词表。
│
├── knowledge_base/
│   └── glossary_general.txt   # Corrector 默认词汇表。
│
├── stt_terms/
│   └── context_gaming.txt     # STT initial_prompt 术语示例。
│
├── reference_audio/           # 用户提供的声音克隆参考。
│   ├── audio_03.txt
│   └── README.md
│
├── models/                    # 本地模型存储（git 忽略）。
│   ├── stt/
│   ├── llm/Qwen3-4B-Instruct-2507.Q4_K_M.gguf
│   └── tts/
│
├── output/
│   ├── audio/
│   ├── subtitles/
│   └── training_data/
│
├── requirements/
│   ├── requirements-main.txt
│   └── requirements-tts.txt
│
├── src/vocal10n/
├── src/vocal10n.egg-info/
│
├── vendor/
│   ├── GPT-SoVITS/
│   └── Qwen3/
│
├── venvs/
│   ├── venv_main/
│   ├── venv_tts/
│   └── venv_qwen3tts/
│
├── temp_qwen3tts/
├── training/
│
├── Vocal10n-prebuild/
└── doc/

约定

• src/ 布局 + pyproject.toml。 在虚拟环境中用 pip install -e . 安装（setup 脚本会完成）。
• 单 YAML 配置。 运行时只加载 config/default.yaml。需要持久化的 UI 改动写回该文件。
• 依赖代码 vendored。 GPT-SoVITS 放在 vendor/GPT-SoVITS/，用于锁定可用版本并减少安装期网络依赖。
• 输出命名约定。 文件名形如 YYYY-MM-DD_HH-MM-SS_source.srt / _target.srt，按会话起始时间分组。