用途:uploads CLI 与托管 MCP(https://agents.uploads.sh/mcp)用于把文件上传到 uploads.sh,返回稳定的公开 URL 和可直接粘贴的 Markdown,并可嵌入 GitHub PR 或 issue。
主要能力:两种传输方式——本地 CLI 与托管 MCP。CLI 适合本地文件、git、localhost 及需要 attach、promote、feed、staged 等命令的场景;托管 MCP 为 bot-only,适合已有字节(base64)或公开 HTTPS URL 的情况。常见上传用 uploads attach <file...>,自动推断当前分支的 PR,并行上传并维护受管评论;put 用于更底层的命名与输出控制。--pr/--issue 会生成无哈希的稳定键(gh/<owner>/<repo>/pull/<num>/<name>),重复上传同名文件会原地覆盖,URL 不变。
使用方式:需 Node.js ≥ 22;安装命令为 npm install --global @buildinternet/uploads,也可用 npx @buildinternet/uploads --help 单次运行。首次配置可运行 uploads login(交互式,需要浏览器),或由管理员分发 UPLOADS_TOKEN、用 uploads login --code 兑换注册码。检查配置可用 uploads setup、uploads doctor、uploads doctor --json。评论功能需要已认证的 gh CLI,普通上传不需要。
适用场景:为 PR/issue 附带图片与截图、在上传前先按分支暂存文件(--branch,用 uploads staged 查看)、生成 PR 截图 feed、维护受管附件评论。
限制:MCP 与 CLI 功能不完全对等,托管 MCP 无文件系统、无 attach,也不支持 localhost 或私有网络截图,带 selector 的标注规格会被远端拒绝。promotion 仅适用于 PR,不适用于 issue;仓库需先绑定 workspace,否则自动附加会静默不生效。token 默认 90 天并含 files:read、files:write,除非管理员显式授予,否则不能删除文件。仓库名解析、本地渲染截图与代理内注等细节以官方文档为准;资料未提供的内容不作推断。