improve desktop issue diagnostics

apps/desktop-client/src/main/adapters/doubao.test.ts

@@ -13,6 +13,7 @@ const {
   isNonCitationAssetDomain,
   isNonCitationAssetUrl,
   hasDoubaoFinishedStreamCapture,
+  deleteDoubaoCurrentConversationInPage,
   parseDoubaoCaptures,
   parseDoubaoStreamBody,
   resolveDoubaoSubmissionAnswer,
@@ -140,6 +141,660 @@ describe('doubao adapter helpers', () => {
     expect(doubaoModeProviderModel('expert')).toBe('doubao-web-fast')
   })
 
+  it('clicks through Doubao current conversation deletion controls', async () => {
+    const previousWindow = globalThis.window
+    const previousDocument = globalThis.document
+    const previousHTMLElement = globalThis.HTMLElement
+    const previousMouseEvent = globalThis.MouseEvent
+    const previousURL = globalThis.URL
+
+    const makeElement = (input: {
+      tagName?: string
+      text?: string
+      attrs?: Record<string, string>
+      rect?: { left: number; top: number; width: number; height: number }
+      visible?: boolean
+      className?: string
+      onClick?: () => void
+      children?: MockElement[]
+    }): MockElement => new MockElement(input)
+
+    class MockMouseEvent {
+      readonly type: string
+      constructor(type: string) {
+        this.type = type
+      }
+    }
+
+    class MockElement {
+      tagName: string
+      innerText: string
+      textContent: string
+      className: string
+      parentElement: MockElement | null = null
+      children: MockElement[] = []
+      tabIndex = -1
+      style = {
+        display: 'block',
+        visibility: 'visible',
+        opacity: '1',
+        cursor: 'default',
+        backgroundColor: 'rgba(0, 0, 0, 0)',
+      }
+
+      private readonly attrs: Map<string, string>
+      private readonly rect: { left: number; top: number; width: number; height: number }
+      private readonly onClick?: () => void
+
+      constructor(input: {
+        tagName?: string
+        text?: string
+        attrs?: Record<string, string>
+        rect?: { left: number; top: number; width: number; height: number }
+        visible?: boolean
+        className?: string
+        onClick?: () => void
+        children?: MockElement[]
+      }) {
+        this.tagName = (input.tagName ?? 'div').toUpperCase()
+        this.innerText = input.text ?? ''
+        this.textContent = input.text ?? ''
+        this.className = input.className ?? ''
+        this.attrs = new Map(Object.entries(input.attrs ?? {}))
+        this.rect = input.rect ?? { left: 0, top: 0, width: 120, height: 32 }
+        this.onClick = input.onClick
+        if (input.visible === false) {
+          this.style.display = 'none'
+        }
+        for (const child of input.children ?? []) {
+          this.appendChild(child)
+        }
+      }
+
+      appendChild(child: MockElement): void {
+        child.parentElement = this
+        this.children.push(child)
+      }
+
+      getAttribute(name: string): string | null {
+        return this.attrs.get(name) ?? null
+      }
+
+      hasAttribute(name: string): boolean {
+        return this.attrs.has(name)
+      }
+
+      querySelector(selector: string): MockElement | null {
+        return this.querySelectorAll(selector)[0] ?? null
+      }
+
+      querySelectorAll(selector: string): MockElement[] {
+        const selectors = selector
+          .split(',')
+          .map((item) => item.trim())
+          .filter(Boolean)
+        const results: MockElement[] = []
+        const visit = (node: MockElement) => {
+          for (const child of node.children) {
+            if (selectors.some((item) => matchesSelector(child, item))) {
+              results.push(child)
+            }
+            visit(child)
+          }
+        }
+        visit(this)
+        return results
+      }
+
+      getBoundingClientRect(): {
+        left: number
+        top: number
+        width: number
+        height: number
+        right: number
+        bottom: number
+      } {
+        let current: MockElement | null = this
+        while (current) {
+          if (current.style.display === 'none' || current.style.visibility === 'hidden') {
+            return {
+              left: 0,
+              top: 0,
+              width: 0,
+              height: 0,
+              right: 0,
+              bottom: 0,
+            }
+          }
+          current = current.parentElement
+        }
+        return {
+          ...this.rect,
+          right: this.rect.left + this.rect.width,
+          bottom: this.rect.top + this.rect.height,
+        }
+      }
+
+      scrollIntoView(): void {}
+
+      dispatchEvent(): boolean {
+        return true
+      }
+
+      click(): void {
+        this.onClick?.()
+      }
+    }
+
+    const matchesSelector = (element: MockElement, selector: string): boolean => {
+      if (selector === '*') {
+        return true
+      }
+      if (/^[a-z]+$/i.test(selector)) {
+        return element.tagName.toLowerCase() === selector.toLowerCase()
+      }
+      const tagMatch = selector.match(/^([a-z]+)(.+)$/i)
+      if (tagMatch) {
+        return (
+          element.tagName.toLowerCase() === tagMatch[1]?.toLowerCase() &&
+          matchesSelector(element, tagMatch[2] ?? '')
+        )
+      }
+      const attrMatch = selector.match(/^\[([^=\]~*^$]+)(?:[*^$]?=['"]?([^'"\]]+)['"]?)?\]$/)
+      if (attrMatch) {
+        const attr = attrMatch[1] ?? ''
+        const expected = attrMatch[2]
+        const value = element.getAttribute(attr)
+        if (expected === undefined) {
+          return value !== null
+        }
+        if (selector.includes('*=')) {
+          return value?.includes(expected) ?? false
+        }
+        return value === expected
+      }
+      return false
+    }
+
+    const documentRoot = makeElement({ rect: { left: 0, top: 0, width: 1280, height: 900 } })
+    const body = makeElement({ rect: { left: 0, top: 0, width: 1280, height: 900 } })
+    documentRoot.appendChild(body)
+
+    let dialog: MockElement | null = null
+    let currentHistory: MockElement | null = null
+    let confirmed = false
+
+    const confirmButton = makeElement({
+      tagName: 'button',
+      text: '删除',
+      attrs: { role: 'button' },
+      rect: { left: 680, top: 478, width: 80, height: 32 },
+      onClick: () => {
+        confirmed = true
+        if (dialog) {
+          body.children = body.children.filter((child) => child !== dialog)
+        }
+        if (currentHistory) {
+          body.children = body.children.filter((child) => child !== currentHistory)
+        }
+      },
+    })
+    dialog = makeElement({
+      tagName: 'div',
+      text: '确定删除对话 删除后不可恢复 取消 删除',
+      attrs: { role: 'dialog', 'aria-modal': 'true' },
+      rect: { left: 440, top: 320, width: 400, height: 220 },
+      visible: false,
+      children: [
+        makeElement({
+          tagName: 'button',
+          text: '取消',
+          attrs: { role: 'button' },
+          rect: { left: 580, top: 478, width: 80, height: 32 },
+        }),
+        confirmButton,
+      ],
+    })
+
+    const deleteItem = makeElement({
+      tagName: 'div',
+      text: '删除',
+      attrs: { role: 'menuitem' },
+      rect: { left: 240, top: 124, width: 96, height: 32 },
+      onClick: () => {
+        dialog!.style.display = 'block'
+      },
+    })
+    const menu = makeElement({
+      tagName: 'div',
+      text: '删除',
+      className: 'dropdown-menu',
+      rect: { left: 228, top: 112, width: 128, height: 48 },
+      visible: false,
+      children: [deleteItem],
+    })
+
+    const moreButton = makeElement({
+      tagName: 'button',
+      text: '...',
+      attrs: { 'aria-label': '更多', role: 'button' },
+      rect: { left: 252, top: 74, width: 28, height: 28 },
+      onClick: () => {
+        menu.style.display = 'block'
+        deleteItem.style.display = 'block'
+      },
+    })
+    currentHistory = makeElement({
+      tagName: 'div',
+      text: '室内门锁供货商',
+      attrs: { 'data-active': 'true' },
+      rect: { left: 16, top: 64, width: 272, height: 48 },
+      className: 'history-item active',
+      children: [
+        makeElement({
+          tagName: 'a',
+          text: '室内门锁供货商',
+          attrs: { href: '/chat/local_4995117315817271' },
+          rect: { left: 24, top: 72, width: 210, height: 28 },
+        }),
+        moreButton,
+      ],
+    })
+
+    body.appendChild(currentHistory)
+    body.appendChild(menu)
+    body.appendChild(dialog)
+
+    const documentMock = {
+      body,
+      querySelectorAll: (selector: string) => body.querySelectorAll(selector),
+      querySelector: (selector: string) => body.querySelector(selector),
+    }
+    const windowMock = {
+      location: {
+        href: 'https://www.doubao.com/chat/local_4995117315817271',
+        origin: 'https://www.doubao.com',
+      },
+      innerWidth: 1280,
+      innerHeight: 900,
+      setTimeout: (callback: () => void) => {
+        callback()
+        return 1
+      },
+      getComputedStyle: (element: MockElement) => element.style,
+    }
+
+    try {
+      const mutableGlobal = globalThis as Record<string, unknown>
+      mutableGlobal.window = windowMock
+      mutableGlobal.document = documentMock
+      mutableGlobal.HTMLElement = MockElement
+      mutableGlobal.MouseEvent = MockMouseEvent
+      mutableGlobal.URL = URL
+
+      const result = await deleteDoubaoCurrentConversationInPage({
+        conversationId: 'local_4995117315817271',
+        pageUrl: 'https://www.doubao.com/chat/local_4995117315817271',
+        title: '豆包',
+      })
+
+      expect(result).toMatchObject({
+        ok: true,
+        conversation_id: 'local_4995117315817271',
+        menu_clicked: true,
+        delete_clicked: true,
+        confirm_clicked: true,
+      })
+      expect(confirmed).toBe(true)
+    } finally {
+      const mutableGlobal = globalThis as Record<string, unknown>
+      mutableGlobal.window = previousWindow
+      mutableGlobal.document = previousDocument
+      mutableGlobal.HTMLElement = previousHTMLElement
+      mutableGlobal.MouseEvent = previousMouseEvent
+      mutableGlobal.URL = previousURL
+    }
+  })
+
+  it('uses the generated Doubao history link when cleanup only has the question text', async () => {
+    const previousWindow = globalThis.window
+    const previousDocument = globalThis.document
+    const previousHTMLElement = globalThis.HTMLElement
+    const previousMouseEvent = globalThis.MouseEvent
+    const previousURL = globalThis.URL
+
+    const makeElement = (input: {
+      tagName?: string
+      text?: string
+      attrs?: Record<string, string>
+      rect?: { left: number; top: number; width: number; height: number }
+      visible?: boolean
+      className?: string
+      onClick?: () => void
+      children?: MockElement[]
+    }): MockElement => new MockElement(input)
+
+    class MockMouseEvent {
+      readonly type: string
+      constructor(type: string) {
+        this.type = type
+      }
+    }
+
+    class MockElement {
+      tagName: string
+      innerText: string
+      textContent: string
+      className: string
+      parentElement: MockElement | null = null
+      children: MockElement[] = []
+      tabIndex = -1
+      style = {
+        display: 'block',
+        visibility: 'visible',
+        opacity: '1',
+        cursor: 'pointer',
+        backgroundColor: 'rgba(0, 0, 0, 0)',
+      }
+
+      private readonly attrs: Map<string, string>
+      private readonly rect: { left: number; top: number; width: number; height: number }
+      private readonly onClick?: () => void
+
+      constructor(input: {
+        tagName?: string
+        text?: string
+        attrs?: Record<string, string>
+        rect?: { left: number; top: number; width: number; height: number }
+        visible?: boolean
+        className?: string
+        onClick?: () => void
+        children?: MockElement[]
+      }) {
+        this.tagName = (input.tagName ?? 'div').toUpperCase()
+        this.innerText = input.text ?? ''
+        this.textContent = input.text ?? ''
+        this.className = input.className ?? ''
+        this.attrs = new Map(Object.entries(input.attrs ?? {}))
+        this.rect = input.rect ?? { left: 0, top: 0, width: 120, height: 32 }
+        this.onClick = input.onClick
+        if (input.visible === false) {
+          this.style.display = 'none'
+        }
+        for (const child of input.children ?? []) {
+          this.appendChild(child)
+        }
+      }
+
+      appendChild(child: MockElement): void {
+        child.parentElement = this
+        this.children.push(child)
+      }
+
+      getAttribute(name: string): string | null {
+        return this.attrs.get(name) ?? null
+      }
+
+      hasAttribute(name: string): boolean {
+        return this.attrs.has(name)
+      }
+
+      querySelector(selector: string): MockElement | null {
+        return this.querySelectorAll(selector)[0] ?? null
+      }
+
+      querySelectorAll(selector: string): MockElement[] {
+        const selectors = selector
+          .split(',')
+          .map((item) => item.trim())
+          .filter(Boolean)
+        const results: MockElement[] = []
+        const visit = (node: MockElement) => {
+          for (const child of node.children) {
+            if (selectors.some((item) => matchesSelector(child, item))) {
+              results.push(child)
+            }
+            visit(child)
+          }
+        }
+        visit(this)
+        return results
+      }
+
+      getBoundingClientRect(): {
+        left: number
+        top: number
+        width: number
+        height: number
+        right: number
+        bottom: number
+      } {
+        let current: MockElement | null = this
+        while (current) {
+          if (current.style.display === 'none' || current.style.visibility === 'hidden') {
+            return {
+              left: 0,
+              top: 0,
+              width: 0,
+              height: 0,
+              right: 0,
+              bottom: 0,
+            }
+          }
+          current = current.parentElement
+        }
+        return {
+          ...this.rect,
+          right: this.rect.left + this.rect.width,
+          bottom: this.rect.top + this.rect.height,
+        }
+      }
+
+      scrollIntoView(): void {}
+
+      focus(): void {}
+
+      dispatchEvent(): boolean {
+        return true
+      }
+
+      click(): void {
+        this.onClick?.()
+      }
+    }
+
+    const matchesSelector = (element: MockElement, selector: string): boolean => {
+      if (selector === '*') {
+        return true
+      }
+      if (selector.includes(' ')) {
+        const parts = selector.split(/\s+/).filter(Boolean)
+        const last = parts.at(-1)
+        return last ? matchesSelector(element, last) : false
+      }
+      if (/^[a-z]+$/i.test(selector)) {
+        return element.tagName.toLowerCase() === selector.toLowerCase()
+      }
+      const tagMatch = selector.match(/^([a-z]+)(.+)$/i)
+      if (tagMatch) {
+        return (
+          element.tagName.toLowerCase() === tagMatch[1]?.toLowerCase() &&
+          matchesSelector(element, tagMatch[2] ?? '')
+        )
+      }
+      const attrMatch = selector.match(/^\[([^=\]~*^$]+)([*^$]?=)?['"]?([^'"\]]*)['"]?\]$/)
+      if (attrMatch) {
+        const attr = attrMatch[1] ?? ''
+        const operator = attrMatch[2]
+        const expected = attrMatch[3] ?? ''
+        const value = element.getAttribute(attr)
+        if (!operator) {
+          return value !== null
+        }
+        if (operator === '*=') {
+          return value?.includes(expected) ?? false
+        }
+        if (operator === '^=') {
+          return value?.startsWith(expected) ?? false
+        }
+        return value === expected
+      }
+      return false
+    }
+
+    const documentRoot = makeElement({ rect: { left: 0, top: 0, width: 1280, height: 900 } })
+    const body = makeElement({ rect: { left: 0, top: 0, width: 1280, height: 900 } })
+    documentRoot.appendChild(body)
+
+    let dialog: MockElement | null = null
+    let currentHistory: MockElement | null = null
+    let nextHistory: MockElement | null = null
+
+    const confirmButton = makeElement({
+      tagName: 'button',
+      text: '删除',
+      attrs: { role: 'button' },
+      rect: { left: 680, top: 478, width: 80, height: 32 },
+      onClick: () => {
+        if (dialog) {
+          body.children = body.children.filter((child) => child !== dialog)
+        }
+        if (currentHistory) {
+          body.children = body.children.filter((child) => child !== currentHistory)
+        }
+      },
+    })
+    dialog = makeElement({
+      tagName: 'div',
+      text: '确定删除对话 删除后不可恢复 取消 删除',
+      attrs: { role: 'dialog', 'aria-modal': 'true' },
+      rect: { left: 440, top: 320, width: 400, height: 220 },
+      visible: false,
+      children: [
+        makeElement({
+          tagName: 'button',
+          text: '取消',
+          attrs: { role: 'button' },
+          rect: { left: 580, top: 478, width: 80, height: 32 },
+        }),
+        confirmButton,
+      ],
+    })
+
+    const deleteItem = makeElement({
+      tagName: 'div',
+      text: '删除',
+      attrs: { role: 'menuitem' },
+      rect: { left: 240, top: 124, width: 96, height: 32 },
+      visible: false,
+      onClick: () => {
+        dialog!.style.display = 'block'
+      },
+    })
+    const menu = makeElement({
+      tagName: 'div',
+      text: '删除',
+      attrs: { role: 'menu' },
+      className: 'dropdown-menu',
+      rect: { left: 228, top: 112, width: 128, height: 48 },
+      children: [deleteItem],
+    })
+
+    const moreButton = makeElement({
+      tagName: 'button',
+      text: '',
+      attrs: { role: 'button' },
+      rect: { left: 252, top: 74, width: 28, height: 28 },
+      onClick: () => {
+        menu.style.display = 'block'
+        deleteItem.style.display = 'block'
+      },
+    })
+    currentHistory = makeElement({
+      tagName: 'a',
+      text: '合肥全屋定制服务商选择指南',
+      attrs: { href: '/chat/38432306062349826', id: 'conversation_38432306062349826' },
+      rect: { left: 16, top: 64, width: 272, height: 48 },
+      className: 'chat-item',
+      children: [
+        makeElement({
+          tagName: 'span',
+          text: '合肥全屋定制服务商选择指南',
+          rect: { left: 24, top: 72, width: 210, height: 28 },
+        }),
+        makeElement({
+          tagName: 'div',
+          className: 'chat-item-menu-wrapper-DPvhf1',
+          rect: { left: 248, top: 72, width: 32, height: 28 },
+          children: [moreButton],
+        }),
+      ],
+    })
+    nextHistory = makeElement({
+      tagName: 'a',
+      text: '合肥全屋定制公司推荐',
+      attrs: { href: '/chat/38432306010828802', id: 'conversation_38432306010828802' },
+      rect: { left: 16, top: 116, width: 272, height: 48 },
+      className: 'chat-item',
+    })
+
+    body.appendChild(currentHistory)
+    body.appendChild(nextHistory)
+    body.appendChild(menu)
+    body.appendChild(dialog)
+
+    const documentMock = {
+      body,
+      querySelectorAll: (selector: string) => body.querySelectorAll(selector),
+      querySelector: (selector: string) => body.querySelector(selector),
+    }
+    const windowMock = {
+      location: {
+        href: 'https://www.doubao.com/chat/',
+        origin: 'https://www.doubao.com',
+      },
+      innerWidth: 1280,
+      innerHeight: 900,
+      setTimeout: (callback: () => void) => {
+        callback()
+        return 1
+      },
+      getComputedStyle: (element: MockElement) => element.style,
+    }
+
+    try {
+      const mutableGlobal = globalThis as Record<string, unknown>
+      mutableGlobal.window = windowMock
+      mutableGlobal.document = documentMock
+      mutableGlobal.HTMLElement = MockElement
+      mutableGlobal.MouseEvent = MockMouseEvent
+      mutableGlobal.URL = URL
+
+      const result = await deleteDoubaoCurrentConversationInPage({
+        conversationId: null,
+        pageUrl: 'https://www.doubao.com/chat/',
+        title: '合肥全屋定制服务商怎么选',
+      })
+
+      expect(result).toMatchObject({
+        ok: true,
+        conversation_id: '38432306062349826',
+        menu_clicked: true,
+        delete_clicked: true,
+        confirm_clicked: true,
+      })
+      expect(body.children.includes(currentHistory)).toBe(false)
+      expect(body.children.includes(nextHistory)).toBe(true)
+    } finally {
+      const mutableGlobal = globalThis as Record<string, unknown>
+      mutableGlobal.window = previousWindow
+      mutableGlobal.document = previousDocument
+      mutableGlobal.HTMLElement = previousHTMLElement
+      mutableGlobal.MouseEvent = previousMouseEvent
+      mutableGlobal.URL = previousURL
+    }
+  })
+
   it('filters byteimg and bytednsdoc asset CDN links from source items', () => {
     expect(isNonCitationAssetDomain('p3-spider-image-sign.byteimg.com')).toBe(true)
     expect(isNonCitationAssetDomain('lf3-static.bytednsdoc.com')).toBe(true)

apps/desktop-client/src/renderer/types.ts

@@ -62,6 +62,10 @@ export interface RuntimeTask {
   startedAt: number | null
   updatedAt: number
   summary: string
+  payload: Record<string, unknown>
+  error: Record<string, unknown> | null
+  result: Record<string, unknown> | null
+  attemptId: string | null
 }
 
 export interface RuntimeActivity {

apps/desktop-client/src/renderer/views/HomeView.vue

@@ -38,56 +38,206 @@ function translateTaskStatus(status: string) {
   return map[status?.toLowerCase()] || status
 }
 
-function formatIssueDetail(issue: RuntimeIssueItem) {
-  if (issue.detail) {
-    return issue.detail
-  }
-  return issue.kind === 'task' ? '任务执行结果需要人工确认。' : '账号授权状态需要重新处理。'
-}
-
 type RuntimeIssueItem = {
   id: string
   kind: 'task' | 'account'
   title: string
-  meta: string
-  detail: string
+  location: string
+  reason: string
+  action: string
   badgeLabel: string
   badgeTone: 'danger' | 'warn'
   at: number
 }
 
+type IssueAccount = {
+  id: string
+  platform: string
+  displayName: string
+  platformUid: string
+  health: 'live' | 'expired' | 'captcha' | 'risk'
+  authState: string
+  authReason: string | null
+  lastSyncAt: number
+  lastVerifiedAt: number | null
+}
+
 const DOUBAO_CHALLENGE_DETAIL =
   '豆包账号触发人机验证，请在桌面客户端打开豆包完成验证码后再继续采集。'
+const DOUBAO_CHALLENGE_ACTION = '打开豆包完成验证码或安全验证，然后刷新账号状态并重试采集。'
 const DOUBAO_CHALLENGE_PATTERN =
   /doubao_challenge_required|challenge_required|captcha_gate|risk_control|人机验证|人工验证|验证码|风控|安全验证/i
+const GENERIC_FAILURE_PATTERN =
+  /^(?:任务执行失败。?|执行失败。?|桌面任务执行失败。?|监控任务执行失败。?|发布任务执行失败。?|unknown_error)$/i
 
 function isDoubaoPlatform(platform: string) {
   return platform.toLowerCase() === 'doubao'
 }
 
-function doubaoTaskChallengeKey(task: RuntimeTask) {
-  return `${task.platform.toLowerCase()}::${task.accountId || task.accountName || 'unknown'}`
+function isDoubaoChallengeAccount(account: { platform: string; authState: string }) {
+  return isDoubaoPlatform(account.platform) && account.authState === 'challenge_required'
 }
 
-function doubaoAccountChallengeKey(account: {
-  platform: string
-  id: string
-  displayName: string
-  platformUid: string
-}) {
-  return `${account.platform.toLowerCase()}::${account.id || account.displayName || account.platformUid || 'unknown'}`
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+function normalizeDisplayText(value: unknown): string | null {
+  if (typeof value !== 'string') {
+    return null
+  }
+  const text = value.trim().replace(/\s+/g, ' ')
+  return text ? text : null
+}
+
+function collectDiagnosticText(value: unknown, depth = 0): string[] {
+  if (depth > 4 || value == null) {
+    return []
+  }
+  if (typeof value === 'string') {
+    const text = normalizeDisplayText(value)
+    return text ? [text] : []
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
+    return [String(value)]
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => collectDiagnosticText(item, depth + 1))
+  }
+  if (!isRecord(value)) {
+    return []
+  }
+
+  const priorityKeys = [
+    'summary',
+    'message',
+    'detail',
+    'code',
+    'auth_reason',
+    'failure_category',
+    'page_error',
+    'runtime_error',
+    'error',
+  ]
+  const priorityText = priorityKeys.flatMap((key) => collectDiagnosticText(value[key], depth + 1))
+  const restText = Object.entries(value)
+    .filter(([key]) => !priorityKeys.includes(key))
+    .flatMap(([, item]) => collectDiagnosticText(item, depth + 1))
+  return [...priorityText, ...restText]
+}
+
+function taskDiagnosticText(task: RuntimeTask) {
+  return [
+    task.title,
+    task.summary,
+    ...collectDiagnosticText(task.error),
+    ...collectDiagnosticText(task.result),
+  ]
+    .filter(Boolean)
+    .join(' ')
 }
 
 function isDoubaoChallengeTask(task: RuntimeTask) {
-  if (!isDoubaoPlatform(task.platform)) {
-    return false
-  }
-
-  return DOUBAO_CHALLENGE_PATTERN.test(`${task.summary || ''} ${task.title || ''}`)
+  return isDoubaoPlatform(task.platform) && DOUBAO_CHALLENGE_PATTERN.test(taskDiagnosticText(task))
 }
 
-function isDoubaoChallengeAccount(account: { platform: string; authState: string }) {
-  return isDoubaoPlatform(account.platform) && account.authState === 'challenge_required'
+function cleanDiagnosticText(text: string | null | undefined): string | null {
+  const normalized = normalizeDisplayText(text)
+  if (!normalized || GENERIC_FAILURE_PATTERN.test(normalized)) {
+    return null
+  }
+  return normalized.length > 180 ? `${normalized.slice(0, 180)}...` : normalized
+}
+
+function firstUsefulDiagnostic(task: RuntimeTask): string | null {
+  const candidates = [
+    task.summary,
+    ...collectDiagnosticText(task.error),
+    ...collectDiagnosticText(task.result),
+  ]
+  for (const candidate of candidates) {
+    const cleaned = cleanDiagnosticText(candidate)
+    if (cleaned) {
+      return cleaned
+    }
+  }
+  return null
+}
+
+function taskIssueReason(task: RuntimeTask): string {
+  const diagnosticText = taskDiagnosticText(task)
+  if (isDoubaoPlatform(task.platform) && DOUBAO_CHALLENGE_PATTERN.test(diagnosticText)) {
+    return DOUBAO_CHALLENGE_DETAIL
+  }
+  if (/login_required|login_expired|not_logged_in|登录态|未登录|重新授权/i.test(diagnosticText)) {
+    return `${translatePlatform(task.platform)}账号登录态不可用，任务无法继续执行。`
+  }
+  if (/captcha|challenge|验证码|人机验证|安全验证|风控/i.test(diagnosticText)) {
+    return `${translatePlatform(task.platform)}账号触发平台验证或风控。`
+  }
+  return firstUsefulDiagnostic(task) ?? '任务失败原因暂未返回详细信息，请结合右侧最近事件排查。'
+}
+
+function taskIssueAction(task: RuntimeTask): string {
+  const diagnosticText = taskDiagnosticText(task)
+  if (isDoubaoPlatform(task.platform) && DOUBAO_CHALLENGE_PATTERN.test(diagnosticText)) {
+    return DOUBAO_CHALLENGE_ACTION
+  }
+  if (/login_required|login_expired|not_logged_in|登录态|未登录|重新授权/i.test(diagnosticText)) {
+    return '重新授权该账号后再重试任务。'
+  }
+  if (/captcha|challenge|验证码|人机验证|安全验证|风控/i.test(diagnosticText)) {
+    return '打开对应平台完成验证，再刷新账号状态。'
+  }
+  return task.status === 'unknown'
+    ? '等待后续补采，或打开任务详情查看原始错误。'
+    : '查看右侧最近事件；如已处理外部问题，可重新触发任务。'
+}
+
+function taskIssueLocation(task: RuntimeTask): string {
+  const parts = [
+    task.kind === 'monitor' ? '监控任务' : '发布任务',
+    translatePlatform(task.platform),
+    task.accountName ? `账号 ${task.accountName}` : '',
+    task.title || task.jobId,
+  ].filter(Boolean)
+  return parts.join(' · ')
+}
+
+function accountIssueReason(account: IssueAccount): string {
+  if (isDoubaoChallengeAccount(account)) {
+    return DOUBAO_CHALLENGE_DETAIL
+  }
+  if (account.authReason === 'risk_control') {
+    return '平台触发风控，需要人工验证后恢复任务执行。'
+  }
+  if (account.authState === 'expired') {
+    return '账号登录态已过期。'
+  }
+  if (account.authState === 'revoked') {
+    return '账号授权已被停用或撤销。'
+  }
+  return '授权状态不可用，需要重新登录或确认账号状态。'
+}
+
+function accountIssueAction(account: IssueAccount): string {
+  if (isDoubaoChallengeAccount(account)) {
+    return DOUBAO_CHALLENGE_ACTION
+  }
+  if (account.authReason === 'risk_control' || account.authState === 'challenge_required') {
+    return '打开对应平台完成验证，再刷新账号状态。'
+  }
+  return '重新授权账号后再继续执行任务。'
+}
+
+function uniqueNonEmpty(values: Array<string | null | undefined>): string[] {
+  return Array.from(
+    new Set(
+      values
+        .map((value) => normalizeDisplayText(value))
+        .filter((value): value is string => value !== null),
+    ),
+  )
 }
 
 function translateEventTitle(title: string) {
@@ -151,97 +301,87 @@ const blockedTasks = computed(() =>
   tasks.value.filter((item) => ['failed', 'unknown'].includes(item.status)),
 )
 const issueItems = computed<RuntimeIssueItem[]>(() => {
-  const doubaoChallengeTaskGroups = new Map<string, RuntimeTask[]>()
-
-  for (const task of blockedTasks.value) {
-    if (!isDoubaoChallengeTask(task)) {
-      continue
-    }
-
-    const key = doubaoTaskChallengeKey(task)
-    const group = doubaoChallengeTaskGroups.get(key)
-    if (group) {
-      group.push(task)
-    } else {
-      doubaoChallengeTaskGroups.set(key, [task])
-    }
-  }
-
-  const doubaoChallengeAccountKeys = new Set(
-    blockedAccounts.value
-      .filter(isDoubaoChallengeAccount)
-      .map((account) => doubaoAccountChallengeKey(account)),
-  )
-  const doubaoChallengeKeys = new Set([
-    ...doubaoChallengeTaskGroups.keys(),
-    ...doubaoChallengeAccountKeys,
-  ])
-
-  const taskIssues = blockedTasks.value
-    .filter(
-      (task) =>
-        !isDoubaoPlatform(task.platform) || !doubaoChallengeKeys.has(doubaoTaskChallengeKey(task)),
-    )
-    .map((task) => ({
-      id: `task-${task.id}`,
-      kind: 'task' as const,
-      title: task.title || task.jobId,
-      meta: `${task.accountName} · ${translatePlatform(task.platform)}`,
-      detail: task.summary,
-      badgeLabel: translateTaskStatus(task.status),
-      badgeTone: 'danger' as const,
-      at: task.updatedAt,
-    }))
-
-  const doubaoChallengeTaskIssues = Array.from(doubaoChallengeTaskGroups.entries())
-    .filter(([key]) => !doubaoChallengeAccountKeys.has(key))
-    .map(([key, challengeTasks]) => {
-      const mergedTasks = blockedTasks.value.filter(
-        (task) => isDoubaoPlatform(task.platform) && doubaoTaskChallengeKey(task) === key,
-      )
-      const representative = mergedTasks.reduce(
-        (latest, task) => (task.updatedAt > latest.updatedAt ? task : latest),
-        challengeTasks[0],
-      )
-      const metaParts = [
-        `${representative.accountName || '豆包账号'} · ${translatePlatform(representative.platform)}`,
-        mergedTasks.length > 1 ? `已合并 ${mergedTasks.length} 个失败任务` : '',
-      ].filter(Boolean)
+  const doubaoChallengeTasks = blockedTasks.value.filter(isDoubaoChallengeTask)
+  const doubaoChallengeAccounts = blockedAccounts.value.filter(isDoubaoChallengeAccount)
+  const hasDoubaoChallenge =
+    doubaoChallengeTasks.length > 0 || doubaoChallengeAccounts.length > 0
 
+  const taskIssues: RuntimeIssueItem[] = blockedTasks.value
+    .filter((task) => !isDoubaoChallengeTask(task))
+    .map((task): RuntimeIssueItem => {
       return {
-        id: `task-doubao-challenge-${key}`,
-        kind: 'task' as const,
-        title: '豆包需要人工验证',
-        meta: metaParts.join(' · '),
-        detail: DOUBAO_CHALLENGE_DETAIL,
-        badgeLabel: '执行失败',
-        badgeTone: 'danger' as const,
-        at: Math.max(...mergedTasks.map((task) => task.updatedAt)),
+        id: `task-${task.id}`,
+        kind: 'task',
+        title:
+          task.status === 'unknown'
+            ? `${translatePlatform(task.platform)}结果待确认`
+            : `${translatePlatform(task.platform)}任务失败`,
+        location: taskIssueLocation(task),
+        reason: taskIssueReason(task),
+        action: taskIssueAction(task),
+        badgeLabel: translateTaskStatus(task.status),
+        badgeTone: 'danger',
+        at: task.updatedAt,
       }
     })
 
-  const accountIssues = blockedAccounts.value.map((account) => {
-    const doubaoChallenge = isDoubaoChallengeAccount(account)
+  const doubaoChallengeIssue: RuntimeIssueItem[] = hasDoubaoChallenge
+    ? [
+        {
+          id: 'doubao-challenge',
+          kind: 'account' as const,
+          title: '豆包需要人工验证',
+          location: uniqueNonEmpty([
+            ...doubaoChallengeAccounts.map(
+              (account) =>
+                `${account.displayName || '豆包账号'} · ${translatePlatform(account.platform)}`,
+            ),
+            ...doubaoChallengeTasks.map(
+              (task) => `${task.accountName || '豆包账号'} · ${task.title || task.jobId}`,
+            ),
+          ])
+            .slice(0, 2)
+            .join('；'),
+          reason: DOUBAO_CHALLENGE_DETAIL,
+          action: [
+            DOUBAO_CHALLENGE_ACTION,
+            doubaoChallengeTasks.length > 1
+              ? `已合并 ${doubaoChallengeTasks.length} 个豆包失败任务。`
+              : '',
+          ]
+            .filter(Boolean)
+            .join(' '),
+          badgeLabel: '需要处理',
+          badgeTone: 'danger' as const,
+          at: Math.max(
+            ...[
+              ...doubaoChallengeTasks.map((task) => task.updatedAt),
+              ...doubaoChallengeAccounts.map(
+                (account) => account.lastVerifiedAt ?? account.lastSyncAt,
+              ),
+            ],
+          ),
+        },
+      ]
+    : []
 
-    return {
-      id: `account-${account.id}`,
-      kind: 'account' as const,
-      title: doubaoChallenge ? '豆包需要人工验证' : account.displayName,
-      meta: doubaoChallenge
-        ? `${account.displayName || '豆包账号'} · ${translatePlatform(account.platform)}`
-        : `${translatePlatform(account.platform)} · ${formatUid(account.platformUid)}`,
-      detail: doubaoChallenge
-        ? DOUBAO_CHALLENGE_DETAIL
-        : account.authReason === 'risk_control'
-          ? '平台触发风控，需要人工验证后恢复任务执行。'
-          : '授权状态不可用，需要重新登录或确认账号状态。',
-      badgeLabel: doubaoChallenge ? '执行失败' : blockedAccountLabel(account),
-      badgeTone: healthTone(account.health) === 'warn' ? ('warn' as const) : ('danger' as const),
-      at: account.lastVerifiedAt ?? account.lastSyncAt,
-    }
-  })
+  const accountIssues: RuntimeIssueItem[] = blockedAccounts.value
+    .filter((account) => !isDoubaoChallengeAccount(account))
+    .map((account): RuntimeIssueItem => {
+      return {
+        id: `account-${account.id}`,
+        kind: 'account',
+        title: `${translatePlatform(account.platform)}账号不可用`,
+        location: `${account.displayName || '未命名账号'} · ${formatUid(account.platformUid)}`,
+        reason: accountIssueReason(account),
+        action: accountIssueAction(account),
+        badgeLabel: blockedAccountLabel(account),
+        badgeTone: healthTone(account.health) === 'warn' ? 'warn' : 'danger',
+        at: account.lastVerifiedAt ?? account.lastSyncAt,
+      }
+    })
 
-  return [...taskIssues, ...doubaoChallengeTaskIssues, ...accountIssues].sort(
+  return [...doubaoChallengeIssue, ...taskIssues, ...accountIssues].sort(
     (left, right) => right.at - left.at,
   )
 })
@@ -320,21 +460,35 @@ const issueBreakdown = computed(() => {
         </div>
         <div v-if="issueItems.length > 0" class="info-list">
           <div v-for="issue in issueItems" :key="issue.id" class="info-row record-row issue-row">
-            <div class="info-stack">
-              <div class="issue-title-line">
-                <span :class="['issue-kind', issue.kind]">
-                  {{ issue.kind === 'task' ? '任务' : '账号' }}
-                </span>
-                <span class="title">{{ issue.title }}</span>
+            <div class="issue-main">
+              <div class="issue-head">
+                <div class="issue-title-line">
+                  <span :class="['issue-kind', issue.kind]">
+                    {{ issue.kind === 'task' ? '任务' : '账号' }}
+                  </span>
+                  <span class="title">{{ issue.title }}</span>
+                </div>
+                <div class="issue-status">
+                  <StatusBadge :tone="issue.badgeTone" :label="issue.badgeLabel" />
+                  <span class="subtitle">
+                    {{ formatRelativeTime(issue.at) }}
+                  </span>
+                </div>
               </div>
-              <span class="subtitle">{{ issue.meta }}</span>
-              <p class="issue-detail">{{ formatIssueDetail(issue) }}</p>
-            </div>
-            <div class="info-stack" style="align-items: flex-end">
-              <StatusBadge :tone="issue.badgeTone" :label="issue.badgeLabel" />
-              <span class="subtitle" style="margin-top: 6px">
-                {{ formatRelativeTime(issue.at) }}
-              </span>
+              <dl class="issue-diagnostics">
+                <div>
+                  <dt>位置</dt>
+                  <dd>{{ issue.location || '当前任务' }}</dd>
+                </div>
+                <div>
+                  <dt>原因</dt>
+                  <dd>{{ issue.reason }}</dd>
+                </div>
+                <div>
+                  <dt>处理</dt>
+                  <dd>{{ issue.action }}</dd>
+                </div>
+              </dl>
             </div>
           </div>
         </div>
@@ -353,7 +507,7 @@ const issueBreakdown = computed(() => {
         <div v-if="activity.length > 0" class="timeline-list">
           <div v-for="entry in activity" :key="entry.id" class="timeline-item record-row">
             <div class="timeline-head">
-              <div style="display: flex; align-items: center; gap: 10px">
+              <div class="timeline-title">
                 <span :class="['feed-dot', entry.severity]"></span>
                 <span class="title">{{ translateEventTitle(entry.title) }}</span>
               </div>
@@ -547,34 +701,43 @@ const issueBreakdown = computed(() => {
 
 .info-row {
   display: flex;
-  justify-content: space-between;
-  align-items: center;
+  align-items: stretch;
 }
 
 .issue-row {
-  align-items: flex-start;
-  gap: 18px;
+  padding: 18px 20px;
 }
 
-.issue-row > .info-stack:first-child {
+.issue-main {
   min-width: 0;
-  flex: 1;
+  width: 100%;
 }
 
-.issue-row > .info-stack:last-child {
-  flex-shrink: 0;
+.issue-head {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  align-items: start;
+  gap: 12px;
 }
 
 .issue-title-line {
   display: flex;
-  align-items: center;
+  align-items: flex-start;
   gap: 8px;
   min-width: 0;
 }
 
 .issue-title-line .title {
-  overflow: hidden;
-  text-overflow: ellipsis;
+  min-width: 0;
+  line-height: 1.45;
+  overflow-wrap: anywhere;
+}
+
+.issue-status {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
   white-space: nowrap;
 }
 
@@ -601,11 +764,32 @@ const issueBreakdown = computed(() => {
   background: #fef3c7;
 }
 
-.issue-detail {
-  margin: 6px 0 0;
+.issue-diagnostics {
+  display: grid;
+  gap: 8px;
+  margin: 12px 0 0;
+}
+
+.issue-diagnostics div {
+  display: grid;
+  grid-template-columns: 42px minmax(0, 1fr);
+  gap: 10px;
+}
+
+.issue-diagnostics dt {
+  color: #64748b;
+  font-size: 12px;
+  font-weight: 800;
+  line-height: 1.6;
+}
+
+.issue-diagnostics dd {
+  min-width: 0;
+  margin: 0;
   color: #475569;
   font-size: 13px;
   line-height: 1.55;
+  overflow-wrap: anywhere;
 }
 
 .timeline-item {
@@ -617,7 +801,20 @@ const issueBreakdown = computed(() => {
 .timeline-head {
   display: flex;
   justify-content: space-between;
-  align-items: center;
+  align-items: flex-start;
+  gap: 12px;
+}
+
+.timeline-title {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  min-width: 0;
+}
+
+.timeline-title .title {
+  line-height: 1.45;
+  overflow-wrap: anywhere;
 }
 
 .timeline-body p {
@@ -647,13 +844,6 @@ const issueBreakdown = computed(() => {
   background-color: #0ea5e9;
 }
 
-/* Base Typo */
-.info-stack {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-}
-
 .title {
   color: #0f172a;
   font-size: 14px;
@@ -689,12 +879,19 @@ const issueBreakdown = computed(() => {
 }
 
 @media (max-width: 720px) {
-  .issue-row {
-    flex-direction: column;
+  .issue-head,
+  .timeline-head {
+    grid-template-columns: 1fr;
+    display: grid;
   }
 
-  .issue-row > .info-stack:last-child {
-    align-items: flex-start !important;
+  .issue-status {
+    justify-content: flex-start;
+  }
+
+  .issue-diagnostics div {
+    grid-template-columns: 1fr;
+    gap: 2px;
   }
 }
 </style>

server/internal/shared/swagger/descriptions.go

@@ -103,9 +103,12 @@ var routeDocs = map[string]routeDoc{
 	"POST /api/ops/desktop-client/releases/upload":                                {"上传桌面客户端包（兼容）", "兼容旧版单请求 Multipart 上传。"},
 	"POST /api/ops/desktop-client/releases/direct-upload":                         {"初始化客户端包 OSS 直传", "校验文件信息并生成浏览器直传 OSS 的短期 PUT 签名 URL。"},
 	"POST /api/ops/desktop-client/releases/direct-upload/complete":                {"完成客户端包 OSS 直传", "校验直传对象是否存在、大小是否匹配，并返回 Object Key、文件大小和 SHA256。"},
+	"POST /api/ops/desktop-client/releases/direct-upload/complete-jobs":           {"创建 OSS 直传完成任务", "异步校验 OSS 直传对象并生成客户端版本上传完成任务。"},
+	"GET /api/ops/desktop-client/release-upload-complete-jobs/:job_id":            {"查询客户端上传完成任务", "查询桌面客户端安装包上传完成任务的阶段、进度和失败原因。"},
 	"POST /api/ops/desktop-client/release-uploads":                                {"初始化客户端包分片上传", "创建分片上传会话，返回 upload_id、分片大小和分片数量。"},
 	"POST /api/ops/desktop-client/release-uploads/:upload_id/chunks/:chunk_index": {"上传客户端包分片", "Multipart 上传单个客户端安装包或更新包分片。"},
 	"POST /api/ops/desktop-client/release-uploads/:upload_id/complete":            {"完成客户端包分片上传", "校验全部分片，流式写入 OSS，并返回 Object Key、文件大小和 SHA256。"},
+	"POST /api/ops/desktop-client/release-uploads/:upload_id/complete-jobs":       {"创建分片上传完成任务", "异步合并并校验分片上传会话，生成客户端版本上传完成任务。"},
 	"DELETE /api/ops/desktop-client/release-uploads/:upload_id":                   {"取消客户端包分片上传", "取消分片上传会话并清理临时分片。"},
 	"POST /api/ops/desktop-client/releases":                                       {"新建客户端版本", "创建桌面客户端版本配置。"},
 	"PATCH /api/ops/desktop-client/releases/:id":                                  {"更新客户端版本", "更新桌面客户端版本配置。"},