myagent-ai 1.23.28 → 1.23.29

package/agents/main_agent.py

@@ -134,6 +134,9 @@ class MainAgent(BaseAgent):
 【记忆】
 - 搜索记忆: myagent-ai memory [--keyword 关键词] [--limit N]
 
+【Agent间通信】
+- 向其他Agent发送消息: myagent-ai chat --agent <Agent路径> --message "消息内容"
+
 【媒体播放】
 - 播放音频: myagent-ai playaudio --url 音频URL [--title 标题] 或 myagent-ai playaudio --file 本地路径
 - 播放视频: myagent-ai playvideo --url 视频URL [--title 标题] 或 myagent-ai playvideo --file 本地路径
@@ -149,6 +152,7 @@ class MainAgent(BaseAgent):
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai ppt-create -s '{JSON幻灯片}'"}</parms><timeout>30</timeout></tool>
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai playaudio --url https://music.163.com/song?id=123 --title 歌曲名"}</parms><timeout>10</timeout></tool>
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai playvideo --url https://www.bilibili.com/video/BV123 --title 视频名"}</parms><timeout>10</timeout></tool>
+  <tool><toolname>command</toolname><parms>{"command": "myagent-ai chat --agent default/coder --message \"请帮我分析这段代码的时间复杂度\""}</parms><timeout>10</timeout></tool>
 
 多个命令可用 && 连接一次执行（强烈推荐，减少LLM回调次数）:
   <tool><toolname>command</toolname><parms>{"command": "myagent-ai search xxx && myagent-ai read-url https://..."}</parms><timeout>30</timeout></tool>

package/core/tool_dispatcher.py

@@ -246,6 +246,31 @@ class ToolDispatcher:
                 if not media_result.get("success"):
                     result["output"] += f"\n[视频播放失败: {media_result.get('error', '')}]"
 
+        # [v1.23.29] 检测 __CHAT_AGENT__ 标记 — CLI chat 命令输出此标记
+        # 格式: __CHAT_AGENT__agent_path|agent_name|message__END__
+        chat_markers = _re.findall(r'__CHAT_AGENT__(.+?)\|(.+?)\|(.+?)__END__', clean_output)
+        if chat_markers:
+            clean_output = _re.sub(r'__CHAT_AGENT__.+?__END__\n?', '', clean_output).strip()
+            result["output"] = clean_output
+            for chat_agent_path, chat_agent_name, chat_msg in chat_markers:
+                # Store as a chat agent event in sent_files for persistence
+                if sent_files is not None:
+                    sent_files.append({
+                        "_type": "chat_agent",
+                        "target_agent": chat_agent_path.strip(),
+                        "target_name": chat_agent_name.strip(),
+                        "message": chat_msg.strip(),
+                    })
+                # Emit SSE event for frontend display
+                try:
+                    await self._emit_sse("v2_chat_agent", {
+                        "target_agent": chat_agent_path.strip(),
+                        "target_name": chat_agent_name.strip(),
+                        "message": chat_msg.strip(),
+                    }, stream_callback)
+                except Exception:
+                    pass
+
         return result
 
     async def _exec_recall_memory(self, params: Dict, task_id: str) -> Dict:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.23.28",
+  "version": "1.23.29",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/scripts/cli.py

@@ -18,6 +18,7 @@ scripts/cli.py - MyAgent CLI 工具集
   GUI:     screenshot, mouse-click, mouse-drag, type-text, hotkey,
            window-list, window-focus
   记忆:    memory
