> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexjade.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件上传功能指南

> 了解如何使用 LawChat 的文件上传功能，支持多种格式的文件上传和分析

## 功能概述

LawChat 支持在对话中上传文件，让 AI 能够理解和分析您提供的文档内容。您可以上传：

* 📄 **法律文档**：合同、协议、判决书等
* 📊 **证据材料**：PDF、Word 文档等
* 📝 **文字资料**：TXT、Markdown 等文本文件
* 🖼️ **图片文件**：证据照片、扫描件等(Beta)

## 支持的文件格式

### 图片格式（当前不支持阅读图片和包含图片的文件）

| 格式           | 说明     | 适用场景        |
| ------------ | ------ | ----------- |
| **JPG/JPEG** | 常见图片格式 | 证据照片、扫描件    |
| **PNG**      | 无损压缩图片 | 截图、图表       |
| **GIF**      | 动态图片   | 不支持动画，仅显示首帧 |
| **WEBP**     | 现代图片格式 | 高质量压缩图片     |

### 文档格式

| 格式           | 说明          | 适用场景        |
| ------------ | ----------- | ----------- |
| **PDF**      | 便携式文档格式     | 合同、判决书、官方文件 |
| **DOC/DOCX** | Word 文档     | 合同草案、法律文书   |
| **TXT**      | 纯文本文件       | 文字记录、笔记     |
| **MD**       | Markdown 文件 | 技术文档、格式化文本  |

### 数据格式

| 格式       | 说明    | 适用场景      |
| -------- | ----- | --------- |
| **CSV**  | 逗号分隔值 | 数据表格、清单   |
| **JSON** | 结构化数据 | 配置文件、数据导出 |
| **XML**  | 标记语言  | 结构化文档     |

### 代码格式

| 格式           | 说明                    | 适用场景      |
| ------------ | --------------------- | --------- |
| **PY**       | Python 代码             | 代码审查、技术分析 |
| **JS/TS**    | JavaScript/TypeScript | 代码相关问题    |
| **HTML/CSS** | 网页代码                  | 网页相关咨询    |

### 其他格式

| 格式       | 说明   | 适用场景      |
| -------- | ---- | --------- |
| **YAML** | 配置文件 | 配置相关咨询    |
| **LOG**  | 日志文件 | 错误分析、问题排查 |

## 文件大小限制

### 限制标准

根据会员等级不同，文件大小限制如下：

| 会员等级     | 单文件上限 | 单次对话总上限 | 每日上传次数 |
| -------- | ----- | ------- | ------ |
| **Free** | 5 MB  | 20 MB   | 10 次   |
| **Pro**  | 20 MB | 100 MB  | 50 次   |
| **Max**  | 50 MB | 500 MB  | 200 次  |

### 存储空间

每个会员等级有总的云存储空间限制：

| 会员等级     | 总存储空间  | 说明     |
| -------- | ------ | ------ |
| **Free** | 100 MB | 适合轻度使用 |
| **Pro**  | 1 GB   | 适合常规使用 |
| **Max**  | 10 GB  | 适合专业用户 |

> **注意**：具体限制可能因系统配置而有所不同，请以实际使用时显示的限制为准。

## 如何上传文件

### 方法一：使用上传按钮

1. **点击上传按钮**

   在对话输入框上方，点击 **📎 附件图标**，会弹出上传菜单。

2. **选择文件类型**

   菜单提供两个选项：

   * 🖼️ **上传图片**：仅显示图片文件
   * 📄 **上传文档**：显示文档和数据文件

3. **选择文件**

   在文件选择对话框中，选择一个或多个文件。

4. **确认上传**

   选择后文件会自动上传，上传成功后会显示在输入框上方。

### 方法二：拖拽上传

1. **打开文件管理器**

   在电脑上打开文件管理器（Finder/资源管理器）。

2. **拖拽文件**

   将文件直接拖拽到对话输入框区域。

3. **松开鼠标**

   松开鼠标后文件会自动开始上传。

### 方法三：复制粘贴

