Skip to content

统一会话页与助手运行 ​

页面契约 ​

普通私聊、临时会话、群聊、数据线、克隆私聊、克隆群聊、频道私聊、WeQ 助手、公众号及服务号均由同一个 ChatPane 绘制完整会话页。来源适配器负责查询、身份投影、发送和运行控制,不提供另一套标题栏、消息循环或编辑器。

共用部分包含标题栏、虚拟时间线、消息行与气泡外层、右键菜单、多选栏、输入区、滚动条、分页触发和定位。Markdown、工具过程、QQ 富消息及生成文件通过正文渲染器扩展。名片内预览、搜索结果、缺口消息和转发查看器仍保持各自的局部查看用途。

源码入口:ChatPane、只读来源适配器、助手适配器。

来源能力 ​

  • 频道私聊、公众号和服务号不提供发送能力,平时收起输入区,多选时显示共用操作栏。
  • 克隆和助手复用共用编辑器;添加图片与编辑工具集中展示,附件与上传状态按需展开。助手模型与思考等级在宽处同行、窄处分层。
  • AI 来源不适用的 QQ 操作不显示;可恢复的临时不可用项保留原因。不能把本地生成身份、appId、nodeId 或设备伪 UID 当作普通好友处理。
  • 标题资料使用现有来源字段。没有可编辑项时不提供空设置页,也不伪造好友关系或在线状态。
  • 分页通过 onLoadOlder、onLoadNewer 回调触发,宿主通过 onTimelineElement 接收当前消息列表元素,不查找其他页面的消息 DOM。
  • 已缓存的气泡沿用 withMessageBubbles → seedMessageBubbles → MessageBubble 链路,预热不等待解码、不延迟正文发布。

只读来源 ​

readonlyConversationPage 接受公众号 peerUid 或服务号 appId,支持最新页、历史游标、新消息方向和消息锚点,默认每页 50 条。游标复用数据库的序号、发送时间与消息 ID 组合,保留重号、零/NULL 序号和负消息 ID。

目录、完整消息页、媒体扫描和正式导出不再仅保留 Ark;文本、图片、混合元素、无 prompt 的 Ark 及未知元素都不应因此消失。listOfficialAccountArkFeed、listServiceAccountArkFeed 仍保留旧接口语义,完整会话不调用它们。

searchReadonlyConversation 在实际来源中分页检索,不能用前端已加载窗口代替完整记录。精确导出冻结来源和消息 ID;服务号使用 appId 分区,频道使用 nodeId,不能退化为普通私聊导出。

助手设置 ​

设置为应用级共享值,不提供账号、设备或会话覆盖。输入区只保留模型、思考等级快捷选择;运行中发送行为只在助手设置中配置默认值,输入区不提供逐条模式选择。

分类参数初始默认
模型与生成模型、思考等级、温度、单次输出 Token 上限跟随默认模型、不指定、0.3、模型默认上限
任务执行最大推进轮数、单工具超时、任务总时限24 轮、60 秒、600 秒
上下文管理带入历史条数、上下文预算、压缩触发/目标比例、摘要上限12 条、32768 Token、70%/50%、1500 Token
提示与工具运行模式、额外提示词、外部 MCP沿用已有配置
图片处理OCR/视觉模型偏好沿用已有偏好
运行中发送立即补充、下一步补充、排队发送立即补充

任务轮数和时限可以选择“不限制”;输出上限的“跟随模型”表示不设置该上限。单次输出上限也约束标题和摘要请求,摘要同时受专用摘要上限约束。压缩目标必须低于触发比例,摘要长度必须低于上下文预算。

模型配置可声明 reasoningEfforts。具体档位显示请求原始字符串,未声明时提供“不指定、low、medium、high”;不指定(off)表示不传 reasoning_effort,不等同于保证模型不思考。所选模型不可用时保留引用并提示,不静默换模型。参数回退必须依据服务端明确指出不支持的参数,不能把其他 400 错误当作思考参数不兼容。

