myagent-ai 1.19.2 → 1.19.4

package/agents/main_agent.py

@@ -45,8 +45,8 @@ class MainAgent(BaseAgent):
 <output>
 <mainsubject>当前对话的6字以内标题（每轮都需输出，系统会每3轮自动更新会话名称）</mainsubject>
 <usersays_correct>通过修正识别错误、调整标点，结合上下文，将用户语音转写文本"usersays"修正为更准确的文本，但尽量少改动。如"usersays"为空，则此处为空。</usersays_correct>
-<response><reply>展示给用户的文本内容:直接回应用户问题；告诉用户，为完成任务，准备如何开展工作；根据工具调用结果，展示任务进展。注意:这是给用户展示信息的最重要标签。</reply><toolstocal>
-<tool><beforecalltext>展示给用户的工具调用信息，方便用户了解调用目的。格式:先使用"接下来、下一步、接着、现在、然后"等连接词，然后介绍调用什么工具，达到什么目的。</beforecalltext><toolname>工具名，用于后台解析器解析调用工具</toolname><parms>调用工具的JSON格式参数对象，如格式: {"query": "搜索关键词", "num": 5}</parms><timeout>预估调用超时时限(秒),工具调用超时会立即回调大语言模型，方便调整工具使用</timeout></tool>
+<response><reply>展示给用户的文本,格式上尽量使用md格式，直观形象展示，甚至可以包括超链接等。内容上，直接回应用户问题；告诉用户，为完成任务，准备如何开展工作；根据工具调用结果，展示任务进展；任务完成后的最终总结。注意:这是给用户展示信息的最重要标签。</reply><toolstocal>
+<tool><beforecalltext>展示给用户的工具调用信息，方便用户了解调用目的。格式:先使用"接下来、下一步、接着、现在、然后、最后"等连接词，然后介绍调用什么工具，达到什么目的。</beforecalltext><toolname>工具名，用于后台解析器解析调用工具</toolname><parms>调用工具的JSON格式参数对象，如格式: {"query": "搜索关键词", "num": 5}</parms><timeout>预估调用超时时限(秒),工具调用超时会立即回调大语言模型，方便调整工具使用</timeout></tool>
 </toolstocal>
 </response>
 <task_plan>仅复杂任务使用任务计划，如"context"包含非空"task_plan"，则更新它。否则，先评估任务复杂度，针对单次查询、简单问答、格式转换、单文件修改、简单计算等简单任务，若预计操作步骤不超过3步，则此处输出为空，不要创建任务列表；针对多文件修改、需要调研+实现+测试、涉及多个模块联动等复杂任务，如预计超过3步操作，则以Markdown列表格式制定新任务列表。格式：每项用 "- [ ] 任务描述" 或 "- [x] 已完成任务"，含完成状态标记。</task_plan>
@@ -61,13 +61,13 @@ class MainAgent(BaseAgent):
 </output>
 
 事项注意:
-1.  toolstocal标签: 可列出所有需要执行的工具调用，可以多个工具。解析器会按顺序执行工具调用，最终全部执行完后，会连同所有结果，回调大语言模型。如果某个工具执行超时了，也会回调回调大模型，让大模型分析为什么超时，改用其他工具。
+1. toolstocal标签: 可列出所有需要执行的工具调用，可以多个工具。解析器会按顺序执行工具调用，最终全部执行完后，会连同所有结果，回调大语言模型。如果某个工具执行超时了，也会回调回调大模型，让大模型分析为什么超时，改用其他工具。
 2. 上下文中的记忆系统说明
 - <automemory>: 系统自动根据你通过 <remember> 保存的记忆和当前用户输入，搜索出的 top10 相关记忆。这些是你过去主动记住的内容（包含时间信息），可供参考。
 - <recall_memory>: 你在上一轮通过 <recall> 指定的记忆搜索结果。系统根据你提供的关键字和时间点搜索了 top5 相关记忆。
 - 两种记忆互补：automemory 是自动匹配的，recall_memory 是你主动指定搜索的。如果 automemory 不足，使用 <recall> 请求更多。
 3. 工具选择指南
-- **搜索信息**: 用 `web_search`（返回标题+URL+摘要），不要用 browser_open
+- **搜索信息**: 用 `web_search`（返回标题+URL+摘要）
 - **读取网页内容**: 用 `web_read`（传入URL，提取正文）
 - **浏览器交互**（填表、点击、截图等）: 才使用 browser_open / browser_click 等
 - **执行代码**: 用 `code` 工具（language: python/javascript/shell）
@@ -75,6 +75,24 @@ class MainAgent(BaseAgent):
 - **文件操作**: 用 `file_read` / `file_write` / `file_list` 等文件工具
 - **发送文件给用户**: 用 `file_send` 工具（参数: file_path=文件路径, description=说明），当你生成或处理了文件需要返回给用户时使用
 - **主动召回记忆**: 用 `recall_memory` 工具（参数: keyword=关键字, time_point=可选时间点如"2025-01", limit=数量默认5），根据关键字和时间搜索历史记忆
