IceFold 說明文件
操作指南

提示範本

只要步驟的檢查器裡有 Prompt template(提示範本)編輯器——包括 Generate Text,以及用自訂節點建立的步驟——都支援同一套語法。輸入 @name,引擎就會依步驟正在處理的內容版本,代入對應的值。末端步驟上的一般匯出檔名欄位也支援同樣的標記,但有下文所述的檔名專屬規則。

規則

@name 會解析成標籤——也就是讀者預期看到、人看得懂的文字。

You are translating the document below into @Language.

Document:
@text

編輯器中以顏色區分兩種名稱:

  • 輸入插槽(綠色)—— @text、@image,也就是任何從上游步驟連線進來的內容。代入此內容版本中上游步驟的輸出。
  • 版本群組(青色)—— @Language、@Platform、@Length……您在空間中宣告的每個版本群組各對應一個。代入該值的可讀標籤(中文、TikTok)。

新增版本群組時,其完整名稱會直接成為標記:Platform 產生 @Platform,Content Length 產生 @{Content Length},內容平台 產生 @{內容平台}。提示範本中的名稱區分大小寫;系統不允許重複的版本群組名稱,確保每個標記只對應一個群組。

無法辨識的名稱會顯示紅色虛線底線,並提供「您是不是要輸入…?」的建議。無法解析的名稱會原封不動留在最終提示詞中——IceFold 絕不會默默丟掉它們。

限定形式:@{name}

如果名稱後面緊接的文字可能被誤認成名稱的一部分,就用大括號把名稱括起來。兩種寫法的代入效果完全相同——大括號只是用來消除歧義。

report_@{Target Language}.v1.txt   →   report_中文.v1.txt

跳脫:@@

若要輸出一般的 @——例如內文中的 Hello @user——請把它連寫兩次:

Hello @@user   →   Hello @user

依此類推:@@@@ 會輸出 @@。另外,緊接在字母或數字後的 @ 本來就會被忽略,所以 [email protected] 不用跳脫也會原樣保留。

編輯器輔助功能

提示範本欄位不只是一個文字框。輸入時:

  • 編輯器上方的標記工具列依來源分組,列出這個步驟能用的所有佔位符,點一下即可插入。未連線的輸入插槽會顯示為灰色。
  • 輸入 @ 時會開啟自動完成;輸入 @{ 則切換成限定形式的建議。
  • 將滑鼠移到任一標記上,即可看到它的類型,以及在目前預覽的內容版本中會代入什麼值。
  • 編輯器下方的預覽面板與後端實際代入的結果完全一致:從下拉選單選一個內容版本,就能看到 LLM 實際會收到的完整提示詞。

語法摘要

寫法 輸出結果
@name 此內容版本中 name 的標籤
@{name} 同上,但明確界定邊界
@@ 一般的 @
[email protected] 原樣保留——字母數字後的 @ 視為內文
@unknown 原樣輸出 @unknown,在編輯器中以紅色標示

在匯出檔名中,只有版本群組標記會被代入,而且用的是值 ID:@Language 會變成 zh,而不是可讀標籤 中文,讓匯出檔名保持穩定。在提示範本欄位中,@Language 則使用標籤。