AgentLab(克隆 / 群聊)
好友克隆与克隆体群聊使用「消息」中的克隆会话视图。通过常规列表聚合入口或「会话视图 → 克隆会话」进入,通过会话列表「+」创建好友克隆或克隆体群聊;选中角色或群后在主聊天区域打开。
TIP
使用前请先在设置 → AI 功能 → API 配置里配好模型提供方,否则克隆与群聊都缺可用的 聊天 / 视觉 / 向量模型。
1. 入口与管理
- 消息列表「+」提供新建好友克隆与克隆体群聊;新建后进入克隆视图,从常规视图发起可返回原搜索与滚动现场。
- 打开克隆体会话后点击「设置」,按人格与画像、回复设置、语音、对我的记忆、导出与部署、克隆体管理分类;全局设置不再单设克隆页。
- 克隆进度在「菜单 → 任务 → 当前任务」查看,收起面板不会停止后台构建。
- 选中克隆任务后可在详情中查看模型实时正文、推理输出和请求状态;并发请求通过分段选择控件切换。输出仅在本次页面会话保留,失败后仍可回看,刷新或移除任务会清空。
- 模型提供方与调用量分别在「AI 功能 → API 配置」和「API 用量」。
- 任务型助手从独立的 WeQ 助手会话视图进入,不是克隆体群聊。
2. 好友克隆
图片处理
克隆私聊与群聊支持选择、粘贴、拖入图片,保留图片与原消息的关系;草稿和已发送图片可跨端恢复、放大查看。会话设置里的「图片处理偏好」是所有克隆体共用的应用级偏好,提供 OCR/视觉模型,默认视觉模型。视觉模型统一使用 API 配置中的「默认视觉模型」,未配置或调用失败时回退 OCR;OCR 失败则标明图片未读并继续处理文字。
新建克隆时的「图片处理偏好」统一控制本次选定语料中的图片与自定义表情,默认仅保留文字占位,也可选择 OCR 或视觉模型;视觉模型使用 API 配置中的「默认视觉模型」,未配置或调用失败时回退 OCR。不扩大历史扫描范围。同一自定义表情在本次训练中复用识别结果,不再单独选择模型或重复解读;无论是否识图,都会继续收集 TA 的高频表情及真实使用上下文,供克隆聊天选用。
训练语料以「图片内容」标记成功的识别/解读结果,并与本人直接发言区分;失败提示和筛图说明不会作为本人发言加入语料。
导出的独立 Bot 携带图片偏好、实际视觉模型、必要提供方配置和筛图开关快照,可在 Bot 控制台中修改。Bot 不依赖桌面进程;本地 OCR 与筛图使用共享 PP-OCR 引擎,模型由控制台主动下载,不复制桌面模型目录。纯文字与视觉聊天无需安装本地 OCR 原生依赖;需要本地 OCR 时在导出目录安装 sharp 与 onnxruntime-node,资源和推理失败会如实回报,不冒充已识别。
从消息列表「+ → 新建好友克隆」打开两步弹窗:
第 1 步:选好友(可多选)
带头像 / 昵称的列表,可搜索,点一行即勾选。选中多位好友后点「下一步」,会为每位好友各起一个克隆任务;会话列表的「添加会话 → 新建好友克隆」也能带已选好友直接进来。
第 2 步:配置
| 配置项 | 说明 |
|---|---|
| 聊天模型 | 必选 |
| 向量模型 | 可选(用于语义检索语料) |
| 图片处理偏好 | 图片与自定义表情统一选择文字占位、OCR 或视觉模型;视觉模式使用全局默认视觉模型 |
| 语料来源 | group = 私聊为主、不足时群补采风格;private = 纯私聊、不回退 |
| 名称 | 克隆体显示名(多选时禁用,各自沿用好友昵称) |
| 额外提示 | 追加给模型的人设说明 |
点「开始克隆」后,配置弹窗自动关闭,并打开统一任务列表;多选好友的任务会全部列出,构建在后台进行:
- 列表显示各项克隆的阶段、进度与结果,收起任务面板不会中断构建;
- 可以切换页面再回来,任务态仍在;克隆任务按账号隔离,仅保留在本次应用会话内;
- 构建完成后自动刷新消息会话列表与新建群聊中的克隆体选项,即使已切到其他页面也会更新。
克隆体人格
在克隆体会话的「设置 → 人格与画像」内点击「更新画像」,确认后使用最新聊天记录重新训练;删除整个克隆体集中在「克隆体管理」。 会话头部「样本 xx 条」后显示最近一次画像更新时间(北京时间),保存模型或提示等配置不会改变该时间。 更新沿用该克隆体当前模型与原训练范围;旧版克隆未保存训练范围时仅使用私聊。 语料会发送至配置的模型服务商,任务可在后台运行,并在「菜单 → 任务 → 当前任务」查看进度。 更新保留克隆体名称、配置、历史会话、记忆及群聊关系;失败时继续使用旧画像,可再次更新。
克隆体由后端从聊天记录里抽取人设:消息统计、风格摘要、语音占比、关系摘要、Top 词项,以及 更深的卡片信息(语气、性格、口头禅、标点习惯、称呼、话题等)。
「人格与画像」展示训练范围、画像与样本,并可编辑额外提示;「回复设置」集中管理聊天模型、生成参数、发言意愿与错别字。「对我的记忆」仅展示聊天中积累的关于你的记忆,不与克隆体画像混用。
模型、提示、发言意愿和语音配置自动保存,无需点击保存按钮。文本、数值和滑条停止编辑 500ms 后保存,选择项直接保存;切换分类或关闭前补交有效修改。状态区区分未保存、保存中、已保存与保存失败;失败保留输入并提供重试,关闭未保存成功时仍留在设置页。更新画像使用已保存的模型配置并立即启动后台任务,遗忘记忆、导出和删除仍需主动点击执行。
3. 和克隆体聊天
每个克隆角色或克隆群对应一段长期对话,打开后继续原历史:
- 旧版各段对话完整合并到对应长期对话,按原时间保留消息及原会话来源,不再提供分会话新建、选择或切换;后续消息继续写入同一段对话。
- 克隆私聊与群聊直接复用普通会话的同一页面模块,输入区、时间线、滚动、多选、右键菜单与记录搜索不再单独实现;克隆后端只适配会话、消息、发送及存储身份;
- 右上角沿用普通会话的搜索、消息、工具和设置结构;竖屏从更多菜单进入,没有可用子项的分组不可点击。设置分别打开「克隆体设置」或「克隆群聊设置」,群成员和整个群的管理在群设置内。
- 设置与普通会话使用相同的原位分类窗格。
- 深浅主题、主题色、聊天背景和装扮随共用页面生效;标题及消息头像保留克隆标识,不代表真实 QQ 消息;
- 克隆体的回复以流式逐段揭示,显示带克隆角标的源好友头像,并保留表情和合成语音;私聊不重复显示昵称,群聊显示发送者;
- 输入区支持文字发送、Enter 发送与 Shift+Enter 换行,中文输入法确认候选时不发送;群聊保留
@成员选择; - 输入框直接使用普通会话的编辑器和工具栏,支持系统表情、字符表情和颜文字;尚未适配的红包、通话、录音、图片文件、Ark 卡片及实时位置等入口保留并置灰,悬停说明限制,不向真实 QQ 发送;
- 消息右键或触屏长按提供复制和多选;多选底部操作栏与普通会话保持相同的常规动作和顺序,复制、导出和退出可用,分析、添加到素材库、转发、撤回与删除等尚未适配的功能仍显示为灰色,并提示暂不支持;不在右上角另设多选按钮,退出后保留输入草稿;
- 克隆和全部会话视图中,每个角色或群只显示一行。支持单项或多选永久删除,确认后删除对应角色或群及其数据,不进入已删除会话;正在生成的选中对象会先停止并等待写入结束。
4. 克隆体群聊
点 新建群聊,选择若干克隆体 + 「我」同处一室;会话列表的「添加会话 → 新建克隆体群聊」也会直接打开这个多选弹窗。
- 发一条消息 → 后端让「被 @ 或全部」克隆体各自回复;
- 每条回复经
account.onGroupChatEvent流式推来,按发送者分气泡逐条揭示; - @ 选择:输入
@弹出成员浮层,选中插入 @名字;发送时按文本里出现的 @名字 推出mentions; - 标题栏设置内「群成员」管理克隆体,移除前需确认;成员行的设置按钮可直接打开对应克隆体配置,关闭后返回原群设置,不切换到私聊。成员配置影响该克隆体的所有私聊和群聊,不是当前群的独立覆盖。
- 群资料侧栏和成员设置的「添加成员」均打开独立多选弹窗,可按克隆体名称或 QQ 号搜索;已在群内的成员默认勾选并置灰,不能取消。新勾选的成员在点击底部「添加」后统一提交,取消不修改群;部分添加失败时成功项锁定,失败及尚未提交的选择保留,重试不会重复添加成功项。
- 「群聊管理」管理整个群,删除会移除该群全部历史,但不删除成员对应的克隆体;不再保留子会话菜单。清空和删除仍需确认。
5. 导出机器人数据保护
导出的 OneBot 机器人在产物 data/ 目录保存对话、记忆、反思和关系。私聊产生的数据按机器人账号、 克隆体和实际对端隔离;真实群聊使用独立的群作用域。共享画像与训练样本仍用于扮演,私聊记忆不会注入其他私聊或群聊。
升级前已经混合保存的旧对话、记忆、笔记和关系仍保留在原文件中,但机器人不会猜测归属或自动注入新会话。 升级后各对端的长期记忆重新积累,桌面端已有克隆会话不受此隔离策略影响。
机器人只将不存在的存储文件视为空库;JSON 损坏、结构无效或无法读取时会拒绝启动并保留原件。 请先停机器人,修复文件或从可信备份恢复,再重启;不要直接覆盖损坏原件。 保存使用同目录临时文件与原子替换,失败会报错,不把未保存的变更当作已持久化。 后台记忆或反思保存失败会记录错误,不自动重发消息。目录同步在不支持的平台上仅尽力完成,不能保证所有断电场景。
机器人同一私聊或群聊按接收顺序处理,不同会话默认最多同时处理 4 个。等待队列默认总计最多 256 条、 每个会话最多 32 条;超限消息不会受理,控制台明确告警,不会静默记成已排队。 可在导出产物 config.json 的 queue 中设置正整数 maxConcurrentChats、maxQueuedMessages 和 maxQueuedPerChat。 停止或重载会取消当前请求、清空等待消息并停止后续分条发送;已经提交给 OneBot 的发送不能撤销,未知结果不会自动重发。 新导出的入口收到 Ctrl+C(SIGINT)或 SIGTERM 时会等待收尾再退出;强制终止或断电不具备此保证。
克隆训练的模型日志与推荐回复共用展示方式:正文流式累计,完整 JSON 在生成结束后自动缩进并高亮,推理输出可折叠,支持查看和复制原文。生成中或截断的内容保留原样;训练日志仍只保留有界的最近输出。
聊天、向量及画像提炼请求默认总期限为 3600 秒(1 小时),包含流式/非流式响应正文读取。慢模型可在提供方配置中设置 timeoutMs(1–2147483647 毫秒的整数);导出时保留该值,独立机器人也可直接修改 config.json 的 llmProviders[].timeoutMs。 该字段是高级配置,当前没有新增界面控件;省略时使用默认值,修改已有提供方的其他字段不会清除已保存的期限。 超时记为失败、主动停止记为取消,两者都不代表模型服务端未执行或未计费。
机器人普通日志仅保留会话类型、实例内脱敏关联标识、状态、长度、数量和耗时,不记录原始对端、昵称、正文、 生成回复或模型错误正文。日志时间为北京时间;脱敏标识在重启或重载后更换,不作为持久身份。 确需临时排障时,可在 config.json 设置 logging.debugContentUntil 为未来 30 分钟内、明确带时区的 ISO 截止时间, 如使用 +08:00 标记北京时间。开启时会警告,正文及错误详情单条最多 512 字符;日志可能包含隐私,请勿分享。 到期自动关闭,系统时钟回拨也不能延长已开启窗口;停止立即关闭旧实例的调试,重载或重启不延长原截止时间。 删除该字段后重载也可关闭;过期字段按关闭处理。本改动不删除历史控制台、容器或系统日志。
名片与群资料栏
克隆会话中点击消息头像、昵称或顶部名称可以查看名片。名片沿用普通好友与群聊的展示, 但不提供联系人页展开按钮。名片展示克隆体自身的名称、头像、本地 ID 和克隆标识,不查询或展示 源好友的 QQ 号、UID、生日、签名等个人资料;源好友头像仅作为克隆头像沿用。 可用按钮沿用「查看消息」「预览消息」等名称,打开的都是本地克隆会话;ID 支持复制。 克隆群聊的右侧群资料栏支持查看成员、搜索名称、点击成员查看名片及折叠展开,成员头像以图标标识克隆身份,不额外添加文字标签, 窄屏可从会话更多菜单的「工具 → 群聊侧栏」打开。尚未适配的公告、精华、文件、相册等 QQ 群能力不在克隆群栏中显示。 成员头像和边栏成员支持同样的右键菜单,可「@Ta」或「踢出群聊」。移除前会确认,仅移出当前群, 不会删除克隆体及其私聊记录;自己不能被移除,群回复中或旧记录只读时不可移除。未适配的「戳一戳」保留置灰。
6. 使用量
「设置 → AI 功能 → API 用量」统一展示助手、克隆及其他 AI 功能的请求与已知 token,按功能和 服务商/模型列出明细,支持时间范围与趋势指标切换。功能用量先展示业务大类的汇总,点击可展开具体用途: 例如「克隆会话 → 表达风格库/画像卡/对话生成」,「WeQ 助手 → 对话生成/会话标题/上下文摘要」。 图片分析、语音合成等共用能力按实际调用业务归类,同一次请求不会在多个功能中重复计数。 旧记录在读取时归类,不改写原账本;无法确认业务来源的旧语音、图片记录保留在语音服务、图片识别中, 未知用途保留原名。小类过多时分页展示。克隆体明细按需展开,旧克隆被删除后也不会 从用量中消失。统计范围、未知用量与记录保留规则见设置。
下一步 → WeQ 助手
