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:
1 parent
679c8abf1d
commit
ca8577f05b
21 files changed
+3616
-244
No files matched your search
@@ -23,6 +23,7 @@ import (
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/capability/transcode"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/channel/adapter"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/channel/session"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config/runtimeconfig"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/logger"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/documents"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/events"
|
||||
@@ -148,6 +149,13 @@ type Options struct {
|
||||
// 就丢弃不补答(WARN + 计数 + 审计,绝不静默)。零或负数取
|
||||
// defaultLaneStaleAfter(那里写了取值依据)。主人私聊与非聊天事件不受该闸约束。
|
||||
LaneStaleAfter time.Duration
|
||||
// Coalesce 是**静默窗口合并**(M23)的注入面:按车道键取生效窗口参数 +
|
||||
// 可注入的定时器工厂。零值 = 走代码默认(群聊窗口 2.0s / 绝对上限 6s / 单批 24 条),
|
||||
// 也就是「装配方忘了接线也有合理行为」,而不是把特性静默关掉。
|
||||
//
|
||||
// 🔴 它**不能**改变车道类型:主人私聊永远是 direct 车道(无窗口、无定时器),
|
||||
// 由 actor 元数据决定,配置无权翻转(见 lane.go 的 newDirectLane/newBatchLane)。
|
||||
Coalesce CoalesceOptions
|
||||
// OwnerLaneFor 是 owner 车道结构化旋钮(design/18 §11「乙 = C」)的**读取**接缝:
|
||||
// 按 (platform, groupID) 返回该群生效的参与策略,返回 nil 表示没有覆盖
|
||||
// (桥用自己的默认档:不对她说就不开口)。为 nil 时全部走默认档 + 桥内内存覆盖。
|
||||
@@ -338,6 +346,13 @@ type Bridge struct {
|
||||
// 读循环只投递不跑回合;同一会话内串行 FIFO、不同会话并行;超龄与背压丢弃都留痕。
|
||||
// 只在 enqueueInbound 里与 mu 同时出现,锁顺序恒为 mu → lanes.mu。
|
||||
lanes *laneSet
|
||||
// coalesceFor 是静默窗口参数(M23)的读取接缝(面板配置文件 → 生效值);
|
||||
// coalesceLog 是窗口引擎的子功能日志器(source=services/channelbridge/coalesce);
|
||||
// coalesceStats 是窗口/发车/续跑的计数面(CoalesceStats() 的只读出口)。
|
||||
// 三者的类型与语义见 coalesce.go;它们只被 batch 车道的头部用到。
|
||||
coalesceFor func(laneKey string) *runtimeconfig.CoalescePolicy
|
||||
coalesceLog *slog.Logger
|
||||
coalesceStats *coalesceCounters
|
||||
}
|
||||
|
||||
// New 依据 opts 构建 Bridge。当必需依赖缺失时返回错误,
|
||||
@@ -414,6 +429,11 @@ func New(opts Options) (*Bridge, error) {
|
||||
cancel: func() {},
|
||||
sem: make(chan struct{}, maxConcurrent),
|
||||
// 每会话车道:深度与陈旧度阈值可经 Options 覆盖(零值取 lane.go 里的默认值)。
|
||||
lanes: newLaneSet(opts.LaneDepth, opts.LaneStaleAfter, log),
|
||||
// 定时器工厂来自 Options.Coalesce.After(M23 测试缝);direct 车道拿不到它。
|
||||
lanes: newLaneSet(opts.LaneDepth, opts.LaneStaleAfter, opts.Coalesce.After, log),
|
||||
// 静默窗口合并(M23):参数读取接缝 + 独立日志来源 + 计数面。
|
||||
coalesceFor: opts.Coalesce.For,
|
||||
coalesceLog: logger.WithSource(log, coalesceLogSource),
|
||||
coalesceStats: &coalesceCounters{},
|
||||
}, nil
|
||||
}
|
||||
Reference in new issue
Block a user