SillyTavern 脚本命令自查手册

使用指南

信息解释

命令的展示格式

数据类型

数据交互

用户输入

input

弹出一个包含所提供文本和输入框的弹出窗口。(别名: /prompt)

1

/input [default="string"] [large=on/off] [wide=on/off] [okButton="string"] [rows=number] [onSuccess=closure] [onCancel=closure] (text)

• default - 输入框默认已填写好的文本
• large - 增加弹出窗口的垂直尺寸
• wide - 增加弹出窗口的水平尺寸
• okButton - 自定义确认键的文本
• rows - 增加输入控件的大小，默认值：1
• onSuccess - 当点击确定按钮或输入成功关闭（通过回车等）时执行的闭包
• onCancel - 当点击取消按钮或关闭输入（通过 Esc 等）时执行的闭包
• text (string) - 输入框标题显示的文本

返回值：用户输入的文本

例：

1

/input default="默认的已有文本" okButton="YES!" 这里是标题

setinput

用提供的文本替换用户输入栏的内容。

1

/setinput (text)

• text (string) - 提供的文本

返回值：无

例：

1

/setinput 替换文本

弹出窗口

echo

显示文本到 Toast (轻量级弹窗提示) 信息中。

1

/echo [title=string] [severity=info/warning/error/success] [timeout=number] [extendedTimeout=number] [preventDuplicates=bool] [awaitDismissal=bool] [cssClass=string] [color=string] [escapeHtml=bool] [onclick=closure] (text) 

• title - 弹窗的标题
• severity - 提示的类型，影响弹窗外观，默认值：info
• timeout - 显示信息的时间（毫秒）。如果将此值和 extendedTimeout 设为 0，则信息将无限期显示，直至被取消。默认值：4000
• extendedTimeout- 显示信息的时间（毫秒）。将此值和 timeout 设为 0，就可以无限期显示直到被取消。默认值：10000
• preventDuplicates - 是否防止重复显示相同信息，默认值：false
• awaitDismissal - 是否等待弹窗结束后再继续，默认值：false
• cssClass - 另外增加 CSS 类添加到 toast 消息（例如：用于自定义样式）
• color - toast 信息的自定义 CSS 颜色。可接受所有有效的 CSS 颜色值（如 "红色"、" #FF0000 "、"rgb (255, 0, 0)"）。可使用 "cssClass "参数和自定义类进行更多自定义
• escapeHtml - 是否在 toast 信息中转义 HTML
• onclick - 当 toast 被点击时调用的闭包。这个已执行的闭包接收脚本中提供的作用域。在操作变量等时，请注意可能产生的副作用。
• text (string) - 弹窗的内容

返回值：text 的内容

例：

1

/echo title=警告 severity=warning 这是一个警告弹窗

popup

弹出一个带有指定文本和按钮的阻挡式弹出窗口。

1

/popup [large=bool] [wide=bool] [wider=bool] [transparent=bool] [okButton="string"] [cancelButton="string"] [result=bool] (text) 

• large - 增加弹出窗口的垂直尺寸，默认为 false
• wide - 增加弹出窗口的水平尺寸，默认为 false
• wider - 显示更宽的弹出窗口，默认为 false
• transparent - 显示透明弹出窗口，默认为 false
• okButton - 自定义确认键的文本，默认为 OK
• cancelButton - 自定义取消键的文本
• result - 如果启用，将返回弹出结果（整数）而不是弹出文本。确定按钮返回 1，取消按钮返回 0，退出按钮返回空字符串。
• text (string) - 弹出框显示的文本，支持简单的 HTML 格式，例如 /popup <font color=red>I'm red!</font>

返回值：text 的内容

例：

1

/popup okButton="OK~" 这是一个弹出框

button

用指定的文本和按钮标签显示一个阻塞弹出窗口。 

1

/buttons labels=["a","b"] (text)

• labels (list) - 必须是字符串的 JSON 序列化数组或包含此类数组的变量名。如果取消弹出，则将点击的按钮标签返回 pipe 或空字符串。
• text (string) - 提示文本，支持 HTML + CSS 格式。

返回值：点击的按键名

例：

1

/buttons labels=["Yes","No"] 继续?

传输控制

pass

通过管道将文本传递给下一条命令。 (别名: /return)

1

/pass (text)

• text (string/number/bool/list/dictionary/closure) - 传递的内容

返回值：传递的内容

abort

终止斜线命令批处理的执行。

1

/abort [quiet=bool] (text)

• quiet - 是否关闭终止时弹出的 Toast 窗口显示，默认值：true
• text (string) - 终止命令执行的原因。当 quiet=false 时显示

返回值：无

||

为防止上一条命令的输出作为未命名参数自动注入下一条命令，请在两条命令之间加双竖杠。

1

||

例：
如以下命令所示，当只有一条竖杠时，ABC 会自动传输到下一个命令，导致弹出两次 ABC 窗口。使用双竖杠后，参数不再传递，第二个 echo 命令无效

1
2
3
4
5
6
7

//弹出两次
/echo ABC |
/echo |

//弹出一次
/echo ABC ||
/echo |

变量

变量类型

• 局部变量--保存在当前聊天的元数据中，并且是唯一的。
• 全局变量--保存在 settings. json 中，适用于所有聊天。
• 数组和对象--变量值可包含 JSON 序列化数组或键值对（对象）。数组： ["apple","banana","orange"]，对象： {"fruits":["apple","banana","orange"]}。

设置变量

setvar

设置一个局部变量的值并将其传入 pipe。使用 index 时，如要将值转换为特定的 JSON 类型，请使用 as 参数。（别名：/setchatvar）

1

setvar [key=varname] [index=number/string] [as=string] (text) 或 {{setvar::varname::value}}

• key - 设置变量名
• index - 变量为数组或对象时使用，如果在一个不存在的变量上使用了 index，该变量将被创建为一个空数组 [] 或空对象 {}。
  • 若为 number，则设置为数组，从 0 开始计数。一次只能写入数组中的一个值，未指定的值显示空值"null"。
  • 若为 string，则设置为对象，string 为键的名称。
• as - 与 index 一起使用时，可更改值的类型。
• text (string/number/bool/list/dictionary) - 变量的内容

返回值：设置的变量的值

例：
获取变量 测试 的结果为 [null,null,null,null,null,"five"]

1

/setvar key=测试 index=5 five

下方命令的运行结果为：{"John":21}

1

/setvar key=ages index=John as=number 21

setglobalvar

设置全局变量的值，具体设置同 setvar。

1

/setglobalvar [key=varname] [index=number/string] (text) 或 {{setglobalvar::name::value}}

获取变量

getvar

获取局部变量的值

1