1. **复制文件或图片**

   * 图片：截图后直接粘贴
   * 文件：在文件管理器中复制

2. **粘贴到输入框**

   在输入框中按 `Ctrl+V`（Windows）或 `⌘+V`（Mac）粘贴。

3. **确认上传**

   文件会自动上传并显示预览。

## 文件处理流程

### 1. 上传阶段

```
选择文件 → 验证格式 → 检查大小 → 开始上传 → 上传完成
```

* **格式验证**：系统检查文件格式是否在支持列表中
* **大小检查**：确认文件大小未超过限制
* **上传进度**：大文件会显示上传进度条

### 2. 处理阶段

根据文件类型不同，系统会进行不同的处理：

**图片文件**：

```
上传图片 → 生成预览 → 可选 OCR 识别 → 等待发送
```

**PDF 文件**：

```
上传 PDF → 提取文本 → 提取图片（可选）→ 等待发送
```

**Word 文档**：

```
上传 DOCX → 提取文本 → 格式化 → 等待发送
```

**文本文件**：

```
上传 TXT → 读取内容 → 编码检测 → 等待发送
```

### 3. 发送阶段

当您发送消息时，文件会：

1. **生成描述**：系统为每个文件生成文字描述
2. **附加到消息**：文件内容作为消息的一部分发送
3. **AI 分析**：AI 接收并分析文件内容
4. **生成回复**：AI 基于文件内容生成回答

## 文件预览和管理

### 预览功能

上传后的文件会显示在输入框上方，每个文件卡片显示：

* **缩略图**：图片显示缩略图，文档显示图标
* **文件名**：原始文件名
* **文件大小**：以 KB/MB 显示
* **删除按钮**：点击 `×` 可以移除文件

### 图片预览

* **小图预览**：128x128 像素缩略图
* **查看大图**：点击缩略图可查看完整图片
* **缩放功能**：支持放大查看细节

### 文档预览

* **文本内容**：显示提取的部分文本内容
* **页数信息**：PDF 显示总页数
* **格式标识**：不同类型文档显示不同图标

### 管理已上传文件

**移除单个文件**：

* 点击文件卡片右上角的 `×` 按钮

**清空所有文件**：

* 点击输入框的"清除"按钮

**重新上传**：

* 移除后可以重新选择上传

## 使用场景

### 场景一：合同审查

**操作步骤**：

1. 点击上传按钮，选择要审查的合同 PDF/Word 文件
2. 输入问题："请帮我审查这份合同，指出可能存在的风险条款"
3. 发送后，AI 会分析合同内容并给出审查意见

**AI 能够**：

* 识别合同类型和主要条款
* 标记不公平或违法条款
* 提供修改建议
* 引用相关法律依据

### 场景二：案件材料分析

**操作步骤**：

1. 上传案件相关的判决书、证据材料等
2. 描述案情并提问："根据这些材料，我的胜算有多大？"
3. AI 会综合分析所有材料

**AI 能够**：

* 提取关键事实
* 分析法律关系
* 评估胜诉概率
* 提供诉讼建议

### 场景三：法律文书起草

**操作步骤**：

1. 上传相关参考文档（如对方发来的律师函）
2. 说明需求："请帮我起草一份答辩状"
3. 提供基本案情信息

**AI 能够**：

* 生成规范的文书格式
* 引用 appropriate 法律条文
* 针对性地回应对方观点
* 提供证据清单建议

### 场景四：图片证据分析

**操作步骤**：

1. 上传现场照片、伤痕照片、损坏物品照片等
2. 说明图片内容和要证明的事实
3. 询问如何有效使用这些证据

**AI 能够**：

* 分析图片的证明力
* 建议如何固定证据
* 提醒需要注意的问题
* 指导证据提交方式

### 场景五：批量文档处理

**操作步骤**：

1. 一次性上传多个相关文件（如多份合同、多个判决书）
2. 要求 AI 进行对比分析或汇总
3. 提出具体问题

**AI 能够**：

* 对比不同文档的异同
* 汇总关键信息
* 发现潜在关联
* 生成综合分析报告

