支持从数据库读取文档进行AI分析

新增 doc_id 参数支持从数据库读取文档内容，同时保留文件上传功能，
实现两种方式的灵活切换。修改了 Markdown、TXT 和 Word 文档的分析接口，
添加从数据库获取文档的逻辑，并相应更新前端 API 调用。

BREAKING CHANGE: 分析接口现在支持文件上传和数据库文档 ID 两种方式

frontend/src/db/backend-api.ts

@@ -1279,15 +1279,21 @@ export const aiApi = {
    * 上传并使用 AI 分析 Markdown 文件
    */
   async analyzeMarkdown(
-    file: File,
+    file: File | null,
     options: {
+      docId?: string;
       analysisType?: MarkdownAnalysisType;
       userPrompt?: string;
       sectionNumber?: string;
     } = {}
   ): Promise<AIMarkdownAnalyzeResult> {
     const formData = new FormData();
-    formData.append('file', file);
+    if (file) {
+      formData.append('file', file);
+    }
+    if (options.docId) {
+      formData.append('doc_id', options.docId);
+    }
 
     const params = new URLSearchParams();
     if (options.analysisType) {
@@ -1432,7 +1438,8 @@ export const aiApi = {
    * 上传并使用 AI 分析 TXT 文本文件，提取结构化数据或生成图表
    */
   async analyzeTxt(
-    file: File,
+    file: File | null,
+    docId: string | null = null,
     analysisType: TxtAnalysisType = 'structured'
   ): Promise<{
     success: boolean;
@@ -1442,7 +1449,12 @@ export const aiApi = {
     error?: string;
   }> {
     const formData = new FormData();
-    formData.append('file', file);
+    if (file) {
+      formData.append('file', file);
+    }
+    if (docId) {
+      formData.append('doc_id', docId);
+    }
 
     const params = new URLSearchParams();
     params.append('analysis_type', analysisType);
@@ -1572,7 +1584,8 @@ export const aiApi = {
    * 使用 AI 解析 Word 文档，提取结构化数据或生成图表
    */
   async analyzeWordWithAI(
-    file: File,
+    file: File | null,
+    docId: string | null = null,
     userHint: string = '',
     analysisType: WordAnalysisType = 'structured'
   ): Promise<{
@@ -1583,7 +1596,12 @@ export const aiApi = {
     error?: string;
   }> {
     const formData = new FormData();
-    formData.append('file', file);
+    if (file) {
+      formData.append('file', file);
+    }
+    if (docId) {
+      formData.append('doc_id', docId);
+    }
     if (userHint) {
       formData.append('user_hint', userHint);
     }

frontend/src/pages/Documents.tsx

@@ -10,7 +10,7 @@ import {
   ChevronDown,
   ChevronUp,
   FileSpreadsheet,
-  File,
+  File as FileIcon,
   Table,
   CheckCircle,
   AlertCircle,
@@ -123,6 +123,17 @@ const Documents: React.FC = () => {
   const [ragResults, setRagResults] = useState<any[]>([]);
   const [ragRebuilding, setRagRebuilding] = useState(false);
 
+  // 选中的文档详情
+  const [selectedDocument, setSelectedDocument] = useState<{
+    doc_id: string;
+    original_filename: string;
+    doc_type: string;
+    content?: string;
+    structured_data?: any;
+    metadata?: any;
+  } | null>(null);
+  const [loadingDocument, setLoadingDocument] = useState(false);
+
   // 解析选项
   const [parseOptions, setParseOptions] = useState({
     parseAllSheets: false,
@@ -277,6 +288,33 @@ const Documents: React.FC = () => {
                     return { ...s, status: 'failed', progress: 0, error: fileResult?.error || '处理失败' };
                   }
                 }));
+
+                // 设置第一个成功文件的 uploadedFile
+                const firstSuccessIdx = fileResults.findIndex((fr: any) => fr?.success);
+                if (firstSuccessIdx >= 0 && acceptedFiles[firstSuccessIdx]) {
+                  const firstFile = acceptedFiles[firstSuccessIdx];
+                  const firstResult = fileResults[firstSuccessIdx];
+                  const ext = firstFile.name.split('.').pop()?.toLowerCase();
+
+                  // 设置 uploadedFile
+                  setUploadedFile(firstFile);
+
+                  // 对于 Excel 文件，获取 parseResult
+                  if (ext === 'xlsx' || ext === 'xls') {
+                    // 调用 parseDocument 获取 parseResult
+                    if (firstResult?.file_path) {
+                      try {
+                        const parseResult = await backendApi.parseDocument(firstResult.file_path);
+                        if (parseResult.success) {
+                          setParseResult(parseResult as any);
+                        }
+                      } catch (parseErr) {
+                        console.warn('获取 parseResult 失败:', parseErr);
+                      }
+                    }
+                  }
+                }
+
                 loadDocuments();
                 return;
               } else if (status.status === 'failure') {
@@ -455,24 +493,79 @@ const Documents: React.FC = () => {
 
   // 基于 AI 分析生成图表
   const handleGenerateCharts = async () => {
-    if (!aiAnalysis || !aiAnalysis.success) {
+    // 检查是否有任何 AI 分析结果
+    const hasExcelAI = aiAnalysis?.success;
+    const hasMdAI = mdAnalysis?.success;
+    const hasWordAI = wordAnalysis?.success;
+    const hasTxtAI = txtAnalysis?.success;
+
+    if (!hasExcelAI && !hasMdAI && !hasWordAI && !hasTxtAI) {
       toast.error('请先进行 AI 分析');
       return;
     }
 
+    // 如果是 Markdown 分析已有图表，直接显示
+    if (hasMdAI && mdAnalysis?.chart_data?.tables) {
+      setAnalysisCharts({
+        success: true,
+        charts: { tables: mdAnalysis.chart_data.tables },
+        statistics: mdAnalysis.chart_data.key_statistics
+      });
+      toast.success('图表生成完成');
+      return;
+    }
+
+    // 如果是 Word 分析已有图表，直接显示
+    if (hasWordAI && wordAnalysis?.result?.charts) {
+      setAnalysisCharts({
+        success: true,
+        charts: wordAnalysis.result.charts,
+        statistics: wordAnalysis.result.statistics
+      });
+      toast.success('图表生成完成');
+      return;
+    }
+
+    // 如果是 TXT 分析已有图表，直接显示
+    if (hasTxtAI && txtAnalysis?.result?.charts) {
+      setAnalysisCharts({
+        success: true,
+        charts: txtAnalysis.result.charts,
+        statistics: txtAnalysis.result.statistics
+      });
+      toast.success('图表生成完成');
+      return;
+    }
+
+    // 尝试从各种分析结果中提取文本并生成图表
     let analysisText = '';
-    if (aiAnalysis.analysis?.analysis) {
-      analysisText = aiAnalysis.analysis.analysis;
-    } else if (aiAnalysis.analysis?.sheets) {
-      const sheets = aiAnalysis.analysis.sheets;
-      if (sheets && Object.keys(sheets).length > 0) {
-        const firstSheet = Object.keys(sheets)[0];
-        analysisText = sheets[firstSheet]?.analysis || '';
+    let fileType = 'unknown';
+
+    if (hasExcelAI) {
+      if (aiAnalysis.analysis?.analysis) {
+        analysisText = aiAnalysis.analysis.analysis;
+        fileType = 'excel';
+      } else if (aiAnalysis.analysis?.sheets) {
+        const sheets = aiAnalysis.analysis.sheets;
+        if (sheets && Object.keys(sheets).length > 0) {
+          const firstSheet = Object.keys(sheets)[0];
+          analysisText = sheets[firstSheet]?.analysis || '';
+          fileType = 'excel';
+        }
       }
+    } else if (hasMdAI && mdAnalysis?.analysis) {
+      analysisText = mdAnalysis.analysis;
+      fileType = 'markdown';
+    } else if (hasWordAI && wordAnalysis?.result?.summary) {
+      analysisText = wordAnalysis.result.summary;
+      fileType = 'word';
+    } else if (hasTxtAI && txtAnalysis?.result?.summary) {
+      analysisText = txtAnalysis.result.summary;
+      fileType = 'txt';
     }
 
     if (!analysisText?.trim()) {
-      toast.error('无法获取 AI 分析结果');
+      toast.error('无法获取 AI 分析文本结果');
       return;
     }
 
@@ -483,7 +576,7 @@ const Documents: React.FC = () => {
       const result = await aiApi.extractAndGenerateCharts({
         analysis_text: analysisText,
         original_filename: uploadedFile?.name || 'unknown',
-        file_type: 'excel'
+        file_type: fileType
       });
 
       if (result.success) {
@@ -601,6 +694,9 @@ const Documents: React.FC = () => {
       const result = await backendApi.deleteDocument(docId);
       if (result.success) {
         setDocuments(prev => prev.filter(d => d.doc_id !== docId));
+        if (selectedDocument?.doc_id === docId) {
+          setSelectedDocument(null);
+        }
         toast.success('文档已删除');
       }
     } catch (err: any) {
@@ -608,6 +704,95 @@ const Documents: React.FC = () => {
     }
   };
 
+  const handleSelectDocument = async (docId: string) => {
+    setLoadingDocument(true);
+    try {
+      const result = await backendApi.getDocument(docId);
+      if (result.success && result.document) {
+        setSelectedDocument(result.document);
+        const doc = result.document;
+
+        // 优先使用 file_path 调用 parseDocument 获取完整解析结果
+        const filePath = doc.metadata?.file_path;
+        if (filePath) {
+          try {
+            const parseResult = await backendApi.parseDocument(filePath);
+            if (parseResult.success) {
+              setParseResult(parseResult as any);
+              const ext = doc.original_filename.split('.').pop()?.toLowerCase() || doc.doc_type;
+              const fakeFile = new File([], doc.original_filename, { type: getMimeType(ext) });
+              setUploadedFile(fakeFile);
+              toast.success('已加载文档: ' + doc.original_filename);
+              setLoadingDocument(false);
+              return;
+            } else {
+              console.warn('parseDocument returned success:false, using fallback');
+            }
+          } catch (parseErr) {
+            console.warn('parseDocument failed, fallback to structured_data:', parseErr);
+          }
+        }
+
+        // 后备：使用 structured_data 构建 parseResult
+        const ext = doc.original_filename.split('.').pop()?.toLowerCase() || doc.doc_type;
+        const fakeFile = new File([], doc.original_filename, { type: getMimeType(ext) });
+
+        if (doc.structured_data) {
+          const mockParseResult: ExcelParseResult = {
+            success: true,
+            data: {},
+            metadata: {
+              filename: doc.filename,
+              original_filename: doc.original_filename,
+              extension: doc.doc_type,
+              doc_type: doc.doc_type as any,
+              file_size: doc.metadata?.file_size || 0,
+            }
+          };
+          if (doc.structured_data.tables && doc.structured_data.tables.length > 0) {
+            const firstTable = doc.structured_data.tables[0];
+            mockParseResult.data = {
+              columns: firstTable.headers || [],
+              rows: (firstTable.rows || []).map((row: string[]) => {
+                const obj: Record<string, any> = {};
+                (firstTable.headers || []).forEach((h: string, i: number) => {
+                  obj[h] = row[i] || '';
+                });
+                return obj;
+              }),
+              row_count: firstTable.rows?.length || 0,
+              column_count: firstTable.headers?.length || 0,
+            };
+          }
+          if (doc.structured_data.sheets) {
+            mockParseResult.data.sheets = doc.structured_data.sheets;
+          }
+          setParseResult(mockParseResult);
+        } else if (doc.content) {
+          setParseResult({
+            success: true,
+            data: { content: doc.content },
+            metadata: {
+              filename: doc.filename,
+              original_filename: doc.original_filename,
+              extension: doc.doc_type,
+              doc_type: doc.doc_type as any,
+              file_size: doc.metadata?.file_size || 0,
+            }
+          });
+        }
+        setUploadedFile(fakeFile);
+        toast.success('已加载文档: ' + doc.original_filename);
+      } else {
+        toast.error(result.error || '获取文档详情失败');
+      }
+    } catch (err: any) {
+      toast.error(err.message || '获取文档详情失败');
+    } finally {
+      setLoadingDocument(false);
+    }
+  };
+
   const filteredDocs = documents.filter(doc =>
     doc.original_filename.toLowerCase().includes(search.toLowerCase())
   );
@@ -621,7 +806,7 @@ const Documents: React.FC = () => {
       case 'doc':
         return <FileText size={28} />;
       default:
-        return <File size={28} />;
+        return <FileIcon size={28} />;
     }
   };
 
@@ -641,11 +826,17 @@ const Documents: React.FC = () => {
     setMdAnalysis(null);
 
     try {
-      const result = await aiApi.analyzeMarkdown(uploadedFile, {
-        analysisType: mdAnalysisType,
-        userPrompt: mdUserPrompt,
-        sectionNumber: mdSelectedSection || undefined
-      });
+      // 判断是从历史文档还是本地上传
+      const docId = selectedDocument?.doc_id && uploadedFile.size === 0 ? selectedDocument.doc_id : undefined;
+      const result = await aiApi.analyzeMarkdown(
+        uploadedFile.size > 0 ? uploadedFile : null,
+        {
+          docId: docId || undefined,
+          analysisType: mdAnalysisType,
+          userPrompt: mdUserPrompt,
+          sectionNumber: mdSelectedSection || undefined
+        }
+      );
 
       if (result.success) {
         toast.success('Markdown AI 分析完成');
@@ -721,8 +912,11 @@ const Documents: React.FC = () => {
     setWordAnalysis(null);
 
     try {
+      // 判断是从历史文档还是本地上传
+      const docId = selectedDocument?.doc_id && uploadedFile.size === 0 ? selectedDocument.doc_id : null;
       const result = await aiApi.analyzeWordWithAI(
-        uploadedFile,
+        uploadedFile.size > 0 ? uploadedFile : null,
+        docId,
         wordUserHint,
         wordAnalysisType
       );
@@ -751,7 +945,13 @@ const Documents: React.FC = () => {
     setTxtAnalysis(null);
 
     try {
-      const result = await aiApi.analyzeTxt(uploadedFile, txtAnalysisType);
+      // 判断是从历史文档还是本地上传
+      const docId = selectedDocument?.doc_id && uploadedFile.size === 0 ? selectedDocument.doc_id : null;
+      const result = await aiApi.analyzeTxt(
+        uploadedFile.size > 0 ? uploadedFile : null,
+        docId,
+        txtAnalysisType
+      );
 
       if (result.success) {
         toast.success('TXT AI 分析完成');
@@ -789,6 +989,18 @@ const Documents: React.FC = () => {
     return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
   };
 
+  const getMimeType = (ext: string): string => {
+    const mimeTypes: Record<string, string> = {
+      'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+      'xls': 'application/vnd.ms-excel',
+      'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+      'doc': 'application/msword',
+      'md': 'text/markdown',
+      'txt': 'text/plain',
+    };
+    return mimeTypes[ext] || 'application/octet-stream';
+  };
+
   const getAnalysisIcon = (type: string) => {
     switch (type) {
       case 'general': return <FileText size={20} />;
@@ -1130,7 +1342,7 @@ const Documents: React.FC = () => {
                         <FileText size={12} className="mr-1" /> Markdown
                       </Badge>
                       <Badge variant="outline" className="bg-gray-500/10 text-gray-600 border-gray-200 text-xs">
-                        <File size={12} className="mr-1" /> 文本
+                        <FileIcon size={12} className="mr-1" /> 文本
                       </Badge>
                     </div>
                   </div>
@@ -1139,6 +1351,38 @@ const Documents: React.FC = () => {
             )}
           </Card>
 
+          {/* 从历史文档中选择 */}
+          {documents.length > 0 && (
+            <Card className="border-none shadow-md">
+              <CardHeader className="pb-4">
+                <CardTitle className="flex items-center gap-2">
+                  <Clock className="text-primary" size={20} />
+                  从历史文档选择
+                </CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-3">
+                <Select
+                  value=""
+                  onValueChange={async (docId) => {
+                    if (!docId) return;
+                    await handleSelectDocument(docId);
+                  }}
+                >
+                  <SelectTrigger className="bg-background">
+                    <SelectValue placeholder="选择历史文档..." />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {documents.slice(0, 20).map((doc) => (
+                      <SelectItem key={doc.doc_id} value={doc.doc_id}>
+                        {doc.original_filename}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              </CardContent>
+            </Card>
+          )}
+
           {/* Excel 解析选项 */}
           {uploadedFile && isExcelFile(uploadedFile.name) && (
             <Card className="border-none shadow-md">
@@ -1423,7 +1667,7 @@ const Documents: React.FC = () => {
           )}
 
           {/* 数据操作 */}
-          {parseResult?.success && (
+          {(parseResult?.success || aiAnalysis?.success || mdAnalysis?.success || wordAnalysis?.success || txtAnalysis?.success) && (
             <Card className="border-none shadow-md bg-gradient-to-br from-emerald-500/5 to-blue-500/5">
               <CardHeader className="pb-4">
                 <CardTitle className="flex items-center gap-2">
@@ -1432,7 +1676,7 @@ const Documents: React.FC = () => {
                 </CardTitle>
               </CardHeader>
               <CardContent className="space-y-3">
-                <Button onClick={handleGenerateCharts} disabled={!aiAnalysis?.success || analyzingForCharts} className="w-full bg-gradient-to-r from-primary to-purple-600 hover:from-primary/90 hover:to-purple-600/90">
+                <Button onClick={handleGenerateCharts} disabled={!(aiAnalysis?.success || mdAnalysis?.success || wordAnalysis?.success || txtAnalysis?.success) || analyzingForCharts} className="w-full bg-gradient-to-r from-primary to-purple-600 hover:from-primary/90 hover:to-purple-600/90">
                   {analyzingForCharts ? <><Loader2 className="mr-2 animate-spin" size={16} />生成中...</> : <><Brain size={16} className="mr-2" />AI 分析图表</>}
                 </Button>
                 <Button onClick={openExportDialog} variant="outline" className="w-full">
@@ -1774,6 +2018,95 @@ const Documents: React.FC = () => {
             </CardContent>
           </Card>
 
+          {/* 已上传文档详情 */}
+          {selectedDocument && (
+            <Card className="border-none shadow-md border-l-4 border-l-cyan-500">
+              <CardHeader>
+                <div className="flex items-center justify-between">
+                  <div className="space-y-1">
+                    <CardTitle className="flex items-center gap-2">
+                      <FileText className="text-cyan-500" size={20} />
+                      文档详情
+                    </CardTitle>
+                    <CardDescription>
+                      {selectedDocument.original_filename} • {selectedDocument.doc_type.toUpperCase()}
+                    </CardDescription>
+                  </div>
+                  <Button variant="ghost" size="sm" onClick={() => setSelectedDocument(null)}>
+                    关闭
+                  </Button>
+                </div>
+              </CardHeader>
+              <CardContent className="max-h-[500px] overflow-y-auto">
+                {loadingDocument ? (
+                  <div className="flex items-center justify-center py-8">
+                    <Loader2 className="animate-spin" size={24} />
+                    <span className="ml-2">加载中...</span>
+                  </div>
+                ) : (
+                  <div className="space-y-4">
+                    {selectedDocument.structured_data?.tables && selectedDocument.structured_data.tables.length > 0 && (
+                      <div className="space-y-2">
+                        <p className="text-sm font-medium">表格数据：</p>
+                        {selectedDocument.structured_data.tables.slice(0, 3).map((table: any, idx: number) => (
+                          <div key={idx} className="border rounded-lg overflow-x-auto">
+                            {table.headers && (
+                              <TableComponent>
+                                <TableHeader>
+                                  <TableRow>
+                                    {table.headers.map((header: string, hIdx: number) => (
+                                      <TableHead key={hIdx}>{header}</TableHead>
+                                    ))}
+                                  </TableRow>
+                                </TableHeader>
+                                <TableBody>
+                                  {(table.rows || []).slice(0, 10).map((row: string[], rIdx: number) => (
+                                    <TableRow key={rIdx}>
+                                      {row.map((cell: string, cIdx: number) => (
+                                        <TableCell key={cIdx}>{cell}</TableCell>
+                                      ))}
+                                    </TableRow>
+                                  ))}
+                                </TableBody>
+                              </TableComponent>
+                            )}
+                          </div>
+                        ))}
+                      </div>
+                    )}
+                    {selectedDocument.structured_data?.key_values && Object.keys(selectedDocument.structured_data.key_values || {}).length > 0 && (
+                      <div className="space-y-2">
+                        <p className="text-sm font-medium">键值对数据：</p>
+                        <div className="grid grid-cols-2 gap-2">
+                          {Object.entries(selectedDocument.structured_data.key_values || {}).map(([key, value]: [string, any]) => (
+                            <div key={key} className="flex gap-2 p-2 bg-muted/30 rounded-lg">
+                              <span className="font-medium text-sm">{key}:</span>
+                              <span className="text-sm text-muted-foreground">{String(value)}</span>
+                            </div>
+                          ))}
+                        </div>
+                      </div>
+                    )}
+                    {selectedDocument.content && (
+                      <div className="space-y-2">
+                        <p className="text-sm font-medium">文本内容预览：</p>
+                        <div className="p-3 bg-muted/30 rounded-lg max-h-[300px] overflow-y-auto">
+                          <p className="text-sm whitespace-pre-wrap font-mono">
+                            {selectedDocument.content.slice(0, 2000)}
+                            {selectedDocument.content.length > 2000 && '...'}
+                          </p>
+                        </div>
+                      </div>
+                    )}
+                    {!selectedDocument.content && !selectedDocument.structured_data?.tables && !selectedDocument.structured_data?.key_values && (
+                      <p className="text-sm text-muted-foreground text-center py-4">该文档没有可显示的内容</p>
+                    )}
+                  </div>
+                )}
+              </CardContent>
+            </Card>
+          )}
+
           {/* 文档列表 */}
           <Card className="border-none shadow-md">
             <CardHeader>
@@ -1801,7 +2134,14 @@ const Documents: React.FC = () => {
               ) : (filteredDocs?.length ?? 0) > 0 ? (
                 <div className="space-y-3">
                   {(filteredDocs || []).map(doc => (
-                    <div key={doc.doc_id} className="flex items-center gap-4 p-4 rounded-xl border border-transparent hover:bg-muted/30 transition-all group">
+                    <div
+                      key={doc.doc_id}
+                      className={cn(
+                        "flex items-center gap-4 p-4 rounded-xl border border-transparent hover:bg-muted/30 transition-all group cursor-pointer",
+                        selectedDocument?.doc_id === doc.doc_id && "bg-primary/5 border-primary/20"
+                      )}
+                      onClick={() => handleSelectDocument(doc.doc_id)}
+                    >
                       <div className={cn(
                         "w-10 h-10 rounded-lg flex items-center justify-center shrink-0",
                         doc.doc_type === 'xlsx' ? "bg-emerald-500/10 text-emerald-500" : "bg-blue-500/10 text-blue-500"
@@ -1814,7 +2154,10 @@ const Documents: React.FC = () => {
                           {doc.doc_type.toUpperCase()} • {format(new Date(doc.created_at), 'yyyy-MM-dd HH:mm')}
                         </p>
                       </div>
-                      <Button variant="ghost" size="icon" className="text-destructive hover:bg-destructive/10 opacity-0 group-hover:opacity-100" onClick={() => handleDelete(doc.doc_id)}>
+                      <Button variant="ghost" size="icon" className="text-destructive hover:bg-destructive/10 opacity-0 group-hover:opacity-100" onClick={(e) => {
+                        e.stopPropagation();
+                        handleDelete(doc.doc_id);
+                      }}>
                         <Trash2 size={16} />
                       </Button>
                     </div>