User Guide · 05
File Panel
Click the 📁 button in the top right to open the file panel (available only on the chat page).
5.1 Browsing
Tree-structured browsing of user's virtual filesystem:
| Directory | Purpose |
|---|---|
docs/ | Document directory (upload reference materials, Agent can read) |
scripts/ | Script directory (Python scripts, Agent can execute) |
generated/ | AI-generated files (images/audio/video, auto-written) |
soul/ | Soul memory notes (visible when Soul filesystem is enabled) |
5.2 Operations
- Upload: drag-drop or select files to upload to specified directory
- Download: click download button or toolbar download icon
- Rename: right-click menu or long-press
- Move: drag to target folder
- Delete: right-click menu
- Diff view: view differences between file versions
5.3 File Preview Panel (Multi-type Viewer)
Different file types use different rendering strategies:
| Type | Rendering |
|---|---|
| Image / Audio / Video / PDF | Native playback / preview, toolbar hides "Save" button |
| Markdown | Reuses chat page markdown rendering (code highlighting + media embedding) |
| HTML | <iframe> rendering (allows Plotly/ECharts but blocks parent page cookie access) |
| CSV / TSV | antd table rendering (max 2000 rows, shows notice when exceeded) |
| JSON / JSONL | Syntax-highlighted preview, falls back to source on parse failure |
| Text / Code | Simple textarea editor (no syntax highlighting for editing) |
| Binary | Placeholder + download button |
Toggle types (Markdown/HTML/CSV/JSON) get a Preview/Source switcher in the toolbar header.
5.4 Typical Use Cases
| Scenario | Action |
|---|---|
| Upload reference documents | Upload PDF/TXT/CSV etc. to docs/, Agent auto-references in conversation |
| Manage scripts | Write or upload Python scripts to scripts/, Agent can execute in sandbox |
| View generated content | View AI-generated images, audio, video in generated/ |
| Soul memory | With Soul enabled, edit Agent personality notes in soul/ |