用户指南 · 05
文件面板
点击右上角的 📁 按钮打开文件面板（仅对话页面可用）。
5.1 浏览
树形结构浏览用户虚拟文件系统：
| 目录 | 用途 |
|---|---|
docs/ | 文档目录（上传参考资料，Agent 可读） |
scripts/ | 脚本目录（Python 脚本，Agent 可执行） |
generated/ | AI 生成的文件（图片/音频/视频，自动写入） |
soul/ | Soul 记忆笔记（启用 Soul 文件系统时显示） |
5.2 操作
- 上传：拖拽或选择文件上传到指定目录
- 下载：单击下载按钮或工具栏的下载图标
- 重命名：右键菜单或长按弹出
- 移动：拖拽到目标文件夹
- 删除：右键菜单
- Diff 查看：查看文件修改前后的差异
5.3 文件预览面板（多类型查看器）
不同类型的文件采用不同的渲染策略：
| 类型 | 渲染方式 |
|---|---|
| 图片 / 音频 / 视频 / PDF | 原生播放 / 预览，工具栏隐藏「保存」按钮 |
| Markdown | 复用聊天页 markdown 渲染（含代码高亮 + 媒体嵌入） |
| HTML | <iframe> 渲染（允许 Plotly/ECharts 但禁止访问父页 cookies） |
| CSV / TSV | antd 表格渲染（最多 2000 行，超过显示提示） |
| JSON / JSONL | 语法高亮预览，解析失败降级为源码 |
| 文本 / 代码 | 简洁 textarea 编辑器（无高亮编辑） |
| 二进制 | 占位 + 下载按钮 |
可切换类型（Markdown/HTML/CSV/JSON）的工具栏头部带 预览/源码 切换器。
5.4 典型使用场景
| 场景 | 操作 |
|---|---|
| 上传参考文档 | 将 PDF/TXT/CSV 等上传到 docs/，Agent 对话时自动引用 |
| 管理脚本 | 在 scripts/ 编写或上传 Python 脚本，Agent 可在沙箱中执行 |
| 查看生成物 | 在 generated/ 查看 AI 生成的图片、音频、视频 |
| Soul 记忆 | 启用 Soul 后在 soul/ 中编辑 Agent 的人格笔记 |