/getvar [key=varname] [index=number/string] (text) 或 {{getvar::name}}

• key - 变量名
• index - 变量为数组或对象时使用
• text (varname) - 与 key 同样的效果，二选一

返回值：获取的变量的值

例：

1
2
3

/getvar height
/getvar key=height
/getvar index=3 costumes

getglobalvar

获取全局变量的值，具体设置同 getvar。

1

/getglobalvar [key=name] [index=number/string] (text) 或 {{getglobalvar::name}}

len

获取数组中的项目数。

1

/len (string/varname) 

• string/varname - getvar 获取变量，或手动输入字符串。若输入的是字符串，则返回的是字符串长度

返回值：值的长度

例：

1
2
3

/len {{getvar::array}} 
或
/len 这是字符串 

变量操作

• 在 /addvar , /incvar , /decvar 命令中首次使用之前未定义的变量时，其默认值为空字符串或 0。
• 如果命令参数接受一个变量名，而本地变量和全局变量的名称相同，则本地变量优先。
• 所有用于变量操作的斜线命令都会将结果值写入 pipe，供下一条命令使用。
• 对于宏，只有 "get"、"inc"和 "dec"类型的宏会返回值，"add"和 "set"类型的宏会用空字符串代替。
• 由于变量在脚本执行之间被保存而不被刷新，因此您可以在其他脚本中或通过宏引用该变量。想要确保该值被丢弃，请在脚本中添加 /flushvar 命令。

addvar

将增量添加到局部变量的值中。

1

/addvar [key=varname] (increment)

• key - 目标变量名
• increment (string/number) - 添加到变量中的增量

例：
如果增量和变量值都可以转换为数字，将执行加法或减法运算。执行以下命令后，test 为 18

1
2

/setvar key=test 8|
/addvar key=test 10|

其他情况将执行字符串连接运算。执行以下命令后，test 为 八10

1
2

/setvar key=test 八|
/addvar key=test 10|

对于数组型，可增加新值。执行以下命令后，test 为 ["5","10"]

1
2

/setvar key=test index=0 5|
/addvar key=test 10|

addglobalvar

将增量添加到全局变量的值中。设置同 addvar。

1

addglobalvar [key=name] (increment) 或 {{addglobalvar::name:increment}}

incvar

使局部变量的值递增 1。

1

/incvar (name) 

• name (varname) - 目标变量名

例：
数字型变量将执行加法运算，其他情况执行字符串连接运算。执行以下命令后，test 为 9

1
2

/setvar key=test 8|
/incvar test|

incglobalvar

使全局变量的值递增 1。具体设置同 incvar。

1

/incglobalvar (name) 

decvar

使局部变量的值递减 1。具体设置同 incvar。

1

/decvar (name) 

decglobalvar

使全局变量的值递减 1。具体设置同 incvar。

1

/decglobalvar (name) 

flushvar

删除本地变量的值。

1

/flushvar (name)

• name (varname) - 目标变量名

返回值：无

flushglobalvar

删除全局变量的值。具体设置同 flushvar。

1

/flushglobalvar (name)

listvar

列出已设置的所有变量。

1

/listvar

返回值：无

sort

按升序对列表或字典排序，并将结果通过 pipe 传递下去。

• 对于列表，返回按值排序的列表。
• 对于字典，返回排序后的键值有序列表。设置 keysort=false 表示键按相关值排序。
  
  ⎗

  ✓

  1	/sort [keysort=true|false] (value)

• keysort - 是按键排序还是按值排序；对列表无效。默认值：true
• value (string/number/list/dictionary) - 值的内容

返回值：已排序的列表或字典键

例：

1
2

/sort [5,3,4,1,2] | /echo
/sort keysort=false {"a": 1, "d": 3, "c": 2, "b": 5} | /echo

返回值：无

数学运算

• 以下所有操作都接受一系列数字或变量名，并将结果输出到管道中。
• 无效运算（如除以 0）以及产生 NaN 值或无穷大的运算都返回 0。
• 乘法、加法、最小值和最大值接受的参数数量不限，参数之间用空格隔开。
• 减法、除法、指数运算和模数运算接受用空格分隔的两个参数。
• 正弦、余弦、自然对数、平方根、绝对值和四舍五入接受一个参数。

add

执行数值集的加法运算。

1

/add (number/varname)...

• value (number/varname) - 待计算的数字或变量名称，输入其他类型（如字符串）会忽略不计

返回值：计算结果

例：计算结果为 52

1
2
3

/setvar key=i 5|
/setvar key=七 7|
/add 10 i 30 七

sub

仅执行两个值的减法运算。

1

/sub (value) (value)

• value (number/varname) - 待计算的数字或变量名称，输入其他类型（如字符串）或多于两个值的部分，都会忽略不计

返回值：计算结果

mul

执行数值集的乘法运算。其他内容与 /add 相同。

1

/mul (value)...

div

仅执行两个值的除法运算。其他内容与 /sub 相同。

1

/div (value) (value)

max

从数值集合中返回最大值。其他内容与 /add 相同。

1

/max (value)...

返回值：返回最大值，不返回其变量名

min

从数值集合中返回最小值。其他内容与 /max 相同。

1

/min (value)...

mod

仅对两个值进行模运算，取余数。其他内容与 /sub 相同。

1

/div (value) (value)

pow

仅对两个值进行乘方运算。其他内容与 /sub 相同。

1

/div (value) (value)

sin

执行单个数值的正弦运算。

1

/sin (value)

• number/varname - 待计算的数字或变量名称，输入其他类型（如字符串）或多于一个值的部分，都会忽略不计

返回值：计算结果

cos

执行单个数值的余弦运算。其他内容与 /sin 相同。

1

/cos (number/varname)

log

对单个数值进行自然对数运算。其他内容与 /sin 相同。

1

/log (number/varname)

abs

执行单个数值的绝对值运算。其他内容与 /sin 相同。

1

/abs (number/varname)

sqrt

执行数值的平方根运算。其他内容与 /sin 相同。

1

/sqrt (number/varname)

round

对数值进行四舍五入到最接近整数的运算。其他内容与 /sin 相同。

1

/round (number/varname)

rand

返回一个介于 from 和 to 之间的随机数，范围的起始值和结束值都属于该范围。返回值将包含小数部分。

1

/rand [from=number] [to=number] [round=round/ceil/floor]

• from - 起始值
• to - 结束值
• round - 取整数，ceil 向上舍入，floor 向下舍入，round 四舍五入。

返回值：随机值的结果

例：
返回 0 到 1 之间的随机数

1

/rand

返回 0 到 10 之间的随机数

1

/rand 10

返回 5 到 10 之间的随机数

1

/rand from=5 to=10

