CLIFF Localization Suiteمستندات

设置参考

全部设置位于 UCliffLocalizationSuiteSettings（类 Config = Editor, defaultconfig），面板路径 编辑 > 项目设置 > 插件 > CLIFF Localization Suite，配置节 [/Script/CliffLocalizationSuite.CliffLocalizationSuiteSettings]，默认写入 Config/DefaultEditor.ini。

Identity

字段类型默认值说明
CLIFF Namespace
CliffNamespace		FStringp-cliff-l10n-suite导出时写入 CLIFF header 的 namespace，必须为小写 kebab-case。规范 ID 的第一段

NOTE

项目设置里的 Clan to Namespace 等映射表会与内置默认表合并（同键覆盖）。空表 = 只用默认表。

Semantic Mapping

字段类型默认值说明
Clan to Namespace
ClanToNamespace		TMap<FString, FString>见下表CLIFF clan → UE Namespace；导出时反向查找 clan
Namespace to Type
NamespaceToType		TMap<FString, FString>见下表UE Namespace → CLIFF type
Namespace to Emotion
NamespaceToEmotion		TMap<FString, FString>Dialogue → neutralUE Namespace → CLIFF emotion

内置默认值：

ClanToNamespace     : category → UObjectCategory
                      tooltip → UObjectToolTips
                      short-tooltip → UObjectShortTooltips
                      display-name → UObjectDisplayNames
                      proper-noun → UObjectDisplayNames
                      dialogue → Dialogue

NamespaceToType     : UObjectCategory → label
                      UObjectToolTips → prompt
                      UObjectShortTooltips → prompt
                      UObjectDisplayNames → proper-noun
                      Dialogue → dialogue

NamespaceToEmotion  : Dialogue → neutral

解析规则与降级口径见 语义映射。

Workflow

字段类型默认值说明
Default Import Directory
DefaultImportDirectory		FString空导入目录对话框的默认目录；留空时用 Target 的本地化数据目录（TargetSet 场景为 <ProjectContent>/Localization）
Default Export Directory
DefaultExportDirectory		FString空导出目录对话框的默认目录；留空同上

AI Translation

字段类型默认值说明
DeepSeek API Key
DeepSeekApiKey		FString（密码框）空留空时读取环境变量 DEEPSEEK_API_KEY；明文写入 DefaultEditor.ini
DeepSeek Base URL
DeepSeekBaseUrl		FStringhttps://api.deepseek.comAPI 基础地址；带 /v1 也能正确拼接
DeepSeek Model
DeepSeekModel		FStringdeepseek-flash模型名
Thinking Level
ThinkingLevel		ECliffDeepSeekThinkingLevelOff（关闭）Off / Low / High / Max；Off 时使用 temperature=1.3
Request Timeout
RequestTimeoutSeconds		float60.0单请求超时（秒），最小 1
Max Retries
MaxRetries		int323单批重试次数，同时决定「缺失目标重跑轮数」上限，最小 0
Batch Size
BatchSize		int3220每批条目数，最小 1
Max Concurrent Cultures
MaxConcurrentCultures		int324并发批次数上限，最小 1
Translation Standard
TranslationStandard		FString（多行）空写入 CLIFF header standard，并追加到 System Prompt
System Prompt
SystemPrompt		FString（多行）空留空使用内置默认提示词；填写则完全替换
Auto Repair CLIFF
bAutoRepairCliff		booltrueAI 产出的 CLIFF 校验失败时自动修复
Max Repair Attempts
MaxRepairAttempts		int322单文件最大修复轮数，最小 0
Include Context
bIncludeContext		booltrue是否把 SourceLocation / context 发给模型
Retranslate Self Translations
bRetranslateSelfTranslations		booltrue重译「自翻译」条目；reviewed / final 永不触碰

思考强度枚举

取值显示名请求行为
Off关闭thinking.type = disabled + temperature = 1.3
Low低thinking.type = enabled + reasoning_effort = low
High高thinking.type = enabled + reasoning_effort = high
Max最高thinking.type = enabled + reasoning_effort = max

只读 API

成员返回说明
GetSemanticMapping()FCliffSemanticMapping内置默认表 + 项目设置合并后的生效映射
ResolveApiKey()FString环境变量 DEEPSEEK_API_KEY 优先，否则返回设置字段
GetDefaultSystemPrompt()FString（static）内置默认 System Prompt
BuildSystemPrompt()FStringSystemPrompt（空则默认）+ \n\n=== Translation Standard ===\n + TranslationStandard

配置示例

; Config/DefaultEditor.ini
[/Script/CliffLocalizationSuite.CliffLocalizationSuiteSettings]
CliffNamespace=my-game
+ClanToNamespace=(("ui", "MyGameUI"))
+NamespaceToType=(("MyGameUI", "label"))
DefaultImportDirectory=G:/Translations/cliff
DeepSeekModel=deepseek-flash
ThinkingLevel=Off
BatchSize=20
TranslationStandard=游戏 UI 使用简体中文，保留英文专有名词与品牌名。

WARNING

不要把真实 API Key 写进提交到仓库的 ini。请使用环境变量 DEEPSEEK_API_KEY，或在提交前清空该字段。

相关阅读