接入架构
| 环节 | 职责 | 注意事项 |
|---|---|---|
| SillyT**ern | 管理角色卡 对话 世界书和提示词 | 本身不提供模型推理 |
| API Connection | 保存类型 来源 端点 密钥和模型 | 选择 Custom OpenAI-compati*le |
| KingFlow AI | 验证密钥并按模型 ID 转发请求 | 余额 套餐和模型分组需可用 |
| 云端模型 | 根据完整提示词生成回复 | 能力和上下文上限取决于具体模型 |
开始前的准备
- 在 KingFlow AI 控制台创建以 sk- 开头的 API Key,并确认余额、套餐或模型分组可用。
- 从模型广场或控制台复制完整模型 ID,不要根据展示名称自行猜测。
- 安装或更新 SillyT**ern,并确认浏览器能打开本地界面。
- 首次测试使用内置或无敏感信息的角色卡,不要直接导入真实个人资料。
- 确认设备能访问 KingFlow API 域名;公司网络如使用**,应先完成网络配置。
安装和启动
| 环境 | 安装方式 | 注意事项 |
|---|---|---|
| Windows | 官方安装脚本或 Launcher | 按官方步骤启动后打开本地网页 |
| **cOS Linux | Git 与 Node.js 安装流程 | 运行启动脚本并保留终端窗口 |
| Docker | 官方容器说明 | 映射配置目录并限制**暴露 |
验证 KingFlow 基础接口
curl https://api.**nju**shen.com/v1/chat/completions \
-H "Authorization: *earer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "<KingFlow控制台中的完整模型ID>",
"messages": [{"role": "user", "content": "只回复:连接成功"}],
"stream": false
}' 添加 KingFlow API 连接
- 打开 SillyT**ern,在顶部工具栏点击 API Connections。
- API 类型选择 Chat Completion。
- Chat Completion Source 选择 Custom (OpenAI-compati*le)。
- Custom Endpoint **L 填写 https://api.**nju**shen.com/v1。不要追加 /chat/completions。
- API Key 粘贴 KingFlow 控制台创建的密钥。
- 从模型下拉列表选择目标模型;若没有列表,手动输入控制台中的完整模型 ID。
- Prompt Post-Processing 首次选择 None。只有出现角色顺序或系统消息兼容问题时再调整。
- 点击 **** Message,确认模型能返回测试回复。
| 字段 | 填写内容 | 说明 |
|---|---|---|
| API | Chat Completion | 使用消息数组格式 |
| Source | Custom OpenAI-compati*le | 连接通用 OpenAI 兼容端点 |
| Endpoint | https://api.**nju**shen.com/v1 | 填写到 /v1 不追加具体接口 |
| API Key | sk-你的密钥 | 只保存在自己的设备和配置目录 |
| Model ID | 控制**整模型 ID | 自动列表为空时手动填写 |
| Post Processing | None | 首次测试不改变消息结构 |
选择提示词后处理
| 选项 | 处理方式 | 适用情况 |
|---|---|---|
| None | 不主动合并消息 | 端点原生接受常规 Chat Completions 时优先 |
| Merge consecutive | 合并同角色连续消息 | 端点不接受连续同角色消息时使用 |
| Semi strict | 合并角色并保留一个系统消息 | 兼容限制更严格的端点 |
| Strict | 要求用户消息先出现 | 端点严格校验角色顺序时使用 |
| Single user message | 把全部内容合成一个用户消息 | 兼容性兜底 会损失角色结构 |

运行首次连接测试
请暂时忽略角色扮演,只完成连接测试:
1. 回复当前模型 ID 或模型名称
2. 计算 23 × 31
3. 最后一行只输出 CONNECTED
不要使用联网工具,不要引用世界书。理解发送到模型的内容
| 组成 | 内容 | 注意事项 |
|---|---|---|
| 角色卡 | 角色描述 性格 示例对话 | 可能包含个人信息或创作设定 |
| 聊天记录 | 当前会话上下文 | 对话越长 输入 Token 越多 |
| 世界书 | 按***触发的**资料 | 触发条目会进入本次请求 |
| 作者注释 | 临时风格和情节指令 | 通常靠近提示词末端 |
| 系统与预设 | 角色顺序 停止词和采样设置 | 会影响兼容性和输出风格 |
保存连接配置档案
- 基础连接验证成功后,在 API Connections 中保存一个 Connection Profile。
- 名称写明提供商和模型,例如 KingFlow 加模型简称。
- 为不同用途建立独立配置,例如写作模型、推理模型和低成本模型。
- 切换配置后再次确认模型 ID 和上下文设置,避免把高成本模型用于长会话。
完成联调验证
- **** Message 能正常返回,连接状态不再报错。
- 模型 ID 与 KingFlow 控制**全一致。
- 新建无敏感信息的角色对话后可以连续回复。
- KingFlow 控制台出现对应密钥和模型的调用记录。
- 切换 Connection Profile 后端点、模型和预设按预期变化。
保护密钥和角色数据
- 不要把真实 API Key 写进角色卡、世界书、聊天内容、截图或共享配置。
- 云端请求可能包含角色卡、聊天记录、世界书触发内容和作者注释。敏感资料应先脱敏。
- 导出角色卡或聊天记录前,检查其中是否含有个人信息、内部设定或密钥。
- 为不同设备和成员创建独立密钥,设备丢失或疑似泄露时立即撤销。
- 长对话会增加输入 Token。定期总结或新建会话,控制成本和上下文噪声。
完成检查清单
- SillyT**ern 已更新并能打开 API Connections。
- API 为 Chat Completion,Source 为 Custom OpenAI-compati*le。
- Endpoint 为 https://api.**nju**shen.com/v1 且没有追加 /chat/completions。
- API Key 来自 KingFlow 控制台且没有写入共享内容。
- 模型 ID 与控制**全一致。
- **** Message、角色对话和 KingFlow 调用记录均正常。
- 已了解角色卡、聊天记录和世界书可能随请求发送到云端。
常见故障排查
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
| **** Message 失败 | 端点 密钥或模型任一项错误 | 按字段顺序核对后重新测试 |
| 404 | 端点追加了 chat completions 或模型 ID 错误 | 端点只填到 /v1 并复制完整模型 ID |
| 401 或 403 | 密钥错误 已停用或无权访问模型 | 重新复制密钥并检查状态和分组 |
| 429 | 余额不足或请求频率过高 | 检查余额与套餐 降低频率后重试 |
| 503 | 通道繁忙或暂时无可用账号 | 稍后有限重试或切换可用模型 |
| 模型列表为空 | models 接口未返回或网络异常 | 手动输入控制**整模型 ID |
| 角色顺序错误 | 端点限制消息角色结构 | 依次尝试 Merge Semi strict 或 Strict |
| 回复截断 | 上下文或输出限制不足 | 缩短聊天记录并核对模型上下文上限 |
| 提示词过大 | 世界书和历史记录同时注入 | 检查 Prompt Itemization 并减少触发内容 |



















