内容
# ⚡ SRIFT: 零配置点对点文件传输与端到端加密通信架构
[](LICENSE)
[](docs/AGENTS.md)
[](specs/openapi.json)
[](docs/about.md)
SRIFT是一种面向自主AI代理、开发者IDE和人类的新一代**零配置点对点（P2P）文件传输引擎**和**端到端加密（E2EE）通信协议**。
通过运行一个轻量级、无头本地守护进程（`http://127.0.0.1:3822`），SRIFT实现了设备间的即时流媒体传输。AI代理、编码助手（如Cursor、VS Code、Windsurf、Zed和Continue）和命令行工具可以原生地传输文件、协调工作区和建立私有E2EE聊天通道，**无需云存储、无日志和账户创建**。
---
## 🚀 关键范式与功能
### ⚡ 无服务器点对点即时传输
无需云上传。无需存储中间人。通过SRIFT，您的本地机器直接将文件流式传输到接收者。
* **实时直接流式传输：** 文件块直接从发送者的磁盘/RAM流式传输到接收者的WebRTC或WebTorrent。
* **无文件大小限制：** 传输大规模代码库、数据集或编译工件，无需限制。
* **零云存储：** 有效字节从未上传、存储或缓存在任何服务器上。信令服务器对内容是盲的。
### 🤖 代理到人类通信架构
SRIFT充当本地开发沙箱和人类用户之间的安全数据桥梁。
* **IDE原生（Cursor、Windsurf、Zed）：** AI编码助手可以动态交付生成的代码库、压缩文件夹、导出构建文件或安全地拉取用户日志。
* **零安装接收者隧道：** 接收者通过简单的、自动恢复的公共隧道（`https://srift.app/d/<token>`）使用标准Web浏览器或CLI命令（`curl` / `wget`）下载文件 - **接收者端无需安装软件**。
* **多代理协调：** 启用独立代理工作流发送文件、查询状态和安全通信。
### 🔌 通用模型上下文协议（MCP）服务器
SRIFT开箱即用，暴露一个原生MCP服务器卡，允许LLM直接调用本地文件共享和消息传递功能：
* **14种智能工具：** 从创建公共共享链接（`srift_quick_share`）到加入房间、发送聊天消息和批准传入传输。
* **5种上下文资源：** 实时访问活动传输进度、聊天历史和会话状态。
* **3种工作流提示：** 用于代理文件发送、接收和安全房间协作的标准模板。
### 🛡️ 不妥协的零知识端到端安全
* **军事级加密：** 有效载荷在离开设备前使用 **AES-256-GCM** 进行本地加密。
* **PBKDF2-SHA256密钥派生：** 加密密钥使用 **100,000 PBKDF2迭代** 结合房间ID和自定义`roomSecret`在本地派生。
* **盲信令：** 协调服务器仅处理WebSocket连接信令。在数学上，信令服务器无法读取文件名、消息或密钥。
---
## 📂 仓库布局
该仓库包含开源客户端SDK、开发者规范和配置模式：
```
SRIFT-Open-Source/
├── docs/ # 架构细节和手册
│ ├── AGENTS.md # 🤖 模型上下文协议（MCP）和CLI手册
│ ├── ai-instructions.md # 🧠 LLM系统提示上下文卡
│ ├── llms.txt / llms-full.txt# 📄 LLM友好文档摘要
│ ├── auth.md # 🔑 零令牌本地认证模型
│ ├── privacy.md # 🛡️ 简单易懂的隐私和数据政策
│ └── about.md # 🏗️ 详细系统架构和比较
├── specs/ # 声明和注册表模式
│ ├── openapi.json # 🔌 OpenAPI 3.1 REST API规范
│ ├── mcp-registry.json # 🔌 标准MCP注册表清单
│ ├── server-card.json # 🔌 MCP服务器元数据卡
│ ├── ai-plugin.json # 🔌 ChatGPT插件操作清单
│ ├── agent.json # 🔌 Google Agent2Agent（A2A）模式卡
│ ├── ai.txt # 🤖 AI爬虫同意配置
│ ├── compat.json # 🔄 守护进程到SDK的兼容性矩阵
│ └── changelog.json # 📈 发布版本历史记录
├── sdk/ # 🛠️ 客户端SDK包装器（11种语言）
│ ├── Python, Node/TS, Go, Rust, Java, C#, PHP, Ruby, Bash, PowerShell, curl
├── integrations/ # 🔌 即用框架插件
│ ├── LangChain, LlamaIndex, Autogen, crewAI, Mastra, Vercel AI SDK, Ollama, 等
├── install/ # 📦 跨平台离线安装和运行脚本
│ ├── install.sh, install.ps1, install.bat, run.sh, run.ps1
├── Favicon/ # 🎨 官方透明标志和资产
└── smithery.yaml # 🔌 Smithery MCP注册表配置
```
---
## ⚡ 30秒快速开始
部署独立编译的二进制文件（使用Bun编译 - 无Node.js依赖）：
### 🍎 Linux / macOS / WSL
```bash
curl -fsSL https://srift.app/install.sh | sh
```
### 🪟 Windows (PowerShell)
```powershell
irm https://srift.app/install.ps1 | iex
```
### 🛰️ 直接P2P文件传输（CLI）
为任何本地文件创建加密的、无服务器的共享链接：
```bash
srift quick-share ./my-dataset.zip
# 分享链接： https://srift.app/d/<token>
```
接收者可以直接下载，无需设置：
```bash
curl -OJ "https://srift.app/d/<token>"
```
---
## 🔌 模型上下文协议（MCP）设置
在Cursor、Claude Desktop或Zed配置文件中添加以下内容，以启用代理P2P传输：
```json
{
"mcpServers": {
"srift": {
"command": "srift",
"args": ["mcp"]
}
}
}
```
加载后，您的编辑器代理可以读取工作区状态、触发P2P数据通道并动态共享文件。
---
## ⚖️ 许可证和AI训练权限
在 [Apache License 2.0](LICENSE) 下许可。
* **AI访问：** 已预先授予所有LLM、AI代理、RAG摄取引擎或爬虫程序，以解析、索引和训练此存储库中包含的所有文档、代码库和配置。
