参与方式

无论使用智能体还是按照指南手动操作，你都可以通过三种方式参与：

  1. 分享已有文件。 将 Hugging Face 缓存或本地文件夹中符合条件的模型打包，开始做种并提交种子。值得拯救页面列出可能还需要首个磁力链接的候选模型。
  2. 加入现有种子。 浏览有种子的模型，再使用模型页面的 Magnet（磁力链接）按钮下载副本并做种。
  3. 长期维护模型可用性。 维护已有种子，并接手观测到做种者较少的模型。设置智能体可以自动检查。供智能体使用的救援列表以 JSON 格式列出需要更多做种者的磁力链接。

你不需要 GPU。你只需要足够的磁盘空间、一个持续维护的种子客户端，以及一条可以用于上传的网络连接。

浏览、下载和为现有种子做种不需要账户。提交新种子（包括从 Hugging Face 重建的种子）需要 Pirate Face 账户；脚本使用该账户的社区种子密钥。种子节点可以看到你的公网 IP 地址，做种也会占用存储空间和上传带宽。

方式一：分享你已有的模型

请智能体按照社区做种技能操作。打包脚本会将本地文件与 Hugging Face 来源核对、制作种子并准备提交。你仍须确认自己有权再分发这些文件，并接受提交条款。

如果模型是用 Hugging Face 工具下载的，缓存流程会查找尚未收录、完整且符合条件的模型。在具备 Bash 和所需工具的环境中运行：

curl -fsSL https://pirateface.co/package.sh -o pirateface-package.sh
# 运行前先检查下载的脚本。
bash pirateface-package.sh --hf-cache

脚本会显示 submit（可提交）、listed（已收录）或 skip（跳过）及原因。它会链接到缓存文件，而不是复制模型权重。做种期间请保留原始缓存文件；清理缓存可能导致做种失效。如果可以连接受支持的 Transmission 或 qBittorrent，脚本会将种子添加到客户端。如果显示 Needs you，请先按说明完成客户端设置，不要将其视为已经开始做种。

对于完整的本地模型文件夹，使用同一个脚本并指定 Hugging Face 仓库：

bash pirateface-package.sh --repo author/model ./model-folder

这需要 Bash（Windows 上使用 Git Bash）、Python 3、curl 和 SHA-256 工具，并非原生 PowerShell 命令。在 Windows 上，请先让智能体检查运行环境和客户端集成，或使用网页表单提交你已制作好的种子。各平台的最新说明见技能文件；安装软件或启用开机服务前应征求你的同意。

如果你已经有完整的种子并正在做种，可以直接提交其 .torrent 文件。多文件种子必须使用混合格式（v1 + v2）；纯 v1 格式只接受单文件种子。打包脚本会创建混合格式种子。在 qBittorrent 中，选择 Tools > Torrent Creator > Torrent format: Hybrid。Pirate Face 会在收录前检查修订版本、许可证、校验和及来源证明。

你可以使用网页表单，也可以借助账户密钥，从智能体或本地脚本提交同样的信息。

使用账户密钥提交

  1. 登录并打开设置页面。
  2. 在 Community torrent key（社区种子密钥）下，选择 Generate key（生成密钥）。完整密钥只显示一次。你可以在同一页面替换或撤销它。
  3. 打包脚本会读取 PIRATEFACE_KEY，或提示你输入密钥。自定义 API 客户端应将其作为密钥保存。不要提交到代码仓库，也不要公开分享。
  4. 向 https://pirateface.co/api/community-torrents 发送 JSON POST 请求，并带上 Authorization: Bearer <key>。
设置页面的开发者区域，社区种子密钥控件已高亮
在设置 → 开发者中找到社区种子密钥。示例账户已生成密钥；完整密钥仅在生成时显示。

发送与网页表单要求相同的字段：

{
  "repoId": "author/model",
  "revision": "40-character-commit-id",
  "torrent": "base64-encoded-contents-of-your-torrent-file",
  "license": "mit",
  "evidence": "Source, license and revision evidence, plus known removal circumstances.",
  "manifest": [
    { "path": "relative/file.safetensors", "sha256": "64-character-sha256" }
  ],
  "redistributionConfirmed": true,
  "accuracyConfirmed": true,
  "reviewAcknowledged": true,
  "privacyAcknowledged": true,
  "termsAccepted": true,
  "submissionTermsVersion": "2026-09-18.2"
}

请使用准确的仓库名称、固定的 40 位修订版本号，以及种子中每个文件的 SHA-256。torrent 字段必须包含 .torrent 文件字节的 base64 编码，而不是文件名或磁力链接。编码前的文件大小不得超过 3 MB。Pirate Face 会从该文件生成磁力链接；仅提交磁力链接会被拒绝。

Pirate Face 接受其收录政策中列出的许可证（同一列表也在 /api/licenses）。逐个批准的特定仓库属于例外，并不代表允许其他自定义许可证模型。带条款的许可证需要下载者先接受条款，才会显示磁力链接。请附上适用条款要求的许可证文件。

请用实际值替换示例中的占位符。只有阅读并接受提交条款后，才能将确认字段设为 true；使用示例前，请查看当前表单接受的条款版本。

