模型与接口
配置文字聊天、角色表现、记忆总结与 QQ 图片理解。
先配文字聊天。角色表现、记忆总结和 QQ 图片理解都是可选功能。
| 词语 | 含义 |
|---|---|
| 接口基础地址 | 模型服务商提供的 API 地址 |
| 模型 ID | 服务商给出的完整模型名称 |
| API 密钥 | 调用该服务的凭据，不是网页登录密码 |
| token | 计算输入、输出长度的单位，不等于字数 |
文字聊天
入口：偏好设置 → 对话 API → 文字聊天。
- 填写接口基础地址、模型名称和 API 密钥。
- 不知道模型 ID 时，可点 检索可用模型并选择；列表里出现不保证有调用权限。
- 点击 测试接口。测试会请求模型，可能计费。
- 显示成功后，向下滚动，点击 保存聊天设置。
远程地址使用 HTTPS；本机服务可用 http://127.0.0.1:端口/v1，需先自行启动。这里使用兼容 Chat Completions 的接口。地址按服务商提供的基础地址填写，避免重复拼接 /chat/completions。
| 提示 | 检查什么 |
|---|---|
| 401 / 403 | API 密钥、账户和模型权限 |
| 404 | API 地址、接口类型和模型 ID |
| 429 | 服务限流、余额或额度 |
| 超时 | 网络、服务状态；本机服务是否已启动 |
台词输出额度
台词最高输出 token 是单次输出上限，不代表每次都用满。这个交付包的新配置默认 20000；已有设置以页面显示为准。
先保持当前值。回复被截断时可检查服务本身限制和日志，再调整；调高可能增加等待和费用。桌面聊天、QQ 回复及主动关心共用该上限。
角色表现：控制表情与状态
入口：偏好设置 → 角色表现 API → 长期陪伴，展开 角色表现规划。
- 选择服务支持的协议。普通兼容接口选 Chat Completions；Jev 专用接口才选 Jev。
- 填写该分区的地址、模型和密钥，点击测试。
- 勾选 启用此分区，点击 保存分区。
不开启仍可聊天，会使用本地表现。启用后通常每轮多一次模型请求；失败时使用本地表现。本包规划默认上限为 10000 token、最长等待 12 秒，可在分区中调整。
记忆总结：自动整理资料
入口：记忆总结 → 总结模型与自动整理。
- 配置支持 Chat Completions 的模型，测试并保存分区。
- 需要自动整理时，再勾选 每六轮成功对话自动整理。
- 想手动添加记忆，可直接使用本地记忆，不必配置总结模型。
QQ 图片理解
入口：偏好设置 → 对话 API → 文字聊天 → QQ 图片理解。
- 确认当前服务和模型支持
image_url图片输入。 - 点击 测试图片理解：程序会上传色块样例，可能计费。
- 测试通过后点击 保存聊天设置。
开启后，绑定玩家发来的静态 PNG、JPEG、WebP 会发给当前模型；每条消息最多 3 张，每张最多 4 MB。本指定包不支持 GIF 动图，也不支持动态 PNG 或动态 WebP。
文字测试成功不等于能识图。测试失败看具体错误：401 先检查密钥；若提示达到输出上限，说明本次测试没得到有效正文，不能只凭它判断模型是否支持图片。这个旧包的图片测试输出上限为 32 token，某些推理模型可能因此测试失败。
密钥与提示词
- 密钥框重新打开后可能为空；查看保存状态。留空一般保留已保存密钥，换服务域名时须输入该服务的密钥。
- 不要把密钥、包含密钥的截图或未检查的日志发给别人。
- 提示词第一次保留预设即可；修改后点击所在分区的保存按钮。自定义提示词不能替换程序的固定规则。