+4. 准备好内容后，最后，再检查输出格式，确保满足以下要求:
+<output>
+<mainsubject>当前对话的6字以内标题（每轮都需输出，系统会每3轮自动更新会话名称）</mainsubject>
+<usersays_correct>通过修正识别错误、调整标点，结合上下文，将用户语音转写文本"usersays"修正为更准确的文本，但尽量少改动。如"usersays"为空，则此处为空。</usersays_correct>
+<response><reply>展示给用户的文本,格式上尽量使用md格式，直观形象展示，甚至可以包括超链接等。内容上，直接回应用户问题；告诉用户，为完成任务，准备如何开展工作；根据工具调用结果，展示任务进展；任务完成后的最终总结。注意:这是给用户展示信息的最重要标签。</reply><toolstocal>
+<tool><beforecalltext>展示给用户的工具调用信息，方便用户了解调用目的。格式:先使用"接下来、下一步、接着、现在、然后、最后"等连接词，然后介绍调用什么工具，达到什么目的。</beforecalltext><toolname>工具名，用于后台解析器解析调用工具</toolname><parms>调用工具的JSON格式参数对象，如格式: {"query": "搜索关键词", "num": 5}</parms><timeout>预估调用超时时限(秒),工具调用超时会立即回调大语言模型，方便调整工具使用</timeout></tool>
+</toolstocal>
+</response>
+<task_plan>仅复杂任务使用任务计划，如"context"包含非空"task_plan"，则更新它。否则，先评估任务复杂度，针对单次查询、简单问答、格式转换、单文件修改、简单计算等简单任务，若预计操作步骤不超过3步，则此处输出为空，不要创建任务列表；针对多文件修改、需要调研+实现+测试、涉及多个模块联动等复杂任务，如预计超过3步操作，则以Markdown列表格式制定新任务列表。格式：每项用 "- [ ] 任务描述" 或 "- [x] 已完成任务"，含完成状态标记。</task_plan>
+<remember><type>填global或session，其中"global"为跨会话全局记忆，"session"为仅当前会话。</type><content>仅从最新用户输入，包括"userprint"或"usersays_correct"或工具调用结果，中提炼值得记忆的信息（如用户偏好、重要结论、错误经验、用户个人信息、对话要点、用户诉求、ai回复等）。因为对话默认不自动保存聊天记录，而是从记忆库搜索最相关的最新内容到"automemory"供决策，所以此次必须有所记忆，才能为后续多轮对话提供持续记忆基础。</content></remember>
+<recall>下一轮需要主动召回的记忆描述。填写需要从记忆库中检索的关键字或描述。如果不填写则为空。如果需要更多记忆支持当前任务，填写相关关键词（可包含时间参考，如"2025年1月的项目"），系统将在下一轮搜索top5相关记忆并通过"recall_memory"注入上下文。也可直接调用"recall_memory"工具即时搜索。</recall>
+<knowledge>从本轮对话或工具执行结果中提炼值得长期保存到知识库的专业知识、事实、经验法则、技术要点等，将被持久化存储，未来可通过 "get_knowledge"检索复用。如果本轮无需保存的知识，则为空。格式要求：简洁明确，每条知识一行，用换行分隔。</knowledge>
+<get_knowledge>下一轮执行时需要从知识库搜索获得的知识，填写检索关键词或描述。如context中已包含充足的knowledge内容，则为空。如需更多专业知识支撑，则填写相关搜索词。</get_knowledge>
+<askuser>需要询问用户的内容，如无，则为空</askuser>
+<finish>true/false，是否结束循环调用llm。如"askuser"为非空，则"finish"为true。否则，根据"context"判断任务是否已完成，是否结束llm回调</finish>
+<finish_reason>当"finish"为true 时必填，详细说明为什么现在结束任务（如：任务已完成/需要用户补充信息/信息不足无法继续等）。finish若为false ，此处为空。</finish_reason>
+<next_step>当 finish=false 时必填，描述下一步计划做什么（简洁明了，1-2句话）。finish=true 时为空。</next_step>
+</output>
 """
 
     def __init__(self, tool_agent=None, memory_agent=None, **kwargs):

package/install.ps1

@@ -9,7 +9,6 @@ $VENV_DIR = ".venv"
 Write-Host "`n--- MyAgent 一键部署 ---" -ForegroundColor Cyan
 
 # 1. 检查 Python
-# 尝试使用 python 或 python3
 $PYTHON_EXE = "python"
 if (-not (Get-Command $PYTHON_EXE -ErrorAction SilentlyContinue)) {
     $PYTHON_EXE = "python3"
@@ -20,7 +19,6 @@ if (-not (Get-Command $PYTHON_EXE -ErrorAction SilentlyContinue)) {
 }
 
 try {
-    # 更加稳健的版本获取方式
     $py_ver_str = & $PYTHON_EXE -c "import sys; print('%d.%d' % sys.version_info[:2])"
     Write-Host "[i] 找到 Python: $py_ver_str"
     
@@ -50,20 +48,42 @@ if (-not (Test-Path $VENV_DIR)) {
     Write-Host "[✓] 虚拟环境已创建。" -ForegroundColor Green
 }
 
-# 3. 安装依赖
-Write-Host "[*] 正在安装/升级依赖..." -ForegroundColor Cyan
-& "$VENV_DIR\Scripts\python.exe" -m pip install --upgrade pip --quiet
-& "$VENV_DIR\Scripts\python.exe" -m pip install -r requirements.txt
+$PIP = "$VENV_DIR\Scripts\python.exe -m pip"
 
-if ($LASTEXITCODE -eq 0) {
-    Write-Host "`n[✓] 部署成功！" -ForegroundColor Green
-    Write-Host "提示: 现在可以运行 ./start.ps1 启动 MyAgent。" -ForegroundColor Yellow
-} else {
-    Write-Host "`n[✗] 依赖安装过程中出现错误。" -ForegroundColor Red
+# 3. 升级 pip
+Write-Host "[*] 正在升级 pip..." -ForegroundColor Cyan
+& $VENV_DIR\Scripts\python.exe -m pip install --upgrade pip --quiet
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "[!] pip 升级失败，继续尝试安装依赖..." -ForegroundColor Yellow
 }
 
+# 4. 安装核心依赖 (必需，失败则中止)
+Write-Host "[*] 正在安装核心依赖..." -ForegroundColor Cyan
+& $VENV_DIR\Scripts\python.exe -m pip install -r requirements.txt
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "`n[✗] 核心依赖安装失败！" -ForegroundColor Red
+    exit 1
+}
+Write-Host "[✓] 核心依赖安装成功。" -ForegroundColor Green
+
+# 5. 安装可选依赖 (失败不影响核心功能)
+if (Test-Path "requirements-optional.txt") {
+    Write-Host "`n[*] 正在安装可选依赖 (语音识别等)..." -ForegroundColor Cyan
+    Write-Host "    (如果编译失败，不影响核心功能)" -ForegroundColor DarkGray
+    & $VENV_DIR\Scripts\python.exe -m pip install -r requirements-optional.txt
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "[✓] 可选依赖安装成功。" -ForegroundColor Green
+    } else {
+        Write-Host "[!] 可选依赖安装失败（部分功能如语音识别可能不可用）。" -ForegroundColor Yellow
+        Write-Host "    提示: funasr 在 Windows + Python 3.14 上需要安装 Microsoft C++ Build Tools" -ForegroundColor DarkGray
+        Write-Host "    下载地址: https://visualstudio.microsoft.com/visual-cpp-build-tools/" -ForegroundColor DarkGray
+    }
+}
+
+Write-Host "`n[✓] 部署完成！" -ForegroundColor Green
+Write-Host "提示: 现在可以运行 .\myagent_start.ps1 启动 MyAgent。" -ForegroundColor Yellow
+
 Write-Host "`n按回车退出..."
-# 仅在非交互模式下禁用 Read-Host
 if ($Host.Name -ne "ServerRemoteHost") {
     Read-Host
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.19.2",
+  "version": "1.19.4",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {
@@ -43,4 +43,4 @@
     "python": ">=3.10",
     "node": ">=18"
   }
-}
+}

package/requirements-optional.txt

@@ -0,0 +1,10 @@
+# MyAgent 可选依赖 - 语音识别等需要编译/大体积的包
+# 安装失败不影响核心功能
+# 注意: funasr 依赖 editdistance，在 Windows + Python 3.14 上需要 MSVC 编译器
+# 若编译失败，语音识别会 fallback 到 Whisper 引擎
+
+funasr>=1.1.0
+torch>=2.0.0
+torchaudio>=2.0.0
+faster-whisper>=1.0.0
+pydub>=0.25.1

package/requirements.txt

@@ -69,18 +69,6 @@ chardet>=5.0.0
 # xlrd: 旧版 Excel (.xls) 文件读取
 xlrd>=2.0.0
 
-# ============================================================
-# 语音识别 (本地 STT，默认启用)
-# ============================================================
-# [v1.18.8] SenseVoice (funasr) 作为首选引擎，中文识别极佳
-# torch/torchaudio 约 200MB (CPU版)，funasr 约 100MB
-# 若仅需 Whisper 备选引擎，可注释下面三行，保留 faster-whisper
-funasr>=1.1.0
-torch>=2.0.0
-torchaudio>=2.0.0
-faster-whisper>=1.0.0
-pydub>=0.25.1
-
 # ============================================================
 # Anthropic Claude (可选)
 # ============================================================
@@ -91,3 +79,8 @@ anthropic>=0.18.0
 # ============================================================
 cryptography>=41.0.0
 websockets>=12.0
+
+# ============================================================
+# 语音识别 (本地 STT，需要编译)
+# 已移至 requirements-optional.txt，单独安装以避免编译失败阻断核心依赖
+# ============================================================

package/skills/registry.py

@@ -128,6 +128,9 @@ class SkillRegistry:
     def auto_discover(self, package: str = "skills"):
         """
         自动发现并注册 skills/ 目录下的所有内置技能。
+        支持两种格式：
+        1. Python Skill 子类（*_skill.py 文件）
+        2. SKILL.md 目录格式（目录下包含 SKILL.md 的 markdown 技能）
 
         Args:
             package: 技能包路径
@@ -136,6 +139,7 @@ class SkillRegistry:
         if not skills_dir.exists():
             return
 
+        # 格式1: 扫描 *_skill.py 文件
         for file in skills_dir.glob("*_skill.py"):
             if file.name.startswith("_") or file.name == "base.py":
                 continue