流程控制

条件判断

if-else

创建条件表达式，根据定义的规则分支执行。

1

/if [left=varname/string/number] [right=varname/string/number] [rule=gt/gte/lt/lte/eq/neq/not/in/nin] [else=closure/subcommand] (closure/subcommand)

• left - 第一个运算对象，此处暂称为 A，为字符串时需要放在引号中
• right - 第二个运算对象，此处暂称为 B，为字符串时需要放在引号中
• rule - 对运算对象进行的布尔运算规则
  1. eq (equals | 等于) => A = B
  2. neq (not equals | 不等于) => A != B
  3. lt (less than | 小于) => A < B
  4. gt (greater than | 大于) => A > B
  5. lte (less than or equals | 小于等于) => A <= B
  6. gte (greater than or equals | 大于等于) => A >= B
  7. not (逻辑非) => !A
  8. in （包括子串） => A 包括 B，不区分大小写
  9. nin （不包括子串） => A 不包括 B，大小写不敏感
• else - 布尔运算的结果为假时执行的子命令，需要使用引号包裹（闭包不需要）
• (closure/subcommand) - 布尔运算的结果为真时执行的子命令，需要使用引号包裹（闭包不需要）

返回值：子命令的执行结果

while

循环运行某些命令，直到满足特定条件。在循环的每一步中，它都会比较变量 left 和变量 right 的值，如果条件为真，则执行任何有效斜线命令，否则退出循环。可用的布尔运算、变量处理、字面值和子命令集与 /if 命令相同。

1

/while [left=varname/string/number] [right=varname/string/number] [rule=gt/gte/lt/lte/eq/neq/not/in/nin] [guard=off] (closure/subcommand)

• left - 第一个运算对象
• right - 第二个运算对象
• rule - 对运算对象进行的布尔运算规则
• guard - 限制循环次数。要禁用并允许无穷循环，可设置 guard=off（默认为 on，开启时次数限制为 100）
• (closure/subcommand) - 布尔运算的结果为真时执行的子命令，需要使用引号包裹（闭包不需要）

返回值：最后执行的命令的结果

例：将 i 的值每次加 1 直到 10，然后输出结果值 10

1
2
3

/setvar key=i 0 |
/while left=i right=10 rule=lt "/addvar key=i 1" |
/echo {{getvar::i}} 

其他

times

将子命令运行指定次数。

1

/times [guard=off] (number) (closure/subcommand)

• number - 重复次数
• closure/subcommand - 子命令，斜线命令需要放在引号中，闭包不需要
• {{timesIndex}} - 宏，显示当前迭代次数（以零为起始）
• guard - 限制迭代次数。要禁用并允许无穷循环，可设置 guard=off（默认为 on，开启时次数限制为 100）

返回值：最后一次执行的命令结果

例：以下命令的结果是 101。添加 guard=off 后 ( /times guard=off 105 "/addvar key=i 1")，结果为 106

1
2

/setvar key=i 1 | 
/times 105 "/addvar key=i 1"

以下命令依次显示 0~3

1

/times 4 "/echo {{timesIndex}}"

delay

将下一条命令延迟指定的毫秒数后再运行。（别名：/wait，/sleep）

1

/delay (time)

• time (number) - 延迟的世界，单位是毫秒

返回值：无

使用 LLM

生成文本

gen

使用提供的提示词生成文本，并通过管道将其传递给下一条命令。

1

/gen [lock=on/off] [name=string] [length=number] [as=system/name] (prompt)

• lock - 生成时是否阻止用户输入，默认为 off
• name - 指示模式的提示词内名称 (Chat Completion API 不支持此功能)
• length - 限制 API 响应的 token 长度
• as - 可以是 system (默认) 或 char 。定义最后提示行的格式。char 将使用角色名，system 将不使用角色名或使用中性角色名。（用于 Text Completion API）
• prompt - 发送给 LLM 的提示词

返回值：LLM 生成的文本

genraw

使用提供的提示词生成文本，并通过管道将文本传递给下一条命令，不会发送角色卡，世界书等提供的提示词之外的内容。

1

/genraw [lock=on/off] [instruct=on/off] [stop=list] [as=system/char] [system=string] [length=number] (prompt)

• lock - 生成时是否阻止用户输入，默认为 off
• instruct - 已启用指示模式的情况下，允许在输入提示词上使用指示格式。默认为 on (Chat Completion API 不支持此功能)
• stop - JSON 序列化的字符串数组。为本次生成添加自定义停止字符串 (如果 API 支持)
• as - 可以是 system (默认) 或 char 。定义最后提示行的格式。char 将使用角色名，system 将不使用角色名或使用中性角色名。（用于 Text Completion API）
• system - 提示词起始的系统提示
• length - 限制 API 响应的 token 长度
• prompt - 发送给 LLM 的提示词

返回值：LLM 生成的文本

例：

1
2

/genraw Write a funny message from Cthulhu about taking over the world. Use emojis. |
/popup <h3>Cthulhu says:</h3><div>{{pipe}}</div>

trigger

触发正常生成（相当于点击 "发送 "按钮）。如果在群组聊天中，则可以使用以 1 为起始的序号或角色名称触发对应角色的回复，否则会根据群组设置触发回复。

1

/trigger [await=bool]

• await - 后续命令是否等待触发后再继续，默认值：false

返回值：无

例：触发群组的成员列表中第一位角色的回复

1

/trigger 1

ask

向特定角色发送消息，即使此角色并非在当前聊天中，也会调取其角色卡与绑定世界书中的内容，以及当前聊天的历史记录一起发送至 LLM。所得到的回复显示在当前聊天内。

1

/ask [name=string] [return=pipe|object|toast-html|toast-text|console|none] (prompt)

• name - 角色名
• return - 提供返回值的方式，默认为 none
  • console：将返回值（对象）记录到控制台
  • none：无返回值
  • object：以对象（或数组）形式返回 pipe，供下一条命令使用
  • pipe：返回管道，执行下一条命令
  • toast-html：将返回值显示为吐司通知 - 可以显示 HTML
  • toast-text：将返回值显示为吐司通知 - 仅显示为文本
• prompt (string) - 提示词

返回值：如果在 return（返回） 参数中指定，则可返回发送信息的文本

continue

继续聊天中的最后一条信息，可选择附加提示。（别名：/cont）

1

/continue [await=bool] (prompt)

• await - 是否让下一条命令在继续生成结束后再执行，默认值：false
• prompt (string) - 提示词，附加在酒馆预设中的 实用提示词-继续推动 提示词的后面

返回值：无

impersonate

调用 AI 帮答，可选择附加提示。（别名：/imp）

1

/impersonate [await=bool] (prompt)

