From 99d306fa96d590589ec6de0d03156b656c77c2ae Mon Sep 17 00:00:00 2001
From: InfinityPacer <160988576+InfinityPacer@users.noreply.github.com>
Date: Tue, 25 Aug 2026 12:11:02 +0800
Subject: [PATCH] fix(agent): identify assistant input controls (#715)

---
 src/components/agent/AgentAssistantPanel.vue     |  9 +++++++++
 .../agent/__tests__/AgentAssistantPanel.spec.ts  | 16 ++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/src/components/agent/AgentAssistantPanel.vue b/src/components/agent/AgentAssistantPanel.vue
index a9f6fbb0..c61af65c 100644
--- a/src/components/agent/AgentAssistantPanel.vue
+++ b/src/components/agent/AgentAssistantPanel.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { useDisplay } from 'vuetify'
 import { useI18n } from 'vue-i18n'
+import { useId } from 'vue'
 import api, { isApiResponse } from '@/api'
 import { useAuthStore, useUserStore } from '@/stores'
 import { getCurrentLocale } from '@/plugins/i18n'
@@ -343,6 +344,9 @@ const drawerStyle = computed(() => ({
   '--agent-assistant-panel-width': drawerWidth.value,
   zIndex: AGENT_ASSISTANT_LAYER_Z_INDEX.panel,
 }))
+const inputGroupId = useId()
+const fileInputId = `agent-assistant-file-input-${inputGroupId}`
+const messageInputId = `agent-assistant-message-input-${inputGroupId}`
 
 // 创建前端展示用的临时 ID。
 function createId(prefix: string) {
@@ -2765,9 +2769,11 @@ onScopeDispose(() => {
         <div class="agent-assistant-input">
           <input
             ref="fileInputRef"
+            :id="fileInputId"
             class="agent-assistant-file-input"
             type="file"
             multiple
+            name="attachments"
             :disabled="isBusy"
             @change="handleFileSelection"
           />
@@ -2776,14 +2782,17 @@ onScopeDispose(() => {
             :disabled="isBusy || recording"
             :title="t('agentAssistant.attachFile')"
             :aria-label="t('agentAssistant.attachFile')"
+            :aria-controls="fileInputId"
             @click="openFilePicker"
           >
             <VIcon icon="mdi-plus" />
           </IconBtn>
           <textarea
             ref="inputRef"
+            :id="messageInputId"
             v-model="inputText"
             class="agent-assistant-textarea"
+            name="message"
             rows="1"
             :disabled="isBusy || recording"
             :placeholder="inputPlaceholder"
diff --git a/src/components/agent/__tests__/AgentAssistantPanel.spec.ts b/src/components/agent/__tests__/AgentAssistantPanel.spec.ts
index 35eb8cb8..26ff4074 100644
--- a/src/components/agent/__tests__/AgentAssistantPanel.spec.ts
+++ b/src/components/agent/__tests__/AgentAssistantPanel.spec.ts
@@ -207,6 +207,22 @@ describe('AgentAssistantPanel stream recovery', () => {
     vi.useRealTimers()
   })
 
+  it('exposes unique semantic controls for file attachments and messages', () => {
+    const wrapper = mountPanel()
+    const fileInput = wrapper.get('input[type="file"]')
+    const messageInput = wrapper.get('textarea')
+    const attachButton = wrapper.get('.agent-assistant-attach')
+
+    expect(fileInput.attributes('id')).toMatch(/^agent-assistant-file-input-/)
+    expect(fileInput.attributes('name')).toBe('attachments')
+    expect(messageInput.attributes('id')).toMatch(/^agent-assistant-message-input-/)
+    expect(messageInput.attributes('name')).toBe('message')
+    expect(fileInput.attributes('id')).not.toBe(messageInput.attributes('id'))
+    expect(attachButton.attributes('aria-controls')).toBe(fileInput.attributes('id'))
+
+    wrapper.unmount()
+  })
+
   it('toggles the desktop assistant between the side panel and fullscreen modes', async () => {
     displayState.mdAndDown.value = false
     vi.stubGlobal(