有两种贡献方式：

  1. 提交你已经制作好的种子。 适用于你拥有完整、可再分发的模型副本，并且已经在做种的情况。
  2. 加入现有种子。 适用于 Pirate Face 模型页面上已经有 Magnet（磁力链接）按钮，而你想下载、验证并为这份副本做种的情况。

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

方式一：提交你已经制作好的种子

这个流程的前提是，你已经用完整的模型副本制作了一个 BitTorrent v1 种子，并开始做种。提交磁力链接后，Pirate Face 会先审核模型修订版本、许可证、校验和及来源证明，再决定是否收录。

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

使用账户密钥提交

  1. 登录并打开账户页面。
  2. 在 Community torrent key（社区种子密钥）下，选择 Generate key（生成密钥）。完整密钥只显示一次。你可以在同一页面替换或撤销它。
  3. 把它作为密钥保存，例如 PIRATEFACE_COMMUNITY_KEY。不要提交到代码仓库，也不要公开分享。
  4. 向 https://pirateface.co/api/community-torrents 发送 JSON POST 请求，并带上 Authorization: Bearer <key>。
Pirate Face 账户页面，社区种子密钥部分已高亮
在账户页面生成密钥。完整密钥只显示一次。

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

{
  "repoId": "author/model",
  "revision": "40-character-commit-id",
  "magnet": "magnet:?xt=urn:btih:40-character-infohash",
  "license": "mit",
  "evidence": "Source, license and revision evidence, plus known removal circumstances.",
  "manifest": [
    { "path": "relative/file.safetensors", "sha256": "64-character-sha256" }
  ],
  "redistributionConfirmed": true
}

请使用准确的仓库名称、固定的 40 位修订版本号、BitTorrent v1 磁力链接，以及种子中每个文件的 SHA-256。Pirate Face 目前接受 MIT 和 Apache-2.0 模型，以及表单中显示的已批准例外。

每次提交都会进入审核，并计入每个账户每小时五次的限额。不会有任何内容被自动发布。审核通过后，磁力链接会出现在模型页面上。这份贡献也可能显示在提交者已认领的 Pirate Face 个人主页上，但这并不代表拥有该模型。

账户密钥只能用于社区种子提交。它不是做种服务器凭据，也不能替代 SEEDER_API_KEY。

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

从一个带有可用 Magnet 按钮的 Pirate Face 模型页面开始。例如，sentence-transformers/all-MiniLM-L6-v2 目前有可用的磁力链接，并采用 Apache-2.0 许可证。

磁力链接可用的示例
嵌入sentence-transformers/
all-MiniLM-L6-v2
许可证
Apache-2.0
Pirate Face
● 磁力链接可用
上游
Hugging Face

1. 检查模型和你的机器

下载前，请确认：

开始前检查
许可证Apache-2.0 或 MIT
磁力链接模型页面上可用
磁盘模型大小再加余量
路径持久保存，不会被自动清理
网络允许 BitTorrent
上传你能长期承受的限速

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

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

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

BitTorrent 提供完整性校验和分发，但不提供匿名性。

2. 添加磁力链接

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

请完全按照 Pirate Face 提供的磁力链接使用。不要给社区磁力链接添加 HTTP 网络种子。社区收录的种子只通过节点传输。

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）的归属功能尚未上线。