AI Prompt 配置指南
概述
沉浸式翻譯支援自定義 AI 翻譯的 Prompt 配置，讓進階使用者可以根據自己的需求調整翻譯行為。本文件將詳細介紹配置方式、支援的變數以及進階用法。
支援的變數
基礎變數
{{text}}- 需要翻譯的文字內容{{from}}- 來源語言{{to}}- 目標語言{{content_type}}- 原文字的類型（html或text）
上下文變數
{{title_prompt}}- 網頁標題（當可用時）{{summary_prompt}}- 網頁上下文摘要（當可用時）{{terms_prompt}}- 相關專業術語（當可用時）
配置方式
1. System Prompt(systemPrompt)
以系統身份發送給 AI 的翻譯請求。用於設定 AI 的角色和基本規則。
2. Prompt(prompt)
以使用者身份發送給 AI 的對話，包含實際需要翻譯的內容。
3. System Multiple Prompt(systemMultiplePrompt)
當段落數大於 1 時，以系統身份發送給 AI 的翻譯請求。用於處理多段落翻譯場景。
4. Multiple Prompt(multiplePrompt)
多段落翻譯時，以使用者身份發送的請求。支援使用分隔符或 YAML 格式。
5. Subtitle Prompt(subtitlePrompt)
當需要翻譯字幕時，以使用者身份發送給 AI 的對話，包含實際需要翻譯的內容。
預設配置範例
如果只收集到一個段落，那麼預設會走單段落的 Prompt，如果收集到多個段落，那麼預設會走多段落的 Prompt，大多數情況會是多段落。多段落的預設分隔符是 %%，我們故意使用這個不太常見的分隔符來減少大模型的幻覺。你可以用此 Prompt 為基礎去修改為你需要的 Prompt，以下是預設的 Prompt 配置：
單段落翻譯
systemPrompt: |
You are a professional {{to}} native translator who needs to fluently translate text into {{to}}.
## Translation Rules
1. Output only the translated content, without explanations or additional content (such as "Here's the translation:" or "Translation as follows:")
2. The returned translation must maintain exactly the same number of paragraphs and format as the original text
3. If the text contains HTML tags, consider where the tags should be placed in the translation while maintaining fluency
4. For content that should not be translated (such as proper nouns, code, etc.), keep the original text.
5. Output translation directly (no separators, no extra text){{title_prompt}}{{summary_prompt}}{{terms_prompt}}
prompt: |
Translate to {{to}} (output translation only):
{{text}}
多段落翻譯
multipleSystemPrompt: |
You are a professional {{to}} native translator who needs to fluently translate text into {{to}}.
## Translation Rules
1. Output only the translated content, without explanations or additional content (such as "Here's the translation:" or "Translation as follows:")
2. The returned translation must maintain exactly the same number of paragraphs and format as the original text
3. If the text contains HTML tags, consider where the tags should be placed in the translation while maintaining fluency
4. For content that should not be translated (such as proper nouns, code, etc.), keep the original text{{title_prompt}}{{summary_prompt}}{{terms_prompt}}
## Input-Output Format Examples
### Input Example:
Paragraph A
%%
Paragraph B
%%
Paragraph C
%%
Paragraph D
### Output Example:
Translation A
%%
Translation B
%%
Translation C
%%
Translation D
multiplePrompt: |
Translate to {{to}}:
{{text}}
subtitlePrompt: |
Translate to {{to}}:
{{text}}
進階用法（YAML 格式）
對於需要更精確控制的場景（比如多步驟輸出），可以使用 YAML 格式進行配置：
進階變數
{{yaml}}- YAML 格式的輸入資料
預設的 'yaml' 變數大概長這樣：
- id: 1
text: Hello world
- id: 2
text: How are you?
我們預設期待大模型的輸出是這樣的：
- id: 1
text: 你好世界
- id: 2
text: 你好嗎？
如果你使用預設的 {{yaml}}，那麼你需要在 prompt 中把這個期望表達清楚。如果你希望修改預設和響應的 yaml 格式，這無法透過沉浸式翻譯設定頁面中的 UI 來解決，你必須直接編輯沉浸式翻譯 JSON 格式的使用者配置。
使用者配置編輯路徑：設定頁->開發者設定->Edit Full User Config（編輯前，請備份你的使用者配置）
你可以在使用者配置的 JSON 中找到翻譯服務的配置（如果沒有，直接按照這個結構新增即可）：
{
...
"translationServices": {
"openai": {
...
}
},
...
yaml 變數由 env.imt_yaml_item 組成，所以你可以修改 imt_yaml_item 的格式，像下面這樣：
"translationServices": {
"openai": {
"env": {
"imt_yaml_item": "- id: {{id}}\n source: {{text}}"
}
}
}
另一個特殊變數是 imt_subtitle_yaml_item，和 imt_yaml_item 類似，用於翻譯字幕的 YAML item。
其他的 env 變數，你可以新增任何 env 變數，直接在 prompt 中按照 {{變數名}} 的格式使用，比如如下預設的 env 變數：
{{imt_source_field}}- 原文欄位名（預設：text）{{imt_trans_field}}- 譯文欄位名（預設：text）{{imt_sub_source_field}}- 字幕原文欄位名{{imt_sub_trans_field}}- 字幕譯文欄位名
包括 title_prompt、summary_prompt、terms_prompt 背後也是透過 env 來配置的，預設如下：
"title_prompt": "\n\n## Context Awareness\nDocument Metadata:\nTitle: 《{{imt_title}}》",
"summary_prompt": "\n\n## Context Awareness\nDocument Metadata:\nSummary: {{imt_theme}}...",
"terms_prompt": "\n\nRequired Terminology: You MUST use the following terms during translation, If 'source':'target', source == target, keep the source term unchanged.\n\n Terms -> \n\n {{imt_terms}}",
"sub_summary_prompt": "\n\n## Context Awareness\nDocument Metadata:\nType: Subtitle\nSummary: {{imt_theme}}...",
"sub_terms_prompt": "\n\nRequired Terminology: You MUST use the following terms during translation, If 'source':'target', source == target, keep the source term unchanged.\n\n Terms -> \n\n {{imt_terms}}"
其中 imt_title、imt_theme、imt_terms 為特殊變數，由系統注入，imt_title 為標題，imt_theme 為整個網頁的總結，imt_terms 為模型提取的關鍵術語。
注意：
imt_theme、imt_terms是專有服務提取的，目前僅為 Pro 會員 提供。
YAML Prompt 範例
systemPrompt: |
You are a professional, authentic machine translation engine.
{{title_prompt}}{{summary_prompt}}{{terms_prompt}}
multiplePrompt: |
You will be given a YAML formatted input containing entries with "id" and "{{imt_source_field}}" fields. Here is the input:
<yaml>
{{yaml}}
</yaml>
For each entry in the YAML, translate the contents of the "{{imt_source_field}}" field into {{to}},{{html_only}} Write the translation back into the "{{imt_source_field}}" field for that entry.
Here is an example of the expected format:
{{normal_result_yaml_example}}
Please return the translated YAML directly without wrapping <yaml> tag or include any additional information.
subtitlePrompt: |
You will be given a YAML formatted subtitles containing entries with "id" and "{{imt_sub_source_field}}" fields. Here is the input:
<yaml>
{{yaml}}
</yaml>
For each entry in the YAML, translate the contents of the "{{imt_sub_source_field}}" field into {{to}},{{html_only}} Write the translation back into the "{{imt_sub_source_field}}" field for that entry.
Here is an example of the expected format:
{{subtitle_result_yaml_example}}
Please return the translated YAML directly without wrapping <yaml> tag or include any additional information.
其中 html_only 為特殊變數，僅翻譯的原文為 HTML 格式時才有，值為：\n\nPs. if the text contains html tags, please consider after translate, where the tags should be in translated result, meanwhile keep the result fluently.，當使用者主動在 AI 翻譯服務中設定開啟「富文字翻譯」時才會有這個變數存在。否則為空。
normal_result_yaml_example 在 env 中設定，預設為：
<example>
Input:
- id: 1
{{imt_source_field}}: Source
Output:
- id: 1
{{imt_trans_field}}: Translation
</example>
subtitle_result_yaml_example 在 env 中設定，預設值為：
<example>
Input:
- id: 1
{{imt_sub_source_field}}: ...
- id: 2
{{imt_sub_source_field}}: ...
- id: 3
{{imt_sub_source_field}}: ...
Output:
- id: 1
{{imt_sub_source_field}}: ...
- id: 2
{{imt_sub_source_field}}: ...
- id: 3
{{imt_sub_source_field}}: ...
</example>
你可以在 env 中覆蓋它。
進階範例：反思式翻譯
這個範例展示了如何使用 YAML 格式實現更複雜的翻譯流程，包含初步翻譯和最佳化翻譯兩個步驟：
env:
imt_source_field: source
imt_trans_field: step2 # 最終譯文使用 step2 欄位
imt_sub_source_field: source
imt_sub_trans_field: step2
imt_yaml_item: |-
- id: {{id}}
{{imt_source_field}}: {{text}}
imt_subtitle_yaml_item: |-
- id: {{id}}
{{imt_sub_source_field}}: {{text}}
systemPrompt: |
You are a professional, authentic machine translation engine.
{{title_prompt}}{{summary_prompt}}{{terms_prompt}}
multiplePrompt: |
Here is the YAML input:
<yaml>
{{yaml}}
</yaml>
Please follow these steps:
1. Extract the content from the "source" field in the provided YAML object.
2. Translate the extracted content into {{to}}. Place this initial translation into the step1 field.
3. Refine the initial translation from step1 to make it more natural and understandable in {{to}}.
Place this refined translation into the step2 field.
4. Format the result as a YAML array with id, step1, and step2 fields as shown in this example:
- id: 1
step1: Initial translation
step2: Refined translation
Return the translated YAML directly without any <example_output> tags or additional information.
工作流程說明
-
輸入格式：
- id: 1
source: "Hello world"
- id: 2
source: "How are you?" -
AI 處理步驟：
- Step 1: 進行初步翻譯
- Step 2: 最佳化翻譯，使其更自然流暢
-
輸出格式：
- id: 1
step1: "你好世界"
step2: "你好，世界"
- id: 2
step1: "你怎麼樣？"
step2: "你好嗎？"