THE TAVERN CODEX开发者文档

服务器插件

服务器插件:服务器插件是一种扩展 SillyTavern 服务器功能的方式。它们可以添加新的 API 端点、处理程序和其他功能。 创建插件 在 plugins 目录中创建一。SillyTavern 酒馆中文百科,保留原文与出处,提供像素酒馆相关入口和阅读导航。

原文 · sillytaverncn.net ↗授权迁移 · 保留原文作者与许可纯文本 ↗
本页章节 4
阅读说明

下方保留源站教程正文,部分版本、价格和产品信息可能随时间变化,请以当前应用与上游文档为准。本站与 SillyTavern 为独立产品,不将其扩展视为像素酒馆可完全兼容的功能。

服务器插件是一种扩展 SillyTavern 服务器功能的方式。它们可以添加新的 API 端点、处理程序和其他功能。

创建插件

  1. 在 plugins 目录中创建一个新目录。目录名称将成为插件的名称。
  2. 在插件目录中创建一个 index.js 文件。这是插件的入口点。
  3. 在 index.js 中导出一个包含以下方法的对象:
module.exports = {
    // 在服务器启动时调用
    async init(app) {
        // app 是 Express 应用程序实例
        // 在这里添加您的路由和中间件
    },

    // 在服务器关闭时调用
    async stop() {
        // 在这里清理资源
    }
}

示例插件

const express = require('express');

module.exports = {
    async init(app) {
        // 创建一个新的路由器
        const router = express.Router();

        // 添加一个新的 API 端点
        router.get('/hello', (req, res) => {
            res.json({ message: 'Hello from plugin!' });
        });

        // 将路由器挂载到 /api/plugins/[plugin-name]
        app.use('/api/plugins/example', router);
    },

    async stop() {
        // 清理代码
    }
}

启用插件

要启用插件,请在 config.yaml 中添加以下内容:

plugins:
  # 插件目录的名称
  - example

插件 API

插件可以访问以下 API:

  • app - Express 应用程序实例
  • express - Express 模块
  • config - 服务器配置对象
  • jsonwebtoken - JWT 模块,用于身份验证
  • path - Node.js path 模块
  • fs - Node.js fs 模块
  • logger - Winston 日志记录器实例

来源、许可与维护

原文由 sillytaverncn.net 维护。本页面经站点运营方授权迁移并重新排版,不移除原文中的作者、贡献者和许可说明。

查看 完整许可与致谢、迁移与链接修复记录、上游文档贡献者及 SillyTavern 官方文档。原文中的第三方项目各自保留其权利。