- 让你的骰娘活起来
- 参考海豹手册，在 SealDice WebUI →「JS插件」中上传
aiplugin4.js； - 点击重载，刷新浏览器页面。
- 在 WebUI →「JS插件」→「插件设置」中找到
aiplugin4，点击展开； - 进入「模型」分组，在「对话模型」中用 TOML 格式填写你的模型，例如：
name = "deepseek-chat"# 模型名，查看你所用大模型平台的文档api_key = "sk-xxxx"# 你的 API Keyuse = ["chat"] # 用途，对话模型填 chat
[body] # 可选：覆盖请求参数temperature = 1max_tokens = 2048provider/base_url可以省略（deepseek / openai / google / zhipu / alibaba / anthropic / moonshot / xai / mistral / siliconflow 会自动识别），也可以显式填写base_url；anthropic（Claude）已适配请求/响应格式（system 拆出、tool_result 合并、响应归一化）；其流式暂不支持，配置stream = true时会自动回退为非流式；- 图片识别需要配置「图片模型」（
use = ["image-understanding"]）；如果模型支持视觉，可在「图片模型」的use里加chat把它当多模态对话模型用（上下文中的图片直接传给模型）；向量记忆需要配置「嵌入模型」（use = ["text-embedding"]，输出维度从嵌入模型的[body] dimensions读取，默认 1024）； - 默认对话模型取列表第一项，可在群里用
.ai model <模型名>切换，.ai model clr恢复默认。
- 在「消息触发」分组中修改「触发正则表达式」，改为你希望的触发方式（默认示例为 @ 骰娘，可直接替换）；
- 在「对话」分组中修改「角色扮演设定」，决定 AI 扮演的角色；每条设定第一行为角色设定名称（可通过
.ai role <名称>切换），其余为设定内容。
- 对着骰娘输入你设定的触发方式（默认是 @ 骰娘），即可看到回复；也可以使用
.ai on开启计数 / 计时 / 概率等自动触发模式； - 如果没有回复，把「基础 → 日志级别」改为「调试」查看触发日志，并对照常见问题处理排查。
AI骰娘4 是一款运行在 SealDice 上的智能对话插件，基于 OpenAI 兼容 API 开发，深度整合海豹骰子生态的 TRPG 功能：
- 智能对话：支持上下文感知的 AI 对话、角色设定与示例对话；
- 记忆体系：长期记忆（向量检索 + 标签/用户/群组过滤）、短期总结记忆、配置驱动的知识库（Markdown 模板 + 自动分块）；
- 工具系统：内置 40+ 工具函数（TRPG 检定、牌堆抽取、消息、图片、禁言、定时器等），支持函数调用与提示词工程两种模式，可接入外部 MCP 服务器与可配置技能；
- 图片处理：图片识别、表情包管理、Markdown/HTML 渲染为图片与本地图片资源；
- 权限体系：命令权限（会话/用户/强触三维）与工具权限（禁止/默认关闭/按会话开关）；
- 可观测性：结构化日志（级别控制、密钥脱敏）、token 用量统计与图表、工具调用审计。
- SealDice v1.4.6+；
- v1.4.6 分离部署（napcat / llonebot 协议）下图片相关功能存在问题，建议 SealDice v1.5.0+；
- 大模型 API：OpenAI 兼容格式；
- 本地开发：Node.js + npm（构建使用 esbuild，建议使用较新 Node 版本）。
通过 GitHub 下载最新稳定版：下载链接
通过 GitHub 下载后自编译最新开发版：
- 安装 Node.js 和 npm
git clone https://github.com/error2913/aiplugin4 # 克隆仓库 npm install # 安装依赖 npm run build # 编译
- 在
dist/文件夹中可找到编译好的aiplugin4.js文件
在 QQ 群中获取
以下依赖按需安装，均可通过 GitHub 下载或在 QQ 群中获取：
- 生成音频依赖插件：自定义音色的 AI 语音；
- ob11 网络连接依赖.js（推荐）或 http 依赖插件：ob11 相关工具（发消息、用户/群信息、禁言、打卡、AI 语音等）；
- 生成图片依赖插件：AI 生图工具；
- ffmpeg：发送本地语音需要配置到环境变量中。
- 参考海豹手册进行插件上传安装；
- 配置修改后自动生效（缓存最多 1 分钟），无需重载 JS。
配置项在 SealDice WebUI 的插件设置中按分组展示，以下键名与当前代码注册的配置一致。
| 设置项 | 说明 |
|---|---|
| 对话模型 | TOML 格式，每行一个模型；name / api_key / use 必填，use 可选项：chat（普通对话）/ compression（消息压缩）/ summarization（记忆总结）；provider / base_url 可省略自动识别；默认对话模型取列表第一项；可选 [body] 覆盖请求参数 |
| 图片模型 | TOML 格式，use 可选 ["image-understanding"]（图片理解/图片转文字）或 ["chat"]（多模态对话：作为对话模型使用，上下文中的图片直接传给模型），也可两者并存 |
| 嵌入模型 | TOML 格式，use 填 ["text-embedding"]（文本嵌入），输出维度在 [body] dimensions 配置（默认 1024），未配置时自动降级为关键词/分数检索 |
# 对话模型示例name = "deepseek-chat"api_key = "sk-xxxx"use = ["chat"]
provider = "deepseek"# 可省略，按名称自动识别
[body] # 可选：覆盖请求参数temperature = 0.8max_tokens = 2048会话内可用
.ai model查看、.ai model <模型名>切换、.ai model clr恢复默认。
| 设置项 | 说明 |
|---|---|
| 日志级别 | 从不 / 错误 / 警告 / 信息 / 调试，反馈问题建议设为「调试」 |
| 日志简短打印 | 日志超长时只保留首尾各 500 字 |
| 日志记录消息内容 | 关闭后请求上下文日志只记录角色与长度，不打印消息正文 |
| 请求超时时限 | 单位毫秒，同时约束模型请求与工具调用，过小会导致长回复/慢工具超时 |
| 请求并发上限 | 同时进行中的请求数量上限，0 表示不限制；超出后进入等待队列 |
| 请求队列上限 | 排队等待的请求数量上限，超过后直接丢弃；0 表示超出并发后不排队 |
| 海豹核心全局路径 | 本地资源相对路径拼接用的 SealDice 核心目录 |
| 是否开启全局待机 | 开启后 AI 不主动回复，收到的所有消息会录入上下文（会话的计数器/计时器/概率仍可触发）；长时间开启可能占用较多上下文 |
| 设置项 | 说明 |
|---|---|
| 角色扮演设定 | 每行一个角色的扮演设定：第一行为角色设定名称（超过 20 字符自动截断，可通过 .ai role <名称> 或豹语变量 $gSYSPROMPT 切换），其余为设定内容 |
| 示例对话 | role 顺序为 user 和 assistant 轮流出现，位于上下文最前面，不会被上下文机制删除 |
| 对话保存轮数 | 出现一次 user 视作一轮，超过轮数会遗忘除示例对话外最早的对话，越长消耗 token 越多 |
| 上下文最大token | 0 为不限制；超过后从最早的消息开始丢弃 |
| 插入system message间隔轮数 | 需小于限制轮数的二分之一才能生效，为 0 时不生效，示例对话不计入轮数 |
| 消息压缩阈值 | 用户消息（含连续多条合并后）超过该字符数时，使用压缩智能体压缩后存入上下文（默认 2000） |
| 设置项 | 说明 |
|---|---|
| 接收图片 | 是否接收并识别图片消息，关闭后不处理任何图片消息 |
| 接收指令消息 | 是否将指令消息计入上下文（指令仍会执行） |
| 接收骰子发送的消息 | 是否处理机器人自己发送的消息 |
| 忽略私聊消息 | 开启后私聊消息不触发 AI |
| 忽略消息豹语条件 | 命中为 1 时忽略，可填豹语表达式限制忽略范围 |
| 忽略消息正则表达式 | 匹配的消息不会被接收录入上下文 |
| ob11 额外消息接收 | 安装 ob11 网络连接依赖后，卡片/视频/音乐/文件/语音/合并转发消息经其事件分发接入（核心 milky 原生路径会过滤这些段），合并转发自动展开为可读文本 |
| 设置项 | 说明 |
|---|---|
| 默认计数器 / 默认计时器 / 默认概率 / 默认触发活跃时间 | .ai on 不带参数时使用的默认值；活跃时间格式 HH:mm-HH:mm-次数 |
| 触发正则表达式 | 匹配符合正则的消息用于强制触发 AI 回复，正则表达式教程 |
| 触发需要满足的条件 | 豹语表达式，例如 $t群号_RAW=='2001' 表示仅允许群 2001 触发；填 1 为无限制 |
| 触发次数上限 | 群内共用令牌桶容量，触发一次减少一计数，计数为 0 时无法触发 |
| 触发次数补充间隔 | 单位秒，按该间隔补充触发次数 |
| 设置项 | 说明 |
|---|---|
| 图片全局识别豹语条件 | 填 '1' 开启所有图片自动识别转文字；或填豹语表达式限制群/用户范围 |
| 识别图片时将url转换为base64 | 永不 / 自动 / 总是，解决大模型无法正常获取 QQ 图床图片的问题 |
| 设置项 | 说明 |
|---|---|
| 开启调用函数功能 | 开启后 AI 可使用各种工具 |
| 切换为提示词工程 | 当 API 不支持 function calling 时开启 |
| 允许连续调用函数次数 | 单次触发内允许连续调用函数的次数，防止 AI 陷入调用函数死循环（默认 10，设为 0 不限制） |
| 工具响应压缩触发字数 | 工具返回结果超过该字数时压缩后再存入上下文，设为 0 不压缩（默认 5000）；web_search 压缩时附带搜索目标 |
| 禁止调用的函数 | 每行一个，设置后将不被允许开启 |
| 默认关闭的函数 | 每行一个，AI 在新会话中默认无法调用，需 .ai tool on <函数名> 开启 |
| 提供给AI的牌堆名称 | 每行一个牌堆名，用于 draw_deck 工具；没有的话建议把 draw_deck 加入禁止调用 |
| MCP服务器配置 | 仅支持 JSON 格式：标准 mcpServers 块（Claude/Cursor/.mcp.json 可直接粘贴）、JSON 数组或单服务器 JSON；stdio 服务器会跳过；配置增删自动生效 |
| 技能配置 | 仅支持标准 SKILL.md 格式（frontmatter 的 name/description 自动解析，正文为技能内容），可直接粘贴其他 agent 的技能文件 |
| ai语音使用的音色 | 预设音色需要支持 AI 语音的协议端，自定义音色需要生成音频依赖（tts）和 ffmpeg |
| 设置项 | 说明 |
|---|---|
| 启用长期记忆 | 开启后对话内容会沉淀为长期记忆 |
| 长期记忆上限 | 长期记忆条数上限，超出后按分数淘汰 |
| 长期记忆展示数量 | 构造记忆 prompt 时展示的长期记忆条数 |
| 启用总结记忆 | 开启后定期对对话进行总结记忆 |
| 总结记忆上限 / 总结记忆间隔轮数 / 总结记忆参与轮数 | 总结记忆条数上限、自动总结间隔、每次总结纳入的对话轮数 |
| 短期记忆上限 | 短期记忆条数上限，超出后从最旧的开始淘汰（默认 10） |
| 启用知识库记忆 | 开启后把知识库内容注入 system prompt，供对话参考 |
| 知识库注入阈值(字符) | 知识库总内容不超过该值时全量注入；超过时只注入条目索引，模型用 kb_read 工具读取详情（默认 5000） |
| 知识库 | Markdown 模板，每条一份完整文档（# 条目标题、##/### 小节，超长自动分块）；只读，内容由管理员维护，AI 通过 kb 工具/指令检索 |
| 设置项 | 说明 |
|---|---|
| 回复引用 | AI 回复时是否引用触发的消息；回复含戳戳（poke）时不引用，避免消息无法显示 |
| 回复最大字数 | 防止最大 tokens 限制不起效导致回复过长 |
| 回复文本去除首尾空白字符 | 发送前去除回复首尾空白 |
| 分段发送延时 | 流式/非流式输出共用，消息间隔是否开启延时防止乱序 |
| 分段发送基础延时/ms | 流式/非流式输出共用，从第二条消息开始每条发送前等待的毫秒数（默认 350） |
| 分段发送含图额外延时/ms | 流式/非流式输出共用，当消息包含图片时额外增加的等待毫秒数（默认 250） |
| 禁止回复复读 | 检测到与上一条回复相似度过高时停止回复 |
| 视作复读的最低相似度 | 与上一条回复的相似度达到该值视为复读（默认 0.8） |
| 设置项 | 说明 |
|---|---|
| 流式输出 | 后端源码，body.stream = true 的模型才会走流式 |
| 图片转base64 | 后端源码，解决 QQ 图床图片无法被大模型访问的问题 |
| 联网搜索 | searxng，有能力建议自己搭建，为 AI 提供联网搜索功能 |
| 网页读取 | 后端源码，为 AI 提供网页详细内容获取功能（MCP，默认 http://127.0.0.1:46799/mcp） |
| 用量图表 | 后端源码，token 使用情况图表生成 |
| md和html图片渲染 | 后端源码，将 Markdown/HTML 渲染为图片（MCP，默认 http://127.0.0.1:37632/mcp） |
| 论坛地址 | 默认：https://aiplugin-forum.fishwhite.top，aiplugin4 专用论坛地址 |
| 论坛API Token | 论坛注册后获取的 api_token，用于发帖等写操作的鉴权 |
| 论坛签名密钥 | 论坛注册后获取的 secret_key，用于请求签名验证 |
各后端服务相互独立，可按需自建；除流式输出外，其余服务并非核心功能所必需。
后端服务已迁移到独立仓库 aiplugin4-backends：自带 launcher.py 一键管理（Windows / Linux 通用，默认不启动任何后端，首次启动某后端时才自动创建 venv 并安装依赖，异常退出自动拉起；webui 提供管理界面，可改端口/看日志，主题跟随系统）。后端清单与接口详见其仓库的 docs/后端.md，插件侧配置文档见 docs/08-相关后端项目。
| 设置项 | 说明 |
|---|---|
| 本地图片路径 | 每行一个本地图片路径，供 system prompt 列出可发送资源；修改后自动生效（缓存最多 1 分钟） |
| 本地语音路径 | 每行一个本地语音：语音名=路径（省略语音名时默认用文件名），供 system prompt 列出；发送语音需要配置 ffmpeg 到环境变量；修改后自动生效（缓存最多 1 分钟） |
6 个 Handlebars 模板（system prompt / 长期记忆 / 总结记忆 / 工具函数 / 图片识别 / 记忆总结）已内置在插件中，不再作为配置项展示，避免误改导致渲染损坏。
根命令为 .ai（AI 大写同样注册），子命令支持别名（如 priv→privilege、ses→session、st→set、ck→check、clr→clear、sb→standby、fgt→forget、memo→memory、tk→token、img→image、ign→ignore），列表类命令支持 --page=<数字>（别名 --p）翻页。
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai priv ses st <ID> <会话权限> | .ai priv ses st QQ-Group:1234 50 | 修改指定会话的权限等级，ID 可为 now 表示当前窗口 |
.ai priv ses ck <ID> | .ai priv ses ck QQ-Group:1234 | 检查指定会话的权限等级 |
.ai priv st <指令> <权限限制> | .ai priv st ai-sb 0-0-0 | 修改具体命令的权限限制，指令用 - 连接，权限限制格式为「会话-用户-强触」 |
.ai priv show <指令> | - | 检查指定指令的权限限制 |
.ai priv reset | - | 重置所有指令权限为默认 |
.ai prompt | - | 查看当前 system prompt（骰主） |
.ai block add <统一ID/@xxx> <原因> | .ai block add QQ:1234567890 乱发广告 | 拉黑用户/群（骰主），被拉黑对象无法触发 AI 对话 |
.ai block rm <统一ID/@xxx> | - | 移除黑名单 |
.ai block list | - | 查看黑名单列表 |
权限数值：-30 黑名单 / 0 普通用户 / 40 邀请者 / 50 群管理员 / 60 群主 / 70 白名单 / 100 骰主。
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai status | - | 查看当前会话设置 |
.ai help <子指令> / .ai <子指令> help | .ai help tool | 查看子命令帮助；.ai <子指令> help 带更多参数时交由子命令自身处理（如 .ai tool help <函数名>） |
.ai ctxn status | - | 查看上下文中的名字与自动修改状态 |
.ai ctxn set [nick/card] | - | 将上下文中的名字设置为昵称/群名片 |
.ai ctxn mod <0|1|2> | - | 自动修改上下文中的名字：0 不修改，1 昵称，2 群名片 |
.ai on / .ai on --r | - | 开启 AI：非指令正则触发默认随之开启；.ai off --r 仅关闭正则触发，.ai on 重新开启 |
.ai on [--r --c=<条> --t=<秒> --p=<%> --a=<开始-结束-次数>] | .ai on --c=10 --t=60 | 开启 AI：--r 开启非指令正则触发，--c/--t/--p/--a 开启计数器/计时器/概率/活跃时间段模式，不带参数仅开启非指令正则触发 |
.ai standby | - | 待机模式：仅录入上下文不主动发言，非指令关键词触发才发言 |
.ai off [--r/--c/--t/--p/--a] | .ai off --t | 关闭 AI（含非指令正则触发），加参数只关闭对应模式 |
.ai fgt [assistant/user] | - | 遗忘当前上下文；assistant 为遗忘 AI 发言与函数调用，user 为遗忘用户发言与函数返回 |
.ai role [<名称>] | - | 查看 / 切换角色设定 |
.ai model [<模型名>] | .ai model deepseek-chat | 查看 / 设置当前会话模型，clr 清除设置恢复默认 |
.ai shut | - | 中断当前流式输出 |
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai memo status (@xxx) | - | 查看当前（或 @ 指定用户的）长期/短期记忆状态 |
.ai memo [p/g] st <内容> | .ai memo p st 西瓜 | 设置个人/群聊设定（个人≤20字，群聊≤30字） |
.ai memo [p/g] st clr | - | 清除设定 |
.ai memo [p/g] del <ID1> <ID2> --关键词 | - | 按 ID 删除记忆，可附带关键词 |
.ai memo [p/g/short] list | - | 展示长期/短期记忆列表，支持 --page 翻页 |
.ai memo [p/g/short] clr | - | 清除长期/短期记忆 |
.ai memo short [on/off] | - | 开启/关闭短期记忆 |
.ai memo sum | - | 立即总结一次短期记忆 |
.ai memo sum clr | - | 清除总结记忆 |
.ai kb [list/search <关键词>/read <ID>] | .ai kb search 触发方式 | 知识库只读查询：列出条目索引 / 按关键词搜索 / 按 ID 读取详情 |
个人记忆跨群、群聊记忆仅限本群；group 分支需邀请者以上，short 分支需会话权限 1。
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai tool | - | 列出所有工具及开关状态 |
.ai tool help <函数名> | .ai tool help get_time | 查看指定工具的详细说明和参数需求 |
.ai tool [on/off] | - | 开启/关闭全部工具函数 |
.ai tool [on/off] <函数名> | .ai tool on jrrp | 开启/关闭指定工具函数 |
.ai tool call <函数名> --参数=值 | .ai tool call jrrp --name=错误 | 试用指定工具函数，输出调用返回信息；参数可尝试 JSON 解析，数字需要引号包裹 |
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai ign add @xxx | - | 添加名单（仅群聊）。名单内的用户能正常对话，但无法被选中作为作用目标 |
.ai ign rm @xxx | - | 删除名单 |
.ai ign lst | - | 查看名单 |
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai tk lst | - | 查看有使用记录的模型 |
.ai tk sum | - | 查看所有模型的 token 使用记录总和 |
.ai tk all | - | 查看所有模型的 token 使用记录，分别列出 |
.ai tk [y/m] (chart) | .ai tk y chart | 查看最近 12 个月 / 31 天的 token 用量，chart 生成用量图片 |
.ai tk <模型名> [y/m] (chart) | - | 查看指定模型的用量记录 |
.ai tk clr [<模型名>] | - | 清除全部或指定模型的用量记录 |
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai img list [lcl] | .ai img list lcl | 展示本地图片列表 |
.ai img itt [图片] (附加提示词) | .ai img itt ran 看看这图里人物是什么 | 使用视觉大模型对图片进行图片转文字 |
.ai img find <图片ID> | - | 查找图片并发送 |
| 命令 | 使用示例 | 说明 |
|---|---|---|
.ai timer lst | - | 查看当前会话所有定时任务 |
.ai timer clr | - | 清除所有定时任务 |
以下为内置工具函数（基于当前源码），可通过 .ai tool help <name> 查看详细用法，也可按分类在群里使用：
| 分类 | 工具函数 |
|---|---|
| 记忆 | add_memory、del_memory、search_memory、clear_memory |
| 知识库 | kb_search、kb_read、kb_list（只读检索，内容由配置维护） |
| 消息 | send_msg、get_msg、delete_msg、send_forward_msg、get_context |
| 定时 | get_time、set_timer、show_timer_list、cancel_timer |
| 触发 | set_trigger_condition |
| 指令 | run_command（列出/调用海豹指令）、get_cmd_help（查看指令帮助） |
| 工具调度 | search_tools（按需搜索工具）、call_tool（统一执行任意工具） |
| 语音 | record、text_to_sound |
| 网页 | web_search、web_read |
| TRPG | draw_deck |
| 属性 | attr_get、attr_set |
| 图片 | image_to_text、text_to_image、meme_list、get_meme_info、meme_generator、render_markdown、render_html |
| QQ 管理 | ban、whole_ban、get_ban_list、rename、group_sign |
| 群资料 | get_list、get_group_member_list、search_chat、search_common_group、get_person_info |
| 精华消息 | set_essence_msg、get_essence_msg_list、delete_essence_msg |
| 音乐 | music_play |
| 黑名单 | suggest_block（AI 建议拉黑，带冷却；默认需骰主确认）、unblock_user、get_block_list |
| 论坛 | forum_get_posts、forum_get_post_detail、forum_search、forum_create_post、forum_manage_comment、forum_get_activity、forum_manage_post |
| MCP / 技能 | <服务器名>_<工具名>（MCP 工具）、use_skill（技能） |
指令类技能（今日人品、COC 模组抽取/搜索、属性展示、属性检定、san 检定等）通过
use_skill按需获取内容，内部统一使用run_command调用海豹指令，对应指令需加入「可调用指令白名单」。
依赖说明：ob11 相关工具需要安装 ob11 网络连接依赖 或 http 依赖插件；
text_to_sound预设音色需要支持 AI 语音的协议端，自定义音色需要生成音频依赖与 ffmpeg；text_to_image需要生成图片依赖；music_play需要协议端配置音卡签名；render_markdown/render_html需要配置 md 和 html 图片渲染后端。
依赖海豹内置指令的工具（如
draw_deck、send_msg等）需要会话中先出现过指令消息（如先使用.r），否则工具会提示"请先使用 .r 指令"。
- 配置修改后自动生效（缓存最多 1 分钟），无需重载 JS；
- 嵌入模型输出维度从
[body] dimensions读取（默认 1024），未配置时记忆检索自动降级为关键词/分数检索、知识库检索自动降级为关键词匹配（嵌入仅作候选重排，加载知识库本身不请求嵌入）； - 流式输出需要自建或使用公共后端，并在「后端 → 流式输出」配置 URL；
body.stream = true的模型才会走流式； - 「请求超时时限」同时约束模型请求与工具调用，过小会导致长回复/慢工具超时；
- CQ 码白名单之外的图片类型消息不处理（当前允许 at/image/reply/face/poke）；卡片/视频/文件/语音/合并转发等段经 ob11 事件分发接收，不受该白名单限制。
不回复 / 触发不生效
- 日志级别改为「调试」，观察触发日志与请求日志；
- 检查「触发正则表达式」与「触发需要满足的条件」（豹语表达式）是否命中，触发条件命中为 1 才触发；
- 检查「触发次数上限/补充间隔」（令牌桶），桶为空会跳过回复；
- 检查消息是否被「忽略正则」或「忽略消息豹语条件」拦下；
- 确认模型配置可访问：url/API Key/模型名正确、余额充足、支持工具调用。
工具调用失败
- 查看日志中的调用失败原因（未注册/未经许可/参数缺失/类型不符/会话类型不符/超时等）；
- 用
.ai tool查看开关状态，.ai tool help <函数名>查看参数，.ai tool call <函数名> --参数=值手动试用； - 工具在「禁止调用的函数」列表中时无法开启；新会话中「默认关闭的函数」需要
.ai tool on <函数名>手动开启； - 依赖海豹指令的工具需要先使用
.r等指令。
记忆/知识库检索不到
- 记忆检索确认「嵌入模型」已配置且「是否开启嵌入模型」开关打开，「启用长期记忆」开关打开；
- 知识库为配置驱动（Markdown 模板），不按角色加载；「启用知识库记忆」开关打开后修改「知识库」配置即可，自动生效（缓存最多 1 分钟），用
.ai kb search <关键词>/.ai kb list验证； - 记忆检索有相似度下限过滤，条目太旧（衰减）或相似度过低不会展示。
图片识别异常
- 确认图片 URL 可以在浏览器访问（过期或 QQ 图床 bug 时更换协议端版本）；
- 模型不支持 QQ 图床时，把「识别图片时将url转换为base64」设为「总是」或「自动」；
- 图片转文字依赖视觉模型配置（「图片模型」TOML，
use = ["image-understanding"]）。
HTTP 请求出错
- 日志中的错误码对照 HTTP 错误码与大模型文档排查；常见原因：url 填错、API Key 错、模型名错、不支持工具调用、余额不足、请求频繁。
| 大模型平台 | 调用url | 文档地址 | 支持语言大模型 | 支持视觉大模型 |
|---|---|---|---|---|
| deepseek | https://api.deepseek.com/chat/completions | deepseek API文档 | deepseek-chat,deepseek-reasoner×▲ | - |
| kimi | https://api.moonshot.cn/v1/chat/completions | Moonshot AI 使用手册 | moonshot-v1-8k,moonshot-v1-32k,moonshot-v1-128k,moonshot-v1-auto | - |
| 百炼大模型 | https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions | 大模型服务平台百炼产品文档 | qwen-max,qwen-plus,qwen-turbo,qwen-long,deepseek-r1×▲,deepseek-v3× | qwen-vl-max,qwen-vl-plus |
| 智谱AI | https://open.bigmodel.cn/api/paas/v4/chat/completions | BigModel 接口文档 | glm-4-plus,glm-4-air,glm-4-air-0111,glm-4-airx,glm-4-long,glm-4-flashx,glm-4-flash,glm-zero-preview×,charglm-4× | glm-4v-plus-0111,glm-4v-plus,glm-4v,glm-4v-flash |
| 百度千帆大模型平台 | https://qianfan.baidubce.com/v2/chat/completions | 千帆大模型服务与开发平台ModelBuilder文档 | ernie-4.0-8k▲,ernie-4.0-turbo-8k▲,ernie-3.5-8k▲,deepseek-v3×▲,deepseek-r1×▲ | deepseek-vl2 |
| 讯飞星火大模型 | https://spark-api-open.xf-yun.com/v1/chat/completions | 讯飞开放平台文档中心 | lite×,generalv3×,pro-128k×,generalv3.5×,max-32k,4.0Ultra | |
| google AI | https://generativelanguage.googleapis.com/v1beta/openai/chat/completions | gemini API 文档 | gemini-2.0-flash,gemini-1.5-flash,gemini-1.5-pro | |
| openAI | https://api.openai.com/v1/chat/completions | openAI API 文档 | gpt-4o,gpt-4o-mini,o1,o3-mini,gpt-4-turbo,gpt-3.5-turbo | gpt-4-turbo,gpt-4o,o1,gpt-4o-mini |
注：× 为不支持 function call；▲ 为需要开启合并 user 消息开关。视觉模型不一定支持 QQ 图床识别，可使用中转插件。
在「模型」配置中，上表平台的
provider/base_url大多可省略（自动识别），未列出的平台填写base_url即可使用。
仅列出部分官方的本插件支持的模型，部分大模型平台同一模型有多个版本并未在上表写出，且更新不及时，存在过期可能，未列出的不一定不能使用，最好到文档自己查看。国外大模型网络问题请自行解决。
本项目采用 MIT 开源协议，欢迎二次开发。原创作者保留署名权。
Copyright 2026 error2913 and baiyu-yu
Permission is hereby granted...
- 海豹骰子开发团队
- 开源社区贡献者
- GitHub Issues: 问题提交
- QQ交流群: 143412516
"才、才不是专门给你写的文档呢！只是...只是顺便而已！(///ω///)" —— 正确·改