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:

DirectoryPurpose
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:

TypeRendering
Image / Audio / Video / PDFNative playback / preview, toolbar hides "Save" button
MarkdownReuses chat page markdown rendering (code highlighting + media embedding)
HTML<iframe> rendering (allows Plotly/ECharts but blocks parent page cookie access)
CSV / TSVantd table rendering (max 2000 rows, shows notice when exceeded)
JSON / JSONLSyntax-highlighted preview, falls back to source on parse failure
Text / CodeSimple textarea editor (no syntax highlighting for editing)
BinaryPlaceholder + download button

Toggle types (Markdown/HTML/CSV/JSON) get a Preview/Source switcher in the toolbar header.

5.4 Typical Use Cases

ScenarioAction
Upload reference documentsUpload PDF/TXT/CSV etc. to docs/, Agent auto-references in conversation
Manage scriptsWrite or upload Python scripts to scripts/, Agent can execute in sandbox
View generated contentView AI-generated images, audio, video in generated/
Soul memoryWith Soul enabled, edit Agent personality notes in soul/