openclaw-openagent 1.0.6 → 1.0.7

package/src/app/remote-agent-tool.ts

@@ -29,7 +29,7 @@ import { sendC2CCustomMessage, waitForC2CReply } from '../tim/c2c.js';
 import type { OasnTransport, TaskHandle, TaskRequest } from '../transport/types.js';
 import fs from 'node:fs';
 import nodePath from 'node:path';
-import { resolveOasnAccessUrl } from '../util/url-resolver.js';
+import { resolveOasnAccessUrl, resolveOasnWebuiUrl } from '../util/url-resolver.js';
 
 // ── Helpers ──
 
@@ -350,7 +350,8 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
           const accessBase = rt.config?.accessApiBase || rt.config?.apiBase;
           if (result.webuiContinuation?.launchUrl) {
             const rawLink = result.webuiContinuation.launchUrl;
-            const link = resolveOasnAccessUrl(accessBase, rawLink);
+            const claimUrl = rt.config?.claimUrl;
+            const link = resolveOasnWebuiUrl(accessBase, claimUrl, rawLink);
             const label = result.webuiContinuation.displayName || 'Open WebUI';
             content = content.trim()
               ? `${content}\n\n${label}: ${link}`

package/src/compat.ts

@@ -15,6 +15,9 @@ export const PLUGIN_VERSION = '1.0.0';
 
 export const SUPPORTED_HOST_MIN = '2026.3.22';
 
+/** Plugin has been verified up to this OpenClaw host version */
+export const MAX_TESTED_VERSION = '2026.6.30';
+
 export interface OpenClawVersion {
   year: number;
   month: number;
@@ -71,6 +74,15 @@ export function assertHostCompatibility(hostVersion: string | undefined): void {
   }
   if (isHostVersionSupported(hostVersion)) {
     logger.info(`[compat] Host OpenClaw ${hostVersion} >= ${SUPPORTED_HOST_MIN}, OK.`);
+    // Warn but don't block for versions beyond tested range
+    const host = parseOpenClawVersion(hostVersion);
+    const max = parseOpenClawVersion(MAX_TESTED_VERSION);
+    if (host && max && compareVersions(host, max) > 0) {
+      logger.warn(
+        `[compat] Host OpenClaw ${hostVersion} is beyond max tested version ${MAX_TESTED_VERSION}. ` +
+        `The plugin may encounter compatibility issues.`,
+      );
+    }
     return;
   }
   throw new Error(

package/src/plugin-ui/assets/openagent-override.js

@@ -2,7 +2,7 @@
  * OpenAgent UI Override — Auto-generated, do not edit directly!
  *
  * Source: src/plugin-ui/modules/
- * Built:  2026-06-25T08:37:18.204Z
+ * Built:  2026-06-25T09:33:52.490Z
  *
  * To modify, edit the source modules and run:
  *   npm run build:override
@@ -1587,6 +1587,97 @@ function AgentCard(agent, opts = {}) {
   return card;
 }
 
+// ════════════════════════════════════════════════════════════════
+// MODULE: agent-book/panel/theme-adapter.js
+// ════════════════════════════════════════════════════════════════
+
+// ── OpenAgent Theme Adapter ──
+//
+// 运行时检测 OpenClaw Control UI 主题系统（v4.x vscode tokens / v5.x glassmorphism），
+// 注入 --oa-* CSS 变量供 styles.js 中的 var() fallback 消费。
+//
+// 必须早于 styles.js 加载（由 build.cjs MANIFEST 顺序保证）。
+
+(function _clInitThemeAdapter() {
+  if (window.__openagentThemeAdapterInstalled) return;
+  window.__openagentThemeAdapterInstalled = true;
+
+  /**
+   * 检测当前 OC 主题系统类型。
+   * @returns {{ hasGlass: boolean, hasVscode: boolean, isDark: boolean }}
+   */
+  function detectThemeSystem() {
+    var cs = getComputedStyle(document.documentElement);
+    var hasGlass = !!(cs.getPropertyValue('--glass-surface').trim());
+    var hasKn = !!(cs.getPropertyValue('--kn-bg-primary').trim());
+    var hasVscode = !!(cs.getPropertyValue('--vscode-editor-background').trim());
+
+    // 多策略暗色检测：v4 data-theme-mode / v5 data-theme / prefers-color-scheme
+    var themeMode = document.documentElement.getAttribute('data-theme-mode')  // v4.x
+      || document.documentElement.getAttribute('data-theme')                 // v5.x
+      || '';
+    var isDark = themeMode.indexOf('dark') >= 0
+      || window.matchMedia('(prefers-color-scheme: dark)').matches;
+
+    return {
+      hasGlass: hasGlass || hasKn,
+      hasVscode: hasVscode,
+      isDark: isDark
+    };
+  }
+
+  /**
+   * 注入 --oa-* CSS 变量到 :root。
+   * styles.js 中的 var(--oa-xxx, fallback) 会优先取这些值。
+   */
+  function setupThemeVariables() {
+    var system = detectThemeSystem();
+    var root = document.documentElement;
+
+    if (system.hasGlass) {
+      // v5.x Glassmorphism: 使用 --glass-* / --kn-* token 族
+      root.style.setProperty('--oa-panel-bg', 'var(--glass-surface, var(--card))');
+      root.style.setProperty('--oa-panel-text', 'var(--kn-text-primary, var(--text, #e0e0e0))');
+      root.style.setProperty('--oa-card-bg', 'var(--glass-card, var(--card, #f5f5f5))');
+      root.style.setProperty('--oa-card-hover-bg', 'var(--glass-card-hover, var(--card-hover))');
+      root.style.setProperty('--oa-border', 'var(--glass-border, var(--border, #e5e5e5))');
+      root.style.setProperty('--oa-shadow-color', 'rgba(0, 0, 0, 0.08)');
+      root.style.setProperty('--oa-divider', 'var(--glass-divider, var(--border, #eee))');
+      root.style.setProperty('--oa-muted-text', 'var(--kn-text-secondary, var(--text-secondary, #999))');
+    } else if (system.hasVscode) {
+      // v4.x VSCode tokens: 使用 --vscode-* 变量
+      root.style.setProperty('--oa-panel-bg', 'var(--vscode-editor-background, #fff)');
+      root.style.setProperty('--oa-panel-text', 'var(--vscode-editor-foreground, #2F2F33)');
+      root.style.setProperty('--oa-card-bg', 'var(--vscode-sideBar-background, #f5f5f5)');
+      root.style.setProperty('--oa-card-hover-bg', 'var(--vscode-list-hoverBackground, #f0f0f0)');
+      root.style.setProperty('--oa-border', 'var(--vscode-panel-border, #e5e5e5)');
+      root.style.setProperty('--oa-shadow-color', 'rgba(0, 0, 0, 0.10)');
+      root.style.setProperty('--oa-divider', 'var(--vscode-sideBar-border, #eee)');
+      root.style.setProperty('--oa-muted-text', 'var(--vscode-descriptionForeground, #999)');
+    }
+    // 无特征 → 不注入变量，styles.js 中的 var() 会 fallback 到硬编码值
+
+    // 注入暗色 class 标记供 styles.js 选择器使用
+    if (system.isDark) {
+      root.style.setProperty('--oa-is-dark', '1');
+    } else {
+      root.style.setProperty('--oa-is-dark', '0');
+    }
+  }
+
+  // 立即执行 + 监听主题变更（v5.x 可能运行时切换主题）
+  setupThemeVariables();
+
+  // 监听 data-theme / data-theme-mode 属性变更
+  var themeObserver = new MutationObserver(function () {
+    setupThemeVariables();
+  });
+  themeObserver.observe(document.documentElement, {
+    attributes: true,
+    attributeFilter: ['data-theme', 'data-theme-mode', 'class']
+  });
+})();
+
 // ════════════════════════════════════════════════════════════════
 // MODULE: agent-book/panel/styles.js
 // ════════════════════════════════════════════════════════════════
@@ -1704,10 +1795,10 @@ function injectStyles() {
     .openagent-agent-panel {
       position: fixed;
       max-height: none;
-      background: #fff;
-      border: 1.2px solid rgba(47, 47, 51, 0.12);
+      background: var(--oa-panel-bg, #fff);
+      border: 1.2px solid var(--oa-border, rgba(47, 47, 51, 0.12));
       border-radius: 18px;
-      box-shadow: 0 -4px 24px rgba(0,0,0,0.08), 0 2px 8px rgba(0,0,0,0.04);
+      box-shadow: 0 -4px 24px var(--oa-shadow-color, rgba(0,0,0,0.08)), 0 2px 8px var(--oa-shadow-color, rgba(0,0,0,0.04));
       z-index: 99999;
       overflow: hidden;
       display: none;
@@ -1751,7 +1842,7 @@ function injectStyles() {
       flex-shrink: 0;
     }
     .openagent-panel-close {
-      background: rgba(249, 249, 249, 1);
+      background: var(--oa-card-bg, rgba(249, 249, 249, 1));
       border: none;
       color: rgba(47, 47, 51, 0.6);
       cursor: pointer;
@@ -2211,41 +2302,61 @@ function injectStyles() {
       padding: 32px; text-align: center; color: #aaa; font-size: 13px;
     }
 
-    /* ── 深色主题（统一） ── */
-    [data-theme-mode="dark"] .openagent-agent-panel {
+    /* ── 深色主题（v4: data-theme-mode / v5: data-theme） ── */
+    [data-theme-mode="dark"] .openagent-agent-panel,
+    [data-theme="dark"] .openagent-agent-panel {
       background: #1c1c1c; border-color: rgba(255,255,255,0.12);
       box-shadow: 0 -4px 24px rgba(0,0,0,0.3);
     }
-    [data-theme-mode="dark"] .openagent-panel-head { border-color: #2a2a2a; }
-    [data-theme-mode="dark"] .openagent-panel-title { color: rgba(224, 224, 224, 0.8); }
-    [data-theme-mode="dark"] .openagent-panel-close { background: #2a2a2a; color: #888; }
-    [data-theme-mode="dark"] .openagent-panel-close:hover { background: #333; color: #ccc; }
-    [data-theme-mode="dark"] .openagent-section-heading { color: rgba(224, 224, 224, 0.45); }
-    [data-theme-mode="dark"] .openagent-parent-heading { color: rgba(224, 224, 224, 0.3); }
-    [data-theme-mode="dark"] .openagent-panel-divider { border-color: rgba(255,255,255,0.1); }
-
-    [data-theme-mode="dark"] .agent-card__name { color: #e0e0e0; }
-    [data-theme-mode="dark"] .agent-card__bio { color: rgba(224, 224, 224, 0.7); }
-    [data-theme-mode="dark"] .agent-card__stat { color: #64748b; }
-
-    [data-theme-mode="dark"] .agent-card--mention { background: transparent; }
-    [data-theme-mode="dark"] .agent-card--mention:hover { background: #252525; }
-    [data-theme-mode="dark"] .agent-card--mention .agent-card__action {
+    [data-theme-mode="dark"] .openagent-panel-head,
+    [data-theme="dark"] .openagent-panel-head { border-color: #2a2a2a; }
+    [data-theme-mode="dark"] .openagent-panel-title,
+    [data-theme="dark"] .openagent-panel-title { color: rgba(224, 224, 224, 0.8); }
+    [data-theme-mode="dark"] .openagent-panel-close,
+    [data-theme="dark"] .openagent-panel-close { background: #2a2a2a; color: #888; }
+    [data-theme-mode="dark"] .openagent-panel-close:hover,
+    [data-theme="dark"] .openagent-panel-close:hover { background: #333; color: #ccc; }
+    [data-theme-mode="dark"] .openagent-section-heading,
+    [data-theme="dark"] .openagent-section-heading { color: rgba(224, 224, 224, 0.45); }
+    [data-theme-mode="dark"] .openagent-parent-heading,
+    [data-theme="dark"] .openagent-parent-heading { color: rgba(224, 224, 224, 0.3); }
+    [data-theme-mode="dark"] .openagent-panel-divider,
+    [data-theme="dark"] .openagent-panel-divider { border-color: rgba(255,255,255,0.1); }
+
+    [data-theme-mode="dark"] .agent-card__name,
+    [data-theme="dark"] .agent-card__name { color: #e0e0e0; }
+    [data-theme-mode="dark"] .agent-card__bio,
+    [data-theme="dark"] .agent-card__bio { color: rgba(224, 224, 224, 0.7); }
+    [data-theme-mode="dark"] .agent-card__stat,
+    [data-theme="dark"] .agent-card__stat { color: #64748b; }
+
+    [data-theme-mode="dark"] .agent-card--mention,
+    [data-theme="dark"] .agent-card--mention { background: transparent; }
+    [data-theme-mode="dark"] .agent-card--mention:hover,
+    [data-theme="dark"] .agent-card--mention:hover { background: #252525; }
+    [data-theme-mode="dark"] .agent-card--mention .agent-card__action,
+    [data-theme="dark"] .agent-card--mention .agent-card__action {
       background: #333; border-color: #555; color: #ddd;
     }
-    [data-theme-mode="dark"] .agent-card--mention .agent-card__action:hover { background: #444; }
-    [data-theme-mode="dark"] .agent-card--search:hover { background: #252525; }
-    [data-theme-mode="dark"] .agent-card--search.openagent-card-selected {
+    [data-theme-mode="dark"] .agent-card--mention .agent-card__action:hover,
+    [data-theme="dark"] .agent-card--mention .agent-card__action:hover { background: #444; }
+    [data-theme-mode="dark"] .agent-card--search:hover,
+    [data-theme="dark"] .agent-card--search:hover { background: #252525; }
+    [data-theme-mode="dark"] .agent-card--search.openagent-card-selected,
+    [data-theme="dark"] .agent-card--search.openagent-card-selected {
       background: rgba(99, 102, 241, 0.12);
       outline-color: rgba(99, 102, 241, 0.4);
     }
-    [data-theme-mode="dark"] .agent-card--search .agent-card__action {
+    [data-theme-mode="dark"] .agent-card--search .agent-card__action,
+    [data-theme="dark"] .agent-card--search .agent-card__action {
       background: #333; border-color: #555; color: #ddd;
     }
-    [data-theme-mode="dark"] .agent-card--search .agent-card__action:hover { background: #444; }
+    [data-theme-mode="dark"] .agent-card--search .agent-card__action:hover,
+    [data-theme="dark"] .agent-card--search .agent-card__action:hover { background: #444; }
 
 
-    [data-theme-mode="dark"] .agent-card--inline {
+    [data-theme-mode="dark"] .agent-card--inline,
+    [data-theme="dark"] .agent-card--inline {
       background: linear-gradient(135deg, #1e1b3a 0%, #1a1a2e 100%);
       border-color: #2d2b55;
     }
@@ -2255,7 +2366,8 @@ function injectStyles() {
     }
     [data-theme-mode="dark"] .agent-card--inline .agent-card__name { color: #e2e8f0; }
     [data-theme-mode="dark"] .agent-card--inline .agent-card__avatar { border-color: #2d2b55; }
-    [data-theme-mode="dark"] .agent-card__loading {
+    [data-theme-mode="dark"] .agent-card__loading,
+    [data-theme="dark"] .agent-card__loading {
       background: #1e1b3a; border-color: #2d2b55; color: #64748b;
     }
   `;
@@ -2890,8 +3002,8 @@ liveTextarea.dispatchEvent(new Event('change', { bubbles: true }));
 //
 // tryInject() 只做 DOM 注入（@ 按钮 + CSS class），不绑定任何事件。
 
-// ── textarea 选择器（全局复用）──
-// 多策略回退：v3 "Message..." / v4 "发消息..." / 结构化选择器
+// ── textarea 选择器（多版本兼容）──
+// v3 "Message..." / v4 "发消息..." / v5.x 结构化选择器
 const _CL_TEXTAREA_SELECTOR = [
   'textarea[placeholder*="发消息"]',
   'textarea[placeholder*="Message"]',
@@ -2900,6 +3012,8 @@ const _CL_TEXTAREA_SELECTOR = [
   '.chat-composer textarea',
   '.chat-input textarea',
   '[class*="composer"] textarea:not([placeholder*="Search"])',
+  '[class*="chat-input"] textarea',
+  '[data-component="chat-input"] textarea',
 ].join(', ');
 
 function _getTextarea() {
@@ -3015,37 +3129,59 @@ function _installSendClickInterceptor() {
   }, true);
 }
 
-function tryInject() {
-  const textarea = _getTextarea();
-
-  if (!textarea) return false;
-  _installSendClickInterceptor();
-  if (document.querySelector('.openagent-at-btn')) return true; // 已注入
-
-  // ── 定位插入点：麦克风图标所在的 toolbar 行 ──
-  const textareaParent = textarea.parentElement;
-  let toolbarRow = null;
+/**
+ * 多策略定位 textarea 所在输入区域的工具栏行。
+ * v4.x: 工具栏在 textarea.parentElement.children 中
+ * v5.x: 工具栏可能嵌套在祖父容器或包含 toolbar class
+ * 返回 null 表示未找到则回退到 textarea 父级插入
+ */
+function _findToolbarRow(textarea) {
+  var parent = textarea.parentElement;
 
-  if (textareaParent) {
-    for (const child of textareaParent.children) {
-      if (child !== textarea && child.querySelector('svg')) {
-        toolbarRow = child;
-        break;
-      }
+  // 策略 1（v4.x）: textarea 兄弟元素含 SVG 图标
+  if (parent) {
+    for (var i = 0; i < parent.children.length; i++) {
+      if (parent.children[i] !== textarea && parent.children[i].querySelector('svg')) return parent.children[i];
     }
   }
-  if (!toolbarRow && textareaParent) {
-    const grandparent = textareaParent.parentElement;
+
+  // 策略 2（v4.x）: 祖父级兄弟元素含 SVG 图标
+  if (parent) {
+    var grandparent = parent.parentElement;
     if (grandparent) {
-      for (const child of grandparent.children) {
-        if (child !== textareaParent && child.querySelector('svg')) {
-          toolbarRow = child;
-          break;
-        }
+      for (var j = 0; j < grandparent.children.length; j++) {
+        if (grandparent.children[j] !== parent && grandparent.children[j].querySelector('svg')) return grandparent.children[j];
       }
     }
   }
 
+  // 策略 3（v5.x）: 搜索包含 toolbar class 的元素
+  var chatContainer = textarea.closest('[class*="chat"]');
+  if (chatContainer) {
+    var toolbarEl = chatContainer.querySelector('[class*="toolbar"]');
+    if (toolbarEl) return toolbarEl;
+  }
+
+  // 策略 4（v5.x fallback）: 搜索 voice/mic 按钮定位其容器
+  var voiceBtn = document.querySelector(
+    'button[aria-label*="voice"], button[aria-label*="语音"], ' +
+    'button[aria-label*="mic"], button[aria-label*="麦克风"]'
+  );
+  if (voiceBtn) return voiceBtn.parentElement;
+
+  return null;
+}
+
+function tryInject() {
+  const textarea = _getTextarea();
+
+  if (!textarea) return false;
+  _installSendClickInterceptor();
+  if (document.querySelector('.openagent-at-btn')) return true; // 已注入
+
+  // ── 定位插入点：麦克风图标所在的 toolbar 行（多策略）──
+  var toolbarRow = _findToolbarRow(textarea);
+
   // ── 创建 Agent Book 按钮 ──
   const atBtn = document.createElement('button');
   atBtn.className = 'openagent-at-btn';
@@ -3079,10 +3215,15 @@ function tryInject() {
   if (toolbarRow) {
     const toolbarLeft = toolbarRow.querySelector('[class*="toolbar-left"]') || toolbarRow;
     const iconButtons = toolbarLeft.querySelectorAll('button, [role="button"]');
+    // 优先按 aria-label 匹配 voice/mic 按钮，回退到位置假设
     let micBtn = null;
-    if (iconButtons.length >= 2) {
-      micBtn = iconButtons[1];
-    } else if (iconButtons.length === 1) {
+    for (var i = 0; i < iconButtons.length; i++) {
+      var label = (iconButtons[i].getAttribute('aria-label') || '').toLowerCase();
+      if (/voice|mic|语音|麦克风/.test(label)) { micBtn = iconButtons[i]; break; }
+    }
+    if (!micBtn && iconButtons.length >= 2) {
+      micBtn = iconButtons[1]; // fallback: v4.x 中 mic 一般是第 2 个按钮
+    } else if (!micBtn && iconButtons.length === 1) {
       micBtn = iconButtons[0];
     }
 
@@ -3092,16 +3233,19 @@ function tryInject() {
       toolbarLeft.appendChild(atBtn);
     }
   } else {
-    (textareaParent || textarea.parentElement).appendChild(atBtn);
+    // 无工具栏时回退到 textarea 的父级插入
+    var fallbackParent = textarea.parentElement;
+    if (fallbackParent) fallbackParent.appendChild(atBtn);
   }
 
   // ── 给输入区域加 position: relative 包裹层 ──
+  var inputParent = textarea.parentElement;
   const inputContainer = textarea.closest('.agent-chat__composer-combobox')
                       || textarea.closest('.chat-input')
                       || textarea.closest('[class*="chat-composer"]')
                       || textarea.closest('[class*="chat"]')
-                      || textareaParent?.parentElement
-                      || textareaParent;
+                      || (inputParent ? inputParent.parentElement : null)
+                      || inputParent;
   if (inputContainer) {
     inputContainer.classList.add('openagent-input-wrapper');
     inputWrapperRef = inputContainer;
@@ -5418,14 +5562,20 @@ function _clScan() {
   var SHELL_SELECTORS = [
     '.chat-tool-card:not(:has(.cl-remote-agent-card))',
     '.chat-tool-msg-collapse:not(:has(.cl-remote-agent-card))',
-    '.chat-tools-collapse:not(:has(.cl-remote-agent-card))'
+    '.chat-tools-collapse:not(:has(.cl-remote-agent-card))',
+    // v5.x+ variants
+    '.tool-card:not(:has(.cl-remote-agent-card))',
+    '.chat-tool-card__wrapper:not(:has(.cl-remote-agent-card))'
   ];
 
   var SUMMARY_SELECTORS = [
     '.chat-tool-card__header',
     '.chat-tool-card__title',
     '.chat-tool-msg-summary:not(.cl-remote-agent-host-shell *)',
-    '.chat-tools-summary:not(.cl-remote-agent-host-shell *)'
+    '.chat-tools-summary:not(.cl-remote-agent-host-shell *)',
+    // v5.x+ variants
+    '.tool-card__header',
+    '.tool-card__title'
   ];
 
   var INDENT_SELECTORS = [

package/src/plugin-ui/build.cjs

@@ -25,6 +25,7 @@ const MANIFEST = [
   // ── agent-book/panel ──
   'agent-book/panel/agent-data.js',
   'agent-book/panel/agent-card.js',
+  'agent-book/panel/theme-adapter.js',   // 必须在 styles.js 之前，设置 --oa-* CSS 变量
   'agent-book/panel/styles.js',
   'agent-book/panel/mention-state.js',
   'agent-book/panel/agent-book.js',

package/src/plugin-ui/modules/agent-book/panel/inject-ui.js

@@ -9,8 +9,8 @@
 //
 // tryInject() 只做 DOM 注入（@ 按钮 + CSS class），不绑定任何事件。
 
-// ── textarea 选择器（全局复用）──
-// 多策略回退：v3 "Message..." / v4 "发消息..." / 结构化选择器
+// ── textarea 选择器（多版本兼容）──
+// v3 "Message..." / v4 "发消息..." / v5.x 结构化选择器
 const _CL_TEXTAREA_SELECTOR = [
   'textarea[placeholder*="发消息"]',
   'textarea[placeholder*="Message"]',
@@ -19,6 +19,8 @@ const _CL_TEXTAREA_SELECTOR = [
   '.chat-composer textarea',
   '.chat-input textarea',
   '[class*="composer"] textarea:not([placeholder*="Search"])',
+  '[class*="chat-input"] textarea',
+  '[data-component="chat-input"] textarea',
 ].join(', ');
 
 function _getTextarea() {
@@ -134,37 +136,59 @@ function _installSendClickInterceptor() {
   }, true);
 }
 
-function tryInject() {
-  const textarea = _getTextarea();
-
-  if (!textarea) return false;
-  _installSendClickInterceptor();
-  if (document.querySelector('.openagent-at-btn')) return true; // 已注入
-
-  // ── 定位插入点：麦克风图标所在的 toolbar 行 ──
-  const textareaParent = textarea.parentElement;
-  let toolbarRow = null;
+/**
+ * 多策略定位 textarea 所在输入区域的工具栏行。
+ * v4.x: 工具栏在 textarea.parentElement.children 中
+ * v5.x: 工具栏可能嵌套在祖父容器或包含 toolbar class
+ * 返回 null 表示未找到则回退到 textarea 父级插入
+ */
+function _findToolbarRow(textarea) {
+  var parent = textarea.parentElement;
 
-  if (textareaParent) {
-    for (const child of textareaParent.children) {
-      if (child !== textarea && child.querySelector('svg')) {
-        toolbarRow = child;
-        break;
-      }
+  // 策略 1（v4.x）: textarea 兄弟元素含 SVG 图标
+  if (parent) {
+    for (var i = 0; i < parent.children.length; i++) {
+      if (parent.children[i] !== textarea && parent.children[i].querySelector('svg')) return parent.children[i];
     }
   }
-  if (!toolbarRow && textareaParent) {
-    const grandparent = textareaParent.parentElement;
+
+  // 策略 2（v4.x）: 祖父级兄弟元素含 SVG 图标
+  if (parent) {
+    var grandparent = parent.parentElement;
     if (grandparent) {
-      for (const child of grandparent.children) {
-        if (child !== textareaParent && child.querySelector('svg')) {
-          toolbarRow = child;
-          break;
-        }
+      for (var j = 0; j < grandparent.children.length; j++) {
+        if (grandparent.children[j] !== parent && grandparent.children[j].querySelector('svg')) return grandparent.children[j];
       }
     }
   }
 
+  // 策略 3（v5.x）: 搜索包含 toolbar class 的元素
+  var chatContainer = textarea.closest('[class*="chat"]');
+  if (chatContainer) {
+    var toolbarEl = chatContainer.querySelector('[class*="toolbar"]');
+    if (toolbarEl) return toolbarEl;
+  }
+
+  // 策略 4（v5.x fallback）: 搜索 voice/mic 按钮定位其容器
+  var voiceBtn = document.querySelector(
+    'button[aria-label*="voice"], button[aria-label*="语音"], ' +
+    'button[aria-label*="mic"], button[aria-label*="麦克风"]'
+  );
+  if (voiceBtn) return voiceBtn.parentElement;
+
+  return null;
+}
+
+function tryInject() {
+  const textarea = _getTextarea();
+
+  if (!textarea) return false;
+  _installSendClickInterceptor();
+  if (document.querySelector('.openagent-at-btn')) return true; // 已注入
+
+  // ── 定位插入点：麦克风图标所在的 toolbar 行（多策略）──
+  var toolbarRow = _findToolbarRow(textarea);
+
   // ── 创建 Agent Book 按钮 ──
   const atBtn = document.createElement('button');
   atBtn.className = 'openagent-at-btn';
@@ -198,10 +222,15 @@ function tryInject() {
   if (toolbarRow) {
     const toolbarLeft = toolbarRow.querySelector('[class*="toolbar-left"]') || toolbarRow;
     const iconButtons = toolbarLeft.querySelectorAll('button, [role="button"]');
+    // 优先按 aria-label 匹配 voice/mic 按钮，回退到位置假设
     let micBtn = null;
-    if (iconButtons.length >= 2) {
-      micBtn = iconButtons[1];
-    } else if (iconButtons.length === 1) {
+    for (var i = 0; i < iconButtons.length; i++) {
+      var label = (iconButtons[i].getAttribute('aria-label') || '').toLowerCase();
+      if (/voice|mic|语音|麦克风/.test(label)) { micBtn = iconButtons[i]; break; }
+    }
+    if (!micBtn && iconButtons.length >= 2) {
+      micBtn = iconButtons[1]; // fallback: v4.x 中 mic 一般是第 2 个按钮
+    } else if (!micBtn && iconButtons.length === 1) {
       micBtn = iconButtons[0];
     }
 
@@ -211,16 +240,19 @@ function tryInject() {
       toolbarLeft.appendChild(atBtn);
     }
   } else {
-    (textareaParent || textarea.parentElement).appendChild(atBtn);
+    // 无工具栏时回退到 textarea 的父级插入
+    var fallbackParent = textarea.parentElement;
+    if (fallbackParent) fallbackParent.appendChild(atBtn);
   }
 
   // ── 给输入区域加 position: relative 包裹层 ──
+  var inputParent = textarea.parentElement;
   const inputContainer = textarea.closest('.agent-chat__composer-combobox')
                       || textarea.closest('.chat-input')
                       || textarea.closest('[class*="chat-composer"]')
                       || textarea.closest('[class*="chat"]')
-                      || textareaParent?.parentElement
-                      || textareaParent;
+                      || (inputParent ? inputParent.parentElement : null)
+                      || inputParent;
   if (inputContainer) {
     inputContainer.classList.add('openagent-input-wrapper');
     inputWrapperRef = inputContainer;