IceFold 文档
使用指南

提示词模板

任何检查器中显示富文本提示词模板编辑器的步骤——包括生成文本和由自定义节点构建的步骤——都支持相同语法。输入 @name,引擎会根据步骤正在运行的内容版本替换为相应的值。终端步骤上的普通导出文件名字段也接受同样的标记语法,具体行为见下文。

规则

@name 解析为标签——即查看者期望的人类可读字符串。

You are translating the document below into @Language.

Document:
@text

有两种类型的名称,在编辑器中以颜色区分:

  • 输入槽(绿色)—— @text@image,任何从上游步骤连线传入的内容。呈现为此内容版本的上游步骤输出。
  • 版本组(青色)—— @Language@Platform@Length……对应您在空间中声明的每个版本组。呈现为值的人类标签(中文TikTok)。

新增版本组时,其完整名称会直接成为标记:Platform 生成 @PlatformContent 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 使用标签。