• await - 是否让下一条命令在 AI 帮答生成结束后再继续，默认值：false
• prompt (string) - 提示词，附加在酒馆预设中的 实用提示词-AI帮答提示词 提示词的后面

stop

停止任何正在运行的流式生成。（别名：/generate-stop）

1

/stop

返回值：true/false，说明生成是否正在运行并被停止

提示词注入

inject

1

/inject [id=string] [position=before/after/chat] [depth=number] [scan=bool] [role=system/user/assistant] [ephemeral=bool] [filter=closure] (prompt)

• id - 一个字符串或变量名，随后调用具有相同 ID 的 /inject 将覆盖之前的文本注入。
• position - 设置提示词注入的位置。默认值： after
  • after ：在 main prompt 之后
  • before : 在 main prompt 之前
  • chat: 在聊天记录中
• depth - 若 position 为 chat，能设置在聊天记录中的注入深度。0 表示在最后一条信息之后插入，1 表示在最后一条信息之前插入，等等。默认值：4。
• scan - 注入的内容是否触发世界书扫描，默认值：false。
• role - 若 position 为 chat，以何种 role 注入，默认值：system
• ephemeral - 生成后是否移除注入的提示词，默认值：false
• filter - 如果定义了过滤器，则只有在闭包返回 true 时才会执行注入操作
• prompt - 注入的提示词。空字符串将清空保存在 id 中的提示词

返回值：无

listinjects

在聊天界面的系统消息中显示脚本为当前聊天添加的所有提示词注入的列表。

1

/listinjects [format=popup|chat|none]

• format - 脚本注入的 JSON 对象, 默认在弹出窗口中显示注入信息。使用 format 参数更改输出格式

返回值：无

flushinjects

删除脚本为当前聊天添加的所有提示注入。

1

/flushinjects

返回值：无

作者注释

note

设置当前聊天的作者注释。

1

/note (text)

• text (string) - 要添加到作者注释的内容

返回值：无

note-frequency

设置作者注释的插入频率。（别名：/freq，/note-freq）

1

/note-frequency (frequency)

• frequency (number) - 0 = 禁用，1 = 始终触发，2 = 间隔一次用户输入触发，以此类推

返回值：无

note-depth

设置作者注释的插入深度。（别名：/depth）

1

/note-depth (depth)

• depth (number) - 插入深度，0 表示在最后一条信息之后插入，1 表示在最后一条信息之前插入，以此类推。使用此命令会自动将作者注释的插入位置切换到 chat 中

返回值：无

note-position

设置当前聊天的作者注释位置。（别名：/pos，/note-pos）

1

/note-position (position)

• position (chat/scenario) - 设置作者注释的位置。
  • before : 在 main prompt 之前
  • after：在 main prompt 之后
  • chat: 在聊天记录中

返回值：无

note-role

设置当前聊天的作者注释插入时的角色。

1

/note-role (role)

• role - 设置作者注释以什么角色插入。
  • system : 系统
  • user：用户
  • assistant: AI

返回值：无

聊天记录

获取聊天记录

messages

访问当前选定聊天中的信息。（别名：/message）

1

/messages [names=off/on] [hidden=off/on] [role=system/assistant/user] (specified message)

• name - 是否在消息开头显示对应的角色名，默认值：off
• hidden - 是否包含已隐藏的消息，默认值：on
• role - 只输出某一角色的消息
• specified message (number/range) - 访问的消息编号或某一范围。可使用 start-finish 格式获取范围内的聊天记录，包含始末编号的对应消息。第一条消息（即开场白）的编号为 0。

返回值：获取消息的内容

例：
获取第 5 至第 10 条消息的内容

1

/messages 5-10

获取最后 3 条信息

1
2
3

/setvar key=start {{lastMessageId}} |
/addvar key=start -2 |
/messages {{getvar::start}} - {{lastMessageId}} |

发送到聊天记录

send

将指定消息添加到聊天记录，但不触发生成。

1

/send [compact=bool] [at=number/varname] [name=string/varname] [return=pipe|object|toast-html|toast-text|console|none] (text)

• compact - 是否使用紧凑型布局, 默认值：false
• at - 发送到聊天记录的位置编号，第一条消息（即开场白）的编号为 0，但当 at 为 0 时，判断为深度，此时插入位置为最新一条消息。支持负数，负数时判断为深度。不设置时默认插入到聊天记录的末尾
• name - 发送后消息显示的角色名，若使用的字符串与变量名重合，即使添加双引号也依旧判断为变量。使用紧凑型布局时不会显示名字。默认值： {{user}}
• return - 提供返回值的方式，默认为 none
  • console：将返回值（对象）记录到控制台
  • none：无返回值
  • object：以对象（或数组）形式返回 pipe，供下一条命令使用
  • pipe：返回管道，执行下一条命令
  • toast-html：将返回值显示为吐司通知 - 可以显示 HTML
  • toast-text：将返回值显示为吐司通知 - 仅显示为文本
• text (string) - 消息内容

返回值：如果在 return（返回） 参数中指定，则可返回发送信息的文本

例：
两种布局的差别

1
2

/send compact=true 紧凑型布局
/send 普通布局

sendas

以特定角色的身份发送信息。不会触发生成。

1

/sendas [name=string] [compact=bool] [at=number/varname] [return=pipe|object|toast-html|toast-text|console|none] (text)

• name - 角色名称，可以使用非当前聊天对象，但存在于角色列表中的角色名。该角色头像也会一同显示。
• compact - 是否使用紧凑型布局, 默认值：false
• at - 发送到聊天记录的位置编号，第一条消息（即开场白）的编号为 0 ，支持负深度。不设置时默认插入到聊天记录的末尾
• return - 提供返回值的方式，默认为 none
  • console：将返回值（对象）记录到控制台
  • none：无返回值
  • object：以对象（或数组）形式返回 pipe，供下一条命令使用
  • pipe：返回管道，执行下一条命令
  • toast-html：将返回值显示为吐司通知 - 可以显示 HTML
  • toast-text：将返回值显示为吐司通知 - 仅显示为文本
• text (string) - 消息内容

返回值：如果在 return（返回） 参数中指定，则可返回发送信息的文本

sys

添加一条不属于用户或角色的中立旁白信息。显示的名称与 role 中的 system 无关，可使用 /sysname 命令进行自定义。参数的详细定义和返回值同 /send。

1

/sys [compact=bool] [at=number/varname] [return=pipe|object|toast-html|toast-text|console|none] (text)

sysname

为该聊天中的系统旁白信息设置名称（仅显示）。

1

/sysname (text)

• text (string) - 旁白名称，默认值：system，留空重置。

返回值：无

comment

