其他工具函数

提示

请务必先阅读如何正确使用酒馆助手

点击查看对应类型定义文件 (可发给 AI 或 IDE 使用, 酒馆助手界面中提供了打包下载)

substitudeMacros

替换字符串中的 SillyTavern 宏

substitudeMacros

function substitudeMacros(text: string): string;

参数

text

• 类型: string
• 描述: 需要替换的字符串

返回值

• 替换结果: string

示例

const text = substitudeMacros("{{char}} speaks in {{lastMessageId}}");
text === "少女歌剧 speaks in 5";

getLastMessageId

获取最新楼层号

getLastMessageId

function getLastMessageId(): number;

返回值

• 最新楼层号: number

errorCatched

包装任意函数, 返回一个会将报错消息通过酒馆通知显示出来的同功能函数.

errorCatched

function errorCatched<T extends any[], U>(fn: (...args: T) => U): (...args: T) => U;

参数

fn

• 类型: (...args: T) => U
• 描述: 要包装的函数

返回值

• 包装后的函数: (...args: T) => U
• 描述: 包装后的函数会捕获 fn 函数的报错, 并通过酒馆通知显示出来

示例

function test() {
  throw Error(`test`);
}
const error_catched_test = errorCatched(test);
error_catched_test();
// 酒馆通知: test

getIframeName 🚫TavernHelper

获取前端界面或脚本的 iframe 标识名称

function getIframeName(): string;

返回值

• iframe 标识名称: string
  • 对于楼层消息是 TH-message-楼层号-前端界面是该楼层第几个界面
  • 对于脚本库是 TH-script-脚本id

getMessageId 🚫TavernHelper

从前端界面的 iframe 标识名称 iframe_name 获取它所在楼层的楼层号, 只能对前端界面 iframe 标识名称使用

function getMessageId(iframe_name: string): number;

参数

iframe_name

• 类型: string
• 描述: 前端界面的 iframe 标识名称

返回值

• 楼层号: number

getCurrentMessageId 🚫TavernHelper

获取本前端界面所在楼层的楼层号, 只能在前端界面内使用

function getCurrentMessageId(): number;

返回值

• 楼层号: number

getScriptId 🚫TavernHelper

获取脚本库的脚本 id

function getScriptId(): string;

返回值

• 脚本 id: string