package rpc import ( "strings" "unicode" "unicode/utf8" "github.com/iamxvbaba/td/tg" "telesrv/internal/links" ) // 服务端自动实体检测:@mention / #hashtag / $cashtag / bot command。 // // 官方 Telegram 服务端会对消息原文检测这些「可自动识别」实体并写入 message.entities; // 客户端发 sendMessage 时只发「用户意图」类实体(bold/italic/code/textUrl/customEmoji/ // inputMessageEntityMentionName 等)以及客户端本地检测的 url。DrKLO 对正常已发送消息 // useManualParse=false,不本地 Linkify @username,完全依赖 message.entities 渲染 @mention // 高亮——故服务端不补 messageEntityMention 时 @username 不渲染成可点击蓝色。url 检测见 // detectURLEntities(webpage_url_extract.go)。 // // 所有 offset/length 以 UTF-16 码元计(Telegram 实体口径),复用 utf16CodeUnitLen;@/#/$ / // 触发字符本身计入实体长度。检测纯按文本正则,不查库校验 username/command 是否真实存在 // (官方亦如此:messageEntityMention 不带 user_id,客户端点击时再 resolveUsername)。 // augmentAutoEntities 在客户端已发实体基础上补充服务端检测的自动实体。补充项与任何 // 已有实体(客户端富文本意图实体或先补入的自动实体)区间相交时丢弃,避免把 mention/ // hashtag 打进 code/pre/textUrl/已有 mentionName 内部或彼此重叠(对齐官方不重复打实体)。 // URL 按跨度逐条补缺,不能因客户端带了某一条 HTTP URL 就跳过同消息中客户端不认识的 // app-link。客户端实体保持在前(超过上限裁剪时优先保留),结果裁剪到实体上限。 func augmentAutoEntities(message string, entities []tg.MessageEntityClass, appLinks links.AppLinkBuilder) []tg.MessageEntityClass { // 快路径:绝大多数消息不含任何可自动识别的触发字符。单次 ContainsAny 扫描即短路返回, // 跳过下面各检测器对全文的扫描与区间分配(纯文本发送零额外开销)。所有 http(s) 链接 // 都含 '/',故 "@#$/" 一并覆盖 url 检测;email/phone 未实现故不在触发集内。 if message == "" || !strings.ContainsAny(message, "@#$/") { return entities } type interval struct{ start, end int } occupied := make([]interval, 0, len(entities)+8) for _, e := range entities { if ln := e.GetLength(); ln > 0 { off := e.GetOffset() occupied = append(occupied, interval{off, off + ln}) } } overlaps := func(s, e int) bool { for _, iv := range occupied { if s < iv.end && iv.start < e { return true } } return false } // extra 延迟分配:仅当真正补到实体时才建切片并复制 entities。像 "邮箱 a@b.com" 这种有 // 触发字符但补不出实体的情况(@ 前是单词字符 → 非 mention),保持零复制返回原 entities。 var extra []tg.MessageEntityClass accept := func(c tg.MessageEntityClass) { if len(entities)+len(extra) >= maxMessageEntityCount { return } ln := c.GetLength() if ln <= 0 { return } off := c.GetOffset() if overlaps(off, off+ln) { return } extra = append(extra, c) occupied = append(occupied, interval{off, off + ln}) } // URL 跨度始终计算并加入排除区(occupied),使 @mention/#hashtag 等不会落进 URL 路径内部 // (如 https://t.me/@scam 的 @scam,既不符官方语义也是钓鱼风险)。逐跨度补缺可覆盖 // “客户端带 HTTP entity、但不认识 telesrv://”的混合消息,同时仍避免重复实体。 for _, u := range detectURLEntities(message, appLinks) { ln := u.GetLength() if ln <= 0 { continue } off := u.GetOffset() if overlaps(off, off+ln) { continue } occupied = append(occupied, interval{off, off + ln}) if len(entities)+len(extra) < maxMessageEntityCount { extra = append(extra, u) } } // 其余自动实体落在任何已占区间(客户端实体或 URL 跨度)内则丢弃;客户端实体优先保留(上限内)。 for _, c := range detectMentionEntities(message) { accept(c) } for _, c := range detectHashtagEntities(message) { accept(c) } for _, c := range detectCashtagEntities(message) { accept(c) } for _, c := range detectBotCommandEntities(message) { accept(c) } if len(extra) == 0 { return entities } out := make([]tg.MessageEntityClass, 0, len(entities)+len(extra)) out = append(out, entities...) return append(out, extra...) } func (r *Router) augmentAutoEntities(message string, entities []tg.MessageEntityClass) []tg.MessageEntityClass { return augmentAutoEntities(message, entities, r.appLinks) } // isWordRune 判定「单词字符」(用于实体前导边界:前一个字符是单词字符时不是新实体起点, // 借此排除 email 的 local@domain、路径里的 and/or 等)。 func isWordRune(r rune) bool { return r == '_' || unicode.IsLetter(r) || unicode.IsDigit(r) } // isHashtagRune 是 hashtag 正文允许的字符(支持 unicode 字母/数字,如 #日本語)。 func isHashtagRune(r rune) bool { return r == '_' || unicode.IsLetter(r) || unicode.IsDigit(r) } // prevRuneBefore 取字节位置 i 之前的一个完整 rune(供前导边界判定);i<=0 返回 ok=false // (字符串起点视为合法实体边界)。 func prevRuneBefore(s string, i int) (rune, bool) { if i <= 0 || i > len(s) { return 0, false } r, size := utf8.DecodeLastRuneInString(s[:i]) if size == 0 { return 0, false } return r, true } // detectMentionEntities 检测 @username(messageEntityMention,仅 offset/length 无 user_id)。 // 规则:前导字符非单词字符且非 '@';username = [A-Za-z0-9_] 长 1..32;'@' 计入长度。 // (设置 mentioned 标志是另一条独立链路 mentionedUserIDsFromMessage,基于 user_id,与本检测无关。) func detectMentionEntities(message string) []tg.MessageEntityClass { var out []tg.MessageEntityClass for i := 0; i < len(message); i++ { if message[i] != '@' { continue } if r, ok := prevRuneBefore(message, i); ok && (isWordRune(r) || r == '@') { continue } j := i + 1 for j < len(message) && isUsernameByte(message[j]) { j++ } if n := j - i - 1; n < 1 || n > 32 { continue } out = append(out, &tg.MessageEntityMention{ Offset: utf16CodeUnitLen(message[:i]), Length: utf16CodeUnitLen(message[i:j]), }) i = j - 1 } return out } // detectBotCommandEntities 检测 /command 与 /command@botusername(messageEntityBotCommand)。 // 规则:前导字符非单词字符且非 '/','@','<';command = [A-Za-z0-9_] 长 1..64;可选 // '@' + [A-Za-z0-9_] 1..32 的 bot username 后缀。前导排除单词字符使日期 12/25、and/or、 // url 路径不被误判为命令。 func detectBotCommandEntities(message string) []tg.MessageEntityClass { var out []tg.MessageEntityClass for i := 0; i < len(message); i++ { if message[i] != '/' { continue } if r, ok := prevRuneBefore(message, i); ok && (isWordRune(r) || r == '/' || r == '@' || r == '<') { continue } j := i + 1 for j < len(message) && isUsernameByte(message[j]) { j++ } if n := j - i - 1; n < 1 || n > 64 { continue } end := j if end < len(message) && message[end] == '@' { k := end + 1 for k < len(message) && isUsernameByte(message[k]) { k++ } if bn := k - end - 1; bn >= 1 && bn <= 32 { end = k } } out = append(out, &tg.MessageEntityBotCommand{ Offset: utf16CodeUnitLen(message[:i]), Length: utf16CodeUnitLen(message[i:end]), }) i = end - 1 } return out } // detectHashtagEntities 检测 #hashtag(messageEntityHashtag,支持 unicode 字母/数字)。 // 规则:前导字符非单词字符且非 '#','@';正文 1..256 个 hashtag 字符且首字符非数字 // (排除 #123 这类纯/前导数字串)。 func detectHashtagEntities(message string) []tg.MessageEntityClass { var out []tg.MessageEntityClass // '#' 是 ASCII,绝不出现在多字节 UTF-8 序列内部,故按字节扫描触发字符(避免对每个 // 位置做 rune 解码);仅在边界判定与 body(支持 unicode 字母/数字)上才做 rune 解码。 for i := 0; i < len(message); i++ { if message[i] != '#' { continue } if r, ok := prevRuneBefore(message, i); ok && (isWordRune(r) || r == '#' || r == '@') { continue } j := i + 1 var firstRune rune runeCount := 0 for j < len(message) { r, size := utf8.DecodeRuneInString(message[j:]) if size <= 0 || !isHashtagRune(r) { break } if runeCount == 0 { firstRune = r } runeCount++ j += size } if runeCount >= 1 && runeCount <= 256 && !unicode.IsDigit(firstRune) { out = append(out, &tg.MessageEntityHashtag{ Offset: utf16CodeUnitLen(message[:i]), Length: utf16CodeUnitLen(message[i:j]), }) i = j - 1 // for 循环 i++ 后落到 j,跳过已消费的 hashtag body } } return out } // detectCashtagEntities 检测 $TICKER(messageEntityCashtag)。规则:前导字符非单词字符 // 且非 '$';正文 1..8 个大写字母,且其后紧邻字符非单词字符(排除 $USDfoo)。 func detectCashtagEntities(message string) []tg.MessageEntityClass { var out []tg.MessageEntityClass for i := 0; i < len(message); i++ { if message[i] != '$' { continue } if r, ok := prevRuneBefore(message, i); ok && (isWordRune(r) || r == '$') { continue } j := i + 1 for j < len(message) && message[j] >= 'A' && message[j] <= 'Z' { j++ } if n := j - i - 1; n < 1 || n > 8 { continue } if r, size := utf8.DecodeRuneInString(message[j:]); size > 0 && isWordRune(r) { continue } out = append(out, &tg.MessageEntityCashtag{ Offset: utf16CodeUnitLen(message[:i]), Length: utf16CodeUnitLen(message[i:j]), }) i = j - 1 } return out }