挂载在 TRSS-Yunzai / Yunzai v3 下的 AI 对话插件：多 provider 对话、智能工具、记忆 V2、媒体与本地 Web 服务。本术语表只收录本项目自有词汇，不收录通用编程概念。
Bot 闸: 工具注入条件中「Bot 自己是当前群的管理员/群主」这一层政策闸，由注册层把关。 Avoid: 管理员权限（分不清指 Bot 的角色还是提问者身份）
提问者闸: 工具注入与执行自查中「提问者是 Bot 主人，或本群管理员/群主」这一层身份闸，即文档里的「主人/群管档」。 Avoid: 管理员权限
Bot 响应白名单:
按 Bot 账号（self_id）决定这个账号要不要响应对话触发的名单；名单为空表示不启用，所有账号都响应。
Avoid: 账号白名单、Bot 白名单（都与「对话白名单」混淆）；Bot 闸（那是群角色闸，不是账号闸）
账号候选: 锅巴里为「Bot 响应白名单」挑选账号时的可选集合：宿主当前已登录的 Bot 账号，加上白名单里已保存、但当前不在线的条目。 Avoid: 账号列表（泛指）、已注册账号（指适配器注册，不是登录）
只读公开信息: 群内本来就全员可见、读取时不产生任何群内可见变化的群信息，如群公告、群待办列表。 Avoid: 公开数据
公开可见效果: 操作后群内成员都能观察到的变化，如设置/完成/取消群待办、撤回消息。它是判断一个操作要不要收进提问者闸的依据。 Avoid: 群内可见副作用
工具内自查:
工具在 func 入口复查群上下文与提问者身份的一层，只读服务端事件 e；它是注入过滤之外的纵深防御，不检查 Bot 群角色（那是 Bot 闸的职责）。
Avoid: 权限校验（自查不是权限闸）
工具调用: 模型在一轮回复中请求执行某个（或一批）工具的请求，携带工具名与参数。 Avoid: function call、execution function（旧日志措辞）
工具返回: 某个「工具调用」执行后的结果（成功值或错误文本），回填给模型。 Avoid: execution result（旧日志措辞）
工具轮次: 工具循环的计数单位：一轮 = 模型发出一次工具调用请求 + 对应「工具返回」回填；连续轮次有上限。 Avoid: 工具调用次数（一轮可含多个并行调用）
合并转发: 把一组消息打包为单条可展开记录的消息形式；本插件的「工具调用与返回」与工具轮附带文本经此发送到会话，默认关闭。 Avoid: 转发、外发（泛指）
参数脱敏:
工具参数写入合并转发前，把承载正文的字段替换为 [REDACTED]、保留结构字段；控制台日志不脱敏。
Avoid: 掩码（凭证的处理见「凭证掩码」）
凭证掩码: API Key 等凭证写入日志前的处理：保留首尾少量字符便于区分，遮蔽主体。 Avoid: 脱敏（与「参数脱敏」不是一回事）
偷图回执:
#gpt偷图 成功后 Bot 发出的那条消息，兼作撤销句柄：它的消息 id 与落库图片路径、是否本次新写入在 Redis 里关联两周，主人引用它发 #gpt撤销偷图 才能指回唯一一张图。
Avoid: 偷图记录（指 Redis 里那条键值，不是消息本身）
引用图:
用户在消息中回复某条消息、该消息里携带的图片；解析后进入 e.img 并标记 e.theImgIsGetFromSource，与当前消息自己携带的图片走同一份 e.img 数组。
Avoid: 引用图片（易与「图片消息被引用」混淆）、转发的图
来源可信媒体地址:
由服务端事件（e.img / e.get_Video）或合并转发展开时收集的媒体段地址提供、模型无法自行指定的媒体地址。它只是「模型不能左右解析结果」这一层判断，不等于内容可信；模型在工具参数里回传同一个地址时才沿用该身份。
Avoid: 可信图片、白名单地址（白名单指域名后缀，是另一层）
本轮原始内容:
本次对话轮里用户消息未经落库剥离的形态（文本 + 内联图片 base64）。它只活在一次对话轮（核心 sendMessage）的内存里，用于工具轮把用户轮原样回放给模型，不进入会话存储。
Avoid: 原始媒体（只覆盖图片，回放的是整条用户消息）、缓存图片（那是下载与转码的中间产物）
媒体占位:
引用图写入会话历史时代替 base64 的纯文本标记（Gemini [多媒体附件: mime]、OpenAI [图片]），只保留「这里曾有图」的位置，不携带画面内容。
Avoid: 图片占位符（与提示词模板里的占位符混淆）
引用的合并转发: 用户回复一条合并转发消息时，被回复的那条记录本身；它在入 core 前被展开成 Markdown 文本，与「引用图」并列。 Avoid: 转发消息（泛指所有合并转发）、引用转发（易与「转发了引用」混淆）
合并转发读取:
智能模式工具 view_forward_msg 按 forward id 拉取一条合并转发并转成文本与媒体 Markdown 地址，供模型主动读取聊天记录中的转发。
Avoid: 合并转发展开（那是引用路径的自动行为）
转发节点: 合并转发里的一条消息，由发送者与若干消息段组成；展开时渲染成一行「昵称(QQ)：内容」。 Avoid: 转发消息（与整条合并转发混淆）
网页读取: 给一个 URL、取回该页正文并交回模型的能力。它是这一类能力的总称，按抓取发生在哪里分成「托管提取」与「本地抓取」两条路。 Avoid: 网页抓取、webfetch（分不清是哪条路）
托管提取:
正文由供应商（Exa / Parallel / Tavily）抓取并提取，插件只做协议封装、截断与不可信标记。站点看到的是供应商的出口地址，Config.proxy 不参与。
Avoid: 网页读取（那是总称）、服务器代理
本地抓取: 插件自己发 HTTP、自己把 HTML 转成 Markdown。站点看到的是本机出口地址，因此受本机网络与反爬限制，也没有 JS 渲染与登录态；代价是不依赖任何 Key 或外部服务。 Avoid: 爬虫、网页抓取（泛指）
续读:
对同一个 URL 用 start 偏移再读一次，取回后续片段。它不是分页 API：每次都重新请求上游；本地抓取没有上游游标，续读就是重新下载整页再切片，Exa 还会按 start + 20000 + 1 重新申请 maxCharacters（多取 1 字符用于判断是否还有后续）。
Avoid: 分页（分页指上游返回页游标）、翻页
记忆容量目标: 每个主体、每个记忆作用域定时整理时参考的有效事实数量目标。实时写入可暂时超额；凌晨仅在超过该容量的 95% 时尝试压至 70% 及以下，失败时不会强制删除补足。 Avoid: 实时写入硬上限、任意时刻不能超过的数量
临时超额记忆: 已实际成功写入、造成所在作用域有效记忆数量暂时超过容量目标的事实。它可以正常被召回，不是待写入候选；定时整理决定其后续保留。 Avoid: 写入失败的记忆、尚未保存的排队事实
角色字幕: 角色动图中承载机器人回复短句的画面内文字，像视频字幕一样叠加在角色画面前景，不使用独立的对话气泡造型。 Avoid: 气泡、对白框（旧视觉样式）
角色基础立绘: 角色动图用于普通状态的正常、闭眼和张嘴三张形态图；它们决定角色外观，不代表角色一定不发生移动。 Avoid: 静止表情、无动作表情
角色特色表情: 角色动图资源中除基础三帧以外的额外情绪立绘，可在一次回复中被辅助模型选中。 Avoid: 反应动作、渐变效果
角色反应动作: 角色动图叠加的跳动、摇摆、点头等动作表现，与选择哪张表情立绘是两项独立决定。 Avoid: 表情图片、表情渐变
按需内容识别: 对话模型在需要时主动调用工具，把聊天记录中的图片、视频或群友头像转换为文字描述的能力；不同于对话模型直接接收本轮图片。 Avoid: 原生引用图输入（另一个处理路径）
贴表情: 给一条已有消息加 QQ 表情回应（reaction），消息本身不变；区别于「发表情」——那是往会话里新发一条表情消息。 Avoid: 发表情、点赞（贴的可能是任意表情）
情绪池:
贴表情工具里「一种情绪 → 一组 QQ 表情 id」的集合。模型只说想表达哪种情绪，具体贴哪一张由工具在池内随机挑。
Avoid: 表情库（那是 sendEmojiTool 的图片目录，不是这张表）、表情列表
表情目录: 情绪池表达不了、由模型点名的具体表情（物件与动作，如玫瑰、蛋糕、收到）清单；一个名字唯一对应一张脸。 Avoid: 表情白名单、faceList
设定文件: 保存在机器人本地、以名字唯一标识的角色设定正文，是「使用设定」可选择内容的唯一来源。 Avoid: 设定（泛指时也指模型系统提示里正在生效的那段）
应用设定: 把某个设定文件的正文写入当前默认模型的系统提示，使其在后续对话中生效；会替换该模型原有的系统提示。 Avoid: 导入设定（本仓指从云端下载成设定文件，该服务已下线）、加载设定
备份设定: 应用设定之前，把当前默认模型原有的系统提示另存为一个新的设定文件，供以后重新应用来回退。 Avoid: 快照、存档
删除设定:
移除本地设定文件（连同同名的 <名字>_example.json），使这个名字从「使用设定」的候选里消失；不改动当前默认模型已应用的系统提示。
Avoid: 卸载设定（那是把已生效的系统提示一并清掉）、删除共享设定（云端那条已下线）
判断批次: 一次定时判断所覆盖的候选消息集合；每批最多回复一次，批次之间不共享状态。 Avoid: 轮次（那是模型的一次工具循环）
候选消息: 某次判断中允许被选中回复的群消息。机器人自身发言、@机器人消息、指令、超限用户消息和已经判断过的消息都不是候选，只作上下文。 Avoid: 待回复消息（泛指整批，含不可选的上下文）
候选标签: 候选消息在该批次内的短标识，模型用它指认要回应哪条；只在一批内有效，跨批次不保持含义。 Avoid: 消息编号（那是与历史同一空间的全局流水号）
入队型绘画插件:
把绘图请求交给插件自己的队列后立即返回的绘画插件（已核实 paimonnai-plugin；nai-plugin-1、nai-plugin-4 按同源实现归入此类，未在本机核实）。它对调用方只表示「已受理」，出图与发送由插件稍后自己完成。
Avoid: 异步绘画插件（所有插件都是异步调用，分不出这个区别）、排队绘画
同步型绘画插件:
在调用内部等到出图、并把图发到会话之后才返回的绘画插件（ap-plugin）。它返回时图已可见，调用方可以据实报告完成。
Avoid: 阻塞型插件（说的是调用方被占住，不是业务语义）
分块预算: 群友 Skill 的 Map 阶段单次子模型调用允许承载的脱敏样本上限，按 token 估算计量（中文按 1.2 字/token、其他按 4 字/token），超过即切下一块；每块结果先落盘再进入合成。 Avoid: 分块大小（易读成字符数）、上下文窗口（那是模型能力，不是这条链路的预算）
女娲蒸馏:
Bot 主人用 #女娲蒸馏 显式触发的一次群成员视角蒸馏：服务端解析目标 → 取样（本群记忆原文优先，不足回退群历史）→ 脱敏 → 分块提炼 → 合成并自检 → 打包成 Agent Skill（ZIP）。它是指令，不是模型可调用的工具；开跑前有一次确认门。
Avoid: 群友 Skill 工具（旧形态，已删除）、用户画像（那是 userProfile 的展示形态）、检索（蒸馏的产物是一份 Skill，不是一次查询）
已存个人事实:
本地记忆系统在 user_group 作用域保存的、关于某个群成员的第三人称原子事实。群友 Skill 只把它当提炼背景，不作为可引用原话，也不进入证据文件。
Avoid: 用户画像（那是 userProfile 的展示形态）、证据