openclaw-openagent 1.0.0

package/src/plugin-ui/build.cjs

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * build.js — 将 modules/ 下的源模块按显式顺序拼接为 openagent-override.js
+ *
+ * 用法: node src/plugin-ui/build.cjs
+ * 输出: src/plugin-ui/assets/openagent-override.js
+ *
+ * 规则:
+ * - 顺序由 MANIFEST 数组决定，新增模块必须手动注册
+ * - 缺少任何模块立即报错退出
+ * - 产物不入 Git，通过 prepack hook 在 npm pack/publish 时自动生成
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ═══════════════════════════════════════════════════════════════
+// MANIFEST — 显式构建顺序，不要用 readdir+sort
+// 新增模块必须在此注册，否则不进产物
+// ═══════════════════════════════════════════════════════════════
+const MANIFEST = [
+  // ── loader ──
+  'loader/shared-state.js',
+  'loader/ws-intercept.js',
+  // ── agent-book/panel ──
+  'agent-book/panel/agent-data.js',
+  'agent-book/panel/agent-card.js',
+  'agent-book/panel/styles.js',
+  'agent-book/panel/mention-state.js',
+  'agent-book/panel/agent-book.js',
+  'agent-book/panel/inject-ui.js',
+  // ── agent-book/remote-agent-tool ──
+  'agent-book/remote-agent-tool/components-core.js',
+  'agent-book/remote-agent-tool/thought-chain-card.js',
+  // ── agent-book/travelcard ──
+  'agent-book/travelcard/travel-styles.js',
+  'agent-book/travelcard/travel-cards.js',
+  'agent-book/travelcard/travel-engine.js',
+  // ── agent-book (跨模块) ──
+  'agent-book/scanner.js',
+  // ── remote-agent（renderToolCardSidebar hook）──
+  // 顺序：adapter → styles → parser/model → UI cards → hooks
+  'remote-agent/native-style-adapter.js',
+  'remote-agent/styles.js',
+  'remote-agent/chunk-parser.js',
+  'remote-agent/progress-store.js',
+  'remote-agent/tool-card-model.js',
+  'remote-agent/execution-card.js',
+  'remote-agent/markdown-renderer.js',
+  'remote-agent/output-card.js',
+  'remote-agent/render-hooks.js',
+  // ── loader (bootstrap 必须最后) ──
+  'loader/bootstrap.js',
+];
+
+// ═══════════════════════════════════════════════════════════════
+
+const modulesDir = path.join(__dirname, 'modules');
+const outFile = path.join(__dirname, 'assets', 'openagent-override.js');
+
+const HEADER = `/**
+ * OpenAgent UI Override — Auto-generated, do not edit directly!
+ *
+ * Source: src/plugin-ui/modules/
+ * Built:  ${new Date().toISOString()}
+ *
+ * To modify, edit the source modules and run:
+ *   npm run build:override
+ */
+
+(() => {
+'use strict';
+`;
+
+const FOOTER = `
+})();
+`;
+
+// ── Build Logic ──
+
+function build() {
+  console.log(`\n[${new Date().toLocaleTimeString()}] Building override...`);
+  let body = '';
+  let errors = 0;
+
+  for (const file of MANIFEST) {
+    const filePath = path.join(modulesDir, file);
+
+    if (!fs.existsSync(filePath)) {
+      console.error(`❌ Missing module: ${file}`);
+      errors++;
+      continue;
+    }
+
+    const content = fs.readFileSync(filePath, 'utf-8');
+    body += `\n// ════════════════════════════════════════════════════════════════\n`;
+    body += `// MODULE: ${file}\n`;
+    body += `// ════════════════════════════════════════════════════════════════\n\n`;
+    body += content.trimEnd() + '\n';
+  }
+
+  if (errors > 0) {
+    console.error(`\n❌ Build failed: ${errors} missing module(s)`);
+    if (!isWatchMode) process.exit(1);
+    return;
+  }
+
+  const output = HEADER + body + FOOTER;
+
+  fs.mkdirSync(path.dirname(outFile), { recursive: true });
+  fs.writeFileSync(outFile, output, 'utf-8');
+
+  const lineCount = output.split('\n').length;
+  console.log(`✅ Built: ${path.relative(process.cwd(), outFile)} (${lineCount} lines)`);
+
+  // ── Auto-deploy to runtime targets ──────────────────────────────────────
+  // 开发时自动复制到插件安装目录和 control-ui，省去手动 cp
+  // 任何 target 不存在都静默跳过（CI/CD 环境不影响）
+
+  const homedir = require('os').homedir();
+
+  const DEPLOY_TARGETS = [
+    // 插件安装目录（Gateway 启动时从这里读取并复制到 control-ui）
+    // 注意：安装目录仍使用旧路径 src/inject/，下次 npm publish 后才会变
+    path.join(homedir, '.openclaw-docker/extensions/openclaw-openagent/src/inject/assets/openagent-override.js'),
+    path.join(homedir, '.openclaw-docker/extensions/openclaw-openagent/src/plugin-ui/assets/openagent-override.js'),
+    path.join(homedir, '.openclaw/extensions/openclaw-openagent/src/inject/assets/openagent-override.js'),
+    path.join(homedir, '.openclaw/extensions/openclaw-openagent/src/plugin-ui/assets/openagent-override.js'),
+  ];
+
+  // 动态发现 control-ui 目录（通过 node 可执行文件路径推断）
+  try {
+    const nodeDir = path.dirname(process.execPath);
+    const controlUiCandidate = path.join(nodeDir, '..', 'lib', 'node_modules', 'openclaw', 'dist', 'control-ui', 'openagent-override.js');
+    DEPLOY_TARGETS.push(path.resolve(controlUiCandidate));
+  } catch {}
+
+  let deployed = 0;
+  for (const target of DEPLOY_TARGETS) {
+    try {
+      if (fs.existsSync(path.dirname(target))) {
+        fs.copyFileSync(outFile, target);
+        console.log(`  → ${path.relative(homedir, target)}`);
+        deployed++;
+      }
+    } catch {}
+  }
+
+  if (deployed > 0) {
+    console.log(`✅ Auto-deployed to ${deployed} target(s)`);
+  } else {
+    console.log('ℹ️  No deploy targets found (standalone build)');
+  }
+}
+
+// ── Execution ──
+
+const isWatchMode = process.argv.includes('--watch');
+
+build();
+
+if (isWatchMode) {
+  console.log(`\n👀 Watching for changes in ${path.relative(process.cwd(), modulesDir)}...`);
+  
+  let debounceTimer;
+  fs.watch(modulesDir, { recursive: true }, (eventType, filename) => {
+    // Ignore dot files and non-js files
+    if (!filename || filename.startsWith('.') || !filename.endsWith('.js')) return;
+    
+    clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      build();
+    }, 100);
+  });
+}

