openclaw-openagent 1.0.7 → 1.0.9

package/src/auth/config.ts

@@ -10,6 +10,8 @@
  */
 
 const DEFAULT_API_BASE = 'https://api.openagent.club';
+const DEFAULT_OASN_PUBLIC_ROOT = 'https://oasn-test.haimawan.com';
+const OASN_ENV_ID_RE = /^[A-Za-z0-9_-]+$/;
 /**
  * OASN 默认 API base。
  *
@@ -22,6 +24,55 @@ export function isUnconfiguredOasnApiBase(value: string | undefined): boolean {
   return !value || value === DEFAULT_OASN_API_BASE;
 }
 
+function normalizeOasnApiBase(value: unknown): string {
+  const normalized = String(value || '')
+    .trim()
+    .replace(/\/+$/, '')
+    .replace(/\/api$/, '');
+  return normalized === DEFAULT_OASN_API_BASE ? '' : normalized;
+}
+
+function normalizeOasnEnvId(value: unknown): string {
+  const envId = String(value || '').trim();
+  if (!envId) return '';
+  return OASN_ENV_ID_RE.test(envId) ? envId : '';
+}
+
+function oasnPublicBaseFromEnvId(envId: string): string {
+  const normalized = normalizeOasnEnvId(envId);
+  if (!normalized) return '';
+  const root = normalizeOasnApiBase(process.env.OASN_PUBLIC_ROOT || process.env.OPENAGENT_OASN_PUBLIC_ROOT || DEFAULT_OASN_PUBLIC_ROOT);
+  return `${root}/e/${normalized}`;
+}
+
+function resolveOasnBase({
+  accountBase,
+  channelBase,
+  envBase,
+  accountEnvId,
+  channelEnvId,
+  envEnvId,
+  fallbackBase,
+}: {
+  accountBase?: unknown;
+  channelBase?: unknown;
+  envBase?: unknown;
+  accountEnvId?: unknown;
+  channelEnvId?: unknown;
+  envEnvId?: unknown;
+  fallbackBase: string;
+}): string {
+  const configuredBase = normalizeOasnApiBase(accountBase) || normalizeOasnApiBase(channelBase);
+  if (configuredBase) return configuredBase;
+  const configuredEnvId = normalizeOasnEnvId(accountEnvId) || normalizeOasnEnvId(channelEnvId);
+  if (configuredEnvId) return oasnPublicBaseFromEnvId(configuredEnvId);
+  const ambientBase = normalizeOasnApiBase(envBase);
+  if (ambientBase) return ambientBase;
+  const ambientEnvId = normalizeOasnEnvId(envEnvId);
+  if (ambientEnvId) return oasnPublicBaseFromEnvId(ambientEnvId);
+  return fallbackBase;
+}
+
 /**
  * Transport 类型 —— v3.9+ 双轨抽象。
  *
@@ -132,19 +183,37 @@ export function resolveOpenagentAccount(
   const envApiBase = transport === 'oasn'
     ? (process.env.OASN_API_BASE || process.env.OPENAGENT_OASN_API_BASE || '')
     : '';
-  const apiBase = (targetAcc['api_base'] || targetAcc['apiBase']
-    || clCfg['api_base']
-    || clCfg['apiBase']
-    || envApiBase
-    || fallbackApiBase) as string;
+  const apiBase = transport === 'oasn'
+    ? resolveOasnBase({
+        accountBase: targetAcc['api_base'] || targetAcc['apiBase'],
+        channelBase: clCfg['api_base'] || clCfg['apiBase'],
+        envBase: envApiBase,
+        accountEnvId: targetAcc['oasn_env_id'] || targetAcc['oasnEnvId'] || targetAcc['env_id'] || targetAcc['envId'],
+        channelEnvId: clCfg['oasn_env_id'] || clCfg['oasnEnvId'] || clCfg['env_id'] || clCfg['envId'],
+        envEnvId: process.env.OASN_ENV_ID || process.env.OPENAGENT_OASN_ENV_ID,
+        fallbackBase: fallbackApiBase,
+      })
+    : (targetAcc['api_base'] || targetAcc['apiBase']
+        || clCfg['api_base']
+        || clCfg['apiBase']
+        || fallbackApiBase) as string;
   const envAccessApiBase = transport === 'oasn'
     ? (process.env.OASN_ACCESS_API_BASE || process.env.OPENAGENT_OASN_ACCESS_API_BASE || '')
     : '';
-  const accessApiBase = (targetAcc['access_api_base'] || targetAcc['accessApiBase']
-    || clCfg['access_api_base']
-    || clCfg['accessApiBase']
-    || envAccessApiBase
-    || apiBase) as string;
+  const accessApiBase = transport === 'oasn'
+    ? resolveOasnBase({
+        accountBase: targetAcc['access_api_base'] || targetAcc['accessApiBase'],
+        channelBase: clCfg['access_api_base'] || clCfg['accessApiBase'],
+        envBase: envAccessApiBase,
+        accountEnvId: targetAcc['oasn_env_id'] || targetAcc['oasnEnvId'] || targetAcc['env_id'] || targetAcc['envId'],
+        channelEnvId: clCfg['oasn_env_id'] || clCfg['oasnEnvId'] || clCfg['env_id'] || clCfg['envId'],
+        envEnvId: process.env.OASN_ENV_ID || process.env.OPENAGENT_OASN_ENV_ID,
+        fallbackBase: apiBase,
+      })
+    : (targetAcc['access_api_base'] || targetAcc['accessApiBase']
+        || clCfg['access_api_base']
+        || clCfg['accessApiBase']
+        || apiBase) as string;
   const claimUrl = (targetAcc['claim_url'] || targetAcc['claimUrl'] || clCfg['claim_url'] || clCfg['claimUrl'] || '') as string;
   const rawStatus = (targetAcc['status'] || targetAcc['claim_status'] || targetAcc['claimStatus'] || clCfg['status'] || '') as string;
   const normalizedStatus = normalizeClaimStatus(rawStatus, agentId, apiKey);

package/src/channel.ts

@@ -13,6 +13,7 @@ import { registry } from './runtime/registry.js';
 import { AccountRuntime } from './runtime/account.js';
 
 import { logger } from './util/logger.js';
+import { resolveOasnRelativeUrl } from './util/url-resolver.js';
 import * as timMessages from './tim/messages.js';
 
 const API_BASE = 'https://api.clawlink.club';
@@ -544,7 +545,7 @@ async function claimOasnAgent(
   agentId: string,
   ownerEmail: string,
 ): Promise<Record<string, unknown>> {
-  const res = await fetch(new URL('/api/agents/claim', apiBase), {
+  const res = await fetch(resolveOasnRelativeUrl(apiBase, '/api/agents/claim'), {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',

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-25T09:33:52.490Z
+ * Built:  2026-06-29T06:32:31.586Z
  *
  * To modify, edit the source modules and run:
  *   npm run build:override
@@ -3129,6 +3129,23 @@ function _installSendClickInterceptor() {
   }, true);
 }
 
+function _installSendKeydownInterceptor() {
+  if (window.__openagentSendKeydownInterceptorInstalled) return;
+  window.__openagentSendKeydownInterceptorInstalled = true;
+  document.addEventListener('keydown', function(e) {
+    if (!CL.pendingMention || CL.remoteSendInFlight) return;
+    if (e.key !== 'Enter' || e.shiftKey || e.isComposing) return;
+
+    const textarea = _getTextarea();
+    if (!textarea || e.target !== textarea) return;
+
+    e.preventDefault();
+    e.stopPropagation();
+    if (typeof e.stopImmediatePropagation === 'function') e.stopImmediatePropagation();
+    _sendPendingMention(textarea);
+  }, true);
+}
+
 /**
  * 多策略定位 textarea 所在输入区域的工具栏行。
  * v4.x: 工具栏在 textarea.parentElement.children 中
@@ -3177,6 +3194,7 @@ function tryInject() {
 
   if (!textarea) return false;
   _installSendClickInterceptor();
+  _installSendKeydownInterceptor();
   if (document.querySelector('.openagent-at-btn')) return true; // 已注入
 
   // ── 定位插入点：麦克风图标所在的 toolbar 行（多策略）──
@@ -6294,6 +6312,67 @@ function _clScan() {
     '  font-size: 12px;',
     '}',
 
+    // ── 附件下载区 ──
+    '.cl-openagent-media-links {',
+    '  display: flex;',
+    '  flex-wrap: wrap;',
+    '  gap: 8px;',
+    '  width: 100%;',
+    '  box-sizing: border-box;',
+    '  padding: 6px 18px 12px;',
+    '}',
+    '.cl-openagent-media-link {',
+    '  display: inline-grid;',
+    '  grid-template-columns: auto auto;',
+    '  grid-template-areas: "icon action" "icon file";',
+    '  align-items: center;',
+    '  column-gap: 8px;',
+    '  row-gap: 1px;',
+    '  max-width: min(100%, 360px);',
+    '  box-sizing: border-box;',
+    '  padding: 8px 10px;',
+    '  border: 1px solid rgba(47,47,51,0.12);',
+    '  border-radius: 8px;',
+    '  background: rgba(47,47,51,0.03);',
+    '  color: rgba(47,47,51,0.90) !important;',
+    '  text-decoration: none !important;',
+    '  font-family: "PingFang SC", sans-serif;',
+    '}',
+    '.cl-openagent-media-link:hover {',
+    '  background: rgba(16,189,235,0.08);',
+    '  border-color: rgba(16,189,235,0.35);',
+    '}',
+    '.cl-openagent-media-link-icon {',
+    '  grid-area: icon;',
+    '  width: 28px;',
+    '  height: 28px;',
+    '  border-radius: 6px;',
+    '  background: rgba(16,189,235,0.12);',
+    '  color: #088BAE;',
+    '  display: inline-flex;',
+    '  align-items: center;',
+    '  justify-content: center;',
+    '  font-size: 11px;',
+    '  font-weight: 700;',
+    '}',
+    '.cl-openagent-media-link-text {',
+    '  grid-area: action;',
+    '  min-width: 0;',
+    '  font-size: 13px;',
+    '  font-weight: 600;',
+    '  line-height: 1.2;',
+    '}',
+    '.cl-openagent-media-link-file {',
+    '  grid-area: file;',
+    '  min-width: 0;',
+    '  overflow: hidden;',
+    '  text-overflow: ellipsis;',
+    '  white-space: nowrap;',
+    '  font-size: 11px;',
+    '  line-height: 1.2;',
+    '  color: rgba(47,47,51,0.50);',
+    '}',
+
     // ── 错误状态 ──
     '.cl-remote-agent-card--error {',
     '  border-color: rgba(220, 38, 38, 0.3);',
@@ -7504,6 +7583,162 @@ function _clRenderOutputMarkdown(text) {
   return result;
 }
 
+// ════════════════════════════════════════════════════════════════
+// MODULE: remote-agent/media-links.js
+// ════════════════════════════════════════════════════════════════
+
+// ── OpenAgent Media Links — toolResult MEDIA: protocol renderer ──
+//
+// OpenClaw host parses MEDIA: links in assistant text, but remote-agent
+// toolResult text is rendered through the plugin card path. Keep this parser
+// local to the card so OASN artifacts become visible downloads.
+
+function _clExtractOpenagentMediaLinksFromText(rawText) {
+  var value = String(rawText || '');
+  var links = [];
+  var seen = Object.create(null);
+
+  function addUrl(rawUrl) {
+    var url = _clNormalizeOpenagentMediaUrl(rawUrl);
+    if (!url || seen[url]) return;
+    seen[url] = true;
+
+    var fileName = _clGetOpenagentMediaFileName(url);
+    links.push({
+      url: url,
+      fileName: fileName,
+      extension: _clInferOpenagentMediaExtension(fileName),
+    });
+  }
+
+  var re = /^\s*MEDIA:\s*(\S+)\s*$/gm;
+  var match;
+
+  while ((match = re.exec(value)) !== null) {
+    addUrl(match[1]);
+  }
+
+  var markdownRe = /\[[^\]]+\]\((https?:\/\/[^)\s]+|\/[^)\s]+)\)/g;
+  while ((match = markdownRe.exec(value)) !== null) {
+    addUrl(match[1]);
+  }
+
+  return links;
+}
+
+function _clExtractOpenagentMediaLinksFromModel(model) {
+  var allText = [];
+  if (model && model.rawText) allText.push(model.rawText);
+  var chunks = model && Array.isArray(model.chunks) ? model.chunks : [];
+  for (var i = 0; i < chunks.length; i++) {
+    if (chunks[i] && chunks[i].text) allText.push(chunks[i].text);
+  }
+  return _clExtractOpenagentMediaLinksFromText(allText.join('\n'));
+}
+
+function _clNormalizeOpenagentMediaUrl(rawUrl) {
+  var value = String(rawUrl || '').trim();
+  if (!value) return '';
+  value = value.replace(/^[`'"]+/, '').replace(/[`'".,;)\]]+$/, '');
+
+  if (value.charAt(0) === '/') return value;
+
+  try {
+    var parsed = new URL(value);
+    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') return value;
+  } catch (e) {}
+
+  return '';
+}
+
+function _clGetOpenagentMediaFileName(url) {
+  var pathValue = '';
+  try {
+    var base = (typeof window !== 'undefined' && window.location && window.location.href)
+      ? window.location.href
+      : 'http://127.0.0.1/';
+    pathValue = new URL(url, base).pathname || '';
+  } catch (e) {
+    pathValue = String(url || '').split('?')[0] || '';
+  }
+
+  var parts = pathValue.split('/');
+  var fileName = parts[parts.length - 1] || 'artifact';
+  try {
+    fileName = decodeURIComponent(fileName);
+  } catch (e) {}
+  return fileName || 'artifact';
+}
+
+function _clInferOpenagentMediaExtension(fileName) {
+  var match = String(fileName || '').toLowerCase().match(/\.([a-z0-9]{1,12})$/);
+  return match ? match[1] : '';
+}
+
+function _clStripOpenagentMediaLines(rawText) {
+  return String(rawText || '')
+    .split(/\r?\n/)
+    .filter(function(line) { return !/^\s*MEDIA:\s*/.test(line); })
+    .join('\n')
+    .trim();
+}
+
+function _clCreateOpenagentMediaLinksSection(links) {
+  if (!Array.isArray(links) || links.length === 0) return null;
+
+  var section = document.createElement('div');
+  section.className = 'cl-openagent-media-links';
+
+  for (var i = 0; i < links.length; i++) {
+    var link = links[i] || {};
+    if (!link.url) continue;
+
+    var anchor = document.createElement('a');
+    anchor.className = 'cl-openagent-media-link';
+    anchor.href = link.url;
+    anchor.target = '_blank';
+    anchor.rel = 'noopener noreferrer';
+    anchor.download = link.fileName || '';
+    anchor.title = link.fileName || link.url;
+
+    var icon = document.createElement('span');
+    icon.className = 'cl-openagent-media-link-icon';
+    icon.textContent = _clGetOpenagentMediaIconText(link.extension);
+    anchor.appendChild(icon);
+
+    var text = document.createElement('span');
+    text.className = 'cl-openagent-media-link-text';
+    text.textContent = _clGetOpenagentMediaActionText(link.extension);
+    anchor.appendChild(text);
+
+    var file = document.createElement('span');
+    file.className = 'cl-openagent-media-link-file';
+    file.textContent = link.fileName || 'artifact';
+    anchor.appendChild(file);
+
+    section.appendChild(anchor);
+  }
+
+  return section.childNodes.length > 0 ? section : null;
+}
+
+function _clGetOpenagentMediaActionText(extension) {
+  var ext = String(extension || '').toUpperCase();
+  if (!ext) return '下载附件';
+  return '下载 ' + ext;
+}
+
+function _clGetOpenagentMediaIconText(extension) {
+  extension = String(extension || '').toLowerCase();
+  if (extension === 'pptx' || extension === 'ppt') return 'P';
+  if (extension === 'docx' || extension === 'doc') return 'D';
+  if (extension === 'xlsx' || extension === 'xls' || extension === 'csv') return 'X';
+  if (extension === 'json') return '{}';
+  if (extension === 'md' || extension === 'txt') return 'T';
+  if (extension === 'zip') return 'Z';
+  return 'F';
+}
+
 // ════════════════════════════════════════════════════════════════
 // MODULE: remote-agent/output-card.js
 // ════════════════════════════════════════════════════════════════
