ghcr.io/spacedriveapp/spacedrive/server:3aa91e9

Spacedrive

一款适用于所有设备和云存储的文件管理器。由虚拟分布式文件系统（Virtual Distributed File System）提供支持，配备适用于 macOS、Windows、Linux、iOS 和 Android 的应用程序

v2.spacedrive.com • *** • 快速开始

什么是 Spacedrive？

Spacedrive 是一个跨设备数据平台。可索引文件、电子邮件、笔记和外部数据源。支持全局搜索。通过 P2P 同步。内置筛选功能确保 AI 代理安全。

• 内容标识 — 每个文件都有一个 BLAKE3 内容哈希。同一文件在两台设备上会生成相同的哈希。Spacedrive 跨所有设备跟踪冗余和重复数据删除。
• 跨设备 — 在一个位置查看所有设备上的所有文件。断开连接的设备上的文件仍保留在索引中，并显示为离线状态。
• P2P 同步 — 设备通过 Iroh/QUIC 直接连接。无需服务器、无需云服务、无单点故障。设备之间同步元数据。文件保留在原始位置。
• 云卷 — 将 S3、Google Drive、Dropbox、OneDrive、Azure 和 GCS 作为一级卷与本地存储一起索引。
• 九种视图 — 网格、列表、列、媒体、大小、最近、搜索、知识和 splat。支持视频、音频、代码、文档、3D 和图像的 QuickPreview。
• 本地优先 — 所有内容均在您的设备上运行。除非您选择在自己的设备之间同步，否则数据不会离开您的设备。

它是否可以替代 Finder 或资源管理器？

不。Spacedrive 位于您的操作系统文件管理器之上，并增加了 Finder/资源管理器所缺乏的功能：

• 全局门户 — 从一个界面搜索和浏览本地磁盘、外部驱动器、NAS、云存储和归档数据源中的文件。
• 文件操作层 — 核心模型内置内容标识、副文件（sidecars）、衍生工件、丰富元数据、同步和跨设备感知。
• 可嵌入和可共享 — 可作为桌面应用程序、无头服务器、托管文件服务运行，或将界面和 APIs 嵌入其他产品。
• 原生支持 AI — 索引和分析管道提前准备数据，而非让代理直接访问原始 shell。
• 更安全的访问模型 — 通过结构化 APIs、权限和处理层路由 AI 和自动化，而非直接文件操作。

您仍需使用操作系统进行低级文件交互。Spacedrive 在其之上添加了跨平台、跨设备、云感知和自动化友好的层。

spacedrive/
├── core/ # Rust 引擎 (CQRS/DDD)
├── apps/
│ ├── tauri/ # 桌面应用 (macOS, Windows, Linux)
│ ├── mobile/ # React Native (iOS, Android)
│ ├── cli/ # 命令行工具和守护进程
│ ├── server/ # 无头服务器
│ └── web/ # 浏览器客户端
├── packages/
│ ├── interface/ # 共享 React UI
│ ├── ts-client/ # 自动生成的 TypeScript 客户端
│ ├── ui/ # 组件库
│ └── assets/ # 图标、图片、SVG
├── crates/ # 独立 Rust  crate (ffmpeg, 加密等)
├── adapters/ # 基于脚本的数据源适配器
└── schemas/ # TOML 数据类型模式

文件系统智能

Spacedrive 通过结合三层功能为文件系统增添智能：

• 文件智能 — 派生数据，如 OCR、转录文本、提取的元数据、缩略图、预览、分类和附属文件。
• 目录智能 — 附加到文件夹和子树的上下文知识（“活跃项目”、“休眠档案”等）。
• 访问智能 — 跨设备和云应用的权限和策略，通过结构化访问而非原始 shell 命令路由代理。

当代理通过 Spacedrive 导航时，它会接收文件列表、子树上下文、有效权限和摘要。用户可以解释他们如何组织系统。代理可以添加带属性的注释。任务从结构和活动中生成摘要。智能始终附加到文件系统，而非埋在临时会话内存中。

安全筛选

启用后，每条记录在可搜索前都要经过安全处理流程：

• Prompt Guard 2 — 本地分类器在电子邮件、消息和文档进入索引前检测提示注入。
• 信任层级 — 原创内容（您的笔记）进行平衡筛选，外部内容（电子邮件收件箱）进行严格筛选。
• 隔离系统 — 标记的记录被排除在 AI 代理查询之外，可在桌面应用中查看。
• 内容围栏 — 搜索结果包含信任元数据，以便代理区分安全与不可信内容。

没有其他本地数据工具会在将索引内容暴露给 AI 之前进行筛选。

架构

核心基于四个原则构建：

1. 虚拟分布式文件系统（VDFS） — 文件和文件夹成为具有丰富元数据的一等对象，独立于物理位置。每个文件都有一个跨设备通用的地址（SdPath）。

2. 内容标识系统 — 自适应哈希（对大文件采用策略性采样的 BLAKE3）为每个内容生成唯一指纹。支持重复数据删除、冗余跟踪和基于内容的操作。

3. 事务性操作 — 每个文件操作都可在执行前预览。查看空间节省量、冲突和预计时间，然后批准或取消。操作成为持久任务，可在网络中断和设备重启后继续。

4. 无领导者同步 — 无需中央协调器的对等同步。设备特定数据使用状态复制。共享元数据使用 HLC 排序日志和确定性冲突解决。

实现为单个 Rust crate，采用 CQRS/DDD 架构。每个操作（文件复制、标签创建、搜索查询）都是注册的动作或查询，具有类型安全的输入/输出，可自动为前端生成 TypeScript 类型。

spacedrive/
├── core/ # Rust 引擎 (CQRS/DDD)
├── apps/
│ ├── tauri/ # 桌面应用 (macOS, Windows, Linux)
│ ├── mobile/ # React Native (iOS, Android)
│ ├── cli/ # 命令行工具和守护进程
│ ├── server/ # 无头服务器
│ └── web/ # 浏览器客户端
├── packages/
│ ├── interface/ # 共享 React UI
│ ├── ts-client/ # 自动生成的 TypeScript 客户端
│ ├── ui/ # 组件库
│ └── assets/ # 图标、图片、SVG
├── crates/ # 独立 Rust crates (ffmpeg, crypto 等)
├── adapters/ # 基于脚本的数据源适配器
└── schemas/ # TOML 数据类型模式

快速开始

git clone https://github.com/spacedriveapp/spacedrive
cd spacedrive

just setup # bun install + 原生依赖 + cargo 配置
just dev-desktop # 启动桌面应用（自动启动守护进程）
just test # 运行所有工作区测试

隐私与安全

Spacedrive 采用本地优先原则。您的数据保留在自己的设备上。

• 端到端加密 — 所有 P2P 流量通过 QUIC/TLS 加密
• 静态加密 — 库可在磁盘上加密（SQLCipher）
• 无遥测 — 零跟踪或分析
• 可自托管 — 运行自己的中继服务器
• 数据主权 — 您控制数据的存储位置

可选的云集成可用于备份和远程访问，但并非必需。云服务将未修改的 Spacedrive 核心作为标准 P2P 设备运行——无特殊权限。

贡献

• **加入 ***** 与开发者和社区交流
• 贡献指南
• 适配器指南 — 编写数据源适配器
• https://github.com/spacedriveapp/spaceui — 共享设计系统（与 Spacedrive 一起克隆以进行 UI 开发）

许可证

FSL-1.1-ALv2 — 功能源代码许可证，两年后转换为 Apache 2.0。