package/src/plugin-ui/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Plugin UI — UIExtensionLoader 入口
+ *
+ * 将 UI 扩展加载委托给 ui-extension-loader 模块。
+ * 保持对外 API 不变（injectControlUiOverride），内部全部走新框架。
+ */
+
+import { loadUIExtensions } from './ui-extension-loader/index.js';
+
+/**
+ * 加载全部 UI 扩展。
+ *
+ * 由 index.ts register() 调用。内部通过 Manifest Reconciler
+ * 自动完成扩展点的 apply / revert / skip。
+ */
+export async function injectControlUiOverride(): Promise<void> {
+  await loadUIExtensions();
+}

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

@@ -0,0 +1,458 @@
+
+
+// ── UI 构建 ──
+
+let panel = null;
+let backdrop = null;
+
+let inputWrapperRef = null; // 保存输入框包裹层引用
+
+// ── 键盘导航状态（§1.5）──
+// 对标 TIM index.ts:13 "let selectedIndex: number = 0"
+let selectedIndex = 0;
+let _currentAgents = [];      // 当前列表中的 agents（供键盘选中使用）
+let _currentTextarea = null;  // 当前关联的 textarea
+
+function ensurePanel() {
+if (panel) return panel;
+
+// 背景遮罩（点击关闭）
+backdrop = document.createElement('div');
+backdrop.className = 'openagent-panel-backdrop';
+backdrop.addEventListener('click', () => {
+  console.log('[openagent] 🔲 backdrop clicked → closePanel (dismissed)');
+  // backdrop 关闭 = 用户主动关闭 → 触发 dismissed（同 ESC 意图）
+  setDismissed();
+  closePanel();
+});
+document.body.appendChild(backdrop);
+
+// 全局点击诊断（捕获阶段，看最先点到什么）
+document.addEventListener('click', (e) => {
+  if (panel && panel.classList.contains('visible')) {
+    console.log('[openagent] 🔍 global click capture:', e.target.tagName, e.target.className, 'composedPath[0]:', e.composedPath()[0]?.tagName);
+  }
+}, true); // 捕获阶段
+
+// 面板 — 独立浮动卡片
+panel = document.createElement('div');
+panel.className = 'openagent-agent-panel';
+panel.innerHTML = `
+  <div class="openagent-panel-head">
+    <span class="openagent-panel-title">
+      <svg class="openagent-panel-title-icon" width="28" height="28" viewBox="0 0 56 56" fill="none">
+        <path d="M28 25H32C34.2091 25 36 26.7909 36 29V39C36 41.2091 34.2091 43 32 43H14C11.7909 43 10 41.2091 10 39V29C10 26.7909 11.7909 25 14 25H15" stroke="#12CCF6" stroke-width="3.3" stroke-linecap="round"/>
+        <path d="M39 31H42C44.2091 31 46 29.2091 46 27V17C46 14.7909 44.2091 13 42 13H24C21.7909 13 20 14.7909 20 17V27C20 29.2091 21.7909 31 24 31H30.0652C30.236 31 30.3282 31.2004 30.217 31.3302L27.5 34.5" stroke="#12CCF6" stroke-width="3.3" stroke-linecap="round"/>
+        <path d="M27 25.5L32.5 21" stroke="#12CCF6" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+      </svg>
+      <span class="panel-title-text">Agent Book</span>
+    </span>
+    <button class="openagent-panel-close">✕</button>
+  </div>
+  <hr class="openagent-panel-divider" />
+  <div class="openagent-agent-list">
+    <div class="openagent-loading">加载中...</div>
+  </div>
+`;
+panel.querySelector('.openagent-panel-close').addEventListener('click', () => {
+  // ✕ 按钮关闭 = 用户主动关闭 → 触发 dismissed（同 ESC 意图）
+  setDismissed();
+  closePanel();
+});
+
+// 挂到 body（与 backdrop 同级，z-index 自然生效）
+document.body.appendChild(panel);
+return panel;
+}
+
+/** 根据 inputWrapper 位置动态定位 panel */
+function _positionPanel() {
+if (!panel || !inputWrapperRef) return;
+const rect = inputWrapperRef.getBoundingClientRect();
+const viewportPadding = 16;
+const width = Math.min(rect.width, window.innerWidth - viewportPadding * 2);
+const left = Math.max(viewportPadding, Math.min(rect.left, window.innerWidth - width - viewportPadding));
+panel.style.left = left + 'px';
+panel.style.width = width + 'px';
+panel.style.bottom = (window.innerHeight - rect.top + 8) + 'px';
+}
+
+/** resize 时实时跟随输入框 */
+function _onResize() { _positionPanel(); }
+
+// 搜索状态管理
+let currentAbort = null;  // AbortController for in-flight search
+let searchDebounceId = null;
+
+// ── @mention → systemProvenanceReceipt 状态 ──
+// 当用户从 Agent Book 选中一个 agent 时，保存其 metadata。
+// 下次 chat.send 时作为 systemProvenanceReceipt 注入，发送后清空。
+
+/**
+ * 提取输入框文本作为搜索词（对齐 openagent-frontend NewChatPanel L82）
+ * 去掉所有 @ 符号，合并空白
+ */
+function extractSearchQuery(textarea) {
+if (!textarea) return '';
+return textarea.value.replace(/@/g, ' ').replace(/\s+/g, ' ').trim();
+}
+
+function openPanel(textarea) {
+const p = ensurePanel();
+_positionPanel(); // 动态定位到 input 上方
+p.classList.add('visible');
+backdrop.classList.add('visible');
+window.addEventListener('resize', _onResize);
+
+const list = p.querySelector('.openagent-agent-list');
+list.innerHTML = '<div class="openagent-loading">加载中...</div>';
+
+// 提取当前输入文本作为搜索词
+const query = extractSearchQuery(textarea);
+console.log('[openagent] openPanel with search query:', JSON.stringify(query));
+
+// 动态生成面板标题 tagline
+_updatePanelTagline(query);
+
+if (query) {
+  // 有输入文本 → 语义搜索
+  searchAgents(query).then(agents => {
+    if (!p.classList.contains('visible')) return;
+    renderAgentList(list, agents, textarea, query);
+  });
+} else {
+  // 空输入 → 全量列表
+  fetchAgentSections().then(agents => {
+    if (!p.classList.contains('visible')) return;
+    renderAgentList(list, agents, textarea, query);
+  });
+}
+}
+
+/** 更新面板标题：优先 API，降级到客户端生成 */
+let _authSigCache = null; // { userSig, expiresAt }
+
+async function _getAuthSig() {
+if (_authSigCache && Date.now() < _authSigCache.expiresAt) {
+  return _authSigCache.userSig;
+}
+try {
+  const res = await fetch('./openagent-auth.json?t=' + Date.now());
+  if (!res.ok) return null;
+  const data = await res.json();
+  if (data?.userSig) {
+    _authSigCache = data;
+    return data.userSig;
+  }
+} catch { }
+return null;
+}
+
+function _updatePanelTagline(query) {
+if (!panel) return;
+const titleEl = panel.querySelector('.panel-title-text');
+if (!titleEl) return;
+
+// 客户端即时文案（无延迟）
+const localTagline = query
+  ? `匹配${query.length > 12 ? query.slice(0, 12) + '…' : query}AGENT`
+  : '在线AGENT | 2.4M';
+titleEl.textContent = localTagline;
+console.log('[openagent] tagline: query=', JSON.stringify(query), 'local=', localTagline);
+
+// 异步获取鉴权 + 调用 tagline API
+_getAuthSig().then(sig => {
+  console.log('[openagent] tagline: authSig=', sig ? `${sig.slice(0,20)}...` : 'null');
+  if (!sig) return; // 无鉴权，保持客户端文案
+  return fetch(TAGLINE_API, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${sig}`,
+    },
+    body: JSON.stringify({ type: 'tagline', query: query || '' }),
+  });
+})
+  .then(r => {
+    console.log('[openagent] tagline: response status=', r?.status);
+    return r?.ok ? r.json() : null;
+  })
+  .then(data => {
+    console.log('[openagent] tagline: API result=', JSON.stringify(data));
+    // 标题固定为 Agent Book，不再被 API 覆盖
+  })
+  .catch(err => { console.warn('[openagent] tagline error:', err); });
+}
+
+/**
+ * 实时搜索更新（debounce 300ms，对齐 MentionPickerPopup）
+ * 当面板打开时，textarea 每次输入都会触发
+ */
+function updatePanelSearch(textarea) {
+if (!panel || !panel.classList.contains('visible')) return;
+
+// 取消前一个请求
+if (currentAbort) currentAbort.abort();
+if (searchDebounceId) clearTimeout(searchDebounceId);
+
+const query = extractSearchQuery(textarea);
+const list = panel.querySelector('.openagent-agent-list');
+
+searchDebounceId = setTimeout(() => {
+  currentAbort = new AbortController();
+  const signal = currentAbort.signal;
+
+  list.innerHTML = '<div class="openagent-loading">搜索中...</div>';
+
+  // 同步更新面板标题
+  _updatePanelTagline(query);
+
+  const doSearch = query
+    ? searchAgents(query, signal)
+    : fetchAgentSections();
+
+  doSearch.then(agents => {
+    if (signal.aborted) return;
+    if (!panel.classList.contains('visible')) return;
+    renderAgentList(list, agents, textarea, query);
+  });
+}, 300);
+}
+
+function closePanel() {
+if (panel) panel.classList.remove('visible');
+if (backdrop) backdrop.classList.remove('visible');
+window.removeEventListener('resize', _onResize);
+// 清理搜索状态
+if (currentAbort) { currentAbort.abort(); currentAbort = null; }
+if (searchDebounceId) { clearTimeout(searchDebounceId); searchDebounceId = null; }
+// 同步状态机（如果 dismissed 已由 setDismissed() 设置则不覆盖）
+closeMention();
+}
+
+// ── 键盘导航函数（§1.5）──
+// 对标 TIM index.ts:158-173 upHandler/downHandler/enterHandler
+
+function moveSelectionUp() {
+  const len = _currentAgents.length;
+  if (!len) return;
+  selectedIndex = (selectedIndex + len - 1) % len;
+  _highlightItem(selectedIndex);
+  _scrollItemIntoView(selectedIndex);
+}
+
+function moveSelectionDown() {
+  const len = _currentAgents.length;
+  if (!len) return;
+  selectedIndex = (selectedIndex + 1) % len;
+  _highlightItem(selectedIndex);
+  _scrollItemIntoView(selectedIndex);
+}
+
+function selectHighlightedAgent(textarea) {
+  const agent = _currentAgents[selectedIndex];
+  const ta = textarea || _currentTextarea;
+  if (agent && ta) {
+    insertMention(ta, agent.name, agent);
+    resetMention(); // 选中 Agent = 正常完成，清空一切（不触发 dismissed）
+    closePanel();
+  }
+}
+
+function _highlightItem(index) {
+  if (!panel) return;
+  const cards = panel.querySelectorAll('.openagent-agent-list .agent-card');
+  cards.forEach((c, i) => {
+    c.classList.toggle('openagent-card-selected', i === index);
+  });
+}
+
+function _scrollItemIntoView(index) {
+  if (!panel) return;
+  const cards = panel.querySelectorAll('.openagent-agent-list .agent-card');
+  if (cards[index]) {
+    cards[index].scrollIntoView({ block: 'nearest', behavior: 'smooth' });
+  }
+}
+
+function _appendParentSection(container, parentTitle, children, textarea, renderedAgents) {
+  const parentSec = _el('section', 'openagent-parent-section');
+  parentSec.appendChild(_text('div', 'openagent-parent-heading', parentTitle));
+  children.forEach(function(child) {
+    if (child.agents && child.agents.length > 0) {
+      _appendAgentSection(parentSec, child.title, child.agents, textarea, renderedAgents);
+    }
+  });
+  container.appendChild(parentSec);
+}
+
+function _appendAgentSection(container, title, agents, textarea, renderedAgents) {
+  if (!agents.length) return;
+  const section = _el('section', 'openagent-agent-section');
+  section.appendChild(_text('div', 'openagent-section-heading', title));
+
+  const grid = _el('div', 'openagent-section-grid');
+  agents.forEach((a) => {
+    const displayIndex = renderedAgents.length;
+    const card = AgentCard(a, {
+      mode: 'mention',
+      onAction: () => {
+        console.log('[openagent] onAction fired for:', a.name);
+        insertMention(textarea, a.name, a);
+        resetMention(); // 点击选中 = 正常完成，清空一切
+        closePanel();
+      }
+    });
+    card.dataset.tag = a.tag || '';
+    card.dataset.name = a.name || '';
+    card.dataset.index = displayIndex;
+    grid.appendChild(card);
+    renderedAgents.push(a);
+
+    card.addEventListener('mousedown', () => console.log('[openagent] 🖱 mousedown on card:', a.name));
+    const tryBtn = card.querySelector('.agent-card__action');
+    if (tryBtn) {
+      tryBtn.addEventListener('mousedown', (e) => {
+        console.log('[openagent] 🖱 mousedown on Try btn:', a.name, 'target:', e.target.tagName, e.target.className);
+      });
+    }
+  });
+  section.appendChild(grid);
+  container.appendChild(section);
+}
+
+function _appendSearchResults(container, agents, textarea, renderedAgents) {
+  const list = _el('div', 'openagent-search-results');
+  agents.forEach((a) => {
+    const displayIndex = renderedAgents.length;
+    const card = AgentCard(a, {
+      mode: 'search',
+      onAction: () => {
+        insertMention(textarea, a.name, a);
+        resetMention();
+        closePanel();
+      }
+    });
+    card.dataset.tag = a.tag || '';
+    card.dataset.name = a.name || '';
+    card.dataset.index = displayIndex;
+    list.appendChild(card);
+    renderedAgents.push(a);
+  });
+  container.appendChild(list);
+}
+
+function renderAgentList(container, agents, textarea, query) {
+if (!agents.length) {
+  const message = CL.agentBookLastError || '暂无在线 Agent';
+  container.innerHTML = '';
+  container.appendChild(_text('div', 'openagent-loading', message));
+  _currentAgents = [];
+  _currentTextarea = textarea;
+  return;
+}
+
+console.log('[openagent] renderAgentList:', agents.length, 'agents, textarea:', !!textarea);
+
+container.innerHTML = '';
+_currentTextarea = textarea;
+
+const renderedAgents = [];
+const normalizedQuery = (query || '').trim();
+if (normalizedQuery) {
+  _appendSearchResults(container, agents, textarea, renderedAgents);
+} else {
+  agents.forEach(section => {
+    if (section.children && section.children.length > 0) {
+      _appendParentSection(container, section.title, section.children, textarea, renderedAgents);
+    } else {
+      _appendAgentSection(container, section.title, section.agents || [], textarea, renderedAgents);
+    }
+  });
+}
+
+// 保存 DOM 顺序中的 agents 列表，供键盘导航使用
+_currentAgents = renderedAgents;
+
+// 默认高亮第一项（§1.5 默认选中）
+// 对标 TIM index.ts:13 "selectedIndex = 0" + index.vue:32 ":class=[index===selectedIndex&&'selected']"
+selectedIndex = 0;
+_highlightItem(0);
+}
+
+/**
+ * 选中 Agent 后插入 @name 到 textarea
+ * 对齐 openagent-frontend NewChatPanel L92-105：
+ * 找到最后一个 @，替换其后内容为 @agentName
+ */
+function insertMention(textarea, agentName, agentData) {
+// 重新查找 textarea（Lit 可能重新渲染导致引用失效）
+const liveTextarea = document.querySelector(
+  'textarea[placeholder*="Message"]'
+) || document.querySelector(
+  'textarea[placeholder*="Enter to send"]'
+) || textarea;
+
+console.log('[openagent] insertMention:', agentName,
+  'textarea found:', !!liveTextarea,
+  'same ref:', liveTextarea === textarea);
+
+if (!liveTextarea) return;
+liveTextarea.focus();
+
+// 存储 agent 信息，发送时替换为 {openagent:...} 标记
+const agentId = agentData?.agent_id || agentData?.agentId || agentData?.id || agentData?.tag ||
+  agentData?.user_id || agentData?.userId || agentData?.identifier || agentData?.tim_user_id || agentData?.timUserId || '';
+const agentAvatar = agentData?.avatar || agentData?.avatar_url || agentData?.avatarUrl || agentData?.image || agentData?.logo || agentData?.photo || null;
+console.log('[cl-diag][mention-select]', {
+  agentName,
+  resolvedAgentId: agentId || null,
+  rawKeys: Object.keys(agentData || {}),
+  rawAgent: agentData,
+});
+if (!agentId) {
+  CL.pendingMention = null;
+  console.warn('[openagent] mention skipped: missing agent identifier for', agentName, agentData);
+  return;
+}
+CL.pendingMention = { agent_id: agentId, name: agentName, avatar: agentAvatar };
+if (CL && typeof CL.storeAgentIdentity === 'function') {
+  CL.storeAgentIdentity({ agent_id: agentId, name: agentName, avatar: agentAvatar });
+}
+console.log('[openagent] mention stored:', CL.pendingMention);
+
+// textarea 显示 @agentName（用户友好）
+const val = liveTextarea.value;
+const lastAtIndex = val.lastIndexOf('@');
+let newValue;
+if (lastAtIndex !== -1) {
+  const before = val.slice(0, lastAtIndex).trimEnd();
+  newValue = before ? `${before} @${agentName} ` : `@${agentName} `;
+} else {
+  newValue = `${val}@${agentName} `;
+}
+
+// 设置值
+const nativeInputValueSetter = Object.getOwnPropertyDescriptor(
+  HTMLTextAreaElement.prototype, 'value'
+)?.set;
+if (nativeInputValueSetter) {
+  nativeInputValueSetter.call(liveTextarea, newValue);
+} else {
+  liveTextarea.value = newValue;
+}
+
+// 光标到末尾
+liveTextarea.selectionStart = liveTextarea.selectionEnd = newValue.length;
+
+// 触发事件让 Lit 识别变化
+liveTextarea.dispatchEvent(new Event('input', { bubbles: true }));
+liveTextarea.dispatchEvent(new Event('change', { bubbles: true }));
+
+// 标记替换由 window.__clMention.onKeyDown 在 OC 注入钩子中处理
+// 不再需要独立的 _installSendInterceptor
+}
+
+// _installSendInterceptor 已移除（v3）
+// 标记替换逻辑迁移到 inject-ui.js → window.__clMention.onKeyDown
+// 在 OC 的 handleKeyDown 钩子中执行，优先级在 slash menu 之后、Enter 发送之前