@@ -159,6 +163,94 @@ class SkillRegistry:
             except Exception as e:
                 logger.warning(f"模块导入失败 ({module_name}): {e}")
 
+        # 格式2: 扫描 SKILL.md 目录格式的技能
+        for subdir in skills_dir.iterdir():
+            if not subdir.is_dir() or subdir.name.startswith("_") or subdir.name.startswith("."):
+                continue
+            skill_md = subdir / "SKILL.md"
+            if not skill_md.exists():
+                continue
+            try:
+                instance = _load_skill_from_md(subdir)
+                if instance and instance.name not in self._skills:
+                    self.register(instance)
+                    logger.info(f"自动发现 SKILL.md 技能: {instance.name} ({subdir.name})")
+            except Exception as e:
+                logger.warning(f"SKILL.md 技能加载失败 ({subdir.name}): {e}")
+
+
+def _load_skill_from_md(skill_dir: Path) -> Optional[Skill]:
+    """从 SKILL.md 目录加载一个 Skill 实例"""
+    import yaml  # lazy import
+
+    skill_md_path = skill_dir / "SKILL.md"
+    if not skill_md_path.exists():
+        return None
+
+    content = skill_md_path.read_text(encoding="utf-8")
+
+    # 解析 YAML front matter
+    if not content.startswith("---"):
+        return None
+    parts = content.split("---", 2)
+    if len(parts) < 3:
+        return None
+    try:
+        meta = yaml.safe_load(parts[1]) or {}
+    except Exception:
+        meta = {}
+
+    name = meta.get("name", skill_dir.name)
+    description = meta.get("description", "")
+    if isinstance(description, list):
+        description = "\n".join(description)
+    description = description.strip()
+    category = meta.get("metadata", {}).get("category", "") if isinstance(meta.get("metadata"), dict) else ""
+    version = meta.get("metadata", {}).get("version", "") if isinstance(meta.get("metadata"), dict) else ""
+
+    # 计算 references 目录中的参考文档
+    ref_dir = skill_dir / "references"
+    references = []
+    if ref_dir.exists():
+        for ref_file in sorted(ref_dir.glob("*.md")):
+            references.append(ref_file.name)
+
+    class MarkdownSkill(Skill):
+        """SKILL.md 格式的技能包装器"""
+        def __init__(self):
+            super().__init__()
+            self.name = name
+            self.description = description or f"Markdown 技能 ({name})"
+            self.parameters = []
+            # 存储额外元信息
+            self._skill_type = "markdown"
+            self._skill_dir = str(skill_dir)
+            self._category = category
+            self._version = version
+            self._references = references
+            self._has_templates = (skill_dir / "templates").exists()
+            self._has_scripts = (skill_dir / "scripts").exists()
+
+        async def execute(self, **kwargs) -> SkillResult:
+            return SkillResult(
+                success=False,
+                error=f"SKILL.md 格式技能不支持直接调用，请通过 LLM 使用 /{self.name} 触发",
+            )
+
+        def to_openclaw_format(self) -> Dict[str, Any]:
+            info = super().to_openclaw_format()
+            info["skill_type"] = "markdown"
+            info["category"] = self._category
+            if self._version:
+                info["version"] = self._version
+            if self._references:
+                info["references"] = self._references
+            info["has_templates"] = self._has_templates
+            info["has_scripts"] = self._has_scripts
+            return info
+
+    return MarkdownSkill()
+
 
 # ==============================================================================
 # 全局注册表

package/web/ui/chat/chat.css

@@ -636,10 +636,16 @@ input,textarea,select{font:inherit}
 }
 .attachment-thumb:hover .attachment-remove{display:flex}
 
-/* [v1.16.12→18] 消息气泡中的附件 */
+/* [v1.16.12→18→19.3] 消息气泡中的附件 */
 .msg-attachments {
   display:flex;flex-wrap:wrap;gap:8px;margin-bottom:8px;
 }
+.msg-attachments-images {
+  margin-bottom:10px; /* 图片在气泡内容上方，底部留更多空间 */
+}
+.msg-attachments-files {
+  margin-top:6px; /* 文件在气泡内容下方 */
+}
 .msg-image-wrapper {
   max-width:300px;border-radius:var(--radius-sm);overflow:hidden;
   border:1px solid var(--bg4);cursor:pointer;
@@ -652,6 +658,13 @@ input,textarea,select{font:inherit}
   transition:max-height .3s ease;
 }
 .msg-image-wrapper:hover .msg-image{max-height:none}
+/* [v1.19.3] Agent 发送的图片样式 */
+.agent-image {
+  border-color:var(--accent);
+}
+.agent-image::after {
+  content:'点击查看大图 · ⬇ 下载';
+}
 /* [v1.16.18] 图片缩略图 hover 叠加层提示 */
 .msg-image-wrapper::after {
   content:'点击查看大图';
@@ -666,17 +679,26 @@ input,textarea,select{font:inherit}
 .msg-file-item {
   display:flex;align-items:center;gap:8px;padding:6px 10px;
   background:var(--bg3);border-radius:var(--radius-sm);
-  font-size:13px;color:var(--text2);max-width:240px;
+  font-size:13px;color:var(--text2);max-width:280px;
   cursor:pointer;transition:background .15s,border-color .15s;
   border:1px solid transparent;
 }
 .msg-file-item:hover{background:var(--bg4);border-color:var(--accent)}
 .agent-file{border-color:var(--accent);background:var(--bg2)}
 .msg-file-icon{font-size:18px;flex-shrink:0}
+.msg-file-info{display:flex;flex-direction:column;gap:2px;min-width:0;flex:1}
 .msg-file-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:500}
 .msg-file-size{font-size:11px;color:var(--text3);flex-shrink:0}
