myagent-ai 1.15.18 → 1.15.20

package/package.json

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

package/skills/search_skill.py

@@ -101,8 +101,13 @@ class WebSearchSkill(Skill):
 
             def _fetch():
                 url = "https://html.duckduckgo.com/html/"
-                r = requests.get(url, params={"q": query}, headers=_HEADERS, timeout=15)
-                r.raise_for_status()
+                try:
+                    r = requests.get(url, params={"q": query}, headers=_HEADERS, timeout=15)
+                    r.raise_for_status()
+                except requests.exceptions.SSLError:
+                    logger.warning("DuckDuckGo SSL 验证失败，跳过证书验证重试")
+                    r = requests.get(url, params={"q": query}, headers=_HEADERS, timeout=15, verify=False)
+                    r.raise_for_status()
                 return r.text
 
             html = await loop.run_in_executor(None, _fetch)
@@ -151,13 +156,24 @@ class WebSearchSkill(Skill):
 
             def _fetch():
                 url = "https://www.bing.com/search"
-                r = requests.get(
-                    url,
-                    params={"q": query, "count": num},
-                    headers=_HEADERS,
-                    timeout=15,
-                )
-                r.raise_for_status()
+                try:
+                    r = requests.get(
+                        url,
+                        params={"q": query, "count": num},
+                        headers=_HEADERS,
+                        timeout=15,
+                    )
+                    r.raise_for_status()
+                except requests.exceptions.SSLError:
+                    logger.warning("Bing SSL 验证失败，跳过证书验证重试")
+                    r = requests.get(
+                        url,
+                        params={"q": query, "count": num},
+                        headers=_HEADERS,
+                        timeout=15,
+                        verify=False,
+                    )
+                    r.raise_for_status()
                 return r.text
 
             html = await loop.run_in_executor(None, _fetch)
@@ -225,8 +241,13 @@ class WebReadSkill(Skill):
             loop = asyncio.get_event_loop()
 
             def _fetch():
-                r = requests.get(url, headers=_HEADERS, timeout=30)
-                r.raise_for_status()
+                try:
+                    r = requests.get(url, headers=_HEADERS, timeout=30)
+                    r.raise_for_status()
+                except requests.exceptions.SSLError:
+                    logger.warning(f"web_read SSL 验证失败 ({url})，跳过证书验证重试")
+                    r = requests.get(url, headers=_HEADERS, timeout=30, verify=False)
+                    r.raise_for_status()
                 r.encoding = r.apparent_encoding
                 return r.text
 
@@ -300,13 +321,24 @@ class URLReadSkill(Skill):
             loop = asyncio.get_event_loop()
 
             def _request():
-                r = requests.request(
-                    method=method,
-                    url=url,
-                    headers=headers,
-                    data=body,
-                    timeout=30,
-                )
+                try:
+                    r = requests.request(
+                        method=method,
+                        url=url,
+                        headers=headers,
+                        data=body,
+                        timeout=30,
+                    )
+                except requests.exceptions.SSLError:
+                    logger.warning(f"url_read SSL 验证失败 ({url})，跳过证书验证重试")
+                    r = requests.request(
+                        method=method,
+                        url=url,
+                        headers=headers,
+                        data=body,
+                        timeout=30,
+                        verify=False,
+                    )
                 return r
 
             response = await loop.run_in_executor(None, _request)

package/web/api_server.py

@@ -256,6 +256,8 @@ class ApiServer:
         r.add_get("/api/agents/{name:[^/]+}/knowledge", self.handle_list_agent_knowledge)
         r.add_post("/api/agents/{name:[^/]+}/knowledge/upload", self.handle_upload_agent_knowledge)
         r.add_delete("/api/agents/{name:[^/]+}/knowledge", self.handle_delete_agent_knowledge)
+        r.add_post("/api/agents/{name:[^/]+}/avatar", self.handle_upload_agent_avatar)
+        r.add_get("/api/agents/{name:[^/]+}/avatar.png", self.handle_get_agent_avatar)
         # ── Agent 通用 CRUD（放在子资源之后，name 不含斜杠避免吞掉子路由） ──
         r.add_get("/api/agents/{name:[^/]+}", self.handle_get_agent)
         r.add_put("/api/agents/{name:[^/]+}", self.handle_update_agent)
