docs(comments): proactive 判据键在 data 内、不在帧壳顶层(安卓核对指出)

4 处注释写「帧顶」而代码放在 data[proactive](+ 测试文件 6 处同源表述)。
安卓端两层都读所以不受影响,但注释与代码相反会误导下一个按注释写的人。
零行为改动(仅注释)。
This commit is contained in:
AskaEth committed 2026-10-06 21:16:20 +08:00
1 parent f1fbc249fd
commit b36798265a
3 files changed
+10 -10

No files matched your search

+2 -2
View File
@@ -21,14 +21,14 @@ import (
// 当 hub 接好广播时它是安全空操作。两种帧类型都携带消息内容,
// 因此 design/11 §7.1 帧门只把它们投递给 owner/admin 连接。
//
// 它**绝不**带 `proactive` 键:普通消息的帧顶永远没有那个结构化判据,客户端因此
// 它**绝不**带 `proactive` 键:普通消息的帧的 `data` 里永远没有那个结构化判据,客户端因此
// 不可能把普通消息误判成主动消息去弹通知(切片 P0b 的「不误伤」那一条)。主动推送
// 那条路走 BroadcastProactivePersisted(proactive.go)。
func (s *Server) BroadcastPersisted(msg history.Message) {
s.broadcastPersisted(msg, false)
}
// broadcastPersisted 是上面两个入口共用的帧构造与扇出:proactive 决定帧顶是否带上
// broadcastPersisted 是上面两个入口共用的帧构造与扇出:proactive 决定帧的 `data` 里是否带上
// 「这是她主动说的话」的结构化判据 `proactive:true`(切片 P0b,见 proactive.go 的
// BroadcastProactivePersisted)。两条入口走**同一个**函数,因此帧类型推导、thinking
// 抹除与角色门(design/11 §7.1)逐字一致 —— 差别只有那一个键。