Files
Cyrene_v2/internal/services/channelbridge/transcript.go
T
AskaEth 9b903a89bc
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
feat(runtime): IM 主人私聊补历史转录(与 Web 主会话同源:抽共享 transcript 包 + OwnerEnvFor 单入口)
2026-10-05 11:36:18 +08:00

62 lines
3.5 KiB
Go

package channelbridge
import (
"context"
"git.yeij.top/AskaEth/Cyrene_v2/internal/channel/session"
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/loop"
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/model"
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/transcript"
)
// 本文件让 IM 的**主人私聊**回合与 Web 主会话回合的环境逐项一致(主人 2026-10-05 要求:
// 处理其他平台的主人消息时和主会话环境完全一致)。
//
// 三条环境在 loop.SessionEnv 上早已一致(ActorEnv=owner、MemWritable=true、PersonaID 取
// 主会话绑定,design/22 §7-3),缺的是**历史转录**:Web 主会话回合由编排器播种该会话最近
// N 条转录(gateway/session_transcript.go),而 IM 回合此前只有「来源系统行 + 当次消息」。
// 于是消息明明落在同一条会话流里,模型看到的历史却不同 —— 她像是第一次见到主人。
//
// 本文件补上这一半:主人私聊回合在装配完本回合自己的消息之后、交给循环之前,前置**主会话**
// 的最近 N 条转录。重建逻辑与条数上限都取自 internal/runtime/transcript —— 与网关同一份
// 实现、同一个常量,绝不另写第二套(两份映射必然漂移)。受限车道(群聊/陌生人)**绝不注入**:
// 那是隔离会话,只看得到自己会话里的当次消息,主人的主会话历史不得外泄(design/16 §4.6)。
// turnEnv 返回一条入站消息本轮运行所用的 loop 会话环境。
//
// - 主人私聊(inboundTarget.private)与 Web 主会话是**同一条车道**,因此经主人车道的
// 唯一构造入口 loop.OwnerEnvFor 派生:两条车道逐字段同源,SessionEnv 将来新增字段时
// 会一起拿到,而不是各自漂移出「同一个她、两套环境」。
// - 受限会话(群聊/陌生人)由结构化解析出的隔离边界决定:记忆只读(MemWritable=false)、
// 并强制默认角色(design/22 §7-4 —— resolvePersona 对受限会话恒返回 "")。身份与权限
// 始终来自 actor 元数据,绝不来自这里的任何字符串(项目红线)。
func turnEnv(sess session.Session, target inboundTarget, personaID string) loop.SessionEnv {
if target.private {
return loop.OwnerEnvFor(personaID)
}
return loop.SessionEnv{ActorEnv: sess.Env(), MemWritable: sess.MemWritable, PersonaID: personaID}
}
// seedTurnTranscript 在主人私聊车道上把**主会话**最近的转录置于本回合模型可见消息之前
// (与网关编排器的 startTurnMessages 同序:转录在前、本次消息在后),使 IM 回合与 Web 主
// 会话看到同一份对话历史。受限(群聊/陌生人)车道原样返回 —— 隔离上下文绝不注入主人的
// 主会话历史。
//
// 时刻与网关一致:调用点在本回合用户消息落库**之前**(runInboundTurn 里装配先于
// persistToMain),因此当次消息绝不会在上下文里出现两次。
//
// 转录读不出来(未接历史存储、读失败、空会话)时同样原样返回,这正是既有行为:主人私聊
// 回合退化为「来源行 + 当次消息」,而不是让回合失败。
func (b *Bridge) seedTurnTranscript(ctx context.Context, target inboundTarget, msgs []model.Message) []model.Message {
if !target.private {
return msgs
}
seed := transcript.Read(ctx, b.history, target.sessionID)
if len(seed) == 0 {
return msgs
}
out := make([]model.Message, 0, len(seed)+len(msgs))
out = append(out, seed...)
return append(out, msgs...)
}