+  通信:    chat
   帮助:    help, -h, --help
 """
 from __future__ import annotations
@@ -135,6 +136,8 @@ async def _run():
         # 媒体播放
         "playaudio": cmd_playaudio,
         "playvideo": cmd_playvideo,
+        # 通信
+        "chat": cmd_chat,
         # 帮助
         "help": cmd_help,
         "-h": cmd_help,
@@ -990,6 +993,32 @@ async def cmd_playvideo(args):
     print(f"__EMBED_VIDEO__{source}|{title}__END__")
 
 
+# =============================================================================
+# 通信命令
+# =============================================================================
+
+async def cmd_chat(args):
+    """Agent间通信 — 向群内其他Agent发送消息"""
+    import argparse
+    p = argparse.ArgumentParser(prog="myagent-ai chat", description="向群内其他Agent发送消息，消息会出现在群聊记录中")
+    p.add_argument("--agent", "-a", required=True, help="目标Agent路径，如 default/coder")
+    p.add_argument("--message", "-m", required=True, help="要发送的消息内容")
+    p.add_argument("--group", "-g", help="群ID（可选，默认使用最近活跃的群）")
+    a = p.parse_args(args)
+
+    # Find agent config
+    agent_dir = Path(__file__).parent.parent / "data" / "agents" / a.agent
+    cfg_file = agent_dir / "config.json"
+    if not cfg_file.exists():
+        print(f"错误: Agent 不存在: {a.agent}", file=sys.stderr)
+        sys.exit(1)
+    cfg = json.loads(cfg_file.read_text(encoding="utf-8"))
+    agent_name = cfg.get("name", a.agent)
+
+    # Output chat marker (similar to __SEND_FILE__ pattern)
+    print(f"__CHAT_AGENT__{a.agent}|{agent_name}|{a.message}__END__")
+
+
 # =============================================================================
 # 帮助命令
 # =============================================================================
@@ -1058,6 +1087,9 @@ GUI (仅 Windows/macOS):
 记忆:
   myagent-ai memory [--keyword 关键词] [--limit N]  搜索历史记忆
 
+通信:
+  myagent-ai chat --agent <路径> --message "消息"   向其他Agent发送消息
+
 媒体播放:
   myagent-ai playaudio --url <URL> [--title]       播放在线音频
   myagent-ai playaudio --file <路径> [--title]      播放本地音频

package/web/api_server.py

@@ -7630,6 +7630,9 @@ window.addEventListener('beforeunload', function() {{
 
     async def handle_send_group_message(self, request):
         """POST /api/groups/{gid}/messages - 发送群消息（广播到所有成员agent）"""
+        import re as _re
+        import time as _time
+
         gid = request.match_info["gid"]
         data = await request.json()
         content = data.get("message", "").strip()
@@ -7666,12 +7669,39 @@ window.addEventListener('beforeunload', function() {{
             metadata={"source": "group_chat", "group_name": group.name},
         )
 
-        # 3. 广播到所有非禁言成员agent，并行处理
+        # 3. [v1.23.29] 解析 @提及
+        at_pattern = _re.compile(r'@(\S+)')
+        at_targets = at_pattern.findall(content)
+        mentioned_agents = set()
+        mentioned_all = False
+
+        for target in at_targets:
+            target_lower = target.lower()
+            if target_lower in ('all', '所有人', '大家'):
+                mentioned_all = True
+                break
+            for m in group.members:
+                agent_cfg = self._read_agent_config(m.agent_path)
+                agent_name = agent_cfg.get("name", "") if agent_cfg else ""
+                if (target_lower == m.agent_path.lower()
+                    or target_lower == agent_name.lower()
+                    or (m.nickname and target_lower == m.nickname.lower())):
+                    mentioned_agents.add(m.agent_path)
+
+        # 4. 广播到所有非禁言成员agent，并行处理
         active_members = [m for m in group.members if not m.muted]
 
+        # [v1.23.29] 确定哪些 Agent 应该回复
+        if mentioned_all:
+            target_members = active_members
+        elif mentioned_agents:
+            target_members = [m for m in active_members if m.agent_path in mentioned_agents]
+        else:
+            target_members = active_members  # 无@=广播给所有（向后兼容）
+
         import asyncio
         # Build a member_order map for deterministic sorting after gather
-        member_order = {m.agent_path: i for i, m in enumerate(active_members)}
+        member_order = {m.agent_path: i for i, m in enumerate(target_members)}
 
         async def process_agent_member(member):
             """Process a single member's response (DO NOT save messages here)"""