添加一个隐藏旁白，该内容会在聊天中显示，但不会发送给 LLM。参数的详细定义和返回值同 /send。

1

/comment [compact=bool] [at=number/varname] (text)

addswipe

为最后一条角色发送的消息添加一次右滑轻扫，但并不会触发重新生成，仅显示用户输入的字符串。对用户，旁白或 /send 等命令生成的消息无效。（别名：/swipeadd）

1

/addswipe [switch=bool] (text)

• switch - 是否切换到新的滑动
• text (string) - 输入的内容会显示在右滑后的消息里

返回值：最新滑动的 ID 号

消息操作

hide

隐藏一条或数条消息，隐藏的内容不会发送给 LLM。参数和返回值同 /messages。

1

/hide [name=string] (specified message)

• name - 只隐藏某个特定角色的信息
• specified message (number/range) - 访问的消息编号或某一范围。可使用 start-finish 格式获取范围内的聊天记录，包含始末编号的对应消息。第一条消息（即开场白）的编号为 0，支持负深度。

返回值：无

unhide

取消隐藏一条或数条消息。参数和返回值同 /messages。

1

/unhide [name=string] (specified message)

• name - 只取消隐藏某个特定角色的信息
• specified message (number/range) - 访问的消息编号或某一范围。可使用 start-finish 格式获取范围内的聊天记录，包含始末编号的对应消息。第一条消息（即开场白）的编号为 0，支持负深度。

返回值：无

cut

从聊天中剪切指定的信息或连续片段。

1

/cut (specified message)

• specified message (number/range) - 访问的消息编号或某一范围。可使用 start-finish 格式获取范围内的聊天记录，包含始末编号的对应消息。第一条消息（即开场白）的编号为 0，支持负深度。

返回值：剪切信息文本，多个片段由换行进行分隔

delmode

进入信息删除模式，如果提供数字参数，则自动删除最近的 N 条信息。（别名：/del）

1

/delmode (delnum)

• delnum (number) - 从最新一条消息开始计数，删除的消息条目数

返回值：无

delswipe

删除最后一条聊天信息中的轻扫消息。（别名：/swipedel）

1

/delswipe (delnum)

• delnum (number) - 从 1 开始计数，删除的指定 ID 的轻扫消息。如果未提供轻扫消息 ID，则会删除当前 ID 的消息。

返回值：无

delname

删除当前聊天中指定名称下的所有消息。（别名：/cancel）

1

/delname (character name)

• character name (string) - 角色名称

返回值：无

delchat

删除当前聊天。

1

/delchat

返回值：无

closechat

关闭当前聊天。

1

/closechat

返回值：无

sync

将当前选定的用户角色同步到当前聊天中用户名。

1

/sync

reasoning-get

获取消息的推理块内容。如果消息没有推理块，则返回空字符串。（别名：/get-reasoning）

1

/reasoning-get (MessageID)

• MessageID - 消息 ID。如果未提供，则使用最后一条消息的 ID。

返回值：推理块内容字符串

reasoning-parse

使用推理格式设置从字符串中提取推理块。（别名：/parse-reasoning）

1

/reasoning-parse [regex=bool] [return=reasoning|content] [strict=bool] (text)

• regex - 是否将正则表达式脚本应用于推理内容。默认值：true
• return - 是返回已解析的推理结果，还是返回不含推理结果的内容。默认值：reasoning
• strict - 是否要求推理块位于字符串的开头（不包括空白）。默认值：true
• text (string) - 输入字符串

返回值：根据 return 参数决定返回值

reasoning-set

给消息设置的推理块。（别名：/set-reasoning）

1

/reasoning-set [at=number] (text)

• at - 消息 ID。如果未提供，则使用最后一条消息的 ID。
• text - 推理块内容

返回值：推理块内容

聊天分支

branch-create

从选定的信息中创建一个新分支。如果没有提供消息 ID，则将使用最后一条消息。
创建分支会自动为分支选择一个名称。创建分支后，分支聊天将自动打开。
如果不想跳转到新聊天，请使用检查点和 /checkpoint-create。

1

/branch-create (number)

• number - 消息 ID

返回值：新分支名称

checkpoint-create

使用提供的名称为所选信息创建一个新的检查点。如果没有提供消息 ID，将使用最后一条消息。留空检查点名称可自动生成检查点。
创建的检查点将与消息永久链接。如果检查点已经存在，其链接将被覆盖。创建检查点后，可以使用带有检查点名称的 /go 命令或消息上的 /checkpoint-go 命令，用检查点标记打开检查点聊天。
如果想跳转到新的聊天，请使用分支和 /branch-create。

1

/checkpoint-create [mesId=number] (name)

• mesID - 消息 ID
• name - 检查点名称

返回值：新检查点名称

例：
下面的命令将为当前角色的最新信息创建一个新的检查点，并将其保存为本地变量以供将来使用。

1
2

/checkpoint-create mes={{lastCharMessage}} Checkpoint for char reply |
/setvar key=rememberCheckpoint {{pipe}}

checkpoint-exit

退出检查点聊天。如果不在检查点聊天中，则返回空字符串。

1

/checkpoint-exit

返回值：退出的聊天名称。如果不在检查点聊天中，则返回空字符串。

checkpoint-get

获取与所选消息关联的检查点名称。如果没有提供消息 ID，将使用最后一条消息。如果没有链接检查点，结果将为空。

1

/checkpoint-get (number)

• number - 消息 ID

返回值：聊天名称

checkpoint-go

打开与所选消息链接的检查点。如果没有提供报文 ID，将使用最后一条消息。
如果要确保所选消息有一个检查点，请使用 /checkpoint-get。

1

/checkpoint-go (number)

• number - 消息 ID

返回值：检查点名称

checkpoint-list

列出该聊天中的所有现有检查点。

1

/checkpoint-list [links=bool]

• links - 获取检查点的所有链接/聊天名称列表，而不是信息 ID。如果设置为 true，则返回所有检查点链接，默认值：false

返回值：该聊天中所有现有检查点的 JSON 数组

checkpoint-parent

获取此检查点的父聊天名称。如果不在检查点聊天中，返回空字符串。

1

/checkpoint-parent

返回值：该检查点的父聊天名称

世界书

世界书状态

world

设置全局世界书的激活状态。

1

/world [state=off/toggle] [silent=bool] (name)

• state - 设置世界书状态，关闭或在开关两种状态切换。不提供此参数则默认状态为激活
• silent - 是否禁止弹出 Toast 弹窗, 默认值：false
• name (string) - 世界书名称，不提供此参数则禁用所有全局世界书

返回值：无

获取世界书内容

getcharbook

