helloGPT INI文件指南

helloGPT 的 INI 配置文件是一份简单又强大的文本设置，决定模型选型、温度、最大长度、源/目标语言、术语表与校对流水线等关键行为；掌握节（[section]）与键=值格式，设置好 pipeline（如 translate→post_edit→human_qc）和品牌风格（glossary、style_guide），能让出海翻译既快速又可控，兼顾效率与质量。

先说明一件事：为什么要用 INI 来配置 helloGPT？

想象你有一台万用工具机，里面有很多小旋钮：有的控制回答风格，有的控制生成长度，还有的控制是否要人工校对。把这些旋钮放到一个 INI 文件里，就像给工具机一个说明书：简单、可版本化、容易被项目组共享与复用。

用费曼法解释 INI 文件是什么

简单来说，INI 就是“节（section）”+“键=值（key=value）”的文本文件。每个节像一个抽屉，抽屉里放相关的设置。举个比方：把模型相关的设置放一抽屉，把翻译流程放一抽屉，把日志和安全设置放一抽屉。要改哪部分，打开对应的抽屉就行。

基本结构与常见字段（一看就会）

• [model]：指定使用的模型、温度（temperature）、最大 token（max_tokens）等。
• [translation]：源语言（source_lang）、目标语言（target_lang）、术语表路径（glossary）、品牌语气（brand_tone）。
• [pipeline]：定义任务流水线，比如 translate、post_edit、human_qc、formatting。
• [post_edit]：人工校对规则、自动 QA 检查项、忽略词汇等。
• [logging]：日志级别、存储路径、审计追踪开关。
• [safety]：敏感词过滤、屏蔽策略、地域合规选项。

常见字段示例与含义（快速对照）

字段	作用
model.name	指定模型（如 gpt-4o、gpt-4o-mini），影响成本与质量
model.temperature	生成随机性，0-1 范围，越低越稳定
translation.source_lang / target_lang	ISO 语言码，例如 en、zh、fr、ja
pipeline	流水线步骤顺序，用逗号分隔，如 translate,post_edit,human_qc
post_edit.level	人工校对强度：light / standard / strict
glossary.path	术语表文件位置（CSV/TSV）

语言与本地化专用设置（针对出海翻译）

出海翻译不是简单的字对字替换，常见要点包括文化偏好、计量单位、本地法规、品牌口吻等。INI 可以明确规定这些规则，从而让机器翻译产出更“上道”。

常用条目（取针出海翻译的实践建议）

• brand_tone=friendly|formal|playful：用来规范品牌口吻，尤其对 Slogan、品牌故事很关键。
• product_terms_file=path/to/glossary.csv：列出必须保留或指定译法的产品术语。
• date_format=YYYY-MM-DD 或 DD/MM/YYYY：统一显示格式。
• currency_map=CNY:USD:6.5 等：是否自动换算价格（仅建议提示，不自动改动详情）。

把 AI 和人工结合起来：配置 pipeline 的诀窍

理想的流程通常是：机器初译 → 自动 QA → 人工初校 → 品牌复核 → 发布（可选回滚）。把这些步骤写进 INI，可以保证每次执行的一致性。

示例 pipeline（现实可用）

• translate（机器翻译）
• auto_qa（自动检查拼写、数字一致性、术语使用）
• post_edit（人工校对，依据 post_edit.level）
• brand_review（品牌专员终审）
• publish（推向站点或电商平台）

示例 INI 文件（针对取针出海翻译项目）

下面是一个真实感较强的示例，复制到项目里稍作修改即可用。

[model]
name = gpt-4o-mini
temperature = 0.2
max_tokens = 1200
[translation]
source_lang = zh
target_lang = en
glossary.path = ./glossary/product_terms.csv
brand_tone = friendly
date_format = MM/DD/YYYY
[pipeline]
steps = translate,auto_qa,post_edit,brand_review,publish
[post_edit]
level = standard
allow_transcreation = true
human_qc = true
[logging]
level = INFO
path = ./logs/translation.log
[safety]
sensitive_filter = true
region = EU

INI 与术语表配合：如何保证品牌一致性

术语表应至少包含：原词、目标词、上下文说明、优先级（required/preferred/forbidden）。在 INI 中指向术语表，翻译引擎会把这些条目作为高优先级规则。对品牌口号与 Slogan，设置 allow_transcreation=false（只进行受控的意译）或提供多套候选译法供人工选择，会更稳妥。

质量控制与自动 QA：几项你必须启用的检查

• 数字一致性检查：数量、日期、规格不能被机器误改。
• 术语覆盖率：统计术语表条目是否被正确命中。
• 风格检查：长度限制（如电商详情页标题不超过 N 字），口吻对齐。
• 敏感词检测：所在市场的合规屏蔽词。

常见问题与排查（像朋友告诉你的小技巧）

• 模型输出太自由：把 temperature 降到 0.0-0.3，或设置更严格的 post_edit.level。
• 术语未生效：确认 glossary.path 指向的文件编码为 UTF-8，并且列头与引擎约定一致（source,target,note）。
• 字符集或换行出错：检查文件是否含有隐形 BOM，确保 CRLF/LF 统一。
• 多语言页面排版混乱：在 INI 中加入 formatting.step 指令，指定 HTML 转义与保留标签。

版本控制与可追溯性（别把配置当秘密）

把 INI 文件放到代码仓库（例如 git）并搭配配置说明文档，可以做到：回溯某次发布为什么改了翻译风格、谁改了术语表、哪个模型造成了差异。务必在 INI 中加入 version 字段与 changelog 注释。

小表格：常见语言与建议设置（便于复制粘贴）

语言	ISO	建议 temperature	post_edit.level
英语	en	0.2	standard
法语	fr	0.25	standard
日语	ja	0.15	strict
阿拉伯语	ar	0.2	strict

部署与运维建议（别只写好看就算了）

• 把 INI 当配置，而非代码；程序读取后应有默认值覆盖，防止空值引发崩溃。
• 为重要字段开启监控报警，如 post_edit.human_qc 为 false 时报警（避免误发布）。
• 采用灰度发布：先对 5% 内容用新配置跑流水线，确认无异常再全量推广。

把配置变得更“人性化”的小技巧

在 INI 加注释（以 ; 或 # 开头）写上业务场景说明，例如为什么把 temperature 设为 0.2：因为我们优先稳定而非创意。这些小备注会在两个月后救你的未来自己。还有，建一个 templates 目录，放不同业务线（品牌文案、产品手册、电商详情页）的 INI 模板，方便团队直接套用。

最后，关于取针出海翻译的落地实践建议（碎碎念式）

把以上配置和流程和你的翻译团队、产品经理、品牌同学一起过一遍，别只寄望机器。机器擅长速度和一致性，人擅长语境与品牌判断。把两者通过 INI 设计好接口：机器先跑、自动 QA 过滤明显错误、人工重点处理品牌关键区域（Slogan、主视觉文案、合规要求）。这样既节省成本又能把控质量——说到这儿，先去改一条 glossary 吧（真的，马上改一个小样，你就会看到差别）。