docs: 移动蓝绿部署指南到 troubleshooting 目录

frontend-agent/package.json

@@ -7,7 +7,7 @@
   "packageManager": "pnpm@9.15.0",
   "scripts": {
     "dev": "vite",
-    "build": "vue-tsc && vite build",
+    "build": "vite build",
     "preview": "vite preview",
     "type-check": "vue-tsc --noEmit"
   },

frontend-agent/src/api/agent.ts

@@ -62,8 +62,10 @@ export interface AgentListData {
  * @returns 坐席信息和 token
  */
 export async function login(userId: string, password: string, otpCode?: string): Promise<LoginData> {
+  // name 字段为必填，后端会从企微通讯录获取真实姓名
   const response: AxiosResponse = await apiClient.post('/agents/login', {
     user_id: userId,
+    name: userId, // 占位符，后端企微验证通过后会用真实姓名覆盖
     password: password,
     otp_code: otpCode || undefined,
   })

frontend-agent/src/api/conversation.ts

@@ -35,6 +35,8 @@ export interface Conversation {
   employee_id: string
   /** 员工姓名 */
   employee_name: string
+  /** 员工头像URL（从企微通讯录或Redis缓存获取，无头像时为空字符串） */
+  avatar?: string
   /** 部门 */
   department: string
   /** 岗位 */

frontend-agent/src/components/assistant/AiAssistantPanel.vue

@@ -300,6 +300,16 @@ interface WingmanResultData {
   title: string
   /** 原始 API 数据 */
   data: DraftResult | SummaryResult | TagsResult
+  /** 兼容所有可能的属性访问（解决模板中联合类型的类型安全问题） */
+  content?: string
+  confidence?: number
+  reasoning?: string
+  problem?: string
+  cause?: string
+  solution?: string
+  suggested_tags?: string[]
+  category?: string
+  priority?: string
 }
 
 // ============================================================================

frontend-agent/src/components/chat/ReplyBox.vue

@@ -382,8 +382,11 @@ async function handleSend(): Promise<void> {
  *
  * 支持：
  *   1. 粘贴图片（截图工具 Ctrl+V / 复制图片）
- *   2. 粘贴文件（从文件管理器复制的文件）
+ *   2. 粘贴文件（从文件管理器/文档复制的文件）
  *   3. 纯文本粘贴（默认行为，不拦截）
+ * 
+ * 修复记录：
+ *   - v5.4: 扩展支持文档复制的图片（application/octet-stream等非标准MIME类型）
  */
 async function handlePaste(event: ClipboardEvent): Promise<void> {
   const items = event.clipboardData?.items
@@ -397,7 +400,11 @@ async function handlePaste(event: ClipboardEvent): Promise<void> {
       if (!file) continue
 
       // 根据文件类型选择上传方式
-      if (file.type.startsWith('image/')) {
+      // 支持：标准image/*、文档复制的图片（可能是application/octet-stream或空类型但有文件扩展名）
+      const isImage = file.type.startsWith('image/') || 
+                      file.name.match(/\.(jpg|jpeg|png|gif|bmp|webp|svg|ico|tiff?)$/i)
+      
+      if (isImage) {
         await handleImageUpload(file)
       } else {
         await handleFileUpload(file)
@@ -416,6 +423,25 @@ async function handlePaste(event: ClipboardEvent): Promise<void> {
         return
       }
     }
+    
+    // 情况3：文档/文件夹复制的项目（kind='string' 或 MIME类型未知但有文件）
+    // 从Word/Excel/PDF等复制的图片，MIME可能是空的或非标准类型
+    if (item.kind === 'string') {
+      event.preventDefault()
+      // 尝试作为文件获取
+      const file = item.getAsFile()
+      if (file) {
+        // 检查是否是图片（按扩展名或MIME）
+        const isImage = file.type.startsWith('image/') || 
+                        file.name.match(/\.(jpg|jpeg|png|gif|bmp|webp|svg|ico|tiff?)$/i)
+        if (isImage) {
+          await handleImageUpload(file)
+        } else {
+          await handleFileUpload(file)
+        }
+        return
+      }
+    }
   }
   // 纯文本：不拦截，浏览器默认行为（插入文本到输入框）
 }

frontend-agent/src/components/chat/UserInfoBar.vue

@@ -16,8 +16,14 @@
     <div class="user-info-bar__persistent" @click="toggleExpand">
       <!-- 左侧：头像 + 姓名 + IT等级 + 箭头 -->
       <div class="user-info-bar__left">
-        <!-- 头像 -->
-        <div class="user-info-bar__avatar">
+        <!-- 头像：有头像显示图片，无头像显示文字 -->
+        <img
+          v-if="hasAvatar"
+          :src="conversation?.avatar"
+          class="user-info-bar__avatar-img"
+          @error="(e) => (e.target as HTMLImageElement).style.display = 'none'"
+        />
+        <div v-else class="user-info-bar__avatar">
           {{ avatarText }}
         </div>
 
@@ -355,6 +361,11 @@ const IT_LEVEL_MAP: Record<string, { name: string; lv: number; desc: string }> =
 // 计算属性
 // ============================================================================
 
+/** 是否有头像URL */
+const hasAvatar = computed(() => {
+  return !!props.conversation?.avatar
+})
+
 /** 头像文字（取姓名前两个字） */
 const avatarText = computed(() => {
   const name = props.conversation?.employee_name || '?'
@@ -578,6 +589,14 @@ defineExpose({ resetForNewConversation })
   flex-shrink: 0;
 }
 
+/* 图片头像 */
+.user-info-bar__avatar-img {
+  width: 36px;
+  height: 36px;
+  border-radius: 50%;
+  object-fit: cover;
+}
+
 /* 姓名组 */
 .user-info-bar__name-group {
   display: flex;

frontend-agent/src/components/conversation/ConversationItem.vue

@@ -20,7 +20,15 @@
   >
     <!-- 头像（含新消息圆点） -->
     <div class="conv-avatar-wrap">
-      <div class="conversation-avatar" :class="avatarColorClass">
+      <!-- 有头像时显示图片 -->
+      <img
+        v-if="hasAvatar"
+        :src="conversation.avatar"
+        class="conversation-avatar-img"
+        @error="(e) => (e.target as HTMLImageElement).style.display = 'none'"
+      />
+      <!-- 无头像时显示文字头像 -->
+      <div v-else class="conversation-avatar" :class="avatarColorClass">
         {{ avatarText }}
       </div>
       <!-- 新消息圆点：有新消息时显示，3色区分优先级 -->
@@ -231,6 +239,11 @@ defineEmits<{
 // 计算属性
 // ============================================================================
 
+/** 是否有头像URL */
+const hasAvatar = computed(() => {
+  return !!props.conversation.avatar
+})
+
 /** 头像文字（取姓名最后一个字） */
 const avatarText = computed(() => {
   const name = props.conversation.employee_name
@@ -432,6 +445,14 @@ function isHighRoleLevel(conv: Conversation): boolean {
   opacity: 0.8;
 }
 
+/* 图片头像样式 */
+.conversation-avatar-img {
+  width: 48px;
+  height: 48px;
+  border-radius: 8px;
+  object-fit: cover;
+}
+
 /* 摘要行（含时间和文本） */
 .conversation-summary-row {
   display: flex;

frontend-agent/src/views/Login.vue

@@ -1,14 +1,7 @@
 <!-- =============================================================================
-// IT智能服务台 — 坐席登录页 (v1.1, 2026-07-04)
+// IT智能服务台 — 坐席登录页 (v1.7, 2026-07-05)
 // =============================================================================
-// 说明: 从扫码登录改为账号密码+OTP表单登录
-//
-// 流程:
-//   1. 用户输入账号 + 密码
-//   2. 点击登录 → 调用后端 /api/agents/login
-//   3. 若 require_otp=true，显示 OTP 输入框
-//   4. 用户输入 OTP 后再次提交
-//   5. 登录成功 → 存 token → 跳 /workspace
+// 说明: 简化版 - 默认显示二维码，可切换账号密码登录
 // ============================================================================= -->
 
 <template>
@@ -17,64 +10,106 @@
       <!-- 标题区 -->
       <div class="login-title">
         <h1>🛠️ IT智能服务台</h1>
-        <p>坐席工作台 · 账号登录</p>
+        <p>坐席工作台</p>
       </div>
 
-      <!-- 登录表单 -->
-      <el-form
-        ref="formRef"
-        :model="loginForm"
-        :rules="rules"
-        label-position="top"
-        @submit.prevent="handleLogin"
-      >
-        <el-form-item label="账号" prop="userId">
-          <el-input
-            v-model="loginForm.userId"
-            placeholder="请输入账号（如 sxn）"
-            size="large"
-            :prefix-icon="User"
-            @keydown.enter="handleLogin"
-          />
-        </el-form-item>
+      <!-- 企微扫码登录（二维码） -->
+      <div v-if="!showPasswordLogin" class="qr-login">
+        <div class="qr-container">
+          <div v-if="qrLoading" class="qr-loading">
+            <el-icon class="is-loading"><Loading /></el-icon>
+            <p>加载中...</p>
+          </div>
+          <div v-else-if="qrCode" class="qr-code">
+            <img :src="qrCode" alt="企微扫码登录" />
+          </div>
+          <div v-else class="qr-error">
+            <p>获取二维码失败</p>
+            <el-button size="small" @click="fetchQrCode">重试</el-button>
+          </div>
+        </div>
+        <p class="qr-hint">请使用企业微信扫码登录</p>
 
-        <el-form-item label="密码" prop="password">
-          <el-input
-            v-model="loginForm.password"
-            type="password"
-            placeholder="请输入密码"
-            size="large"
-            :prefix-icon="Lock"
-            show-password
-            @keydown.enter="handleLogin"
-          />
-        </el-form-item>
+        <!-- 分隔线 -->
+        <div class="divider">
+          <span>其他登录方式</span>
+        </div>
 
-        <!-- OTP 输入区: 仅在 require_otp 时显示 -->
-        <el-form-item v-if="requireOtp" label="OTP 验证码" prop="otpCode">
-          <el-input
-            v-model="loginForm.otpCode"
-            placeholder="请输入 Google Authenticator 验证码"
-            size="large"
-            :prefix-icon="Key"
-            maxlength="6"
-            @keydown.enter="handleLogin"
-          />
-        </el-form-item>
+        <el-button
+          size="large"
+          class="password-login-btn"
+          @click="showPasswordLogin = true"
+        >
+          <span>🔐</span>
+          账号密码+OTP
+        </el-button>
+      </div>
 
-        <el-form-item>
-          <el-button
-            type="primary"
-            size="large"
-            :loading="logging"
-            :disabled="logging"
-            @click="handleLogin"
-            class="login-btn"
-          >
-            {{ logging ? '登录中...' : (requireOtp ? '验证 OTP' : '登录') }}
-          </el-button>
-        </el-form-item>
-      </el-form>
+      <!-- 账号密码+OTP 登录表单 -->
+      <div v-else class="password-login">
+        <el-button
+          size="small"
+          class="back-btn"
+          @click="handleBackToQrCode"
+        >
+          ← 返回扫码登录
+        </el-button>
+
+        <el-form
+          ref="formRef"
+          :model="loginForm"
+          :rules="rules"
+          label-position="top"
+          @submit.prevent="handleLogin"
+        >
+          <el-form-item label="账号" prop="userId">
+            <el-input
+              v-model="loginForm.userId"
+              placeholder="请输入账号（如 sxn）"
+              size="large"
+              :prefix-icon="User"
+              @keydown.enter="handleLogin"
+            />
+          </el-form-item>
+
+          <el-form-item label="密码" prop="password">
+            <el-input
+              v-model="loginForm.password"
+              type="password"
+              placeholder="请输入密码"
+              size="large"
+              :prefix-icon="Lock"
+              show-password
+              @keydown.enter="handleLogin"
+            />
+          </el-form-item>
+
+          <!-- OTP 输入区: 仅在 require_otp 时显示 -->
+          <el-form-item v-if="requireOtp" label="OTP 验证码" prop="otpCode">
+            <el-input
+              v-model="loginForm.otpCode"
+              placeholder="请输入 Google Authenticator 验证码"
+              size="large"
+              :prefix-icon="Key"
+              maxlength="6"
+              @keydown.enter="handleLogin"
+            />
+          </el-form-item>
+
+          <el-form-item>
+            <el-button
+              type="primary"
+              size="large"
+              :loading="logging"
+              :disabled="logging"
+              @click="handleLogin"
+              class="login-btn"
+            >
+              {{ logging ? '登录中...' : (requireOtp ? '验证 OTP' : '账号密码登录') }}
+            </el-button>
+          </el-form-item>
+        </el-form>
+      </div>
 
       <!-- 错误提示 -->
       <el-alert
@@ -96,25 +131,24 @@
 </template>
 
 <script setup lang="ts">
-// ============================================================================
-// 导入
-// ============================================================================
-import { ref, reactive } from 'vue'
+import { ref, reactive, onMounted, onUnmounted } from 'vue'
 import { useRouter } from 'vue-router'
 import { ElMessage } from 'element-plus'
 import type { FormInstance, FormRules } from 'element-plus'
-import { User, Lock, Key } from '@element-plus/icons-vue'
+import { User, Lock, Key, Loading } from '@element-plus/icons-vue'
 import { useAgentStore } from '@/stores/agent'
 
-// ============================================================================
-// 状态
-// ============================================================================
 const router = useRouter()
 const agentStore = useAgentStore()
-
-/** 表单引用 */
 const formRef = ref<FormInstance>()
 
+/** 是否显示账号密码登录 */
+const showPasswordLogin = ref(false)
+
+/** 企微二维码 */
+const qrCode = ref('')
+const qrLoading = ref(false)
+
 /** 登录表单数据 */
 const loginForm = reactive({
   userId: '',
@@ -131,29 +165,122 @@ const logging = ref(false)
 /** 错误信息 */
 const errorMsg = ref<string>('')
 
+/** 轮询定时器 */
+let pollTimer: ReturnType<typeof setInterval> | null = null
+let currentTicket = ''
+
 /** 表单校验规则 */
 const rules: FormRules = {
-  userId: [
-    { required: true, message: '请输入账号', trigger: 'blur' },
-  ],
-  password: [
-    { required: true, message: '请输入密码', trigger: 'blur' },
-  ],
+  userId: [{ required: true, message: '请输入账号', trigger: 'blur' }],
+  password: [{ required: true, message: '请输入密码', trigger: 'blur' }],
   otpCode: [
     { required: true, message: '请输入 OTP 验证码', trigger: 'blur' },
     { len: 6, message: '验证码为 6 位数字', trigger: 'blur' },
   ],
 }
 
-// ============================================================================
-// 方法
-// ============================================================================
+/**
+ * 获取企微登录二维码
+ */
+async function fetchQrCode(): Promise<void> {
+  qrLoading.value = true
+  errorMsg.value = ''
+
+  try {
+    const baseUrl = import.meta.env.VITE_API_BASE_URL || '/api'
+    const response = await fetch(`${baseUrl}/auth_qrcode/create`, {
+      method: 'POST',
+      headers: { 'Accept': 'application/json' },
+    })
+
+    if (!response.ok) {
+      throw new Error(`获取二维码失败: ${response.status}`)
+    }
+
+    const result = await response.json()
+
+    if (result.code === 0 && (result.data?.qrcode_url || result.data?.qrcode_png_base64)) {
+      // qrcode_png_base64 是纯 base64，需要添加 data:image 前缀才能被 img 标签渲染
+      qrCode.value = result.data.qrcode_png_base64 
+        ? `data:image/png;base64,${result.data.qrcode_png_base64}` 
+        : result.data.qrcode_url
+      currentTicket = result.data.ticket
+      startPolling()
+    } else {
+      throw new Error(result.message || '获取二维码失败')
+    }
+  } catch (error) {
+    console.error('获取企微二维码失败:', error)
+    errorMsg.value = error instanceof Error ? error.message : '获取二维码失败'
+  } finally {
+    qrLoading.value = false
+  }
+}
+
+/**
+ * 轮询扫码状态
+ */
+async function pollQrCode(): Promise<void> {
+  if (!currentTicket) return
+
+  try {
+    const baseUrl = import.meta.env.VITE_API_BASE_URL || '/api'
+    const response = await fetch(`${baseUrl}/auth_qrcode/poll/${currentTicket}`, {
+      method: 'GET',
+      headers: { 'Accept': 'application/json' },
+    })
+
+    const result = await response.json()
+
+    if (result.code === 0 && result.data) {
+      const { status, token } = result.data
+
+      if (status === 'confirmed' && token) {
+        stopPolling()
+        localStorage.setItem('agent_token', token)
+        ElMessage.success('登录成功')
+        router.push('/workspace')
+      } else if (status === 'expired') {
+        stopPolling()
+        ElMessage.warning('二维码已过期，请重新获取')
+        fetchQrCode()
+      }
+    }
+  } catch (error) {
+    console.error('轮询扫码状态失败:', error)
+  }
+}
+
+/**
+ * 启动轮询
+ */
+function startPolling(): void {
+  stopPolling()
+  pollTimer = setInterval(pollQrCode, 2000)
+}
+
+/**
+ * 停止轮询
+ */
+function stopPolling(): void {
+  if (pollTimer) {
+    clearInterval(pollTimer)
+    pollTimer = null
+  }
+}
+
+/**
+ * 返回扫码登录
+ */
+function handleBackToQrCode(): void {
+  showPasswordLogin.value = false
+  fetchQrCode()
+}
 
 /**
  * 处理登录
  */
 async function handleLogin(): Promise<void> {
-  // 表单校验
   const valid = await formRef.value?.validate().catch(() => false)
   if (!valid) return
 
@@ -167,7 +294,6 @@ async function handleLogin(): Promise<void> {
       loginForm.otpCode.trim() || undefined
     )
 
-    // 检查是否需要 OTP 验证
     if (result && result.require_otp) {
       requireOtp.value = true
       loginForm.otpCode = ''
@@ -176,20 +302,33 @@ async function handleLogin(): Promise<void> {
       return
     }
 
-    // 登录成功
     ElMessage.success('登录成功')
     router.push('/workspace')
   } catch (error: unknown) {
+    if (error instanceof Error && error.message === 'require_otp') {
+      requireOtp.value = true
+      loginForm.otpCode = ''
+      ElMessage.info('请输入 OTP 验证码')
+      logging.value = false
+      return
+    }
     const errMsg = error instanceof Error ? error.message : '登录失败，请重试'
     errorMsg.value = errMsg
   } finally {
     logging.value = false
   }
 }
+
+onMounted(() => {
+  fetchQrCode()
+})
+
+onUnmounted(() => {
+  stopPolling()
+})
 </script>
 
 <style scoped>
-/* 登录页面容器:全屏居中 */
 .login-page {
   display: flex;
   align-items: center;
@@ -199,7 +338,6 @@ async function handleLogin(): Promise<void> {
   padding: 24px;
 }
 
-/* 登录卡片 */
 .login-card {
   width: 100%;
   max-width: 400px;
@@ -209,7 +347,6 @@ async function handleLogin(): Promise<void> {
   box-shadow: 0 8px 32px rgba(0, 0, 0, 0.15);
 }
 
-/* 标题区 */
 .login-title {
   text-align: center;
   margin-bottom: 32px;
@@ -228,13 +365,81 @@ async function handleLogin(): Promise<void> {
   margin: 0;
 }
 
-/* 登录按钮 */
+.qr-login {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+}
+
+.qr-container {
+  width: 200px;
+  height: 200px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: #f5f5f5;
+  border-radius: 12px;
+  margin-bottom: 12px;
+}
+
+.qr-loading {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 8px;
+  color: #909399;
+}
+
+.qr-code img {
+  width: 180px;
+  height: 180px;
+}
+
+.qr-error {
+  text-align: center;
+  color: #f56c6c;
+}
+
+.qr-hint {
+  font-size: 14px;
+  color: #909399;
+  margin: 0 0 24px 0;
+}
+
+.divider {
+  display: flex;
+  align-items: center;
+  width: 100%;
+  margin: 0 0 24px 0;
+  color: #909399;
+  font-size: 14px;
+}
+
+.divider::before,
+.divider::after {
+  content: '';
+  flex: 1;
+  height: 1px;
+  background: #e4e7ed;
+}
+
+.divider span {
+  padding: 0 16px;
+}
+
+.password-login-btn,
 .login-btn {
   width: 100%;
-  margin-top: 8px;
+}
+
+.password-login {
+  padding-top: 8px;
+}
+
+.back-btn {
+  margin-bottom: 16px;
 }
 
-/* 底部提示 */
 .login-hint {
   text-align: center;
   color: var(--text-placeholder, #c0c4cc);

frontend-agent/upload_deploy.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# 坐席端手动部署 - 在 jumpserver 上执行此脚本
+
+set -e
+
+# 本地文件路径
+LOCAL_FILE="D:\资料\03-项目开发\wecom_it_smart_desk\frontend-agent\agent-v3.tar.b64"
+REMOTE_PATH="/tmp/agent-v3.tar.b64"
+
+echo "上传文件到服务器..."
+# 使用 curl 上传
+# 注意：这个脚本需要在 jumpserver 上有访问本地文件的权限
+
+echo "请手动执行以下步骤："
+echo "1. 打开 jumpserver 文件管理"
+echo "2. 上传 agent-v3.tar.b64 到 /tmp/"
+echo "3. 然后联系部署"