SuperAPI AI 工具集

proof-uploader

部署与运维

查看项目

更新于 10-16 05:37

技能介绍

Proof Uploader 是一个命令行工具技能,用于将文件上传到 S3 兼容的对象存储,并围绕上传结果处理 Markdown 链接和清理旧对象。

用途 该技能的核心用途是安装、配置和使用 proof CLI。它适合需要把构建产物、文档附件或其他文件上传到 S3 兼容存储,并希望自动更新 Markdown 中引用链接的场景。同时,它也提供清理旧对象的能力,用于管理存储桶中的历史文件。

主要能力

  • 上传文件:通过 proof upload-file FILE... 上传一个或多个文件。
  • 重写 Markdown 链接:通过 proof prepare-proof INPUT.md OUTPUT.md 处理输入 Markdown,并输出重写链接后的 Markdown。
  • 清理旧对象:通过 proof vacuum 2w 清理存储桶中超过指定时间(示例为 2 周)的旧对象。
  • 链接模式控制:默认生成公开 URL;可通过配置 download_mode: signed 或环境变量 PROOF_DOWNLOAD_MODE=signed 改为生成一周有效的预签名 URL。

使用方式 安装命令为: go install github.com/tylergannon/agents/cmd/proof@latest

配置支持两种方式,并强调凭据不应放入被跟踪的文件:

  • YAML:参考 references/config.yaml,放置到 ~/.proof-uploader/config.yaml。
  • dotenv:参考 references/.env.example,作为未被跟踪的 .env 使用。

常用命令:

  • proof upload-file FILE...
  • proof prepare-proof INPUT.md OUTPUT.md
  • proof vacuum 2w

适用场景 适用于需要将文件上传到 S3 兼容存储并自动维护 Markdown 链接的自动化流程,例如文档构建、静态站点生成、构建产物发布等。也适用于需要定期清理旧上传对象的维护任务。

限制 资料未提供关于支持的具体 S3 兼容服务、认证方式细节、错误处理、并发能力、文件大小限制、价格或收费模式等信息。使用前需自行准备 S3 兼容存储的凭据,并确保凭据不进入版本控制。