@@ -7704,19 +7734,64 @@ window.addEventListener('beforeunload', function() {{
                 my_role = {"owner": "群主", "admin": "管理员"}.get(member.role, "成员")
                 my_desc = agent_cfg.get("description", "") if agent_cfg else ""
 
-                group_context = (
-                    f"## 群聊上下文\n"
-                    f"- 群名称: {group.name}\n"
-                    f"- 群ID: {group.id}\n"
-                    f"- 群描述: {group.description}\n"
-                    f"- 当前发言者: 用户\n"
-                    f"- 你的身份: {my_name} ({my_role})"
-                    + (f" — {my_desc}" if my_desc else "")
-                    + f"\n- 群成员 ({len(group.members)}人):\n"
-                    + "\n".join(member_lines)
-                    + "\n\n注意：你只代表自己发言，回复时使用第一人称。"
-                    "如果消息不是跟你相关的，可以简短回复或不回复。"
-                )
+                # [v1.23.29] 构建近期群聊记录
+                recent_msgs = mgr.get_messages(gid, limit=10)
+                history_lines = []
+                for rm in recent_msgs:
+                    rm_name = rm.sender_name or ("用户" if rm.sender == "user" else rm.agent_path)
+                    rm_time_str = _time.strftime("%H:%M", _time.localtime(rm.timestamp)) if rm.timestamp else ""
+                    history_lines.append(f"[{rm_time_str}] {rm_name}: {rm.content[:200]}")
+                chat_history = "\n".join(reversed(history_lines))
+
+                # [v1.23.29] 确定 @提及信息
+                is_mentioned = mentioned_all or member.agent_path in mentioned_agents
+                at_info = ""
+                if mentioned_all:
+                    at_info = "- 本次消息使用了 @所有人，请务必回复。\n"
+                elif mentioned_agents:
+                    if is_mentioned:
+                        at_info = f"- 本次消息使用了 @{my_name}，请务必回复。\n"
+                    else:
+                        at_info = "- 本次消息使用了 @其他成员，与你无关，请不要回复。\n"
+                else:
+                    at_info = "- 本次消息没有 @任何人（广播消息），你可以根据内容决定是否回复。\n"
+
+                group_context = f"""## 群聊上下文
+
+你正在参与一个群聊，以下是群的详细信息：
+
+### 群信息
+- 群名称: {group.name}
+- 群描述: {group.description or '无'}
+- 当前发言者: 用户（群聊中的真人用户）
+
+### 你的身份
+- 名称: {my_name}
+- 路径: {agent_path}
+- 角色: {my_role}{"（已禁言，但仍可接收消息）" if member.muted else ""}
+
+### 群成员列表（共{len(group.members)}人）
+{chr(10).join(member_lines)}
+
+### 沟通规则（重要）
+1. **@提及机制**: 用户发送消息时可以使用 @名称 来指定回复者
+   - @某个Agent: 只有被@的Agent需要回复
+   - @所有人 / @all: 所有成员都需要回复
+   - 不@任何人（广播）: 你自行判断是否需要回复
+2. **跨Agent沟通**: 你可以使用 `myagent-ai chat --agent <路径> --message "消息"` 命令向群内其他Agent发送消息。消息会出现在群聊中，对方下次被@时会看到。
+3. **回复方式**:
+   - 直接回复用户的消息
+   - 需要其他Agent协助时，使用 chat 命令沟通，不要假装代替其他Agent回答
+   - 如需协调多个Agent，建议用户使用 @所有人
+{at_info}
+### 近期群聊记录（最近10条）
+{chat_history if chat_history else '（暂无历史消息）'}
+
+### 重要提醒
+- 你只代表你自己发言，使用第一人称
+- 不要假装是其他Agent或代替其他Agent回答
+- 如果问题超出你的能力范围，建议用户@相关专家Agent
+- 如果需要其他Agent的信息，使用 `myagent-ai chat` 命令沟通"""
 
                 # 将群聊上下文追加到 agent_system_prompt
                 if agent_system_prompt:
@@ -7766,8 +7841,8 @@ window.addEventListener('beforeunload', function() {{
                     "response": f"处理失败: {str(e)}",
                 }
 
-        # 并行调用所有成员agent
-        tasks = [process_agent_member(m) for m in active_members]
+        # 并行调用目标成员agent
+        tasks = [process_agent_member(m) for m in target_members]
         try:
             gather_results = await asyncio.gather(*tasks, return_exceptions=True)
         except Exception as e:
@@ -7793,6 +7868,26 @@ window.addEventListener('beforeunload', function() {{
             key=lambda r: member_order.get(r.get("agent_path", ""), 999999)
         )
 
+        # [v1.23.29] 从 Agent 响应中提取 __CHAT_AGENT__ 标记，清理并保存跨Agent通信消息
+        _chat_msg_pattern = _re.compile(r'__CHAT_AGENT__(.+?)\|(.+?)\|(.+?)__END__')
+        for resp in final_responses:
+            resp_text = resp.get("response", "")
+            chat_matches = _chat_msg_pattern.findall(resp_text)
+            if chat_matches:
+                # 清理标记文本
+                resp["response"] = _chat_msg_pattern.sub('', resp_text).strip()
+                # 保存跨Agent通信消息到群聊
+                for c_path, c_name, c_msg in chat_matches:
+                    chat_sys_msg = GroupMessage(
+                        group_id=gid,
+                        sender=resp.get("agent_path", ""),
+                        sender_name=resp.get("name", ""),
+                        sender_avatar=resp.get("avatar", "🤖"),
+                        content=f"💬 对 {c_name.strip()} 说: {c_msg.strip()}",
+                        msg_type="text",
+                    )
+                    mgr.add_message(chat_sys_msg)
+
         # Save agent messages sequentially in sorted order
         for resp in final_responses:
             agent_msg = GroupMessage(

package/web/ui/chat/chat.css

@@ -2671,3 +2671,59 @@ body.popout-mode #popoutBtn{display:none !important}
 .md-table-wrapper td{padding:7px 12px;border:1px solid var(--border-light);color:var(--text);vertical-align:top;word-break:break-word}
 .md-table-wrapper tr:nth-child(even){background:var(--bg3)}
 .md-table-wrapper tr:hover{background:var(--accent-light)}
+
+/* ══════════════════════════════════════════════════════
+   ── @ Mention Panel (v1.23.29) ──
+   ══════════════════════════════════════════════════════ */
+#atMentionPanel{
+  background:var(--bg-secondary,var(--bg2));
+  border:1px solid var(--border-color,var(--border));
+  border-radius:8px;
+  box-shadow:0 4px 16px rgba(0,0,0,.4);
+  min-width:200px;
+  max-width:320px;
+  font-size:13px;
+  padding:4px 0;
+}
+.at-mention-item{
+  display:flex;
+  align-items:center;
+  gap:8px;
+  padding:8px 12px;
+  cursor:pointer;
+  transition:background .15s;
+}
+.at-mention-item:hover,.at-mention-item.at-item-active{
+  background:var(--bg-hover,rgba(255,255,255,.08));
+}
+.at-emoji{
+  font-size:16px;
+  width:24px;
+  text-align:center;
+  flex-shrink:0;
+}
+.at-name{
+  font-weight:500;
+  color:var(--text-primary,var(--text));
+}
+.at-path{
+  font-size:11px;
+  color:var(--text-secondary,var(--text3));
+  margin-left:auto;
+}
+.at-all-btn{
+  background:transparent;
+  border:1px solid var(--accent);
+  color:var(--accent);
+  border-radius:6px;
+  padding:4px 10px;
+  font-size:12px;
+  cursor:pointer;
+  white-space:nowrap;
+  transition:all .2s;
+  flex-shrink:0;
+}
+.at-all-btn:hover{
+  background:var(--accent);
+  color:#fff;
+}

package/web/ui/chat/chat_main.js

@@ -391,6 +391,26 @@ async function initChat() {
     document.getElementById('sendBtn').disabled = !this.value.trim();
     saveDraft();
   });
+  // [v1.23.29] Initialize @ mention panel for group chat
+  if (typeof initAtMention === 'function') initAtMention();
+  // [v1.23.29] Create @all button (hidden by default, shown in group chat)
+  var sendBtn = document.getElementById('sendBtn');
+  if (sendBtn && sendBtn.parentElement && !document.getElementById('atAllBtn')) {
+    var atAllBtn = document.createElement('button');
+    atAllBtn.id = 'atAllBtn';
+    atAllBtn.className = 'at-all-btn';
+    atAllBtn.textContent = '@所有人';
+    atAllBtn.style.display = 'none';
+    atAllBtn.onclick = function() {
+      var input = document.getElementById('userInput');
+      if (input) {
+        input.value = input.value + '@所有人 ';
+        input.focus();
+        document.getElementById('sendBtn').disabled = false;
+      }
+    };
+    sendBtn.parentElement.insertBefore(atAllBtn, sendBtn);
+  }
   // Load task plan if in exec mode (panel stays hidden until tasks exist)
   if (state.chatMode === 'exec') {
     // Don't show task panel by default - it will appear when the LLM creates a task list

package/web/ui/chat/groupchat.js

@@ -154,6 +154,10 @@ async function selectGroup(gid) {
     document.getElementById('activeAgentBadge').style.display = 'none';
     document.getElementById('groupBackBtn').style.display = '';
     document.getElementById('groupSettingsBtn').style.display = '';
+
+    // Show @all button for group chat
+    var atAllBtn = document.getElementById('atAllBtn');
+    if (atAllBtn) atAllBtn.style.display = '';
     var _ccb = document.getElementById('clearChatBtn'); if (_ccb) _ccb.style.display = 'none';
     var dot = document.querySelector('.main-title .dot');
     if (dot) dot.style.display = 'none';
@@ -199,6 +203,8 @@ function exitGroupChat() {
   document.getElementById('activeAgentBadge').style.display = '';
   document.getElementById('groupBackBtn').style.display = 'none';
   document.getElementById('groupSettingsBtn').style.display = 'none';
+  var atAllBtn = document.getElementById('atAllBtn');
+  if (atAllBtn) atAllBtn.style.display = 'none';
   var _ccb2 = document.getElementById('clearChatBtn'); if (_ccb2) _ccb2.style.display = '';
   var dot = document.querySelector('.main-title .dot');
   if (dot) dot.style.display = '';
@@ -239,7 +245,8 @@ function _renderGroupMessagesInner() {
     html = '<div class="welcome-card">'
       + '<h2><span class="emoji">' + escapeHtml((group && (group.avatar_emoji || group.emoji)) || '👥') + '</span>'
       + ' <span>群聊: ' + escapeHtml((group && group.name) || '') + '</span></h2>'
-      + '<p class="subtitle">向所有成员发送消息，每个 Agent 会分别回复</p>'
+      + '<p class="subtitle">输入 @ 选择要回复的 Agent，或直接发送消息广播给所有人</p>'
+      + '<p class="subtitle" style="font-size:12px;color:var(--text-secondary)">支持 @Agent名 指定回复 | @所有人 全部回复 | myagent-ai chat 跨Agent沟通</p>'
       + '</div>';
     container.innerHTML = html;
     return;
@@ -593,6 +600,150 @@ async function confirmAddMembers() {
   }
 }
 
+// ══════════════════════════════════════════════════════
+// ── @ Mention Panel (@提及面板) ──
+// ══════════════════════════════════════════════════════
+
+var _atPanelVisible = false;
+var _atPanelFiltered = [];
+
+function initAtMention() {
+  var input = document.getElementById('userInput');
+  if (!input) return;
+  input.addEventListener('input', _onInputChangeForAt);
+  input.addEventListener('keydown', _onInputKeydownForAt);
+  // Close panel on click outside
+  document.addEventListener('click', function(e) {
+    if (!e.target.closest('#atMentionPanel') && !e.target.closest('#userInput')) {
+      _hideAtPanel();
+    }
+  });
+}
+
+function _onInputChangeForAt(e) {
+  if (currentView !== 'group') { _hideAtPanel(); return; }
+  var val = e.target.value;
+  var pos = val.lastIndexOf('@');
+  if (pos < 0 || (pos > 0 && val[pos - 1] !== ' ' && val[pos - 1] !== '\n')) {
+    _hideAtPanel();
+    return;
+  }
+  var query = val.substring(pos + 1).toLowerCase().split(' ')[0];
+  if (query.length > 20) { _hideAtPanel(); return; }
+
+  var group = groups.find(function(g) { return g.id === currentGroupId; });
+  if (!group || !group.members) { _hideAtPanel(); return; }
+
+  _atPanelFiltered = [];
+  // Add "所有人" option
+  var allMatch = !query || 'all'.indexOf(query) >= 0 || '所有人'.indexOf(query) >= 0 || '大家'.indexOf(query) >= 0;
+  if (allMatch) {
+    _atPanelFiltered.push({name: '所有人', path: '@all', emoji: '📢', isAll: true});
+  }
+  // Add members
+  for (var i = 0; i < group.members.length; i++) {
+    var m = group.members[i];
+    var mc = (state.agentsFlat || []).find(function(a) { return a.path === m.agent_path; });
+    var mName = (mc && mc.name) || m.agent_path;
+    var mEmoji = (mc && mc.avatar_emoji) || '🤖';
+    if (!query || mName.toLowerCase().indexOf(query) >= 0 || m.agent_path.toLowerCase().indexOf(query) >= 0) {
+      _atPanelFiltered.push({name: mName, path: m.agent_path, emoji: mEmoji});
+    }
+  }
+
+  if (_atPanelFiltered.length === 0) { _hideAtPanel(); return; }
+  _showAtPanel(pos);
+}
+
+function _showAtPanel(atPos) {
+  var existing = document.getElementById('atMentionPanel');
+  if (!existing) {
+    existing = document.createElement('div');
+    existing.id = 'atMentionPanel';
+    document.body.appendChild(existing);
+  }
+  var html = '';
+  for (var i = 0; i < _atPanelFiltered.length; i++) {
+    var item = _atPanelFiltered[i];
+    var cls = i === 0 ? ' at-item-active' : '';
+    html += '<div class="at-mention-item' + cls + '" data-index="' + i + '" data-name="' + escapeHtml(item.name) + '" data-path="' + escapeHtml(item.path) + '">'
+      + '<span class="at-emoji">' + item.emoji + '</span>'
+      + '<span class="at-name">' + escapeHtml(item.name) + '</span>'
+      + (item.isAll ? '' : '<span class="at-path">' + escapeHtml(item.path) + '</span>')
+      + '</div>';
+  }
+  existing.innerHTML = html;
+  existing.style.display = 'block';
+  existing._atIndex = 0;
+
+  // Position near input
+  var input = document.getElementById('userInput');
+  var rect = input.getBoundingClientRect();
+  existing.style.position = 'fixed';
+  existing.style.left = Math.max(8, rect.left) + 'px';
+  existing.style.bottom = (window.innerHeight - rect.top + 4) + 'px';
+  existing.style.maxHeight = '200px';
+  existing.style.overflowY = 'auto';
+  existing.style.zIndex = '99999';
+
+  // Click handlers
+  var items = existing.querySelectorAll('.at-mention-item');
+  items.forEach(function(el) {
+    el.addEventListener('mousedown', function(e) {
+      e.preventDefault();
+      _selectAtItem(parseInt(el.dataset.index));
+    });
+  });
+  _atPanelVisible = true;
+}
+
+function _hideAtPanel() {
+  var panel = document.getElementById('atMentionPanel');
+  if (panel) panel.style.display = 'none';
+  _atPanelVisible = false;
+}
+
+function _selectAtItem(index) {
+  var item = _atPanelFiltered[index];
+  if (!item) return;
+  var input = document.getElementById('userInput');
+  var val = input.value;
+  var pos = val.lastIndexOf('@');
+  var mention = item.isAll ? '@所有人 ' : '@' + item.name + ' ';
+  input.value = val.substring(0, pos) + mention + val.substring(pos + 1 + (val.substring(pos + 1).split(' ')[0].length));
+  input.focus();
+  _hideAtPanel();
+}
+
+function _onInputKeydownForAt(e) {
+  if (!_atPanelVisible || !_atPanelFiltered.length) return;
+  var panel = document.getElementById('atMentionPanel');
+  if (e.key === 'ArrowDown') {
+    e.preventDefault();
+    panel._atIndex = Math.min(panel._atIndex + 1, _atPanelFiltered.length - 1);
+    _highlightAtItem(panel);
+  } else if (e.key === 'ArrowUp') {
+    e.preventDefault();
+    panel._atIndex = Math.max(panel._atIndex - 1, 0);
+    _highlightAtItem(panel);
+  } else if (e.key === 'Enter' || e.key === 'Tab') {
+    e.preventDefault();
+    _selectAtItem(panel._atIndex);
+  } else if (e.key === 'Escape') {
+    _hideAtPanel();
+  }
+}
+
+function _highlightAtItem(panel) {
+  var items = panel.querySelectorAll('.at-mention-item');
+  items.forEach(function(el, i) {
+    el.classList.toggle('at-item-active', i === panel._atIndex);
+  });
+  // Scroll into view
+  var active = panel.querySelector('.at-item-active');
+  if (active) active.scrollIntoView({block: 'nearest'});
+}
+
 // ══════════════════════════════════════════════════════
 // ── Group Chat Send (群聊消息发送) ──
 // ══════════════════════════════════════════════════════