@@ -7521,20 +7756,30 @@ function _clRenderOutputMarkdown(text) {
 // UI 结构复用 shared thought-chain styles；数据来源是 RenderHook model。
 
 function _clRenderOutputCard(model, onOpenSidebar) {
+  var mediaLinks = typeof _clExtractOpenagentMediaLinksFromModel === 'function'
+    ? _clExtractOpenagentMediaLinksFromModel(model)
+    : [];
+
   // ── 从 chunks 提取最终结果。SSE 思考链只由 call/execution card 展示，避免重复。──
   var resultTexts = [];
   for (var i = 0; i < model.chunks.length; i++) {
     var chunk = model.chunks[i];
     if (chunk.type === 'result') {
-      if (_clShouldRenderOutputText(chunk.text)) resultTexts.push(chunk.text);
+      var resultText = typeof _clStripOpenagentMediaLines === 'function'
+        ? _clStripOpenagentMediaLines(chunk.text)
+        : chunk.text;
+      if (_clShouldRenderOutputText(resultText)) resultTexts.push(resultText);
     } else if (chunk.type === 'text') {
       // 远端 Agent 最终回复是普通文本（toolResult(reply.content)），
       // chunk-parser 归为 type='text'，也应作为最终结果显示
-      if (_clShouldRenderOutputText(chunk.text)) resultTexts.push(chunk.text);
+      var textChunk = typeof _clStripOpenagentMediaLines === 'function'
+        ? _clStripOpenagentMediaLines(chunk.text)
+        : chunk.text;
+      if (_clShouldRenderOutputText(textChunk)) resultTexts.push(textChunk);
     }
   }
 
-  if (resultTexts.length === 0) {
+  if (resultTexts.length === 0 && mediaLinks.length === 0) {
     var placeholder = document.createElement('span');
     placeholder.className = 'cl-remote-agent-card cl-remote-agent-output-placeholder';
     placeholder.style.display = 'none';
@@ -7547,7 +7792,8 @@ function _clRenderOutputCard(model, onOpenSidebar) {
   }
 
   var container = document.createElement('div');
-  container.className = 'cl-remote-agent-card cl-thought-chain cl-output-card cl-output-card--pending';
+  container.className = 'cl-remote-agent-card cl-thought-chain cl-output-card'
+    + (resultTexts.length > 0 ? ' cl-output-card--pending' : '');
   container.dataset.clCardRole = 'output';
   if (CL && typeof CL.diagMarkCard === 'function') {
     CL.diagMarkCard(container, 'output', { tcid: model.toolCallId || '' });
@@ -7575,6 +7821,12 @@ function _clRenderOutputCard(model, onOpenSidebar) {
   divider.className = 'cl-thought-chain-divider';
   content.appendChild(divider);
 
+  // ── 附件下载链接 ──
+  if (mediaLinks.length > 0 && typeof _clCreateOpenagentMediaLinksSection === 'function') {
+    var mediaSection = _clCreateOpenagentMediaLinksSection(mediaLinks);
+    if (mediaSection) content.appendChild(mediaSection);
+  }
+
   // ── 最终结果展示 ──
   if (resultTexts.length > 0) {
     var resultSection = document.createElement('div');

package/src/plugin-ui/build.cjs

@@ -48,6 +48,7 @@ const MANIFEST = [
   'remote-agent/tool-card-model.js',
   'remote-agent/execution-card.js',
   'remote-agent/markdown-renderer.js',
+  'remote-agent/media-links.js',
   'remote-agent/output-card.js',
   'remote-agent/render-hooks.js',
   // ── loader (bootstrap 必须最后) ──

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

@@ -136,6 +136,23 @@ function _installSendClickInterceptor() {
   }, true);
 }
 
+function _installSendKeydownInterceptor() {
+  if (window.__openagentSendKeydownInterceptorInstalled) return;
+  window.__openagentSendKeydownInterceptorInstalled = true;
+  document.addEventListener('keydown', function(e) {
+    if (!CL.pendingMention || CL.remoteSendInFlight) return;
+    if (e.key !== 'Enter' || e.shiftKey || e.isComposing) return;
+
+    const textarea = _getTextarea();
+    if (!textarea || e.target !== textarea) return;
+
+    e.preventDefault();
+    e.stopPropagation();
+    if (typeof e.stopImmediatePropagation === 'function') e.stopImmediatePropagation();
+    _sendPendingMention(textarea);
+  }, true);
+}
+
 /**
  * 多策略定位 textarea 所在输入区域的工具栏行。
  * v4.x: 工具栏在 textarea.parentElement.children 中
@@ -184,6 +201,7 @@ function tryInject() {
 
   if (!textarea) return false;
   _installSendClickInterceptor();
+  _installSendKeydownInterceptor();
   if (document.querySelector('.openagent-at-btn')) return true; // 已注入
 
   // ── 定位插入点：麦克风图标所在的 toolbar 行（多策略）──

package/src/plugin-ui/modules/remote-agent/media-links.js

@@ -0,0 +1,151 @@
+// ── OpenAgent Media Links — toolResult MEDIA: protocol renderer ──
+//
+// OpenClaw host parses MEDIA: links in assistant text, but remote-agent
+// toolResult text is rendered through the plugin card path. Keep this parser
+// local to the card so OASN artifacts become visible downloads.
+
+function _clExtractOpenagentMediaLinksFromText(rawText) {
+  var value = String(rawText || '');
+  var links = [];
+  var seen = Object.create(null);
+
+  function addUrl(rawUrl) {
+    var url = _clNormalizeOpenagentMediaUrl(rawUrl);
+    if (!url || seen[url]) return;
+    seen[url] = true;
+
+    var fileName = _clGetOpenagentMediaFileName(url);
+    links.push({
+      url: url,
+      fileName: fileName,
+      extension: _clInferOpenagentMediaExtension(fileName),
+    });
+  }
+
+  var re = /^\s*MEDIA:\s*(\S+)\s*$/gm;
+  var match;
+
+  while ((match = re.exec(value)) !== null) {
+    addUrl(match[1]);
+  }
+
+  var markdownRe = /\[[^\]]+\]\((https?:\/\/[^)\s]+|\/[^)\s]+)\)/g;
+  while ((match = markdownRe.exec(value)) !== null) {
+    addUrl(match[1]);
+  }
+
+  return links;
+}
+
+function _clExtractOpenagentMediaLinksFromModel(model) {
+  var allText = [];
+  if (model && model.rawText) allText.push(model.rawText);
+  var chunks = model && Array.isArray(model.chunks) ? model.chunks : [];
+  for (var i = 0; i < chunks.length; i++) {
+    if (chunks[i] && chunks[i].text) allText.push(chunks[i].text);
+  }
+  return _clExtractOpenagentMediaLinksFromText(allText.join('\n'));
+}
+
+function _clNormalizeOpenagentMediaUrl(rawUrl) {
+  var value = String(rawUrl || '').trim();
+  if (!value) return '';
+  value = value.replace(/^[`'"]+/, '').replace(/[`'".,;)\]]+$/, '');
+
+  if (value.charAt(0) === '/') return value;
+
+  try {
+    var parsed = new URL(value);
+    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') return value;
+  } catch (e) {}
+
+  return '';
+}
+
+function _clGetOpenagentMediaFileName(url) {
+  var pathValue = '';
+  try {
+    var base = (typeof window !== 'undefined' && window.location && window.location.href)
+      ? window.location.href
+      : 'http://127.0.0.1/';
+    pathValue = new URL(url, base).pathname || '';
+  } catch (e) {
+    pathValue = String(url || '').split('?')[0] || '';
+  }
+
+  var parts = pathValue.split('/');
+  var fileName = parts[parts.length - 1] || 'artifact';
+  try {
+    fileName = decodeURIComponent(fileName);
+  } catch (e) {}
+  return fileName || 'artifact';
+}
+
+function _clInferOpenagentMediaExtension(fileName) {
+  var match = String(fileName || '').toLowerCase().match(/\.([a-z0-9]{1,12})$/);
+  return match ? match[1] : '';
+}
+
+function _clStripOpenagentMediaLines(rawText) {
+  return String(rawText || '')
+    .split(/\r?\n/)
+    .filter(function(line) { return !/^\s*MEDIA:\s*/.test(line); })
+    .join('\n')
+    .trim();
+}
+
+function _clCreateOpenagentMediaLinksSection(links) {
+  if (!Array.isArray(links) || links.length === 0) return null;
+
+  var section = document.createElement('div');
+  section.className = 'cl-openagent-media-links';
+
+  for (var i = 0; i < links.length; i++) {
+    var link = links[i] || {};
+    if (!link.url) continue;
+
+    var anchor = document.createElement('a');
+    anchor.className = 'cl-openagent-media-link';
+    anchor.href = link.url;
+    anchor.target = '_blank';
+    anchor.rel = 'noopener noreferrer';
+    anchor.download = link.fileName || '';
+    anchor.title = link.fileName || link.url;
+
+    var icon = document.createElement('span');
+    icon.className = 'cl-openagent-media-link-icon';
+    icon.textContent = _clGetOpenagentMediaIconText(link.extension);
+    anchor.appendChild(icon);
+
+    var text = document.createElement('span');
+    text.className = 'cl-openagent-media-link-text';
+    text.textContent = _clGetOpenagentMediaActionText(link.extension);
+    anchor.appendChild(text);
+
+    var file = document.createElement('span');
+    file.className = 'cl-openagent-media-link-file';
+    file.textContent = link.fileName || 'artifact';
+    anchor.appendChild(file);
+
+    section.appendChild(anchor);
+  }
+
+  return section.childNodes.length > 0 ? section : null;
+}
+
+function _clGetOpenagentMediaActionText(extension) {
+  var ext = String(extension || '').toUpperCase();
+  if (!ext) return '下载附件';
+  return '下载 ' + ext;
+}
+
+function _clGetOpenagentMediaIconText(extension) {
+  extension = String(extension || '').toLowerCase();
+  if (extension === 'pptx' || extension === 'ppt') return 'P';
+  if (extension === 'docx' || extension === 'doc') return 'D';
+  if (extension === 'xlsx' || extension === 'xls' || extension === 'csv') return 'X';
+  if (extension === 'json') return '{}';
+  if (extension === 'md' || extension === 'txt') return 'T';
+  if (extension === 'zip') return 'Z';
+  return 'F';
+}