## 最佳实践

### 1. 文件命名规范

**好的做法**：

* `劳动合同 - 张三 -2024.pdf`
* `借款合同 - 原告证据 1.docx`
* `现场照片 - 交通事故地点.jpg`

**不好的做法**：

* `未命名 1.pdf`
* `IMG_20240101_123456.jpg`
* `新建 Microsoft Word 文档.docx`

### 2. 文件质量要求

**图片文件**：

* ✅ 清晰可辨，分辨率不低于 300 DPI
* ✅ 光线充足，无反光遮挡
* ✅ 完整拍摄，包含关键信息

**文档文件**：

* ✅ 文字版 PDF（非扫描图片）
* ✅ 格式规范，无乱码
* ✅ 内容完整，无缺页

### 3. 内容预处理

上传前建议：

* **去除敏感信息**：如身份证号、银行卡号等
* **拆分大文件**：超过 20 页的文档建议拆分
* **合并相关文件**：多个小文件可合并为一个

### 4. 配合文字说明

上传文件时，建议配合详细的文字说明：

```
我上传了一份劳动合同，是我和 XX 公司在 2024 年 1 月签订的。
主要问题：
1. 合同约定了竞业限制，但没有约定补偿金
2. 加班费计算标准不明确
3. 社保缴纳基数低于实际工资

请帮我分析这些条款是否合法，我该如何维权？
```

### 5. 分批次上传

对于复杂案件：

* **第一批**：基础材料（合同、协议等）
* **第二批**：证据材料（聊天记录、照片等）
* **第三批**：补充材料（鉴定报告、证人证言等）

分批次上传可以让 AI 更好地理解案情发展。

## 注意事项

### 1. 隐私保护

⚠️ **重要提醒**：

* 不要上传包含个人隐私的文件（身份证、户口本等）
* 敏感信息请打码后再上传
* 机密文件请谨慎处理

### 2. 文件格式限制

虽然支持多种格式，但以下格式**不支持**：

* ❌ 加密的 PDF 或 Word 文档
* ❌ 损坏的文件
* ❌ 特殊编码的文件

### 3. 内容准确性

* AI 提取的文本可能存在误差
* 扫描件（图片型 PDF）识别准确率较低
* 重要内容请以原件为准

### 4. 存储期限

* 上传的文件会存储在云端
* 删除对话会同时删除相关文件
* 建议下载重要文件的备份

### 5. 处理时间

大文件处理需要时间：

| 文件大小    | 预计处理时间  |
| ------- | ------- |
| \< 1 MB | 1-3 秒   |
| 1-5 MB  | 3-10 秒  |
| 5-20 MB | 10-30 秒 |
| > 20 MB | 30 秒以上  |

## 常见问题

### Q: 为什么我的文件上传失败？

A: 可能的原因：

* 文件格式不支持
* 文件超过大小限制
* 网络连接问题
* 文件已损坏

### Q: 上传的文件安全吗？

A: 系统采取以下安全措施：

* 文件加密存储
* 仅您和 AI 可以访问
* 定期安全审计
* 符合数据保护法规

### Q: 可以上传视频或音频吗？

A: 目前**不支持**视频和音频文件。如需分析音视频内容，建议：

* 转换为文字记录后上传
* 使用第三方工具生成字幕/文字稿

### Q: 上传后文件会保存多久？

A: 文件存储期限：

* 活跃对话中的文件：长期保存
* 已删除对话的文件：同步删除
* 建议自行备份重要文件

### Q: 如何查看已上传的文件列表？

A: 目前可以通过以下方式：

* 在对话中查看历史消息的附件
* 后续版本将增加文件管理功能

### Q: 文件上传失败可以重试吗？

A: 可以，建议：

* 检查网络和文件格式
* 刷新页面后重新上传
* 如仍失败，请联系客服

> **提示**：文件上传功能让 AI 能够"看到"您的文档，大大提升了咨询的准确性和针对性。合理使用文件上传，可以让 AI 提供更专业、更具体的法律建议。