XylemNode

接入指南

SillyTavern

本地自托管的对话前端，主打角色扮演与多轮聊天。它自己不跑模型，而是接后端；选 Chat Completion 里的 Custom (OpenAI-compatible) 源，填好地址和密钥就能用 XylemNode。

获取 API Key
官网 / 下载
  1. 01

    安装并启动

    SillyTavern 要在本机运行（需 Node.js 环境）。按官方安装指南装好后，Windows 双击 Start.bat、macOS/Linux 跑 ./start.sh 启动；也可用官方 Launcher 或 Docker。启动后在浏览器打开终端提示的本地地址（默认 http://localhost:8000）。

  2. 02

    打开 API 连接、选自定义源

    点顶部的 API Connections（插头图标），把 API 类型切到 Chat Completion，再把 Chat Completion Source 选成 Custom (OpenAI-compatible)。

  3. 03

    填地址与密钥

    在自定义端点处填 XylemNode 的地址（带 /v1）和密钥。

    Custom Endpoint (Base URL)
    https://api.xylemnode.com/v1
    API Key
    sk-你的密钥
  4. 04

    选模型并连接

    XylemNode 实现了 /v1/models，SillyTavern 会自动带出模型下拉列表，选一个（如 gpt-5.6-sol）即可；若没拉到就在文本框手填模型 ID。点 Connect 连接，再用 Test Message 发一条验证通路。

提示词格式说明

① 若某些模型对消息格式有要求（比如只允许一条 system 消息、角色需严格交替）而报错，展开 Prompt Post-Processing，选 Merge consecutive messages 或 Semi-strict 等预设即可兼容。 ② 端点明明正常却一直弹告警时，可勾选 Bypass API status check 跳过状态检查。

常见问题

SillyTavern 提示模型 ID 未设置，或报 system 消息必须在最前面？

前者是发请求前的硬拦截：你把模型切成了手填模式却把输入框留空，请求体里的 model 会是空串、上游无法路由，所以它直接拦下不发。填完整模型标识，或改回用下拉里拉到的模型即可。后者是消息结构不合模型口味——仓库里报过 System message must be at the beginning 这类错：Chat Completion 模式下 ST 会把系统提示拆到多处，而有些模型只接受首条 system、或要求角色严格交替。展开 Prompt Post-Processing 选 Merge、Semi-strict 这类预设，让它在发出前把消息合并成合规结构就行，不用改角色卡。