syncgate 0.8.1

Lightweight multi-storage routing and sync abstraction layer

SyncGate 🎯

统一管理散落在各处的文件

🎯 产品定位

SyncGate 是轻量级多存储路由与同步抽象层，统一管理本地文件、HTTP 链接和 S3 对象存储。

核心功能

1. 🔗 统一路径 - 本地/HTTP/S3 一个命令访问
2. 🌳 虚拟文件系统 - 不移动源文件，只管理链接
3. ✅ 链接验证 - 自动验证链接有效性
4. ⚡ 无延迟 - 实时透传，不做缓存

支持的存储

存储类型	状态	说明
本地文件	✅	local:/path/to/file
HTTP/HTTPS	✅	https://example.com/file
AWS S3	✅	s3://bucket/key
WebDAV	🚧	计划中
FTP/SFTP	🚧	计划中

🚀 快速开始

安装

pip install syncgate

演示

python3 demo_complete.py

输出：

🎯 SyncGate Complete Demo
============================================================

📝 Step 1: 创建链接
  ✅ Local:  /docs/notes.txt
  ✅ HTTP:   /online/api.json
  ✅ S3:     /cloud/data.csv

📂 Step 2: 虚拟文件系统结构
virtual/
├── 📁 docs/  → local:/path/to/files
├── 📁 online/ → https://api.example.com
└── 📁 cloud/  → s3://my-bucket/data

🔍 Step 3: 链接验证
  ✅ /docs/notes.txt
  ✅ /online/api.json

✅ 演示完成!

使用

# 创建链接
syncgate link /docs/a.txt local:/path/to/file.txt local
syncgate link /online/api.json https://api.example.com/data.json http
syncgate link /cloud/data.csv s3://my-bucket/data/2024.csv s3

# 列出目录
syncgate ls /docs

# 树形结构
syncgate tree /

# 验证链接
syncgate validate /docs/a.txt

# 查看状态
syncgate status /docs/a.txt

📖 文档

• Architecture - 架构设计
• API Reference - API 文档
• Demo Output - 演示输出

🛠️ 开发

# 克隆项目
git clone https://github.com/cyydark/syncgate.git
cd syncgate

# 运行演示
python3 demo_complete.py

# 运行测试
pytest tests/

📈 路线图

v0.1.x (当前)

• 核心框架
• Local/HTTP/S3 后端
• CLI 命令
• 链接验证
• 推广素材 ⏳
• 首日发布 ⏳

v0.2.x

• WebDAV 后端
• AI 元数据提取
• 向量搜索

v1.0

• 完整测试覆盖
• 文档完善
• 首个正式版

🤝 贡献

欢迎提交 Issue 和 PR！

📄 许可

MIT License - see LICENSE

---

SyncGate - 统一管理散落在各处的文件 📁🌐☁️