+.msg-file-actions{flex-shrink:0;margin-left:4px}
+.msg-file-download{
+  display:inline-flex;align-items:center;justify-content:center;
+  width:28px;height:28px;border-radius:var(--radius-xs);
+  font-size:16px;text-decoration:none;color:var(--text3);
+  transition:background .15s, color .15s;
+}
+.msg-file-download:hover{background:var(--accent);color:#fff}
 
-/* [v1.17] 移动端文件附件适配 */
+/* [v1.17→19.3] 移动端文件附件适配 */
 @media (max-width: 768px) {
   .msg-file-item {
     max-width: 100%;
@@ -689,6 +711,7 @@ input,textarea,select{font:inherit}
   .msg-file-name { font-size: 14px; }
   .msg-attachments { gap: 10px; }
   .msg-image-wrapper { max-width: 100%; }
+  .msg-file-download { width: 34px; height: 34px; font-size: 18px; }
 }
 
 /* [v1.17] 折叠文件内容样式 */

package/web/ui/chat/chat_container.html

@@ -278,6 +278,27 @@
 
 </div>
 
+<!-- [v1.19.2] VNC Remote Desktop Overlay -->
+<div id="vncOverlay" style="display:none;position:fixed;top:0;left:0;width:100%;height:100%;z-index:9999;background:#1a1a2e;flex-direction:column">
+  <div style="display:flex;align-items:center;justify-content:space-between;padding:8px 16px;background:#16213e;border-bottom:1px solid #0f3460;flex-shrink:0">
+    <div style="display:flex;align-items:center;gap:12px">
+      <span style="color:#eee;font-size:14px;font-weight:600">远程桌面</span>
+      <span id="vncOverlayStatus" style="font-size:12px;color:#888">正在连接...</span>
+    </div>
+    <div style="display:flex;gap:8px">
+      <button onclick="openVNCInNewTab()" style="padding:4px 12px;border-radius:4px;border:1px solid #0f3460;background:#0f3460;color:#eee;cursor:pointer;font-size:12px" title="在新标签页中打开">新标签页</button>
+      <button onclick="closeVNCOverlay()" style="padding:4px 12px;border-radius:4px;border:1px solid #e94560;background:transparent;color:#e94560;cursor:pointer;font-size:12px">关闭</button>
+    </div>
+  </div>
+  <div style="flex:1;position:relative">
+    <iframe id="vncIframe" style="width:100%;height:100%;border:none" allow="clipboard-read; clipboard-write"></iframe>
+    <div id="vncLoadingHint" style="position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);color:#888;font-size:14px;text-align:center">
+      <div style="margin-bottom:8px;font-size:32px">💻</div>
+      <div>正在连接远程桌面...</div>
+    </div>
+  </div>
+</div>
+
 <!-- Mobile Overlay -->
 <div class="mobile-overlay" id="chatMobileOverlay"></div>
 <!-- Toast Container -->

package/web/ui/chat/chat_main.js

@@ -975,43 +975,80 @@ async function toggleVNC() {
     return;
   }
 
-  toast('正在启动远程桌面...', 'info');
+  toast('正在启动远程桌面，请稍候...', 'info', 60000);
   try {
     var result = await api('/api/vnc/start', { method: 'POST' });
     if (result.success) {
       await refreshVNCStatus();
+      toast('远程桌面已启动，正在打开远程桌面窗口...', 'success');
       // 如果是"已在运行"（附加到已有实例），立刻打开窗口
       if (result.message && result.message.indexOf('已在运行') > -1) {
-        toast('远程桌面已连接', 'success');
         openVNCWindow();
       } else {
-        toast('远程桌面已启动', 'success');
         // 新启动的需要等服务完全就绪
         setTimeout(function() {
           openVNCWindow();
         }, 2000);
       }
     } else {
-      toast('启动失败: ' + (result.message || '未知错误'), 'error');
+      toast('远程桌面启动失败: ' + (result.message || '未知错误'), 'error', 8000);
     }
   } catch (e) {
-    toast('启动失败: ' + e.message, 'error');
+    toast('远程桌面启动失败: ' + e.message, 'error', 8000);
   }
 }
 
 function openVNCWindow() {
+  // [v1.19.2] 优先使用页面内覆盖层（兼容 IM WebView 等不允许弹窗的环境）
+  var vncUrl = '/vnc/vnc.html';
+  var overlay = document.getElementById('vncOverlay');
+  var iframe = document.getElementById('vncIframe');
+  if (overlay && iframe) {
+    overlay.style.display = 'flex';
+    iframe.src = vncUrl;
+    // iframe 加载完成后隐藏 loading 提示
+    iframe.onload = function() {
+      var hint = document.getElementById('vncLoadingHint');
+      var status = document.getElementById('vncOverlayStatus');
+      if (hint) hint.style.display = 'none';
+      if (status) status.textContent = '已连接';
+      if (status) status.style.color = '#00ff88';
+    };
+    return;
+  }
+  // 回退: 弹窗方式（仅限非 IM 环境）
   if (vncWindow && !vncWindow.closed) {
     vncWindow.focus();
     return;
   }
-  // 在新窗口中打开 noVNC 客户端
   var w = Math.min(1200, screen.width - 100);
   var h = Math.min(800, screen.height - 100);
   var left = Math.round((screen.width - w) / 2);
   var top = Math.round((screen.height - h) / 2);
-  vncWindow = window.open('/vnc/vnc.html', 'myagent_vnc',
+  vncWindow = window.open(vncUrl, 'myagent_vnc',
     'width=' + w + ',height=' + h + ',left=' + left + ',top=' + top +
     ',menubar=no,toolbar=no,location=no,status=no,scrollbars=no,resizable=yes');
+  if (!vncWindow || vncWindow.closed) {
+    vncWindow = window.open(vncUrl, '_blank');
+    if (!vncWindow || vncWindow.closed) {
+      toast('浏览器拦截了弹窗，请允许弹窗后重试，或点击菜单远程桌面入口', 'warning', 8000);
+    }
+  }
+}
+
+function closeVNCOverlay() {
+  var overlay = document.getElementById('vncOverlay');
+  var iframe = document.getElementById('vncIframe');
+  var hint = document.getElementById('vncLoadingHint');
+  var status = document.getElementById('vncOverlayStatus');
+  if (overlay) overlay.style.display = 'none';
+  if (iframe) iframe.src = 'about:blank';
+  if (hint) hint.style.display = 'block';
+  if (status) { status.textContent = '正在连接...'; status.style.color = '#888'; }
+}
+
+function openVNCInNewTab() {
+  window.open('/vnc/vnc.html', '_blank');
 }
 
 async function stopVNC() {
@@ -1021,6 +1058,8 @@ async function stopVNC() {
     var result = await api('/api/vnc/stop', { method: 'POST' });
     toast(result.message || '远程桌面已停止', 'info');
     await refreshVNCStatus();
+    // 关闭 VNC 覆盖层和弹窗
+    closeVNCOverlay();
     if (vncWindow && !vncWindow.closed) {
       vncWindow.close();
     }
@@ -2317,280 +2356,142 @@ async function clearCurrentChat() {
 }
 
 // ── Group History Messages ──
-// Groups consecutive non-user messages (assistant + tool_call + tool_result) into single
-// assistant messages with parts[] for timeline rendering, matching the streaming display.
+// 将数据库中的扁平消息序列分组为 user/assistant 交替结构，
+// 每个 assistant 组包含 interleaved 的 text + tool_call + tool_result parts。
 //
-// DB storage pattern:
-//   user_input → role="user",    key="user_input"
-//   text       → role="assistant", key=""
-//   tool_call  → role="assistant", key="tool_call"  (NOT role="tool"!)
-//   tool_result→ role="tool",     key="tool_result"
-//
-// Result: user → [assistant { text → tool_call → tool_result → text → ... }] → user
+// DB 存储模式:
+//   用户输入   → role="user",     key="user_input"
+//   助手文本   → role="assistant", key=""
+//   工具调用   → role="assistant", key="tool_call"
+//   工具结果   → role="tool",      key="tool_result"
+//   推理思考   → role="assistant", key="reasoning"
 
 // 解析 tool_call 消息内容，兼容新旧格式
-// 新格式: "beforecalltext\n调用工具: xxx\n参数: yyy"
-// 旧格式: "调用工具: xxx\n参数: yyy"
 function parseToolCallContent(content) {
   if (!content) return { title: '调用工具', toolName: '', params: '' };
   var lines = content.split('\n');
-  var title = '';
-  var toolName = '';
-  var params = '';
-  // 查找 "调用工具:" 行
+  var toolName = '', params = '';
   for (var li = 0; li < lines.length; li++) {
-    var line = lines[li].trim();
-    var m = line.match(/^调用工具:\s*(\S+)/);
-    if (m) {
-      toolName = m[1];
-      break;
-    }
+    var m = lines[li].trim().match(/^调用工具:\s*(\S+)/);
+    if (m) { toolName = m[1]; break; }
   }
-  // 查找 "参数:" 行
   for (var li2 = 0; li2 < lines.length; li2++) {
-    var line2 = lines[li2].trim();
-    var m2 = line2.match(/^参数:\s*([\s\S]*)/);
-    if (m2) {
-      params = m2[1].trim();
-      break;
-    }
-  }
-  // 标题: 如果第一行不是"调用工具:"，则使用第一行作为 beforecalltext 标题
-  if (lines[0] && !lines[0].trim().startsWith('调用工具:')) {
-    title = lines[0].trim();
-  } else {
-    title = toolName ? ('调用工具: ' + toolName) : content.substring(0, 100);
+    var m2 = lines[li2].trim().match(/^参数:\s*([\s\S]*)/);
+    if (m2) { params = m2[1].trim(); break; }
   }
+  var tcIdx = lines.findIndex(function(l) { return l.trim().match(/^调用工具:/); });
+  var title = tcIdx > 0 ? lines.slice(0, tcIdx).join('\n').trim() : '';
+  if (!title) title = toolName ? ('调用工具: ' + toolName) : '调用工具';
   return { title: title, toolName: toolName, params: params };
 }
 
+// 解析 tool_result 消息: "[tool_name] 成功/失败\n{output}"
+function parseToolResultContent(content) {
+  if (!content) return { title: '执行结果', toolName: '', success: true, body: '' };
+  var idx = content.indexOf('\n');
+  var header = idx > 0 ? content.substring(0, idx) : content.substring(0, 80);
+  var body = idx > 0 ? content.substring(idx + 1) : '';
+  var toolName = (header.match(/^\[([^\]]+)\]/) || [])[1] || '';
+  var isOk = !content.includes('失败');
+  var title = toolName ? (toolName + (isOk ? ' ✓' : ' ✗')) : (isOk ? '执行成功' : '执行失败');
+  return { title: title, toolName: toolName, success: isOk, body: body };
+}
+
 function groupHistoryMessages(messages) {
   if (!Array.isArray(messages) || messages.length === 0) return messages;
 
-  const grouped = [];
-  let i = 0;
-  let _evtId = 0; // Event ID counter
+  var grouped = [];
+  var evtId = 0;
+
+  // 辅助: 将单条消息解析为 part（reasoning 除外）
+  function msgToPart(m) {
+    var key = (m.key || '').toLowerCase();
+    if (key === 'reasoning') return null;
+    if (key === 'tool_call') {
+      var tc = m._parsedToolCall || parseToolCallContent(m.content);
+      m._parsedToolCall = tc;
+      return { type: 'exec', data: { id: evtId++, type: 'tool_call', title: tc.title, tool_name: tc.toolName, params: tc.params || undefined, status: 'done' } };
+    }
+    if (m.role === 'tool') {
+      var tr = parseToolResultContent(m.content);
+      return { type: 'exec', data: { id: evtId++, type: 'tool_result', title: tr.title, tool_name: tr.toolName, success: tr.success, summary: tr.body.substring(0, 500).trim(), result: { output: tr.body.substring(0, 2000) } } };
+    }
+    if (m.content && m.content.trim() && m.content !== '(无回复)') {
+      return { type: 'text', content: m.content };
+    }
+    return null;
+  }
 
+  var i = 0;
   while (i < messages.length) {
-    const msg = messages[i];
+    var msg = messages[i];
 
+    // ── 用户消息: 直接加入 ──
     if (msg.role === 'user') {
       var userEntry = { role: 'user', content: msg.content, time: msg.time || '' };
-      // [v1.16.18] 保留附件元数据
       if (msg.images) userEntry.images = msg.images;
       if (msg.files) userEntry.files = msg.files;
       grouped.push(userEntry);
       i++;
-    } else if (msg.role === 'assistant') {
-      // Start of a new agent group: collect ALL consecutive non-user messages
-      const parts = [];
-      let lastAssistantTime = msg.time || '';
-      let reasoningText = ''; // 推理模型思考过程
-
-      // Process the first assistant message
-      if (msg.key === 'reasoning') {
-        // 推理模型思考过程 — 合并到分组消息的 reasoning 字段
-        reasoningText = msg.content || '';
-      } else if (msg.key === 'tool_call') {
-        // 新格式: beforecalltext\n调用工具: xxx\n参数: yyy
-        // 旧格式: 调用工具: xxx\n参数: yyy
-        var _tcParts = msg._parsedToolCall || parseToolCallContent(msg.content);
-        msg._parsedToolCall = _tcParts; // 缓存
-        parts.push({
-          type: 'exec',
-          data: {
-            id: _evtId++,
-            type: 'tool_call',
-            title: _tcParts.title,
-            tool_name: _tcParts.toolName,
-            params: _tcParts.params || undefined,
-            status: 'done',
-          }
-        });
-      } else if (msg.content && msg.content.trim() && msg.content !== '(无回复)') {
-        parts.push({ type: 'text', content: msg.content });
-      }
+      continue;
+    }
 
-      i++;
+    // ── 收集连续的非 user 消息为一个 assistant 组 ──
+    var parts = [];
+    var reasoningText = '';
+    var lastTime = msg.time || '';
+    var firstMsg = msg;
+    // [v1.19.3] 收集组内所有消息的文件（agent 通过 file_send 发送的文件存在 metadata.files 中）
+    var allAgentFiles = [];
 
-      // Collect all following tool_call (role=assistant), tool_result (role=tool),
-      // and assistant text messages into the same group.
-      // This handles: text → tool_call → tool_result → text → tool_call → tool_result → text
-      while (i < messages.length) {
-        const next = messages[i];
-
-        if (next.role === 'tool') {
-          // Parse tool_result content: format is "[tool_name] 成功/失败\n{output}"
-          const firstNewline = next.content.indexOf('\n');
-          const headerLine = firstNewline > 0 ? next.content.substring(0, firstNewline) : next.content.substring(0, 80);
-          const bodyContent = firstNewline > 0 ? next.content.substring(firstNewline + 1) : '';
-          // Extract tool name from header: [tool_name] 成功 or [tool_name] 失败
-          const toolResultName = (headerLine.match(/^\[([^\]]+)\]/) || [])[1] || '';
-          const isOk = !next.content.includes('失败');
-          const displayTitle = toolResultName ? (toolResultName + (isOk ? ' ✓' : ' ✗')) : (isOk ? '执行成功' : '执行失败');
-          parts.push({
-            type: 'exec',
-            data: {
-              id: _evtId++,
-              type: 'tool_result',
-              title: displayTitle,
-              tool_name: toolResultName,
-              success: isOk,
-              summary: bodyContent.substring(0, 500).trim(),
-              result: { output: bodyContent.substring(0, 2000) },
-            }
-          });
-          i++;
-        } else if (next.role === 'assistant' && next.key === 'tool_call') {
-          // 新格式: beforecalltext\n调用工具: xxx\n参数: yyy
-          var _tcParts2 = next._parsedToolCall || parseToolCallContent(next.content);
-          next._parsedToolCall = _tcParts2;
-          parts.push({
-            type: 'exec',
-            data: {
-              id: _evtId++,
-              type: 'tool_call',
-              title: _tcParts2.title,
-              tool_name: _tcParts2.toolName,
-              params: _tcParts2.params || undefined,
-              status: 'done',
-            }
-          });
-          lastAssistantTime = next.time || lastAssistantTime;
-          i++;
-        } else if (next.role === 'assistant') {
-          if (next.key === 'reasoning') {
-            // 推理模型思考过程 — 追加到 reasoningText
-            reasoningText = reasoningText ? (reasoningText + '\n\n' + (next.content || '')) : (next.content || '');
-          } else if (next.content && next.content.trim() && next.content !== '(无回复)') {
-            parts.push({ type: 'text', content: next.content });
-          }
-          lastAssistantTime = next.time || lastAssistantTime;
-          i++;
-        } else {
-          break;
-        }
-      }
+    while (i < messages.length && messages[i].role !== 'user') {
+      var m = messages[i];
+      var mkey = (m.key || '').toLowerCase();
+      lastTime = m.time || lastTime;
 
-      const textParts = parts.filter(p => p.type === 'text');
-      const assembledContent = textParts.length > 0
-        ? textParts[textParts.length - 1].content
-        : '';
-
-      var _groupedEntry = {
-        role: 'assistant',
-        content: assembledContent,
-        time: lastAssistantTime,
-        reasoning: reasoningText || undefined,
-        parts: parts.length > 0 ? parts : undefined,
-        exec_events: parts.filter(p => p.type === 'exec').map(p => p.data),
-      };
-      // [fix] 保留 _files 字段（agent 生成的文件附件）
-      if (msg._files) _groupedEntry._files = msg._files;
-      grouped.push(_groupedEntry);
-    } else if (msg.role === 'tool') {
-      // Orphan tool message — wrap in an assistant group
-      const parts = [];
-      const isResult = msg.key === 'tool_result';
-      const isCall = msg.key === 'tool_call';
-
-      if (isCall) {
-        var _tcParts3 = msg._parsedToolCall || parseToolCallContent(msg.content);
-        msg._parsedToolCall = _tcParts3;
-        parts.push({
-          type: 'exec',
-          data: {
-            id: _evtId++,
-            type: 'tool_call',
-            title: _tcParts3.title,
-            tool_name: _tcParts3.toolName,
-            params: _tcParts3.params || undefined,
-            status: 'done',
-          }
-        });
-      } else if (isResult) {
-        const firstNewline = msg.content.indexOf('\n');
-        const headerLine = firstNewline > 0 ? msg.content.substring(0, firstNewline) : msg.content.substring(0, 80);
-        const bodyContent = firstNewline > 0 ? msg.content.substring(firstNewline + 1) : '';
-        const toolResultName = (headerLine.match(/^\[([^\]]+)\]/) || [])[1] || '';
-        const isOk = !msg.content.includes('失败');
-        const displayTitle = toolResultName ? (toolResultName + (isOk ? ' ✓' : ' ✗')) : (isOk ? '执行成功' : '执行失败');
-        parts.push({
-          type: 'exec',
-          data: {
-            id: _evtId++,
-            type: 'tool_result',
-            title: displayTitle,
-            tool_name: toolResultName,
-            success: isOk,
-            summary: bodyContent.substring(0, 500).trim(),
-            result: { output: bodyContent.substring(0, 2000) },
-          }
-        });
+      // 收集该消息携带的文件（来自 metadata.files）
+      if (m.files && Array.isArray(m.files) && m.files.length > 0) {
+        for (var fi = 0; fi < m.files.length; fi++) {
+          allAgentFiles.push(m.files[fi]);
+        }
       }
-
-      i++;
-      while (i < messages.length) {
-        const next = messages[i];
-        if (next.role === 'assistant' && next.key === 'tool_call') {
-          var _tcParts4 = next._parsedToolCall || parseToolCallContent(next.content);
-          next._parsedToolCall = _tcParts4;
-          parts.push({
-            type: 'exec',
-            data: {
-              id: _evtId++,
-              type: 'tool_call',
-              title: _tcParts4.title,
-              tool_name: _tcParts4.toolName,
-              params: _tcParts4.params || undefined,
-              status: 'done',
-            }
-          });
-          i++;
-        } else if (next.role === 'assistant') {
-          if (next.content && next.content.trim() && next.content !== '(无回复)') {
-            parts.push({ type: 'text', content: next.content });
-          }
-          i++;
-        } else if (next.role === 'tool') {
-          const firstNewline = next.content.indexOf('\n');
-          const headerLine = firstNewline > 0 ? next.content.substring(0, firstNewline) : next.content.substring(0, 80);
-          const bodyContent = firstNewline > 0 ? next.content.substring(firstNewline + 1) : '';
-          const toolResultName = (headerLine.match(/^\[([^\]]+)\]/) || [])[1] || '';
-          const isOk = !next.content.includes('失败');
-          const displayTitle = toolResultName ? (toolResultName + (isOk ? ' ✓' : ' ✗')) : (isOk ? '执行成功' : '执行失败');
-          parts.push({
-            type: 'exec',
-            data: {
-              id: _evtId++,
-              type: 'tool_result',
-              title: displayTitle,
-              tool_name: toolResultName,
-              success: isOk,
-              summary: bodyContent.substring(0, 500).trim(),
-              result: { output: bodyContent.substring(0, 2000) },
-            }
-          });
-          i++;
-        } else {
-          break;
+      // 也检查流式 _files（兼容实时流切换到历史显示的场景）
+      if (m._files && Array.isArray(m._files) && m._files.length > 0) {
+        for (var _fi = 0; _fi < m._files.length; _fi++) {
+          allAgentFiles.push(m._files[_fi]);
         }
       }
 
-      const textParts = parts.filter(p => p.type === 'text');
-      var _groupedEntry2 = {
-        role: 'assistant',
-        content: textParts.length > 0 ? textParts[textParts.length - 1].content : '',
-        time: msg.time || '',
-        parts: parts.length > 0 ? parts : undefined,
-        exec_events: parts.filter(p => p.type === 'exec').map(p => p.data),
-      };
-      // [fix] 保留 _files 字段（agent 生成的文件附件）
-      if (msg._files) _groupedEntry2._files = msg._files;
-      grouped.push(_groupedEntry2);
-    } else {
+      if (mkey === 'reasoning') {
+        reasoningText = reasoningText ? (reasoningText + '\n\n' + (m.content || '')) : (m.content || '');
+      } else {
+        var part = msgToPart(m);
+        if (part) parts.push(part);
+      }
       i++;
     }
+
+    // 组装: content 取最后一段文本（用于搜索/纯文本回退），parts 展示完整时间线
+    var textParts = parts.filter(function(p) { return p.type === 'text'; });
+    var hasExecParts = parts.some(function(p) { return p.type === 'exec'; });
+
+    var entry = {
+      role: 'assistant',
+      content: textParts.length > 0 ? textParts[textParts.length - 1].content : '',
+      time: lastTime,
+    };
+    if (reasoningText) entry.reasoning = reasoningText;
+    // 有工具调用或多段文本时设置 parts（启用 timeline 渲染）
+    if (hasExecParts || textParts.length > 1) {
+      entry.parts = parts;
+    }
+    // exec_events 兼容旧渲染路径
+    var execParts = parts.filter(function(p) { return p.type === 'exec'; });
+    if (execParts.length > 0) entry.exec_events = execParts.map(function(p) { return p.data; });
+    // [v1.19.3] 设置收集到的所有 agent 文件
+    if (allAgentFiles.length > 0) entry._files = allAgentFiles;
+
+    grouped.push(entry);
   }
 
   return grouped;
@@ -2679,25 +2580,22 @@ function _renderMessagesInner() {
 
     const avatar = isUser ? '<span style="font-size:18px">👤</span>' : avatarHtml({avatar_image: state.currentAgent?.avatar_image, avatar_emoji: botEmoji, avatar_color: state.currentAgent?.avatar_color, name: state.currentAgent?.name}, 32, 'border-radius:8px;');
     const content = renderMarkdown(msg.content);
-    // [v1.16.12→17] 渲染图片和文件附件（支持磁盘持久化 file_id）
-    const attachmentHtml = (() => {
+    // [v1.19.3] 渲染图片和文件附件（支持磁盘持久化 file_id，图片在气泡顶部、文件在底部）
+    const imageAttachmentHtml = (() => {
       let parts = [];
-      // User images
+      // User images（用户发送的图片）
       if (isUser && msg.images && msg.images.length > 0) {
         for (let _imgIdx = 0; _imgIdx < msg.images.length; _imgIdx++) {
           const img = msg.images[_imgIdx];
-          // Check if we have a file_id (from server) or raw data
           const fileId = img.id;
           let src;
           let hasFallback = false;
           if (fileId) {
             src = '/api/file/' + fileId;
-            // [fix] 如果有 base64 回退数据，准备 onerror 处理
             if (img._base64) hasFallback = true;
           } else {
             src = 'data:' + (img.type || 'image/png') + ';base64,' + (img.data || '');
           }
-          // [fix] 添加 onerror 回退：file_id 加载失败时使用 base64 数据或显示占位
           let onerror = '';
           if (hasFallback) {
             onerror = ' onerror="this.onerror=null;this.src=\'data:' + escapeHtml(img.type || 'image/png') + ';base64,' + img._base64 + '\'"';
@@ -2707,34 +2605,58 @@ function _renderMessagesInner() {
           parts.push('<div class="msg-image-wrapper"><img src="' + src + '" class="msg-image" loading="lazy" alt="' + escapeHtml(img.name || 'image') + '"' + onerror + ' onclick="openFileViewer(\'' + (fileId || '') + '\', this.src, \'' + escapeHtml(img.name || 'image') + '\')" /></div>');
         }
       }
-      // User files
+      // Agent images（agent 通过 file_send 发送的图片文件，type 为 image/*）
+      const agentFiles = (msg._files || []);
+      if (!isUser && agentFiles.length > 0) {
+        for (const f of agentFiles) {
+          const isImage = f.type && f.type.startsWith('image/');
+          if (isImage && f.id) {
+            parts.push('<div class="msg-image-wrapper agent-image"><img src="/api/file/' + f.id + '" class="msg-image" loading="lazy" alt="' + escapeHtml(f.name || 'image') + '" onerror="this.onerror=null;this.style.background=\'var(--bg3)\';this.style.minHeight=\'60px\';this.alt=\'[图片加载失败]\'" onclick="openFileViewer(\'' + f.id + '\', this.src, \'' + escapeHtml(f.name) + '\')" /></div>');
+          }
+        }
+      }
+      return parts.length > 0 ? '<div class="msg-attachments msg-attachments-images">' + parts.join('') + '</div>' : '';
+    })();
+    const fileAttachmentHtml = (() => {
+      let parts = [];
+      // User files（用户发送的非图片文件）
       if (isUser && msg.files && msg.files.length > 0) {
         for (const f of msg.files) {
           const fileId = f.id;
           const sizeStr = f.size ? formatFileSize(f.size) : '';
           const icon = _getFileIcon(f.name || f.type || '');
-          parts.push('<div class="msg-file-item" onclick="openFileViewer(\'' + (fileId || '') + '\', \'/api/file/' + (fileId || '') + '\', \'' + escapeHtml(f.name) + '\')" title="点击打开">' +
+          parts.push('<div class="msg-file-item" title="点击预览">' +
             '<span class="msg-file-icon">' + icon + '</span>' +
-            '<span class="msg-file-name">' + escapeHtml(f.name) + '</span>' +
+            '<span class="msg-file-info"><span class="msg-file-name">' + escapeHtml(f.name) + '</span>' +
             (sizeStr ? '<span class="msg-file-size">' + sizeStr + '</span>' : '') +
+            '</span>' +
+            '<span class="msg-file-actions">' +
+            '<a class="msg-file-download" href="/api/file/' + (fileId || '') + '/download" download="' + escapeHtml(f.name) + '" title="下载" onclick="event.stopPropagation()">⬇</a>' +
+            '</span>' +
             '</div>');
         }
       }
-      // Agent files (v2_file events) — 支持实时流式 _files 和历史加载的 files
-      const agentFiles = (msg._files || (msg.files && !isUser ? msg.files : []));
-      if (agentFiles.length > 0) {
+      // Agent files (v2_file events) — 支持实时流式 _files 和历史加载的 files（只渲染非图片文件）
+      const agentFiles = (msg._files || []);
+      if (!isUser && agentFiles.length > 0) {
         for (const f of agentFiles) {
+          const isImage = f.type && f.type.startsWith('image/');
+          if (isImage) continue; // 图片已在 imageAttachmentHtml 中渲染
           const fileId = f.id;
           const sizeStr = f.size ? formatFileSize(f.size) : '';
           const icon = _getFileIcon(f.name || f.type || '');
-          parts.push('<div class="msg-file-item agent-file" onclick="openFileViewer(\'' + (fileId || '') + '\', \'/api/file/' + (fileId || '') + '\', \'' + escapeHtml(f.name) + '\')" title="点击打开">' +
+          parts.push('<div class="msg-file-item agent-file" title="点击预览">' +
             '<span class="msg-file-icon">' + icon + '</span>' +
-            '<span class="msg-file-name">' + escapeHtml(f.name) + '</span>' +
+            '<span class="msg-file-info"><span class="msg-file-name">' + escapeHtml(f.name) + '</span>' +
             (sizeStr ? '<span class="msg-file-size">' + sizeStr + '</span>' : '') +
+            '</span>' +
+            '<span class="msg-file-actions">' +
+            '<a class="msg-file-download" href="/api/file/' + (fileId || '') + '/download" download="' + escapeHtml(f.name) + '" title="下载" onclick="event.stopPropagation()">⬇</a>' +
+            '</span>' +
             '</div>');
         }
       }
-      return parts.length > 0 ? '<div class="msg-attachments">' + parts.join('') + '</div>' : '';
+      return parts.length > 0 ? '<div class="msg-attachments msg-attachments-files">' + parts.join('') + '</div>' : '';
     })();
     const thoughtHtml = msg.thought ? (() => {
       const isStreaming = !!msg.streaming;
@@ -2774,7 +2696,7 @@ function _renderMessagesInner() {
     const ttsIndicator = _isSpeakingThis ?
       ' <span class="tts-playing-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"/><path d="M15.54 8.46a5 5 0 0 1 0 7.07"/></svg></span>' : '';
 
-    // ── Determine rendering mode and streaming indicator ──
+    // ── Determine rendering mode ──
     const hasParts = Array.isArray(msg.parts) && msg.parts.length > 0;
     const hasStreamingText = msg._streamingText && msg._streamingText.trim();
     const anyContent = msg.content || msg._streamingText || hasParts;
@@ -2787,10 +2709,11 @@ function _renderMessagesInner() {
         <span style="font-weight:500">Agent 正在思考...</span>
       </div>` : '';
 
-    // ── Timeline rendering: all parts in ONE unified bubble ──
-    let timelineHtml = '';
+    // ── Bubble content: timeline (parts) or single text ──
+    var bubbleHtml = '';
     if (hasParts || hasStreamingText) {
-      let partsInner = '';
+      // Timeline mode: interleaved text + tool cards
+      var partsInner = '';
       for (const part of (msg.parts || [])) {
         if (part.type === 'text' && part.content.trim()) {
           partsInner += '<div class="timeline-segment">' + renderMarkdown(part.content) + '</div>';
@@ -2807,37 +2730,32 @@ function _renderMessagesInner() {
         partsInner += '<div class="timeline-segment">' + renderMarkdown(msg._streamingText) + _cursor + '</div>';
       }
       if (partsInner) {
-        // All parts (text segments + tool calls) wrapped in ONE message-bubble (full width during streaming)
-        timelineHtml = '<div class="message-bubble msg-bubble-wrapper"><div class="msg-timeline">' + partsInner + '</div></div>';
+        bubbleHtml = '<div class="message-bubble msg-bubble-wrapper"><div class="msg-timeline">' + partsInner + '</div></div>';
+      }
+    } else {
+      // Single bubble mode: plain text (possibly collapsed)
+      var renderedContent = content;
+      if (!msg.streaming && !isUser && shouldCollapseContent(msg.content)) {
+        renderedContent = '<details class="file-content-collapse"><summary>📄 文件内容处理结果（点击展开）</summary><div class="collapse-body">' + content + '</div></details>';
+      }
+      if (renderedContent) {
+        bubbleHtml = '<div class="message-bubble msg-bubble-wrapper">' + renderedContent + ttsIndicator + '</div>';
       }
     }
 
-    // [v1.17] 对历史消息中的长文件内容进行折叠
-    const needCollapse = !msg.streaming && !isUser && !hasParts && !hasStreamingText && shouldCollapseContent(msg.content);
-    const collapsedContent = needCollapse
-      ? '<details class="file-content-collapse"><summary>📄 文件内容处理结果（点击展开）</summary><div class="collapse-body">' + content + '</div></details>'
-      : content;
-
-    // Backward compat: single bubble for messages without parts (full width)
-    const singleBubbleHtml = (!hasParts && !hasStreamingText)
-      ? (collapsedContent ? `<div class="message-bubble msg-bubble-wrapper">${collapsedContent}${ttsIndicator}</div>` : '')
-      : '';
-
-    // ── Task Plan (historical view only — hidden during streaming, shown after completion) ──
+    // ── Task Plan & Finish Reason (V2 structured output, historical only) ──
     var taskPlanHtml = '';
     if (!msg.streaming && msg._v2TaskPlan && msg._v2TaskPlan.trim()) {
       taskPlanHtml = '<div class="v2-task-plan" style="margin-bottom:8px"><div class="v2-task-plan-header" style="font-size:12px;font-weight:600;color:var(--text3);margin-bottom:4px">📋 任务计划</div><div class="v2-task-plan-body">' + renderMarkdown(msg._v2TaskPlan) + '</div></div>';
     }
-    // ── Finish Reason（finish=true 时显示完成原因） ──
     var finishReasonHtml = '';
     if (msg._v2FinishReason && msg._v2FinishReason.trim()) {
       finishReasonHtml = '<div class="v2-finish-reason" style="margin-bottom:8px;padding:8px 12px;border-radius:var(--radius-xs);background:rgba(16,185,129,.08);border-left:3px solid #10b981;font-size:13px;color:var(--text2)"><span style="font-weight:600;color:#10b981;margin-right:6px">✅ 完成原因:</span>' + escapeHtml(msg._v2FinishReason.trim()) + '</div>';
     }
-    const execEventsHtml = (!isUser && !hasParts && msg.exec_events && msg.exec_events.length > 0)
-      ? renderExecEvents(msg.exec_events, i) : '';
-    // [v1.15.9] reasoning 块提级：渲染在 message-row 之外，作为 messages-inner 的直接子元素
-    // 这样它不受 message-avatar(32px) 挤压，能真正撑满 100% 宽度
+
+    // ── Reasoning block (rendered outside message-row for full width) ──
     if (reasoningHtml) html += reasoningHtml;
+    // ── Message row ──
     html += `
       <div class="message-row ${msg.role}${msg.streaming ? ' streaming' : ''}">
         <div class="message-avatar">${avatar}</div>
@@ -2845,12 +2763,11 @@ function _renderMessagesInner() {
           ${thoughtHtml}
           ${taskPlanHtml}
           ${finishReasonHtml}
-          ${timelineHtml}
-          ${singleBubbleHtml}
-          ${attachmentHtml}
+          ${imageAttachmentHtml}
+          ${bubbleHtml}
+          ${fileAttachmentHtml}
           ${streamingIndicator}
-          ${execEventsHtml}
-          ${msg.time ? `<div class="message-time">${formatTime(msg.time)}</div>` : ''}
+          ${msg.time ? '<div class="message-time">' + formatTime(msg.time) + '</div>' : ''}
           ${actionBtns}
         </div>
       </div>`;
@@ -3486,13 +3403,13 @@ function initScrollToBottomBtn() {
   }, { passive: true });
 }
 
-function toast(message, type = 'info') {
+function toast(message, type = 'info', duration = 3000) {
   const container = document.getElementById('toastContainer');
   const el = document.createElement('div');
   el.className = `toast toast-${type}`;
   el.textContent = message;
   container.appendChild(el);
-  setTimeout(() => { el.style.opacity = '0'; setTimeout(() => el.remove(), 300); }, 3000);
+  setTimeout(() => { el.style.opacity = '0'; setTimeout(() => el.remove(), 300); }, duration);
 }
 
 // ══════════════════════════════════════════════════════

package/web/ui/index.html

@@ -230,9 +230,16 @@ tr:hover{background:var(--surface2)}
   .toast{left:16px;right:16px;bottom:16px}
   .agent-card{flex-direction:column;align-items:flex-start}
   .agent-card .flex.flex-col{flex-direction:row;gap:4px}
-  /* 技能行移动端允许换行 */
-  .skill-row{flex-wrap:wrap}
-  .skill-row .flex{flex-wrap:wrap;gap:4px}
+  /* 技能行移动端优化：纵向堆叠，简介区域不受挤压 */
+  .skill-row{flex-wrap:wrap;gap:8px;align-items:flex-start;padding:12px}
+  .skill-row > div:first-child{display:none}
+  .skill-row .skill-info{flex:1 1 100%;min-width:0}
+  .skill-row .skill-name{font-size:14px}
+  .skill-row .skill-desc{font-size:13px;line-height:1.6}
+  .skill-row .flex{flex-wrap:wrap;gap:6px;width:100%;justify-content:flex-start}
+  .skill-row .flex .toggle{margin-left:auto}
+  .skill-row .flex .tag{font-size:11px}
+  .skill-row .flex .badge{font-size:10px}
   /* 任务表格优化 */
   .table-wrap table{min-width:auto}
   .table-wrap td[style*="max-width:300px"]{max-width:150px!important;white-space:normal!important;word-break:break-all}
@@ -1748,16 +1755,23 @@ async function renderSkills(){
 function skillRowHtml(s){
   const isDisabled=s.disabled;
   const paramCount=(s.parameters||[]).length;
+  const isMarkdown=s.skill_type==='markdown';
+  const icon=isMarkdown?'📝':'🔧';
+  const typeBadge=isMarkdown?'<span class="badge badge-purple">Prompt</span>':'<span class="badge badge-green">内置</span>';
+  const paramTag=paramCount>0?`<span class="tag">${paramCount} 参数</span>`:'';
+  const refTag=(s.references||[]).length>0?`<span class="tag">${s.references.length} 参考资料</span>`:'';
+  const tplTag=s.has_templates?'<span class="tag">含模板</span>':'';
+  const scriptTag=s.has_scripts?'<span class="tag">含脚本</span>':'';
   return `<div class="skill-row" data-name="${escHtml(s.name||'')}" data-desc="${escHtml(s.description||'')}">
-    <div style="flex-shrink:0;width:36px;text-align:center;font-size:18px">🔧</div>
+    <div style="flex-shrink:0;width:36px;text-align:center;font-size:18px">${icon}</div>
     <div class="skill-info">
       <div class="skill-name">${escHtml(s.name)} ${isDisabled?'<span class="badge badge-red">已禁用</span>':''} ${s.dangerous?'<span class="badge badge-red">⚠ 危险</span>':''}</div>
       <div class="skill-desc">${escHtml(s.description||'暂无描述')}</div>
     </div>
     <div class="flex gap-8 items-center" style="flex-shrink:0">
-      <span class="badge badge-green">内置</span>
+      ${typeBadge}
       ${s.category?`<span class="badge badge-blue">${escHtml(s.category)}</span>`:''}
-      <span class="tag">${paramCount} 参数</span>
+      ${paramTag}${refTag}${tplTag}${scriptTag}
       <label class="toggle" title="${isDisabled?'启用':'禁用'}"><input type="checkbox" ${!isDisabled?'checked':''} onchange="toggleSkill('${escHtml(s.name)}',this.checked)"><span class="slider"></span></label>
       <button class="btn btn-sm btn-ghost" onclick="viewSkillDetail('${escHtml(s.name)}')">详情</button>
     </div>