获取角色绑定的传说书名称并将其传入管道。如果未设置角色传说书，则返回空字符串。如果不提供角色名称，则无法在群聊中使用。（别名：/getcharlore，/getcharwi）

1

/getcharbook [type=primary|additional|all] (name)

• type - 要获取的传说书展示类型，为"all" 和 "additional" 时返回列表，默认值：primary
• name(number/string) - 角色名称或唯一的角色标识符。如果未提供，则使用当前角色。

  返回值：传说书名称或传说书名称列表

getchatbook

获取当前聊天绑定的世界书名称，如果未绑定，则创建一个新的，名称默认为 Chat_Book_{charname}_{time} 然后将其传递到管道中。（别名：/getchatlore，/getchatwi）

1

/getchatbook [name=string]

• name - 如果创建一个新的传说书名称，将自动生成

  返回值：世界书名称

getpersonabook

获取当前角色绑定的传说书名称，并将其传入管道。如果未设置，则返回空字符串。（别名：/getpersonalore，/getpersonawi

1

/getpersonabook

返回值：传说书名称

findentry

使用字段值的模糊匹配查找指定世界书中条目的 UID，并将其传入管道。若有多个匹配结果，输出靠前的单个 UID。（别名：/findlore，/findwi）

1

/findentry [file=string] [field=string] (text)

• file - 世界书名称
• field - 字段值，详见此章末尾的有效输入字段表，默认值：key
• text (string) - 匹配的内容

返回值：UID

例：
模糊匹配名叫 Lore 的世界书中关键字含有 Shadowfang 的条目，并输出 UID

1

/findentry file=Lore field=key Shadowfang

getentryfield

从指定的世界书中获取特定 UID 的条目的字段值，并将其传入管道。（别名：/getlorefield，/getwifield）

1

/getentryfield [file=string] [field=string] (UID)

• file - 世界书名称
• field - 获取的字段值，详见此章末尾的有效输入字段表，默认值：content
• UID (number) - 指定条目的 UID

返回值：获取的字段值内容

例：
获取名叫 Lore 的世界书中 UID 为 123 的条目的内容

1

/getentryfield file=Lore field=content 123

wi-get-timed-effect

从指定的世界书中获取某个 UID 的条目的定时效果（粘性/冷却/delay）的当前状态。

1

/wi-get-timed-effect [file=string] [effect=sticky/cooldown/delay] [format=bool/number] (UID)

• file - 世界书名称
• effect - 效果名称
• format - 以何种格式输出状态，布尔值（true/false）或效果持续的剩余时间。默认值：bool
• UID (number) - 指定条目的 UID

返回值：条目的效果状态

例：
以下命令查询世界书 Lore 的 UID 为 123 的条目粘性效果是否激活，返回 true 或 false

1

/wi-get-timed-effect file=Lore effect=sticky format=bool 123

以下命令查询世界书 Lore 的 UID 为 123 的条目粘性效果剩余的持续时间，如果未激活则返回 0

1

/wi-get-timed-effect file=Lore effect=sticky format=number 123

设定世界书内容

createentry

在指定世界书中创建新条目，并将 UID 从管道中传出。（别名：/createlore，/createwi）

1

/createentry [file=string] [key=string] (text)

• file - 世界书名称。若不存在，会新建同名世界书
• key - 条目关键词。要为关键词设置多个值，请使用逗号分隔的列表作为值。
• text (string) - 条目内容

返回值：新条目的 UID

例：
在名叫 Lore 的世界书新增条目，条目的关键词为 Shadowfang, sword, weapon，内容为 The sword of the king

1

/createentry file=Lore key=Shadowfang,sword,weapon The sword of the king

setentryfield

设置指定世界书中特定 UID 条目的字段值。（别名：/setlorefield，/setwifield）

1

/setentryfield [file=string] [uid=number] [field=string] (text)

• file - 世界书名称
• uid - 指定条目的 uid，uid 必须存在
• field - 要设置的字段值，详见此章末尾的有效输入字段表。要为关键词设置多个值，请使用逗号分隔的列表作为值。默认值：content
• text (string) - 字段值的内容

返回值：无

例：
设置名叫 Lore 的世界书中 UID 为 123 的条目的关键词，关键词为 Shadowfang, sword, weapon

1

/setentryfield file=Lore uid=123 field=key Shadowfang,sword,weapon

wi-set-timed-effect

为指定世界书中带有 UID 的条目设置定时效果（粘性/冷却/delay）。持续时间必须在条目本身中设置。仅适用于当前聊天。启用已激活的效果会刷新持续时间。如果最后一条聊天信息被轻扫或删除，该效果将被移除。

1

/wi-get-timed-effect [file=string] [uid=number] [effect=sticky/cooldown/delay] (mode) (UID)

• file - 世界书名称
• uid - 指定条目的 uid，uid 必须存在
• effect - 效果名称
• mode (on/off/toggle) - 效果的状态，开/关/切换。默认值：toggle

返回值：无

例：
以下命令将世界书 Lore 的 UID 为 123 的条目的粘性效果激活

1

/wi-set-timed-effect file=Lore uid=123 effect=sticky on

有效输入字段

逻辑

• 0 = 与任意
• 1 = 非所有
• 2 = 非任意
• 3 = 与所有

Position

• 0 = main prompt 之前
• 1 = main prompt 之后
• 2 = 作者注释之前
• 3 = 作者注释之后
• 4 = 聊天记录中
• 5 = 对话示例之前
• 6 = 对话示例之后

角色 (仅在 Position = 4 时有效)

• 0 = System
• 1 = User
• 2 = Assistant

文本操作

编辑文本

replace

根据模式替换所提供字符串中的文本。（别名：/re）

1

/replace [model=literal|regex] [pattern=string] [replacer=string] (text)

• model (string) - 匹配模式。如果model为literal（或省略），则model为字面搜索字符串（区分大小写）。如果model为regex，pattern会被解析为 ECMAScript 正则表达式。默认值：literal。
• pattern (string) - 匹配规则。
• replacer (string) - 以何种内容替换。替换器根据输入文本中的模式进行替换，如果省略replacer，替换内容将是空字符串。
• text (string) - 需要匹配的文本。

返回值：替换后的文本

例：

1
2
3
4
5

/let x Blue house and blue car ||                                                                        
/replace pattern="blue" {{var::x}}                                | /echo  |/# Blue house and  car     ||
/replace pattern="blue" replacer="red" {{var::x}}                 | /echo  |/# Blue house and red car  ||
/replace mode=regex pattern="/blue/i" replacer="red" {{var::x}}   | /echo  |/# red house and blue car  ||
/replace mode=regex pattern="/blue/gi" replacer="red" {{var::x}}  | /echo  |/# red house and red car   ||