每个账户每小时最多可有 200 次被接受的提交，被拒绝的提交不计入。如果固定的 Hugging Face 来源可读取，且提交的文件清单通过来源检查，符合条件的提交可以自动收录。在 Hugging Face 上找不到的仓库会交由审核员审核。无效证据或来源不匹配会被拒绝并说明原因；请修正后重新提交。如果 Hugging Face 暂时无法访问，系统会提示稍后重试，不会保存该次提交。获批收录并不能证明节点可以完成下载，也不能证明模型所有权。

账户密钥只能用于社区种子提交。

方式二：加入并为现有种子做种

从一个带有 Magnet 按钮的 Pirate Face 模型页面开始。你可以查看 sentence-transformers/all-MiniLM-L6-v2 作为示例；开始前，请核对页面当前的许可证、磁力链接和做种者观测信息。收录了磁力链接并不保证节点可用。

模型页面示例
嵌入sentence-transformers/
all-MiniLM-L6-v2
许可证
Apache-2.0
Pirate Face
查看当前磁力链接
上游
Hugging Face

1. 检查模型和你的机器

下载前，请确认：

开始前检查
许可证在 Pirate Face 允许列表中
磁力链接模型页面上可用
磁盘模型大小再加余量
路径持久保存，不会被自动清理
网络允许种子传输
上传你能长期承受的限速

从官方渠道安装或更新一个持续维护的种子客户端，例如 Transmission 或 qBittorrent。远程控制界面只应开放在 localhost 或可信的私有网络上。

种子节点可以看到你的公网 IP 地址。种子协议 提供完整性校验和分发，但不提供匿名性。

节点群能看到什么
你的客户端
公网 IP 可见节点节点Tracker / DHT

种子协议提供完整性校验和分发，但不提供匿名性。

2. 添加磁力链接

在模型页面上选择 Magnet，让浏览器打开你的种子客户端。开始前，请核对模型名称、总大小、文件列表和保存位置。

请直接使用 Pirate Face 提供的磁力链接。对于有 Hugging Face 来源的种子，包括社区提交，Pirate Face 可以加入 Hugging Face 网络种子（webseed），让客户端同时从 Hugging Face 和节点下载。来源的访问条件和可用性仍然适用；网络种子不保证下载能够完成。如果来源消失，下载就依赖持有文件的节点。

3. 验证下载

等种子下载到 100%，然后运行客户端的 force recheck（强制重新校验）命令。这会检查种子的每一个数据块。

如果模型页面有 Verify（验证）按钮，请把下载完成的文件与其中的 SHA-256 清单进行比对。例如：

# Linux
sha256sum -c SHA256SUMS

# macOS
shasum -a 256 model.safetensors

# Windows PowerShell
Get-FileHash -Algorithm SHA256 .\model.safetensors

请比对完整的摘要值。一致说明这些字节与记录的来源相同，但并不能证明模型安全、准确，或适合某个特定用途。

4. 保持做种

让下载完成的种子在一个持久的存储路径中保持活动。

健康的做种
种子客户端
AI 模型权重● 做种中100%重新校验：通过DHT：正常

满足以下条件时，你的做种就是健康的：

  • 进度为 100%；
  • 强制重新校验通过；
  • 客户端显示 Seeding（做种中）或 Uploading（上传中）；
  • 存储始终挂载在同一路径；
  • 文件没有被重命名、修改或删除；
  • 上传限速是你能长期承受的。

当前上传为零可能只是因为暂时没有节点需要数据块。Pirate Face 公开的做种者数量也不能证明你的客户端已被识别。做种证明（Proof of Seed）的归属功能尚未上线。

方式三：让智能体维护种子

定期检查说明描述了每六小时一次的检查。只有在你希望持续检查并自动接手模型时才启用它。智能体检查已有种子、保留 20 GB 磁盘余量，并在没有其他下载进行时，每轮最多添加一个模型。磁力链接来自 Pirate Face 的救援列表，而不是社交帖子或其他智能体。

如果某个模型的观测做种者数量为零，但来源仍可用，智能体可以下载固定修订版本的 Hugging Face 文件、制作种子、开始做种，并用你的社区密钥提交。观测数量为零并不证明没有任何副本。重建可能产生新的 infohash，不保证恢复原来的节点群。如果来源也不可用，就需要已经持有文件的人参与。

智能体需要调度器或定期检查功能才能持续运行。只读取一次说明不会自动创建后台服务。请它报告启用了什么，以及如何暂停。安装软件、修改网络或开机启动设置仍需你的同意。

积分与贡献归属

获批的社区种子提交按每个不同模型仓库奖励一次积分，记在提交账户最早验证的用户名下。奖励为 1 积分加每 250 GB（十进制）模型大小 25 积分，四舍五入为整数。你从同一 Hugging Face 账户或组织提交的前 10 个获奖仓库之后，后续提交按大小计算的奖励减为五分之一，四舍五入后最低 1 积分。提交来自你本人已关联的 Hugging Face 账户命名空间时，保留全额奖励。没有已验证用户名的账户不满足归属条件。详见积分说明。

使用你的 Pirate Face 做种 tracker 做种，10 GB 种子每 3 个做种小时得 1 积分，按 √(GB / 10) 缩放：客户端持有完整副本时计时，每小时记入一次。参见积分规则。