@@ -2082,7 +2084,7 @@ class ApiServer:
                     "error": f"系统 Agent '{path}' 的灵魂文件和身份文件受保护，不可修改",
                 }, status=403)
             # 系统 Agent 只允许修改有限字段
-        allowed_fields = ("name", "description", "avatar_color", "avatar_emoji", "model", "system_prompt",
+        allowed_fields = ("name", "description", "avatar_color", "avatar_emoji", "avatar_image", "model", "system_prompt",
                    "execution_mode", "enabled", "sandbox_image", "sandbox_network", "sandbox_memory",
                    "platform", "platform_token", "platform_app_id", "platform_app_secret",
                    "model_id", "backup_model_ids", "work_dir", "department")
@@ -5018,6 +5020,110 @@ class ApiServer:
 
         return web.json_response({"ok": True, "message": "已删除"})
 
+    async def handle_upload_agent_avatar(self, request):
+        """POST /api/agents/{name}/avatar - 上传 Agent 头像图片（支持裁剪）
+
+        请求格式: multipart/form-data
+        - file: 图片文件 (jpg/png/webp)
+        - crop_x, crop_y, crop_w, crop_h: 裁剪区域（像素，可选，不传则不裁剪）
+        - size: 输出尺寸（像素，默认128，最大512）
+
+        返回: {"ok": True, "url": "/api/agents/{name}/avatar.png"}
+        """
+        agent_path = request.match_info["name"]
+        ad = self._agent_dir(agent_path)
+        if not (ad / "config.json").exists():
+            return web.json_response({"error": "Agent 不存在"}, status=404)
+
+        try:
+            reader = await request.multipart()
+            field = await reader.next()
+
+            if not field or field.name != "file":
+                return web.json_response({"error": "缺少 file 字段"}, status=400)
+
+            # 读取上传的图片数据
+            image_data = bytearray()
+            while True:
+                chunk = await field.read_chunk()
+                if not chunk:
+                    break
+                image_data.extend(chunk)
+
+            # 解析裁剪参数
+            crop_x = int(request.query.get("crop_x", 0))
+            crop_y = int(request.query.get("crop_y", 0))
+            crop_w = int(request.query.get("crop_w", 0))
+            crop_h = int(request.query.get("crop_h", 0))
+            out_size = min(int(request.query.get("size", 128)), 512)
+
+            # 使用 Pillow 处理图片
+            from PIL import Image
+            import io
+
+            img = Image.open(io.BytesIO(bytes(image_data)))
+
+            # 如果有 Alpha 通道，转为 RGB（JPEG 不支持透明）
+            if img.mode in ("RGBA", "P"):
+                # 创建白色背景
+                bg = Image.new("RGB", img.size, (255, 255, 255))
+                if img.mode == "P":
+                    img = img.convert("RGBA")
+                bg.paste(img, mask=img.split()[3] if img.mode == "RGBA" else None)
+                img = bg
+            elif img.mode != "RGB":
+                img = img.convert("RGB")
+
+            # 裁剪
+            if crop_w > 0 and crop_h > 0:
+                img = img.crop((crop_x, crop_y, crop_x + crop_w, crop_y + crop_h))
+
+            # 居中裁剪为正方形（如果还不是正方形）
+            w, h = img.size
+            min_side = min(w, h)
+            left = (w - min_side) // 2
+            top = (h - min_side) // 2
+            img = img.crop((left, top, left + min_side, top + min_side))
+
+            # 缩放到目标尺寸
+            img = img.resize((out_size, out_size), Image.LANCZOS)
+
+            # 保存为 PNG
+            avatar_path = ad / "avatar.png"
+            img.save(str(avatar_path), "PNG", optimize=True)
+
+            # 更新 config.json 中的 avatar_image 字段
+            cfg = self._read_agent_config(agent_path)
+            if cfg:
+                cfg["avatar_image"] = f"/api/agents/{agent_path}/avatar.png"
+                (ad / "config.json").write_text(
+                    json.dumps(cfg, indent=2, ensure_ascii=False), encoding="utf-8"
+                )
+
+            # 确保头像文件可被静态访问：注册 avatar 路由
+            avatar_url = f"/api/agents/{agent_path}/avatar.png"
+
+            return web.json_response({
+                "ok": True,
+                "url": avatar_url,
+                "size": out_size,
+            })
+
+        except ImportError:
+            return web.json_response({"error": "需要 Pillow 库: pip install Pillow"}, status=500)
+        except Exception as e:
+            logger.error(f"头像上传失败 ({agent_path}): {e}", exc_info=True)
+            return web.json_response({"error": f"头像上传失败: {e}"}, status=500)
+
+    async def handle_get_agent_avatar(self, request):
+        """GET /api/agents/{name}/avatar.png - 获取 Agent 头像图片"""
+        agent_path = request.match_info["name"]
+        ad = self._agent_dir(agent_path)
+        avatar_file = ad / "avatar.png"
+        if not avatar_file.exists():
+            return web.json_response({"error": "头像不存在"}, status=404)
+        return web.FileResponse(str(avatar_file))
+
     # ── 知识库 RAG 搜索 ──
 
     async def handle_knowledge_search(self, request):
@@ -5253,14 +5359,62 @@ class ApiServer:
                 model_chain = self._build_model_chain(agent_cfg, agent_path)
                 session_id = f"group_{gid}_{agent_path}"
 
+                # [v1.15.18] 构建 Agent 专属系统提示词（与1:1聊天一致）
+                _, agent_system_prompt = self._build_agent_chat_context(agent_path, agent_cfg, content)
+
+                # [v1.15.18] 构建群聊上下文：群信息 + 成员列表 + 发言者身份
+                member_lines = []
+                for m in group.members:
+                    mc = self._read_agent_config(m.agent_path)
+                    m_name = mc.get("name", m.agent_path) if mc else m.agent_path
+                    m_desc = mc.get("description", "") if mc else ""
+                    role_label = {"owner": "群主", "admin": "管理员"}.get(m.role, "成员")
+                    nick = f"（昵称: {m.nickname}）" if m.nickname else ""
+                    line = f"  - {m_name} [{m.agent_path}] ({role_label})"
+                    if m_desc:
+                        line += f" — {m_desc}"
+                    line += nick
+                    if m.muted:
+                        line += "（已禁言）"
+                    member_lines.append(line)
+
+                my_name = agent_cfg.get("name", agent_path) if agent_cfg else agent_path
+                my_role = {"owner": "群主", "admin": "管理员"}.get(member.role, "成员")
+                my_desc = agent_cfg.get("description", "") if agent_cfg else ""
+
+                group_context = (
+                    f"## 群聊上下文\n"
+                    f"- 群名称: {group.name}\n"
+                    f"- 群ID: {group.id}\n"
+                    f"- 群描述: {group.description}\n"
+                    f"- 当前发言者: 用户\n"
+                    f"- 你的身份: {my_name} ({my_role})"
+                    + (f" — {my_desc}" if my_desc else "")
+                    + f"\n- 群成员 ({len(group.members)}人):\n"
+                    + "\n".join(member_lines)
+                    + "\n\n注意：你只代表自己发言，回复时使用第一人称。"
+                    "如果消息不是跟你相关的，可以简短回复或不回复。"
+                )
+
+                # 将群聊上下文追加到 agent_system_prompt
+                if agent_system_prompt:
+                    agent_system_prompt += "\n\n" + group_context
+                else:
+                    agent_system_prompt = group_context
+
                 # 构建部门上下文（如果此群属于某个部门）
-                agent_content = content
                 dept_context = self._build_dept_context(gid, agent_path)
                 if dept_context:
-                    agent_content = dept_context + "\n\n---\n\n" + content
+                    agent_system_prompt += "\n\n" + dept_context
+
+                # 构建最终消息（用户原文不包含任何注入内容）
+                agent_content = content
 
                 if model_chain and self.core.llm:
-                    response = await self._try_model_chain(model_chain, agent_content, session_id)
+                    response = await self._try_model_chain(
+                        model_chain, agent_content, session_id,
+                        agent_path=agent_path, agent_system_prompt=agent_system_prompt,
+                    )
                 else:
                     response = await self.core.process_message(agent_content, session_id)
 
@@ -5446,14 +5600,55 @@ class ApiServer:
                     model_chain = self._build_model_chain(agent_cfg, agent_path)
                     session_id = f"group_{group_id}_{agent_path}"
 
-                    # 构建部门上下文
-                    agent_content = description
+                    # [v1.15.18] 构建 Agent 专属系统提示词 + 群聊上下文（与发送群消息一致）
+                    _, agent_system_prompt = self._build_agent_chat_context(agent_path, agent_cfg, description)
+
+                    # 构建群聊上下文
+                    member_lines = []
+                    for m in group.members:
+                        mc = self._read_agent_config(m.agent_path)
+                        m_name = mc.get("name", m.agent_path) if mc else m.agent_path
+                        m_desc = mc.get("description", "") if mc else ""
+                        role_label = {"owner": "群主", "admin": "管理员"}.get(m.role, "成员")
+                        line = f"  - {m_name} [{m.agent_path}] ({role_label})"
+                        if m_desc:
+                            line += f" — {m_desc}"
+                        member_lines.append(line)
+
+                    my_name = agent_cfg.get("name", agent_path) if agent_cfg else agent_path
+                    my_role = {"owner": "群主", "admin": "管理员"}.get(member.role, "成员")
+                    my_desc = agent_cfg.get("description", "") if agent_cfg else ""
+
+                    group_context = (
+                        f"## 群聊上下文\n"
+                        f"- 群名称: {group.name}\n"
+                        f"- 群ID: {group.id}\n"
+                        f"- 群描述: {group.description}\n"
+                        f"- 当前发言者: 用户（重试任务）\n"
+                        f"- 你的身份: {my_name} ({my_role})"
+                        + (f" — {my_desc}" if my_desc else "")
+                        + f"\n- 群成员 ({len(group.members)}人):\n"
+                        + "\n".join(member_lines)
+                        + "\n\n注意：你只代表自己发言，回复时使用第一人称。"
+                        "如果消息不是跟你相关的，可以简短回复或不回复。"
+                    )
+
+                    if agent_system_prompt:
+                        agent_system_prompt += "\n\n" + group_context
+                    else:
+                        agent_system_prompt = group_context
+
                     dept_context = self._build_dept_context(group_id, agent_path)
                     if dept_context:
-                        agent_content = dept_context + "\n\n---\n\n" + description
+                        agent_system_prompt += "\n\n" + dept_context
+
+                    agent_content = description
 
                     if model_chain and self.core.llm:
-                        response = await self._try_model_chain(model_chain, agent_content, session_id)
+                        response = await self._try_model_chain(
+                            model_chain, agent_content, session_id,
+                            agent_path=agent_path, agent_system_prompt=agent_system_prompt,
+                        )
                     else:
                         response = await self.core.process_message(agent_content, session_id)
 

package/web/ui/chat/chat_main.js

@@ -249,6 +249,20 @@ function getAgentGradient(name) {
   return `linear-gradient(135deg,${palettes[idx][0]},${palettes[idx][1]})`;
 }
 
+/** 渲染 Agent 头像 HTML — 支持 avatar_image（图片）和 avatar_emoji（emoji）双模式 */
+function avatarHtml(agent, size, extraStyle) {
+  if (!agent) return '';
+  const s = size || 36;
+  const style = (extraStyle || '') + 'width:' + s + 'px;height:' + s + 'px;border-radius:50%;object-fit:cover;display:block';
+  if (agent.avatar_image) {
+    return '<img src="' + escapeHtml(agent.avatar_image) + '" style="' + style + '" onerror="this.style.display=\'none\'">';
+  }
+  const emoji = agent.avatar_emoji || agent.emoji || getAgentInitials(agent.name);
+  const bg = agent.avatar_color ? agent.avatar_color + '22' : 'transparent';
+  const border = agent.avatar_color ? '2px solid ' + agent.avatar_color : 'none';
+  return '<div style="' + style + ';background:' + bg + ';border:' + border + ';display:flex;align-items:center;justify-content:center;font-size:' + Math.round(s * 0.55) + 'px">' + escapeHtml(emoji) + '</div>';
+}
+
 // ── State Persistence (localStorage) ──
 const StatePersistence = {
   PREFIX: 'myagent_',
@@ -988,9 +1002,10 @@ function renderMasterAgentCard() {
   var color = agent ? (agent.avatar_color || 'linear-gradient(135deg,#6366f1,#8b5cf6)') : 'linear-gradient(135deg,#6366f1,#8b5cf6)';
   var bgStyle = color.includes('gradient') ? 'background:' + color : '';
   var bgClass = color.includes('gradient') ? '' : getAgentColorClass('default');
+  var avatarContent = (agent && agent.avatar_image) ? '<img src="' + escapeHtml(agent.avatar_image) + '" style="width:100%;height:100%;object-fit:cover;border-radius:12px">' : emoji;
 
   el.innerHTML = '<div class="rp-master-card ' + (isActive ? 'active' : '') + '" onclick="selectAgent(\'default\')">'
-    + '<div class="rp-master-avatar ' + bgClass + '" style="' + bgStyle + '">' + emoji + '</div>'
+    + '<div class="rp-master-avatar ' + bgClass + '" style="' + bgStyle + '">' + avatarContent + '</div>'
     + '<div class="rp-master-info">'
     + '<div class="rp-master-name">' + escapeHtml(name) + '</div>'
     + '<div class="rp-master-desc">' + escapeHtml(desc) + '</div>'
@@ -2456,7 +2471,7 @@ function _renderMessagesInner() {
     // Skip standalone tool messages (now grouped into assistant parts via groupHistoryMessages)
     if (msg.role === 'tool') continue;
 
-    const avatar = isUser ? '👤' : botEmoji;
+    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);
     const thoughtHtml = msg.thought ? (() => {
       const isStreaming = !!msg.streaming;

package/web/ui/index.html

@@ -378,9 +378,10 @@ function agentCardHtml(a,deptMap){
   const dept=deptMap?.[a.department]||null;
   const emoji=a.avatar_emoji||'🤖';
   const color=a.avatar_color||'#6366f1';
+  const avatarHtml=a.avatar_image?'<img src="'+escHtml(a.avatar_image)+'" style="width:100%;height:100%;object-fit:cover">':emoji;
   const enabled=a.enabled!==false;
   return `<div class="agent-card" data-name="${escHtml(a.name||'')}" data-desc="${escHtml(a.description||'')}">
-    <div class="avatar" style="background:${color}22;border:2px solid ${color}">${emoji}</div>
+    <div class="avatar" style="background:${color}22;border:2px solid ${color};overflow:hidden">${avatarHtml}</div>
     <div class="info">
       <h4>${escHtml(a.name||a.path)} ${isSys?'<span class="badge badge-purple">系统</span>':''} ${!enabled?'<span class="badge badge-red">已禁用</span>':''}</h4>
       <p>${escHtml(a.description||'无描述')}</p>
@@ -424,7 +425,30 @@ function openCreateAgentModal(){
       <div class="form-group"><label>描述</label><input id="caDesc" placeholder="Agent 描述"></div>
     </div>
     <div class="form-row">
-      <div class="form-group"><label>头像 Emoji</label><input id="caEmoji" placeholder="🤖" maxlength="4"></div>
+      <div class="form-group"><label>头像</label>
+        <div class="flex gap-8 items-center" style="flex-wrap:wrap">
+          <div id="caAvatarPreview" class="avatar" style="width:48px;height:48px;background:#6366f122;border:2px solid #6366f1;font-size:24px">🤖</div>
+          <div style="flex:1;min-width:200px">
+            <div class="flex gap-8 items-center">
+              <input id="caEmoji" placeholder="🤖" maxlength="4" style="width:60px" oninput="$('caAvatarPreview').textContent=this.value||'🤖'">
+              <label class="btn btn-sm" style="cursor:pointer"><input type="file" accept="image/*" hidden onchange="handleAvatarUpload(this,'ca')">
+                📷 上传图片
+              </label>
+            </div>
+            <div id="caCropArea" style="display:none;margin-top:8px">
+              <div style="position:relative;display:inline-block">
+                <img id="caCropImg" style="max-width:300px;max-height:200px;border:1px solid #ddd;cursor:crosshair" onmousedown="startCrop(event,'ca')">
+                <div id="caCropOverlay" style="position:absolute;border:2px dashed #4f46e5;background:rgba(79,70,229,0.15);display:none;pointer-events:none"></div>
+              </div>
+              <div class="flex gap-8 mt-8">
+                <button class="btn btn-sm btn-primary" onclick="confirmAvatarCrop('ca','${name||''}')">✂️ 裁剪并使用</button>
+                <button class="btn btn-sm btn-ghost" onclick="cancelAvatarCrop('ca')">取消</button>
+              </div>
+            </div>
+            <input type="hidden" id="caAvatarImage" value="">
+          </div>
+        </div>
+      </div>
       <div class="form-group"><label>头像颜色</label><div class="flex gap-8 items-center"><input id="caColor" value="#6366f1" type="color" style="width:48px;height:34px;padding:2px"><input id="caColorText" value="#6366f1" style="flex:1" oninput="$('caColor').value=this.value"></div></div>
     </div>
     <div class="form-row">
@@ -484,7 +508,31 @@ async function openEditAgentModal(path){
         <div class="form-group"><label>描述</label><input id="eaDesc" value="${escHtml(a.description||'')}" ${isSys?'disabled':''}></div>
       </div>
       <div class="form-row">
-        <div class="form-group"><label>头像 Emoji</label><input id="eaEmoji" value="${escHtml(a.avatar_emoji||'')}" ${isSys?'disabled':''}></div>
+        <div class="form-group"><label>头像</label>
+          <div class="flex gap-8 items-center" style="flex-wrap:wrap">
+            <div id="eaAvatarPreview" class="avatar" style="width:48px;height:48px;background:${escHtml(a.avatar_color||'#6366f1')}22;border:2px solid ${escHtml(a.avatar_color||'#6366f1')};font-size:24px;overflow:hidden">${a.avatar_image?'<img src="'+escHtml(a.avatar_image)+'" style="width:100%;height:100%;object-fit:cover">':escHtml(a.avatar_emoji||'🤖')}</div>
+            <div style="flex:1;min-width:200px">
+              <div class="flex gap-8 items-center">
+                <input id="eaEmoji" value="${escHtml(a.avatar_emoji||'')}" style="width:60px" oninput="if(!$('eaAvatarImage').value){$('eaAvatarPreview').textContent=this.value||'🤖';$('eaAvatarPreview').innerHTML=''}" ${isSys?'disabled':''}>
+                <label class="btn btn-sm" style="cursor:pointer" ${isSys?'style=\"pointer-events:none;opacity:0.5\"':''}><input type="file" accept="image/*" hidden onchange="handleAvatarUpload(this,'ea')" ${isSys?'disabled':''}>
+                  📷 上传图片
+                </label>
+                ${a.avatar_image?'<button class="btn btn-sm btn-ghost" onclick="removeAvatarImage(\\''+escHtml(path)+'\\')">🗑️ 移除图片</button>':''}
+              </div>
+              <div id="eaCropArea" style="display:none;margin-top:8px">
+                <div style="position:relative;display:inline-block">
+                  <img id="eaCropImg" style="max-width:300px;max-height:200px;border:1px solid #ddd;cursor:crosshair" onmousedown="startCrop(event,'ea')">
+                  <div id="eaCropOverlay" style="position:absolute;border:2px dashed #4f46e5;background:rgba(79,70,229,0.15);display:none;pointer-events:none"></div>
+                </div>
+                <div class="flex gap-8 mt-8">
+                  <button class="btn btn-sm btn-primary" onclick="confirmAvatarCrop('ea','${escHtml(path)}')">✂️ 裁剪并使用</button>
+                  <button class="btn btn-sm btn-ghost" onclick="cancelAvatarCrop('ea')">取消</button>
+                </div>
+              </div>
+              <input type="hidden" id="eaAvatarImage" value="${escHtml(a.avatar_image||'')}">
+            </div>
+          </div>
+        </div>
         <div class="form-group"><label>头像颜色</label><div class="flex gap-8 items-center"><input id="eaColor" value="${escHtml(a.avatar_color||'#6366f1')}" type="color" style="width:48px;height:34px;padding:2px" ${isSys?'disabled':''}><input id="eaColorText" value="${escHtml(a.avatar_color||'#6366f1')}" style="flex:1" oninput="$('eaColor').value=this.value" ${isSys?'disabled':''}></div></div>
       </div>
       <div class="form-group"><label>绑定模型</label><select id="eaModelId"><option value="">使用全局默认</option>${modelOpts}</select></div>
@@ -1897,6 +1945,63 @@ async function sysLoadPreview(){
   if(pages[page])showPage(page);else showPage('dashboard');
 })();
 setInterval(()=>{api('/api/status').catch(()=>{})},30000);
+
+/* ── 头像上传 + 裁剪 ── */
+var _cropState={prefix:'',dragging:false,sx:0,sy:0};
+function handleAvatarUpload(input,prefix){
+  var file=input.files[0];if(!file)return;
+  if(file.size>5*1024*1024){showToast('图片不能超过 5MB','danger');return}
+  var reader=new FileReader();
+  reader.onload=function(e){
+    var img=$(prefix+'CropImg');img.src=e.target.result;
+    $(prefix+'CropArea').style.display='block';
+    $(prefix+'CropOverlay').style.display='none';
+    _cropState.prefix=prefix;
+  };
+  reader.readAsDataURL(file);
+}
+function startCrop(e,prefix){
+  _cropState={prefix:prefix,dragging:true,sx:e.offsetX,sy:e.offsetY};
+  var overlay=$(prefix+'CropOverlay');
+  overlay.style.display='block';
+  overlay.style.left=e.offsetX+'px';overlay.style.top=e.offsetY+'px';
+  overlay.style.width='0';overlay.style.height='0';
+  document.addEventListener('mousemove',doCrop);document.addEventListener('mouseup',endCrop);
+}
+function doCrop(e){
+  if(!_cropState.dragging)return;
+  var img=$(_cropState.prefix+'CropImg'),rect=img.getBoundingClientRect();
+  var overlay=$(_cropState.prefix+'CropOverlay');
+  var x1=Math.min(_cropState.sx,e.clientX-rect.left),y1=Math.min(_cropState.sy,e.clientY-rect.top);
+  var x2=Math.max(_cropState.sx,e.clientX-rect.left),y2=Math.max(_cropState.sy,e.clientY-rect.top);
+  x2=Math.min(x2,rect.width);y2=Math.min(y2,rect.height);
+  var w=x2-x1,h=y2-y1;if(w<5||h<5)return;
+  overlay.style.left=x1+'px';overlay.style.top=y1+'px';overlay.style.width=w+'px';overlay.style.height=h+'px';
+}
+function endCrop(){_cropState.dragging=false;document.removeEventListener('mousemove',doCrop);document.removeEventListener('mouseup',endCrop);}
+function cancelAvatarCrop(prefix){$(prefix+'CropArea').style.display='none';}
+function confirmAvatarCrop(prefix,agentPath){
+  var img=$(prefix+'CropImg'),overlay=$(prefix+'CropOverlay');
+  var scale=img.naturalWidth/img.clientWidth;
+  var cx=Math.round(parseFloat(overlay.style.left)*scale),cy=Math.round(parseFloat(overlay.style.top)*scale);
+  var cw=Math.round(parseFloat(overlay.style.width)*scale),ch=Math.round(parseFloat(overlay.style.height)*scale);
+  if(cw<10||ch<10){showToast('请拖动选择裁剪区域','danger');return}
+  var formData=new FormData();
+  formData.append('file',$(prefix+'CropImg').src.split(',')[1]?dataURItoBlob($(prefix+'CropImg').src):'');
+  showToast('正在上传裁剪...','info');
+  fetch('/api/agents/'+encodeURIComponent(agentPath)+'/avatar?crop_x='+cx+'&crop_y='+cy+'&crop_w='+cw+'&crop_h='+ch+'&size=128',{
+    method:'POST',body:formData
+  }).then(r=>r.json()).then(d=>{
+    if(d.ok){$(prefix+'AvatarImage').value=d.url;$(prefix+'AvatarPreview').innerHTML='<img src="'+d.url+'" style="width:100%;height:100%;object-fit:cover">';$(prefix+'CropArea').style.display='none';showToast('头像已更新','success');}
+    else showToast(d.error||'上传失败','danger');
+  }).catch(e=>showToast('上传失败: '+e,'danger'));
+}
+function dataURItoBlob(dataURI){var b=atob(dataURI.split(',')[1]),a=new Uint8Array(b.length);for(var i=0;i<b.length;i++)a[i]=b.charCodeAt(i);return new Blob([a],{type:'image/png'});}
+async function removeAvatarImage(agentPath){
+  var ad=await api('/api/agents/'+encodeURIComponent(agentPath));if(!ad||!ad.avatar_image)return;
+  await api('/api/agents/'+encodeURIComponent(agentPath),{method:'PUT',body:JSON.stringify({avatar_image:''})});
+  $('eaAvatarImage').value='';$('eaAvatarPreview').innerHTML=escHtml(ad.avatar_emoji||'🤖');showToast('已移除头像图片','success');
+}
 </script>
 </body>
 </html>