feat(channelbridge): 群聊静默窗口合并与回合中续跑（M23）
主人 2026-10-23/24：「要让群聊聊天很自然，很流畅的做法」。群里「一鼓作气打三句」 此前会让她回三次；本片在**每会话车道头部**加一段静默等待，把这几句合成**一轮**回答 （批内每条仍是独立的一条消息，design/15 §2.1 不许拼成一条）。 四条不可走样： - 🔴 主人私聊**结构性**无窗口：车道分 `newDirectLane`（无 batcher 字段、拿不到定时器 工厂）与 `newBatchLane`，类型由 actor 元数据（IsOwner() && !IsGroupChat()）决定， 配置无权翻转； - 🔴 窗口内零丢失：唯一容器是车道队列（takeAll 单消费者取出），合并阶段无新增丢弃点 （CoalescedDroppedTotal 恒 0）；超单批上限的**尾部回插队首**保序、锁内、发车前； - 🔴 一条批 = 一个 turnID = 一次 loop.Run = 一条助手回复； - 🔴 不改「回什么」：闸门仍逐条跑（prepareInbound 逐字搬运 M22 的 processFrom）， 被静默的消息进不了批。 实现落点： - lane.go：direct/batch 两种车道 + front（回插队首）+ takeAll + 停机诚实登记； - coalesce.go：生效参数解析、滑动窗口 + 绝对上限等待、发车原因与计数； - coalesce_lane.go：攒批 → 拆分 → 陈旧度/闸门 → 发车； - coalesce_prepare.go / coalesce_batch.go：processFrom 拆成 prepareInbound + runBatch； - runtimeconfig/channels_coalesce.go：$DATA_DIR/config/coalesce.json（零新 .env 键）； - gateway/admin_coalesce.go：GET/PUT /api/v1/admin/channels/coalesce（三态补丁 + writeAuth + 审计 channels.coalesce + 热生效），routes.go 两行注册（塔已批）； - 前端：渠道总览页一张卡（六个旋钮；主人私聊只给只读说明，不给开关）。 M22 既有用例仍在（lane_test.go 夹具显式关窗以钉住车道本身）；stranger_test.go 的那条 按塔裁定 #4 改写：「已有回合在跑 ⇒ 只登记不回」变成排队回答（留 WARN，绝不静默）。 回归：go build/vet/test ./... 全绿；三包 -race 全绿；前端 tsc --noEmit + npm run build + 渲染测试 36 项通过。不 push、不重启后端、未改 .env 与 Docs/。
This commit is contained in:
AskaEth committed
1 parent
679c8abf1d
commit
ca8577f05b
21 files changed
+3616
-244
No files matched your search
@@ -3,7 +3,6 @@ package channelbridge
|
||||
import (
|
||||
"context"
|
||||
"errors"
|
||||
"strings"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/channel/adapter"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/channel/session"
|
||||
@@ -115,109 +114,20 @@ func (b *Bridge) process(ctx context.Context, msg adapter.UnifiedMessage) {
|
||||
b.processFrom(ctx, msg, b.adapter(msg.Platform))
|
||||
}
|
||||
|
||||
// processFrom 针对指定的账号适配器运行完整入站流水线：
|
||||
// 解析会话/actor、应用允许/拒绝黑白名单、以聊天文本
|
||||
// 驱动 agent 循环，并把循环的回复经接收该消息的同一
|
||||
// 适配器送回去。身份由会话层结构化解析；
|
||||
// 桥接器绝不读取消息内容来判定发送者是谁
|
||||
// （项目红线）。
|
||||
// processFrom 针对指定的账号适配器运行完整入站流水线：逐条过闸门（prepareInbound）
|
||||
// 然后跑**一条**回合（runBatch）。身份由会话层结构化解析；桥接器绝不读取消息内容来
|
||||
// 判定发送者是谁（项目红线）。
|
||||
//
|
||||
// 它是**同步**便捷路径（`process` 与测试用）。真实的渠道入站走车道
|
||||
// （enqueueInbound → laneWorker → prepareInbound + runBatch），因为只有车道能提供
|
||||
// 「同一会话串行」与「静默窗口合并」这两件事。
|
||||
func (b *Bridge) processFrom(ctx context.Context, msg adapter.UnifiedMessage, a adapter.PlatformAdapter) {
|
||||
// 语音 → 文本归一是入站流水线的**第一件事**（切片 IM-ASR；design/06 §1.1）：
|
||||
// 它必须在「丢空判据」之前发生，否则 telegram 的纯语音（无 caption ⇒ Content
|
||||
// 为空）会在下面被整条丢掉。归一写回 msg.Content 之后，最小打扰判定、落库与
|
||||
// 模型可见消息看到的都是**同一份**文本（转写结果，或一行诚实的失败提示）。
|
||||
//
|
||||
// 它同时给出这条语音的**来源与三态结论**（切片 CODE-VOICE；design/24 §10.2 第 2 步），
|
||||
// 由本函数的调用方一路带到闸门之后的落副本步与落库步 —— 结论与正文同源，绝不重算。
|
||||
inboundVoice := b.normalizeInboundVoice(ctx, &msg)
|
||||
|
||||
// design/12 §6 策略一补充：系统通知在进入任何下游之前先过「传入前审查」——
|
||||
// 归一化 → 剥离异常字段 → 分类 → fail-safe。被判为可忽略（或畸形/未识别）的
|
||||
// 事件只登记、绝不驱动 loop；被放行的事件已就地换成**剥离后的安全文本**，
|
||||
// 继续走常规流水线（限定注入 / 升级真会话）。
|
||||
notice := b.preEntryReview(ctx, &msg, a)
|
||||
// design/26 §4/§5（切片 E3）：**渠道事件留存**的唯一插入点。
|
||||
//
|
||||
// 位置说明（与 §5.1 示意图的一行之差）：preEntryReview **就是**那一步归一化
|
||||
// （它调用适配器的 SystemNoticeNormalizer 并净化 SafeText），把 recordEvent 放在
|
||||
// 它之后一行可以**只归一化一次**，并且 §9.2 第 2 条要求把 NoticeClass 的裁决结果
|
||||
// 记进日志 —— 那只有这一行之后才有结论。关键性质不变：留存**无条件**，在任何
|
||||
// 早退分支（仅登记 / 静默 / 升级）之前，且**绝不**决定 loop 走不走。
|
||||
b.recordEvent(ctx, msg, a, notice)
|
||||
if notice.Applicable && !notice.Proceed {
|
||||
b.registerNoticeOnly(ctx, msg, a, notice)
|
||||
item := laneItem{msg: msg, a: a, arrivedAt: b.now()}
|
||||
p, ok := b.prepareInbound(ctx, item)
|
||||
if !ok {
|
||||
return
|
||||
}
|
||||
|
||||
text := strings.TrimSpace(msg.Content)
|
||||
// 无文本且无**任何可用媒体** ⇒ 没有可处理的内容。带附件的「纯文件消息」、带语音的
|
||||
// 「纯语音消息」与带图片的「纯图片消息」（微信/QQ 发图常常没有配文）必须继续往下走：
|
||||
// 附件/语音/图片就是它的内容（design/24 §4.4 的「不许静默丢」；语音那一路的归一已
|
||||
// 保证它要么有文本、要么有诚实提示，图片那一路的失败也留一行中文诚实提示）。
|
||||
if text == "" && !hasUsableMedia(msg) {
|
||||
b.log.Debug("inbound message has no chat text, skipped",
|
||||
"platform", msg.Platform, "channel", msg.ChannelID)
|
||||
return
|
||||
}
|
||||
|
||||
// design/16 §4.6 §6：黑白名单在流水线的最前端执行，
|
||||
// 早于会话解析与循环驱动，因此被拉黑或不在白名单的
|
||||
// 群/用户消息绝不会到达 LLM。
|
||||
// 主人始终放行（由解析出的 actor 结构化决定）。
|
||||
actor := session.ResolveActor(msg, b.owner)
|
||||
if !actor.IsOwner() && b.blacklistDrop(msg, a) {
|
||||
return
|
||||
}
|
||||
|
||||
sess, err := b.sessions.GetOrCreate(ctx, msg, b.owner)
|
||||
if err != nil {
|
||||
b.log.Warn("session resolve failed", "platform", msg.Platform,
|
||||
"channel", msg.ChannelID, "error", err)
|
||||
return
|
||||
}
|
||||
|
||||
b.log.Debug("inbound → session",
|
||||
"platform", msg.Platform, "channel", msg.ChannelID,
|
||||
"session", sess.SessionID, "actor_role", sess.ActorRole,
|
||||
"env", sess.Env(), "mem_writable", sess.MemWritable)
|
||||
|
||||
// design/12 §6 策略一/二 + design/18 §11「乙 = C」（主人 2026-10-13 裁决）：
|
||||
// owner 车道不再**无条件短路**这道闸 —— 主人群消息也按结构化判据决定说不说。
|
||||
// - 主人**私聊/非群**：恒回，不受影响；
|
||||
// - 主人**群聊**：只有指向她本人的（@她 / @全体 / 未接线渠道旧判据）才必回，
|
||||
// 其余**仍进上下文但不触发回复**（落进该群隔离会话，见 ownerlane.go）；
|
||||
// - 非主人：走既有的最小打扰分级（shouldRespond）。
|
||||
// 被拦下的消息只登记到其隔离会话日志并静默——绝不驱动完整 agent 循环。
|
||||
//
|
||||
// 由「传入前审查」放行的系统通知（notice.Applicable）不在此列：它们已由策略一
|
||||
// 的归一化/分类**终局判定**（高价值升级真会话、其余限定注入），若再走这道面向
|
||||
// 聊天消息的闸门，actor=system 会在 isLowValueEvent 处被第二次静默掉。
|
||||
if !notice.Applicable {
|
||||
if ok, reason := b.shouldRespond(ctx, msg, actor, sess, a); !ok {
|
||||
b.registerSilenced(ctx, msg, actor, sess, a)
|
||||
b.log.Debug("inbound message silenced (minimal disturbance)",
|
||||
"platform", msg.Platform, "channel", msg.ChannelID,
|
||||
"session", sess.SessionID, "actor_role", actor.Role, "reason", reason)
|
||||
return
|
||||
}
|
||||
}
|
||||
|
||||
// 裁决①的第二个流控（主人 2026-10-05）：陌生人私聊虽然一律回答，但
|
||||
// **同一发送者同时最多 1 个在跑的回合**。槽位复用同一个 flowgate 的
|
||||
// 会话计数（AcquireTurn/ReleaseTurn，键口径与限流一致）；已有回合在跑时
|
||||
// 这一条只登记、不回，并留可见告警 —— 一个陌生人无法用并发消息占满循环。
|
||||
if isStrangerPrivate(sess) {
|
||||
if gate := b.gateFor(a); gate != nil {
|
||||
if !gate.AcquireTurn(msg) {
|
||||
b.registerThrottled(ctx, msg, actor, sess, a,
|
||||
"stranger private: a turn is already running for this sender")
|
||||
return
|
||||
}
|
||||
defer gate.ReleaseTurn(msg)
|
||||
}
|
||||
}
|
||||
|
||||
b.runInboundTurn(ctx, msg, a, text, actor, sess, inboundVoice)
|
||||
b.runBatch(ctx, []preparedInbound{p})
|
||||
}
|
||||
|
||||
// blacklistDrop 对非主人消息应用黑白名单，返回
|
||||
@@ -260,99 +170,6 @@ func inboundTargetFor(sess session.Session, platform string) inboundTarget {
|
||||
return inboundTarget{sessionID: sess.SessionID}
|
||||
}
|
||||
|
||||
// runInboundTurn 为被放行的消息驱动 agent 轮次：解析
|
||||
// 路由目标、把消息携带的文件类附件**落库并挂成文档部件**
|
||||
// （design/24 §3；切片 M1）、把图片媒体内联成 data: URI 部件挂上既有视觉链路
|
||||
// （切片 IM-IMG；design/24 §4.2 末）、把那条被归一过的语音的**可播副本**落盘并
|
||||
// 产出 `voice` 引用（design/24 §10.2 第 4 步；切片 CODE-VOICE）、构建模型可见的
|
||||
// 消息列表（再前置**该会话自己**最近的历史转录：主人私聊取主会话、群聊/陌生人取
|
||||
// 该隔离会话，见 transcript.go），在轮次之前持久化入站
|
||||
// 用户消息**连同它们的 `document` 引用列、`image` 列与 `voice` 列**（因此即使渠道
|
||||
// 回复失败它也已落地，客户端也有附件芯片、图片与 🎤 可看），并在轮次之后把抽取结论
|
||||
// 补回同一 document 列，运行循环并把结果交给 deliverReply。
|
||||
//
|
||||
// voiceTurn（切片 CODE-VOICE）是那条语音的归一结论 —— **只在放行之后**才可能落副本：
|
||||
// 被黑白名单或最小打扰拦下的语音，盘上不留任何文件（与附件同一纪律）。
|
||||
func (b *Bridge) runInboundTurn(ctx context.Context, msg adapter.UnifiedMessage, a adapter.PlatformAdapter,
|
||||
text string, actor adapter.Actor, sess session.Session, voiceIn voiceTurn) {
|
||||
target := inboundTargetFor(sess, msg.Platform)
|
||||
|
||||
// 入站附件摄取留在**闸门之后**（本函数只在消息被放行后调用）：被黑白名单或
|
||||
// 最小打扰拦下的消息绝不在盘上留下文件。成功者挂成文档部件，装配期
|
||||
// resolveDocuments 照既有链路抽取/注入；读不到的走诚实提示。
|
||||
attachments := b.ingestInboundDocuments(ctx, msg)
|
||||
// 语音副本落盘与附件摄取**并列**、同处闸门之后：不可播的格式先转码（复用
|
||||
// internal/capability/transcode 的既有能力），转码不可用就**不落副本**并如实记分类。
|
||||
// 它拿到的字节是**原始字节**（转写早已在流水线最前端用同一份原始字节做完）。
|
||||
voiceRef := b.ingestInboundVoiceCopy(ctx, msg, voiceIn)
|
||||
// 图片内联与文档摄取**并列**、互不影响：文档走存储与抽取，图片走 data: URI 部件
|
||||
// （同一条用户消息上两条都能挂）。它没有 ctx —— 这里没有任何 I/O（字节由适配器取回）。
|
||||
images := b.ingestInboundImages(msg)
|
||||
|
||||
// 本回合的**权威 turn id**：IM 车道没有编排器，桥接器自己就是这条车道的回合
|
||||
// 权威（turnid.go）。它在落库**之前**生成，因此同一次入站回合的用户消息、助手
|
||||
// 回复带上的是同一个值，前端按 (sessionId, turnId) 两级分桶时才分得进同一个回合
|
||||
// —— 这正是此前缺口所在：IM 的落库行没有 turn id，任何消费方都无法判定「这条
|
||||
// 回复属于哪个回合」。它同时挂到 loop ctx 上，使循环发出的流帧与历史行同源。
|
||||
turnID := newTurnID()
|
||||
|
||||
// 第三方边界只在受限（群聊/陌生人）上下文中生效：
|
||||
// 记忆只读（MemWritable=false），并携带发送者名，
|
||||
// 使 agent 能看到是谁在说话（design/16 §4.6 §1-2）。
|
||||
// 谁算主人、谁算第三方由解析出的 actor 结构化决定——绝不
|
||||
// 依据提示词文本。主人本人的发言**不带**发送者名（主人从不被标注）：
|
||||
// 受限会话里「带昵称的 user 消息 = 第三方」「不带昵称的 = 主人本人」
|
||||
// 就是模型侧的归属判定车道（loop/attribution.go），落库也走同一个值 ——
|
||||
// 否则转录会把主人的历史发言读成第三方人员说的。
|
||||
//
|
||||
// 该轮以哪个角色说话遵循 design/22 §2/§7-3/§7-4：主人私聊
|
||||
// 镜像进主会话时取主会话的绑定，否则取账号的
|
||||
// 渠道级绑定，再否则取全局默认；群聊或
|
||||
// 陌生人会话强制使用默认角色。
|
||||
runEnv := turnEnv(sess, target, b.resolvePersona(ctx, sess, target, adapterName(a)))
|
||||
senderName := thirdPartySenderName(msg, actor)
|
||||
loopMsgs := b.buildLoopMessages(ctx, text, runEnv, actor, senderName, msg)
|
||||
// 附件/图片先挂到**本回合的**用户消息上（attachInboundContent 认列表里第一条
|
||||
// RoleUser），再前置历史转录 —— 顺序反过来会把附件挂到转录里的旧用户消息上。
|
||||
attachInboundContent(loopMsgs, attachments, images)
|
||||
loopMsgs = b.seedTurnTranscript(ctx, target, loopMsgs)
|
||||
|
||||
// 只把部件挂在内存里的模型可见消息上，客户端读到的那条消息就是一片空白 —— 附件芯片
|
||||
// 只认 `document` 列，图片只认 `image` 列（**图片绝不进 `document` 列**），🎤 只认
|
||||
// `voice` 列。这里写的是引用与身份，文档结论要等回合跑完（下一段）。
|
||||
document := b.inboundDocumentColumn(msg, attachments)
|
||||
image := inboundImageColumn(images)
|
||||
|
||||
// 主人私聊消息落在 Web 主会话并广播给 Web 客户端；
|
||||
// 受限消息落在其隔离会话（适配器日志页），
|
||||
// 以 `channel_persisted` 事件广播（绝不进入
|
||||
// 主/`web` 会话或 Web 聊天）。
|
||||
// 无论有没有文本都要落库：附件/图片就是纯媒体消息的内容（design/24 §4.4）。
|
||||
var userMsg history.Message
|
||||
if target.private {
|
||||
userMsg = b.persistToMain(ctx, history.RoleUser, text, "", document, image, target.platform, deviceIDFor(msg), adapterName(a), turnID)
|
||||
} else {
|
||||
userMsg = b.persistIsolated(ctx, history.RoleUser, text, document, image, deviceIDFor(msg), sess, msg.Platform, senderName, adapterName(a), turnID)
|
||||
}
|
||||
// 语音事实与用户消息**同源落库**（design/24 §10.2 第 5 步）：写进刚落的那一行，
|
||||
// 客户端因此能按结构化字段显示 🎤 与播放控件（绝不从正文里认媒体类型）。
|
||||
b.persistMessageVoice(userMsg, voiceRef)
|
||||
|
||||
res, err := b.run.Run(loop.WithTurnID(loop.WithSessionEnv(ctx, runEnv), turnID), target.sessionID, loopMsgs)
|
||||
if err != nil {
|
||||
b.log.Warn("agent run failed", "platform", msg.Platform,
|
||||
"session", target.sessionID, "error", err)
|
||||
}
|
||||
// 抽取结论（status/chars/truncated/reason）只能在回合跑起来之后才有，这里按
|
||||
// 服务端存储名把结论补回刚落库的那一行（design/24 §6.1 的两段式，与 Web 侧
|
||||
// gateway/session_document_status.go 同一口径）。
|
||||
b.persistTurnDocumentStatus(userMsg, res)
|
||||
// 出错也交给 deliverReply：回合不能因为「模型那边出了问题」就对用户静默
|
||||
// （空回复 / 轮次用尽 / 内部报错都落一条诚实的可见回复；被取消的回合除外，
|
||||
// 见 turnreply.go）。
|
||||
b.deliverReply(ctx, msg, a, sess, target, res, err, turnID)
|
||||
}
|
||||
|
||||
// deliverReply 解析本回合的可见回复、持久化并经接收该消息的适配器
|
||||
// 送回去。可见回复由 turnVisibleReply 给出（turnreply.go）：真实文本逐字，
|
||||
// 空回复 / 轮次用尽 / 安全网终止 / 内部报错则是按原因区分的中文诚实说明 ——
|
||||
@@ -360,7 +177,7 @@ func (b *Bridge) runInboundTurn(ctx context.Context, msg adapter.UnifiedMessage,
|
||||
// （adapter.ErrUnsupported）只按 debug 级跳过，不算失败：回复
|
||||
// 已在历史存储中落地。
|
||||
//
|
||||
// turnID 是这次入站回合的权威标识（见 runInboundTurn）：助手回复与刚落的用户消息
|
||||
// turnID 是这次入站回合的权威标识（见 coalesce_batch.go 的 runBatch）：助手回复与刚落的用户消息
|
||||
// 传同一个值，落库后两条行同属一路，客户端据此配对「回复 ↔ 提问」。
|
||||
func (b *Bridge) deliverReply(ctx context.Context, msg adapter.UnifiedMessage, a adapter.PlatformAdapter,
|
||||
sess session.Session, target inboundTarget, res *loop.Result, runErr error, turnID string) {
|
||||
|
||||
Reference in new issue
Block a user