upper

将提供的文本字符串转换为大写。（别名：/uppercase，/to-upper）

1

/upper (text)

• text (string) - 需要转换的字符串文本

返回值：调整后的字符串

lower

将提供的文本字符串转换为小写。（别名：/lowercase，/to-lower）

1

/lower (text)

• text (string) - 需要转换的字符串文本

返回值：调整后的字符串

修剪文本

substr

从提供的字符串中提取文本。（别名：/substring）

1

/substr [start=number] [end=number] (text)

• start - 起始索引
• end - 结束索引
• text (string) - 被修剪字符串

返回值：修剪后的字符串

例：
如果 start 被省略，则视为 0。 如果 start < 0，索引从字符串的末尾开始计算。如果 start >= 字符串长度，则返回空字符串。如果省略了 end，或者 end >= 字符串长度，则提取到字符串的末尾。如果 end < 0，索引从字符串的末尾开始计算。如果 end <= start 在对负值进行规范化处理后，返回空字符串。

1
2
3
4
5

/let x The morning is upon us.     ||                                     
/substr start=-3 {{var::x}}         | /echo  |/# us.                    ||
/substr start=-3 end=-1 {{var::x}}  | /echo  |/# us                     ||
/substr end=-1 {{var::x}}           | /echo  |/# The morning is upon us ||
/substr start=4 end=-1 {{var::x}}   | /echo  |/# morning is upon us     ||

trimtokens

将文本的开头或结尾修剪为指定的 token 数。

1

/trimtokens [limit=number] [direction=start/end] (text)

• limit - 剩余的 token 数
• direction - 保留的位置，为 start 则删去末尾的字符串，end 反之。默认值：end
• text (string) - 被修剪字符串

返回值：修剪后的字符串

例：

1

/trimtokens limit=5 direction=start This is a long sentence with many words

trimstart

将输入内容剪切到第一个完整句子的开头，即删除输入内容的第一个完整句子。

1

/trimstart (text)

• text - 需要插入的内容

返回值：修剪后的字符串

例：
此命令运行结果为 And here is another sentence.

1

/trimstart This is a sentence. And here is another sentence.

trimend

将输入内容剪切到最后一个完整句子的末尾。即文本末尾不带英文句号 . 的字符串删除。其他内容同 /trimstart。

1

/trimend (text)

文本匹配

fuzzy

将输入文本与字符串列表进行模糊匹配，并将最佳匹配字符串输出到管道中。

1

/fuzzy [list=list] [threshold=number] (text)

• list - 一个 JSON 序列化的字符串数组，其中包含候选条目。也可以指定一个包含列表的变量名。
• threshold - 可以控制匹配的严格程度。低值（最小 0.0）表示匹配非常严格。1.0（最大值）表示匹配非常宽松，可以匹配任何内容。默认值：0.4
• mode - 可选的 mode 参数用于控制多个项目匹配文本时的行为。
  • first（默认）返回低于阈值的第一个匹配项。
  • best（最佳）返回低于阈值的最佳匹配项。
• text (string) - 准备匹配的字符串

返回值：第一个符合条件的候选条目

例：

1

/fuzzy list=["a","b","c"] threshold=0.4 abc

regex

针对指定文本执行 Regex 扩展中的正则脚本。必须启用脚本才生效。

1

/regex [name=string] (text)

• name - 脚本名称
• text (string) - 准备匹配的字符串

返回值：匹配结果

配置快速回复

创建

qr-set-create

创建新快速回复集，再次运行会覆盖现有预设。（别名：/qr-presetadd）

1

/qr-set-create [nosend=bool] [before=bool] [inject=bool] (name)

• nosend - 禁用在用户输入中发送/插入（对斜线命令无效）, 默认值：false
• before - 用户发送消息时，是否先运行程序，LLM 再处理发送的消息内容，默认值：false
• inject - 自动注入用户输入（如果禁用，则使用 {{input}} 宏进行手动注入），默认值：false
• name (string) - 快速回复集的名称

返回值：无

例：
运行以下命令后

1

/qr-set-create nosend=true before=true inject=true MyNewPreset

qr-create

创建新的快速回复。

1

/qr-create [label=string] [set=string] [hidden=bool] [startup=bool] [user=bool] [bot=bool] [load=bool] [group=bool] [title=string] (text)

• label - 按钮上的文本，也是快速回复的名称
• set - 快速回复集的名称，必须事先创建好，查询不到会报错
• hidden - 是否隐藏按钮，默认值：false
• startup - 应用程序启动时自动执行，默认值：false
• user - 用户发送消息时自动执行，默认值：false
• bot - AI 发送消息时自动执行，默认值：false
• load - 聊天加载时自动执行，默认值：false
• group - 群组成员发送消息前自动执行，默认值：false
• title - 光标停留在按钮上时显示的标题/工具提示
• text (string) - 命令内容

返回值：无

例：
在快速回复集 MyPreset 下创建名叫 MyButton 的程序，内容为/echo 123

1

/qr-create set=MyPreset label=MyButton /echo 123

qr-contextadd

添加快速回复上下文菜单。

1

/qr-contextadd [set=string] [label=string] [chain=bool] (name)

• set - 快速回复集的名称，必须事先创建好，查询不到会报错
• label - 快速回复名称，必须事先创建好，查询不到会报错
• chain - 启用后，当前快速回复将与上下文菜单中点击的命令一起（先于命令）发送，默认值：false
• name - 加入到子菜单中的另一个快速回复集，必须事先创建好，查询不到会报错

例：
给 MyPreset 的 MyButton 添加上下文菜单 MyOtherPreset 并链接

1

/qr-contextadd set=MyPreset label=MyButton chain=true MyOtherPreset

获取

qr-get

获取快速回复的属性。

1

/qr-get [set=string] [label=string] [id=number]

• set - QR 集的名称， 例如：set=PresetName1
• label - 按钮上的文字，例如：label=MyButton
• id - QR 的数字 ID，例如：id=42

返回值：包含所有 QR 属性的字典

例：

1
2

/qr-get set=MyPreset label=MyButton | /echo
/qr-get set=MyPreset id=42 | /echo

更新

qr-update

更新指定快速回复。未注明参数同/qr-create

1

/qr-create [newlabel=string] [label=string] [set=string] [hidden=bool] [startup=bool] [user=bool] [bot=bool] [load=bool] [group=bool] [title=string] (text)

• newlabel - 新的快速回复名称
• label - 需要更新的快速回复名称
• set - 快速回复集的名称，必须事先创建好，不存在会报错

返回值：无

例：
将 MyPreset 中的 MyButton 更名为 MyRenamedButton，并修改命令为/echo 321

