From 30c300cfe8555aaacf7c7ce97730595fd88a9871 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E9=91=AB?= Date: Thu, 2 Apr 2026 18:14:35 +0800 Subject: [PATCH] adjust default cfg range --- app.py | 2 +- src/voxcpm/cli.py | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/app.py b/app.py index 598e797..df8f109 100644 --- a/app.py +++ b/app.py @@ -59,7 +59,7 @@ _USAGE_INSTRUCTIONS_ZH = ( "🎛️ **Controllable Voice Cloning — 可控音色克隆** \n" "支持上传参考音频，并可以给instruction文本来指导控制语速、情绪、风格等表现。\n\n" "🎙️ **Hi-Fi Cloning — 高保真克隆** \n" - "追求最佳克隆效果，启用并上传参考音频文本来最大程度克隆原始音色。\n\n" + "启用并上传参考音频文本，同时开启参考音频 + 音频续写，保留最佳一致性体验。\n\n" ) _EXAMPLES_FOOTER_ZH = ( diff --git a/src/voxcpm/cli.py b/src/voxcpm/cli.py index dd9feae..60f8264 100644 --- a/src/voxcpm/cli.py +++ b/src/voxcpm/cli.py @@ -46,10 +46,10 @@ def validate_output_path(output_path: str) -> Path: def validate_ranges(args, parser): """Validate numeric argument ranges.""" if not (0.1 <= args.cfg_value <= 10.0): - parser.error("--cfg-value must be between 0.1 and 10.0") + parser.error("--cfg-value must be between 0.1 and 10.0 (recommended: 1.0–3.0)") if not (1 <= args.inference_timesteps <= 100): - parser.error("--inference-timesteps must be between 1 and 100") + parser.error("--inference-timesteps must be between 1 and 100 (recommended: 4–30)") if args.lora_r <= 0: parser.error("--lora-r must be a positive integer") @@ -358,13 +358,13 @@ def _add_common_generation_args(parser): "--cfg-value", type=float, default=2.0, - help="CFG guidance scale (float, recommended 0.5–5.0, default: 2.0)", + help="CFG guidance scale (float, recommended 1.0–3.0, default: 2.0)", ) parser.add_argument( "--inference-timesteps", type=int, default=10, - help="Inference steps (int, 1–100, default: 10)", + help="Inference steps (int, recommended 4–30, default: 10)", ) parser.add_argument( "--normalize", action="store_true", help="Enable text normalization" @@ -510,13 +510,13 @@ Examples: "--cfg-value", type=float, default=2.0, - help="CFG guidance scale (float, recommended 0.5–5.0, default: 2.0)", + help="CFG guidance scale (float, recommended 1.0–3.0, default: 2.0)", ) batch_parser.add_argument( "--inference-timesteps", type=int, default=10, - help="Inference steps (int, 1–100, default: 10)", + help="Inference steps (int, recommended 4–30, default: 10)", ) batch_parser.add_argument( "--normalize", action="store_true", help="Enable text normalization"