设置参数索引
当你想确认某个参数属于设置页的哪个页签、它的存储键和界面文案是什么、以及详细说明在哪个页面时，使用本页。本页把设置页七个页签下的全部可见参数汇总成索引表，并为每一项提供跳转到对应设置页或参数锚点的链接；参数的具体语义、三类默认值、消费者和运行机理在对应设置页展开，这里仅做汇总与反向链接，不重复撰写脱离功能的文件百科。
设置页外壳、说明面板和导入导出见设置外壳、说明面板与配置导入导出；全部枚举选项的 value/i18n 对照见界面选项对照表；九种工作流的阶段矩阵见工作流矩阵。
本页用法
按以下顺序使用本页：
- 在“设置页与页签”确认目标参数所属页签及对应页面。
- 在“参数索引”按页签找到参数行；存储键、English 与简体中文实际文案在同一行并列。
- 点击“跳转”列进入对应设置页的参数小节；没有独立显式锚点的参数行跳转到页面本身。
- 默认值、依赖、消费者和运行机理一律以跳转后的设置页正文为准，这里不展开。
本页聚焦设置页的可见参数行。settings_tab_layout.json 有 109 个条目，其中 108 个渲染为可见参数；剩余的 render.font_color 因发行默认值为 null 且没有对应控件分支而不渲染。界面语言、主题、系统代理、更新检查和自动检查更新开关属于“关于应用”页面，不是设置页参数行。以下内容不属于本页：API 管理页的凭据、地址、模型、候选槽与轮询策略，编辑器属性面板参数，提示词列表与批量管理方案，以及九种工作流的完整处理步骤。
设置页与页签
设置页通过左侧页签分组显示参数；页签标题来自 locale 的实际显示值。Advanced 只是 OCR、Detection、Inpainting 页签内的分隔线标题，不是独立页签。
| 布局标题 / UI 调用 key | English 实际值 | 简体中文实际值 | 可见参数数 | 对应页面 |
|---|---|---|---|---|
General | General | 通用 | 17 | 通用与应用设置、CLI、批量与输出 |
OCR | OCR | 文字识别 | 17 | OCR、过滤与文本行合并 |
Detection | Detection | 检测 | 13 | 检测 |
Translation | Translation | 翻译 | 11 | 翻译设置 |
Inpainting | Inpainting | 修复 | 10 | 蒙版与图像修复 |
Typesetting | Typesetting | 排版 | 28 | 排版与渲染 |
Mode Specific | Mode Specific | 模式相关 | 11 | 模式专用工作流与模板对齐、超分与上色 |
七个页签合计 107 个可见参数行。
参数索引
下表按设置页页签分组，逐项记录存储键、English 与简体中文实际文案，并提供跳转链接。数据来自 doc/wiki/data/settings.generated.json（由设置布局、UI 绑定和两个 locale 生成）与 doc/wiki/data/i18n.generated.json；每个跳转锚点都已与对应设置页中的显式锚点核对。
通用
通用页签的 17 个参数分散在两个页面：应用级参数见通用与应用设置，CLI/输出参数见CLI、批量与输出。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
cli.verbose | Verbose Logging | 详细日志 | #cli-verbose |
cli.ignore_errors | Ignore Errors | 忽略错误 | #cli-ignore-errors |
cli.use_gpu | Use GPU | 使用 GPU | #cli-use-gpu |
cli.disable_onnx_gpu | Disable ONNX GPU Acceleration | 禁用 ONNX GPU 加速 | #cli-disable-onnx-gpu |
cli.format | Output Format | 输出格式 | #cli-format |
cli.overwrite | Overwrite Existing Files | 覆盖已存在文件 | #cli-overwrite |
cli.skip_no_text | Skip Images Without Text | 跳过无文本图像 | #cli-skip-no-text |
cli.save_text | Editable Image | 图片可编辑 | #cli-save-text |
cli.save_quality | Image Save Quality | 图像保存质量 | #cli-save-quality |
cli.attempts | Retry Attempts | 重试次数 | #cli-attempts |
cli.batch_size | Batch Size | 批量大小 | #cli-batch-size |
cli.batch_concurrent | Concurrent Batch Processing | 并发批量处理 | #cli-batch-concurrent |
use_custom_api_params | Use Custom API Params | 使用自定义API参数 | #custom-api-params |
cli.save_to_source_dir | Save to Source Directory | 输出到原图目录 | #cli-save-to-source-dir |
cli.export_editable_psd | Export Editable PSD | 导出可编辑PSD | #cli-export-editable-psd |
cli.psd_script_only | Generate PSD Script Only | 仅生成PSD脚本 | #cli-psd-script-only |
app.unload_models_after_translation | Unload Models After Translation | 翻译完成后卸载模型 | #unload-models |
文字识别
本页签 17 个参数的说明见OCR、过滤与文本行合并。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
ocr.ocr | OCR Model | OCR模型 | #ocr-ocr |
ocr.use_hybrid_ocr | Enable Hybrid OCR | 启用混合OCR | #hybrid-ocr |
ocr.secondary_ocr | Secondary OCR | 备用OCR | #hybrid-ocr |
ocr.ai_ocr_prompt_path | AI OCR Prompt | AI OCR 提示词 | #ocr-vl-and-ai |
ocr.ai_ocr_concurrency | AI OCR Concurrency | AI OCR 并发数 | #ocr-vl-and-ai |
ocr.ocr_vl_language_hint | PaddleOCR-VL Language Hint | PaddleOCR-VL 语言提示 | #ocr-vl-and-ai |
ocr.ocr_vl_custom_prompt | PaddleOCR-VL Custom Prompt (Override) | PaddleOCR-VL 自定义提示词（优先） | #ocr-vl-and-ai |
ocr.use_model_bubble_filter | Enable Model Bubble Filter | 启用模型气泡过滤 | #model-bubble-filter |
ocr.min_text_length | Minimum Text Length | 最小文本长度 | #ocr-min-text-length |
ocr.ignore_bubble | Ignore Non-Bubble Text | 忽略非气泡文本 | #ocr-ignore-bubble |
ocr.merge_special_require_full_wrap | Require Full Wrap In Special Pre-Merge | 模型辅助合并 | #special-pre-merge |
ocr.model_bubble_overlap_threshold | Model Bubble Overlap Threshold | 模型气泡重叠阈值 | #model-bubble-filter |
filter_text_enabled | Enable Filter List | 启用过滤列表 | #filter-text-enabled |
ocr.prob | Text Region Min Probability | 文本区域最低概率 (prob) | #ocr-prob |
ocr.merge_gamma | Merge Distance Tolerance | 合并-距离容忍度 | #merge-tolerances |
ocr.merge_sigma | Merge Outlier Tolerance | 合并-离群容忍度 | #merge-tolerances |
ocr.merge_edge_ratio_threshold | Merge Edge Ratio Threshold | 合并-边缘距离比例阈值 | #merge-edge-ratio |
检测
本页签 13 个参数的说明见检测。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
detector.detector | Text Detector | 文本检测器 | #detector-detector-parameter |
detector.import_yolo_labels | Import Fixed YOLO Boxes | 导入固定YOLO框 | #detector-import-yolo-labels |
detector.use_yolo_obb | Enable YOLO Detection | 启用YOLO辅助检测 | #detector-use-yolo-obb |
detector.use_sfx_filter | SFX Filter | 拟声词过滤 | #detector-use-sfx-filter |
detector.sfx_filter_include_bubble_text | Include Bubble Text in SFX Filter | 气泡文本参与拟声词过滤 | #detector-sfx-filter-include-bubble-text |
detector.min_box_area_ratio | Min Box Area Ratio | 最小检测框面积占比 | #detector-min-box-area-ratio |
detector.detection_size | Detection Size | 检测大小 | #detector-detection-size |
detector.det_rearrange_min_effective_short_side | Long Image Rearrange Min Short Side | 长图重排最低有效短边 | #detector-rearrange-short-side |
detector.text_threshold | Text Threshold | 文本阈值 | #detector-text-threshold |
detector.box_threshold | Box Generation Threshold | 边界框生成阈值 | #detector-box-threshold |
detector.unclip_ratio | Unclip Ratio | Unclip比例 | #detector-unclip-ratio |
detector.yolo_obb_conf | YOLO Confidence Threshold | YOLO置信度阈值 | #detector-yolo-obb-conf |
detector.yolo_obb_overlap_threshold | YOLO Overlap Removal Threshold | YOLO辅助检测重叠率删除阈值 | #detector-yolo-obb-overlap-threshold |
翻译
本页签 11 个参数的说明见翻译设置。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
translator.translator | Translator | 翻译器 | #translator-translator |
translator.target_lang | Target Language | 目标语言 | #translator-target-lang |
translator.keep_lang | Keep Source Language | 保留源语言 | #translator-keep-lang |
translator.enable_streaming | Enable Streaming | 启用流式传输 | #translator-enable-streaming |
translator.no_text_lang_skip | Don't Skip Target Lang | 不跳过目标语言文本 | #translator-no-text-lang-skip |
translator.extract_glossary | Auto Extract Glossary | 自动提取新术语 | #translator-extract-glossary |
translator.max_requests_per_minute | Max Requests Per Minute | 每分钟最大请求数 | #translator-max-requests-per-minute |
translator.remove_trailing_period | Auto Remove Final Period/Comma | 自动移除末尾句号逗号 | #translator-remove-trailing-period |
cli.context_size | Context Pages | 上下文页数 | #cli-context-size |
translator.convert_to_traditional | Convert to Traditional Chinese | 简体转繁体 | #translator-chinese-conversion |
translator.convert_to_simplified | Convert to Simplified Chinese | 繁体转简体 | #translator-chinese-conversion |
修复
本页签 10 个参数的说明见蒙版与图像修复。其中 inpainter.inpainter、inpainter.solid_fill_pure_bubbles、inpainter.per_block_inpainting 在该页没有独立显式锚点，跳转到页面本身。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
inpainter.inpainter | Inpainting Model | 修复模型 | 页面 |
mask_dilation_offset | Mask Dilation Offset | 遮罩扩张偏移 | #dilation-and-kernel |
ocr.limit_mask_dilation_to_bubble_mask | Keep Dilation Inside Bubble Mask | 膨胀不超过气泡蒙版 | #bubble-range |
ocr.use_model_bubble_repair_intersection | Expand Bubble Repair Range | 扩大气泡修复范围 | #bubble-range |
inpainter.solid_fill_pure_bubbles | Solid Fill Pure Bubbles | 纯色气泡直接填色 | 页面 |
inpainter.per_block_inpainting | Per-Block Inpainting | 逐块修复 | 页面 |
inpainter.inpainting_size | Inpainting Size | 修复大小 | #size-and-precision |
inpainter.inpainting_precision | Inpainting Precision | 修复精度 | #size-and-precision |
kernel_size | Kernel Size | 卷积核大小 | #dilation-and-kernel |
inpainter.force_use_torch_inpainting | Force Use PyTorch Inpainting | 强制使用PyTorch修复 | #force-torch |
排版
本页签 29 个参数的说明见排版与渲染。该页参数小节没有独立显式锚点，全部跳转到页面本身。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
render.renderer | Renderer | 渲染器 | 页面 |
render.font_family | Font | 字体 | 页面 |
render.disable_system_fonts | Disable System Fonts | 禁止使用系统字体库 | 页面 |
render.ai_renderer_prompt_path | AI Renderer Prompt | AI 渲染提示词 | 页面 |
render.ai_renderer_concurrency | AI Renderer Concurrency | AI 渲染并发数 | 页面 |
render.alignment | Alignment | 对齐方式 | 页面 |
render.semantic_linebreak | Chinese Semantic Line Break | 中文语义断句 | 页面 |
render.remove_linebreak_punctuation | Trim Around Line Breaks | 去除换行符周围逗号句号 | 页面 |
render.disable_auto_wrap | AI Line Breaking | AI断句 | 页面 |
render.optimize_line_breaks | AI Line Break Auto Enlarge | AI断句自动扩大文字 | 页面 |
render.strict_smart_scaling | Don't Expand Box on Auto Enlarge | AI断句自动扩大文字下不扩大文本框 | 页面 |
render.check_br_and_retry | AI Line Break Check | AI断句检查 | 页面 |
render.stroke_width | Stroke Width Ratio | 描边宽度比例 | 页面 |
render.disable_font_border | Disable Font Border | 禁用字体边框 | 页面 |
render.center_text_in_bubble | Center in Bubble | 气泡内居中 | 页面 |
render.font_size_offset | Font Size Offset | 字体大小偏移量 | 页面 |
render.font_size_minimum | Minimum Font Size | 最小字体大小 | 页面 |
render.direction | Text Direction | 文本方向 | 页面 |
render.uppercase | Uppercase | 大写 | 页面 |
render.lowercase | Lowercase | 小写 | 页面 |
render.no_hyphenation | Disable Hyphenation | 禁用连字符 | 页面 |
render.bubble_layout_english | Bubble Layout (Force Horizontal) | 根据气泡排版(强制横排) | 页面 |
render.line_spacing | Line Spacing | 行间距 | 页面 |
render.letter_spacing | Letter Spacing | 字间距 | 页面 |
render.font_size | Font Size | 字体大小 | 页面 |
render.rtl | Right to Left | 从右到左 | 页面 |
render.layout_mode | Layout Mode | 排版模式 | 页面 |
render.max_font_size | Maximum Font Size | 最大字体大小 | 页面 |
render.font_scale_ratio | Font Scale Ratio | 字体缩放比例 | 页面 |
模式相关
本页签 11 个参数分散在两个页面：直接粘贴与模板对齐参数见模式专用工作流与模板对齐，超分与上色参数见超分与上色。
| 存储值 | English 实际值 | 简体中文实际值 | 跳转 |
|---|---|---|---|
render.enable_template_alignment | Enable Direct Paste Mode | 启用直接粘贴模式 | #render-enable-template-alignment |
render.paste_mask_dilation_pixels | Paste Mode Mask Dilation Pixels | 粘贴模式蒙版膨胀大小 | #render-paste-mask-dilation-pixels |
upscale.upscaler | Upscaling Model | 超分模型 | #upscale-upscaler |
upscale.upscale_ratio | Upscale Ratio | 超分倍数 | #upscale-upscale-ratio |
upscale.tile_size | Tile Size (0=No Split) | 分块大小(0=不分割) | #upscale-tile-size |
upscale.revert_upscaling | Revert Upscaling | 还原超分 | #upscale-revert-upscaling |
colorizer.colorizer | Colorization Model | 上色模型 | #colorizer-colorizer |
colorizer.ai_colorizer_prompt_path | AI Colorizer Prompt | AI 上色提示词 | #colorizer-ai-colorizer-prompt-path |
colorizer.ai_colorizer_history_pages | AI Colorizer History Pages | AI 上色历史页数 | #colorizer-ai-colorizer-history-pages |
colorizer.colorization_size | Colorization Size | 上色大小 | #colorizer-colorization-size |
colorizer.denoise_sigma | Denoise Strength | 降噪强度 | #colorizer-denoise-sigma |
覆盖边界与反向链接
- 反向链接：本页是设置页专题文档的汇总跳转入口；参数详细说明仍以专题页为准。
- 兄弟参考页：完整枚举选项的 value/i18n 对照见界面选项对照表，九种工作流阶段矩阵见工作流矩阵，各页代码位置汇总见代码索引，调试产物见调试产物索引。
- 由其他控件写回、不作为设置参数行显示的值：
upscale.realcugan_model由超分模型下拉写回（见超分与上色）；八个工作流标志（cli.generate_and_export、cli.template、cli.translate_json_only、cli.load_text、cli.colorize_only、cli.upscale_only、cli.inpaint_only、cli.replace_translation）由翻译工作区的工作流下拉设置（见模式专用工作流与模板对齐）。编辑器偏好（editor_*，包括菜单写回的app.editor_rich_text_popup_pinned）属于AppSection，但不在通用页签显示为动态行。 - 运行时列表（字体、模型名、API 预设、提示词文件、批量方案）来自本机或用户配置，不进入本索引的固定清单。
开发指南
选项中英对照
UI 调用 key 与实际文案
本页出现的页签、标题和按钮均核对自 desktop_qt_ui/locales/en_US.json 与 zh_CN.json：
| UI 调用 key | English 实际值 | 简体中文实际值 |
|---|---|---|
Settings | Settings | 设置 |
Settings Page Title | Settings | 参数设置 |
Settings Page Subtitle | Adjust translation pipeline parameters. Changes are saved automatically. | 调整翻译流程的各项参数。修改后将自动保存。 |
General | General | 通用 |
OCR | OCR | 文字识别 |
Detection | Detection | 检测 |
Translation | Translation | 翻译 |
Inpainting | Inpainting | 修复 |
Typesetting | Typesetting | 排版 |
Mode Specific | Mode Specific | 模式相关 |
Advanced | Advanced | 高级 |
Export Config | Export Config | 导出配置 |
Import Config | Import Config | 导入配置 |
代码位置
| 层级 | 文件 | 本页核对内容 |
|---|---|---|
| 设置布局 | desktop_qt_ui/ui/main_page/settings_tab_layout.json | 七个页签、110 个条目、109 个可见参数、Advanced 分隔线 |
| 页面外壳 | desktop_qt_ui/ui/main_page/pages/settings_page.py | 页签标题 key、导入/导出、说明面板 |
| 动态控件 | desktop_qt_ui/ui/main_page/dynamic_settings.py | 控件类型、文件编辑动作、跳过的字段 |
| UI/i18n | desktop_qt_ui/app_logic.py、desktop_qt_ui/locales/en_US.json、zh_CN.json | label 映射与实际中英文显示值 |
| 配置模型 | desktop_qt_ui/core/config_models.py、manga_translator/config.py | Qt/核心参数定义与默认 |
| 生成数据 | doc/wiki/data/settings.generated.json、doc/wiki/data/i18n.generated.json | 109 条参数记录、1353 个 i18n 条目 |
| 调查资料 | doc/wiki/research/phase0-options-i18n-matrix.md、phase0-page-coverage-matrix.md | 选项矩阵和覆盖矩阵 |
| 设置专题页 | doc/wiki/zh/desktop/settings/*.md | 参数锚点与跳转目标逐项核对 |