1

/qr-update set=MyPreset label=MyButton newlabel=MyRenamedButton /echo 321

qr-set-update

更新一个现有的快速回复集。所有参数和返回值同 /qr-set-create。（别名：/qr-presetupdate）

1

/qr-set-update [nosend=bool] [before=bool] [inject=bool] (name)

运行

run

运行来自作用域变量的闭包，或来自当前启用的命令集或其他命令集的具有指定名称的快速回复，不使用 args 参数时可以简写为 /: （后不接空格）。已命名的参数在快速回复中用 {{arg::key}} 引用。（别名：/call，/exec）

1

/run [args=string/number/bool/list/dictionary] (name)

• args - 已命名的参数
• name (string) - 闭包或快速回复的名称。如果当前命令集与其他命令集具有同名的 label，可以使用 /run QRpreset 1. QRlabel 1 来指定程序。此情况下，系统将首先查找名叫 QRpreset 1. QRlabel 1 的程序，不存在的情况下，才搜索命令集名称 QRpreset 1 和其下的 QRlabel 1

返回值：脚本执行的结果

例一：使用/:调用
新建快速回复，名称（label）为 测试。命令如下：

1

/echo 这是一条测试消息

新建另一个快速回复，名称（label）为 调用测试。命令如下：

1

/: 测试

运行 调用，会弹出 这是一条测试消息 的窗口。

例二：传递参数
新建快速回复，名称（label）为 年龄。命令如下：

1

/echo 今年是 {{arg::year}} ，我 {{arg::age}} 岁了

新建另一个快速回复，名称（label）为 调用年龄。命令如下：

1

/run year=2024 age=99 年龄

运行 调用年龄，会弹出 今年是 2024 ，我 99 岁了 的窗口。

例三：跨命令集指定程序
调用名叫 另一个命令集 下的 年龄 程序。命令如下：

1

/run year=2024 age=99 另一个命令集. 年龄

break

跳出通过 /run 或 /: 执行的循环或闭包。

1

/break value (string|number|range|bool|varname|closure|subcommand|list|dictionary)

• value - 以需要向下传递的管道值代替当前的管道值。

返回值：无

qr

激活已启用的某一快速回复程序。

1

/qr (index)

• index (number) - 根据快速回复按钮从左至右的排序确定序号。最左侧为 0。确定序号后，即使隐藏按键命令也能运行。

返回值：无

设置

qr-set

设置全局的 Chat Quick Reply Sets 快速回复集启用状态。

1

/qr-set [visible=bool] (name)

• visible - 设置启用状态，默认值：true
• name - 快速回复集名称

返回值：无

qr-chat-set

设置当前聊天的 Chat Quick Reply Sets 快速回复集启用状态。

1

/qr-chat-set [visible=bool] (name)

• visible - 设置启用状态，默认值：true
• name - 快速回复集名称

返回值：无

qr-list

获取此快速回复集中所有快速回复程序的名称列表。

1

/qr-list (name)

• name - 快速回复集名称

返回值：程序名列表，多个程序用 , 分隔

qr-set-list

获取此快速回复集中所有快速回复程序的名称列表。

1

/qr-set-list (type)

• type (all/global/chat) - 快速回复集的启用类型，默认值：all

返回值：快速回复集列表，多个集用 , 分隔

删除

qr-delete

删除指定的快速回复程序。

1

/qr-delete [set=string] [label=string]

• set - 指定快速回复集
• label - 指定集中的某个快速回复程序，如果没有提供此参数，则删除整个集合。

返回值：无

qr-set-delete

删除指定的快速回复集。

1

/qr-set-delete (name)

• name (string) - 指定快速回复集

返回值：无

qr-contextclear

移除某个快速回复程序的所有上下文菜单集。

1

/qr-contextclear [set=string] (name)

• set - 指定快速回复集
• name (string) - 指定集中的某个快速回复程序

返回值：无

例：
删除 MyPreset 中 MyButton 的所有上下文菜单

1

/qr-contextclear set=MyPreset MyButton

qr-contextdel

移除某个快速回复程序的指定上下文菜单集。

1

/qr-contextclear [set=string] [label=string] (name)

• set - 指定快速回复集
• label - 指定集中的某个快速回复程序
• name (string) - 要移除的上下文菜单集名称

返回值：无

例：
移除 MyPreset 中 MyButton 的上下文菜单 MyOtherPreset

1

/qr-contextdel set=MyPreset label=MyButton MyOtherPreset

用户界面

聊天窗口

chat-render

将指定数量的消息呈现到聊天窗口中。如果没有提供参数，则显示所有的消息。

1

/chat-render [scroll=bool] (number)

• scroll - 呈现后滚动到顶部。默认值：false
• number - 消息数量

返回值：无

chat-reload

重载当前聊天。

1

/chat-reload

返回值：无

角色卡

rename-char

重命名当前角色卡。

1

/rename-char [silent=bool] [chats=bool] (name)

• silent - 是否隐藏任何弹出窗口，隐藏后之前聊天记录的名称不会更改。如果为 false，则会弹出取名窗口，可以不提供 name 参数。默认值：true
• chats - 是否重命名之前所有聊天记录中的角色名
• name (string) - 新的角色名

返回值：true 或 false，代表重命名的成功或失败

renamechat

重命名当前聊天文件名。

1

/renamechat (name)

• name (string) - 聊天文件名

返回值：无

random

用随机角色开始新的聊天。如果提供了参数，则只从具有指定标签的角色中选择。

1

/random (tag)

• tag (string) - 指定某一个角色标签组

返回值：无

go

用角色或群组的名称打开聊天窗口，首先搜索完全匹配的名称，然后按前缀搜索，最后按子串搜索。（别名：/char）

1

/go (name)

• name (string) - 角色或群组名称

返回值：无

chat-manager

打开当前角色/组的聊天记录管理器。（别名：/chat-history，/manage-chats）

1

/chat-manager

返回值：无

newchat

与当前角色开始新的聊天。

1

/newchat

返回值：无

closechat

关闭当前聊天。

1

/closechat

返回值：无

tempchat

同 AI 开启一个临时聊天。

1

/tempchat

返回值：无

UI 风格

theme

根据名称设置 UI 主题。

1

/theme (name)

• name - 主题预设名称，必须是已存在的预设名

返回值：无

bubble

将信息样式设置为 "气泡聊天" 样式。（别名：/bubbles）

1

/bubble

返回值：无

flat

将信息样式设置为 "平面聊天" 样式。（别名：/default）

1

/flat

返回值：无

single

将信息样式设置为 "单一文档" 样式。（别名：/story）

1

/single

返回值：无

vn

切换视觉小说模式的开启/关闭。