Dataset Viewer 快速上手指南

Dataset Viewer 是一款基于 Tauri、React 和 TypeScript 构建的高性能数据集查看器。它专为处理海量数据设计，支持秒级打开 100GB+ 大文件、毫秒级搜索以及无需解压直接预览压缩包。

🛠️ 环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows、macOS 或 Linux。
• 硬件建议：虽然软件针对大文件进行了优化，但处理超大规模数据集时，建议拥有足够的内存（RAM）以获得最佳体验。
• 前置依赖：
  • 本工具提供预编译的二进制安装包，普通用户无需安装任何开发环境依赖即可直接使用。
  • 若您计划进行插件开发或源码编译，则需要安装 Node.js、Rust 和 Tauri CLI。

📥 安装步骤

推荐直接下载官方发布的预编译版本进行安装，这是最快捷的方式。

方式一：下载预编译包（推荐）

访问 GitHub Releases 页面，根据您的操作系统下载对应的安装包：

• Windows: 下载 .exe 或 .msi 文件。
• macOS: 下载 .dmg 文件（Intel/Apple Silicon 通用）。
• Linux: 下载 .AppImage、.deb (Debian/Ubuntu) 或 .rpm (Fedora/RHEL) 文件。

下载完成后，运行安装程序并按照提示完成安装。

💡 国内加速提示：如果 GitHub 下载速度较慢，您可以尝试使用国内镜像站（如 Gitee 镜像，若有）或通过代理工具加速下载链接。

方式二：从源码构建（仅限开发者）

如果您需要自定义构建或贡献代码，请使用以下命令：

# 克隆仓库
git clone https://github.com/stardustai/dataset-viewer.git
cd dataset-viewer

# 安装依赖
npm install

# 启动开发模式
npm run tauri dev

# 构建生产版本
npm run tauri build

🚀 基本使用

安装完成后，启动 Dataset Viewer 即可开始高效浏览数据。

1. 连接数据源

启动应用后，您将在主界面看到连接设置面板。Dataset Viewer 支持多种数据源协议：

• 本地文件：直接拖拽文件或点击 "Local Files" 浏览本地目录。
• 远程存储：支持 WebDAV, SSH/SFTP, SMB/CIFS, AWS S3 以及 HuggingFace Hub。
  • 选择对应的协议标签页。
  • 输入主机地址、端口、用户名和密码（或 Access Key）。
  • 点击 Connect 建立连接。

2. 浏览与预览

连接成功后，文件列表将展示在左侧栏：

• 直接预览压缩包：双击 .zip 或 .tar 文件，无需解压即可直接浏览内部文件结构。
• 大文件加载：打开超过 100GB 的日志文件或数据集，软件将通过虚拟滚动技术瞬间加载，不会占用大量内存。

3. 查看特定格式

点击任意文件即可查看内容，软件会自动识别格式并渲染：

• 代码文件 (.py, .js, .rs 等)：自动应用语法高亮。
• 数据文件 (.csv, .parquet, .xlsx)：以表格形式展示，支持排序和过滤。
• JSON/YAML：提供可折叠的树状结构视图。
• 3D 点云：支持交互式 3D 可视化。

4. 毫秒级搜索

在顶部搜索栏输入关键词：

• 软件将在当前文件（即使是百 GB 级别）中进行实时搜索。
• 匹配项会立即高亮显示，并支持快速跳转。

---

现在您可以尽情探索海量数据，享受流畅的查看体验了！