服务商配置读取当前端点的模型元数据,能力分别保留支持/不支持/未知。metadata.reasoning.controls 区分 effort、toggle、budget、adaptive,并保存原始值、默认值与来源字段;metadata.raw 保留扩展对象。原生 think、LM Studio、Claude 等控制不因档位同名就直接作为兼容 API 的 reasoning_effort;没有适用的命名档位时使用显式空列表,避免下游补出默认三档。overrides 记录手动修改字段,异步回填不覆盖这些值;换模型或端点时清除旧自动结果。元数据查询不发推理,缺失项按批次一次确认后才发送合成探测,成功但无法证明参数生效的结果仍保持未知。

助手与克隆体设置均自动保存:选择项即选即存,文本、数值及滑条停止输入 500ms 后保存,失焦、切分类和关闭前补交有效修改。每个设置对象串行合并补丁,成功回执只确认发出时的快照,在途新输入进入下一批。失败保留输入并可重试,关闭补交失败时不关闭面板;无效输入不提交。恢复默认仅影响当前字段,不增加手动冲突选择或覆盖确认。

代码高亮在引擎和语言加载期间同步返回完整原文,所有等待同种语言的代码块均订阅完成通知;加载失败保留纯文本。消息修订后忽略旧版本的异步高亮结果,复制始终使用原始代码。

独立任务启动或显式继续时固定有效配置,包括实际解析出的模型端点、生成参数、提示、任务与上下文参数、MCP 和图片策略。当前任务不受后续配置更新影响;同一任务内的补充沿用原快照。发送行为默认值控制消息受理方式,由宿主在新消息提交时读取;重试沿用首次受理的实际模式。

三种发送行为 ​

默认行为运行中收到消息时
立即补充中断当前模型请求;正在执行的工具先收尾,尚未开始的同批调用跳过,再带补充继续当前任务
下一步补充不中断当前模型调用及对应工具批次,在下一步模型调用前加入当前任务
排队发送当前任务正常完成后,按顺序启动下一项独立任务,启动时读取最新参数

运行时可以编辑输入和准备图片,发送与停止同时存在。停止意图不依赖 runId 已返回,不能因创建会话或提交尚未响应而失效。

补充后的记录按时间分段:已有回答片段、用户补充、后续回答各有稳定消息 ID,并关联同一任务。不保留没有正文或过程的空片段。流式占位不进入正式导出选区。

过程默认运行时展开、完成后收起;手动调整的状态优先。工具调用与结果配对展示,参数和结果可以展开、复制;计划、笔记、文件仍作为正文内容渲染。失败和停止状态保留在对应回答中,有真实恢复点才提供继续,否则可以重新编辑消息,不自动从头重跑任务。

队列与恢复 ​

队列持久化在所属账号与数据源的助手目录,按会话隔离。可以编辑、取消和调整待执行顺序;幂等请求 ID 防止重试重复受理,取消后的回执也不会把消息重新入队。

正常完成后继续下一项;手动停止、外部取消或失败后暂停并保留队列。重开应用或账号后不自行执行。用户可以继续当前任务并恢复队列,或跳过当前任务执行下一条。

提交、队列查询/编辑和控制接口绑定账号及数据源。事件携带 sessionId、runId、messageId、taskId 和来源标识,队列启动后无需前端代发请求。切换界面不停止宿主任务,也不要求保留隐藏聊天 DOM。

工具执行前后保存检查点;恢复使用已确认的结果,不重发已开始且终态未确认的调用。清空内容与永久删除会话保持区别,均等待对应任务写入收尾,再移除相应历史、断点和队列,不影响其他会话。

定向回归 ​

bash
pnpm --filter @weq/service exec vitest run test/assistant_unified_runtime.test.ts test/assistant_api_usage.test.ts test/readonly_conversation.test.ts test/feed_export.test.ts
pnpm --filter @weq/desktop exec vitest run test/unified_conversation_contract.test.ts test/guild_direct_selection.test.ts test/clone_conversation_ui.test.ts test/conversation_switch.test.ts
node apps/desktop/test/browser/run-unified-conversation.mjs

浏览器夹具使用合成消息和模拟接口,不连接真实 QQ 数据库。复用现有 Playwright 环境;可通过 WEQ_PLAYWRIGHT_IMPORT、WEQ_BROWSER_EXECUTABLE 指定已有运行时,通过 WEQ_STYLE_ARTIFACTS 保存截图。验证应覆盖所有来源、桌面/窄屏、深浅主题、只读多选、长 Markdown、设置保存及运行中发送默认值,而不只检查静态源码或最终截图。

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准