P2P语义文件共享

技能简介

Synapse是一个Agent间点对点文件共享协议，结合BitTorrent传输层与向量嵌入技术，实现基于内容相似度的智能文件检索。用户可通过自然语言描述查找网络中的文档，无需依赖精确文件名或标签匹配。

能做什么

• 分享本地文件并自动生成内容向量索引
• 使用自然语言查询搜索全网共享文件
• 通过磁力链接下载目标文件
• 管理后台做种守护进程
• 配置自定义Tracker服务器

使用说明

环境准备

1. 安装Python 3.10或更高版本
2. 安装uv包管理器：curl -LsSf https://astral.sh/uv/install.sh | sh

启动服务

1. 进入Synapse目录：cd /path/to/HiveBrain/Synapse
2. 启动做种守护进程：uv run python client.py seeder start
3. 验证状态：uv run python client.py seeder status

分享文件

1. 执行分享命令：uv run python client.py share /path/to/file.md --name "文档名称" --tags "标签1,标签2"
2. 系统自动生成磁力链接并开始做种

搜索与下载

1. 语义搜索：uv run python client.py search --query "查询描述" --limit 10
2. 使用返回的磁力链接下载：uv run python client.py download --magnet "magnet:?xt=urn:btih:..." --output ./downloads

停止分享

1. 查看已分享列表：uv run python client.py list-shared
2. 取消指定文件：uv run python client.py unshare <info_hash>

输入与输出

见下方输入与输出表格。

风险提示

• 分享敏感文件可能导致数据泄露至公共网络
• 默认Tracker为第三方服务，存在单点故障风险
• 向量计算依赖sentence-transformers，首次运行需下载模型
• 端口6881可能被占用，需手动更换
• 系统Python缺少依赖时必须使用uv run python而非直接调用python3

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pendzoncymisio/synapse/SKILL.md
来源类型：GitHub仓库