uploads：AI Agent 工具实践指南

在项目中评估uploads，可以先看清用途边界：轻量级文件托管和上传工具，供编码代理添加工件以拉取请求，云和自托管选项。团队若要把它用于部署与运行环境，应先处理权限、依赖和环境差异会放大维护成本，否则试用结果很容易失真。短测时我会在非生产环境复现一次安装与运行，并保留依赖锁定、权限边界、日志、回滚和资源消耗的结果，方便团队复盘。它对愿意维护环境并重视故障恢复的工程团队更有价值，但正式采用前仍要复查许可证、近期提交和问题区回应。

uploads

编码代理缺少上传命令。

在工作时捕获屏幕截图、录音和其他工件：测试 报告、日志、JSON、PDFs、zip。当拉取请求打开时，uploads.sh 将 它们在一个整洁的评论中，每次修订都会自动更新。主办 uploads.sh 可以免费启动。连接您自己的存储桶 — Cloudflare R2 或任何 S3 兼容提供商 — 因此该存储桶中的存储是不计量的，或者是自托管的 开源服务。

uploads.sh  ·  Docs  ·  npm →  ·  Quick start  ·  What 看起来 like  ·  What 在此 repo  ·  Develop

拉取请求打开时工件已准备就绪

上传 托管编码代理在稳定公共 URLs 上生成的工件 他们可以在拉取请求和问题中使用：屏幕截图和屏幕录制， 还有测试报告、日志、JSON、CSV、Markdown、PDFs 和 zip 存档 （完整列表位于 计划和限制 下）。开 一个分支，uploads put 一旦每个文件准备好就将其暂存。当拉动时 请求打开后，uploads.sh 将暂存文件提升为一个托管评论。

GitHub 自己的附件可通过浏览器工作，并且自 GitHub CLI 2.99 起 （2026 年 9 月），来自 gh … --attach，但仅一次拉取请求或问题 存在，并且文件保留在 GitHub 自己的托管后面，在那里它们不能 嵌入或在其他地方获取。 uploads.sh给代理商一个稳定的 从构建和测试更改的同一终端公开 URL，同时 该分支仍在进行中。托管的 MCP 服务器对代理执行相同的操作 根本无法运行命令，将文件视为字节或 URL。 GitHub 无 公开 API （尚未）。

密钥是无散列的，因此重新上传相同的文件名会就地覆盖 URL 永远不会改变——它的每个嵌入都会立即更新。工作区保留 租户（及其预算和关键政策）分开。

该存储库是规范部署的来源 uploads.sh：API工作器、验证工作器、MCP服务器、 Astro Web 应用程序和 @buildinternet/uploads CLI（从以下位置发布到 npm） packages/uploads).

它看起来像什么

每个 PR 一条评论，在每次同步时重写。已标记的文件 --state before 和 --state after 配对成并排表；其他 图像和视频位于其下方，以及非媒体文件（报告、日志、档案） 在文件表中列出其类型和大小。

_{The真实评论 #436.}

当多对共享评论时，由 --meta path=… 进行配对（一对 before 每个路径一个 after），并回退到仅相差一个的文件名 before/after 代币 — hero-before.webp 和 hero-after.webp。

您附加的所有内容也会落在您的工作区中，并按其来源进行分组 来自 — path 的页面，repo 或 app 的项目 — 并且可从其中浏览 地方。

_{该截图查看按项目和 path.} 分组上传

打开共享页面的任何文件：复制就绪嵌入（Markdown、HTML 等）， 原始 URL 和删除按钮。

_{Each 文件的共享页面 — 复制就绪嵌入、详细信息和 delete.}

快速启动

安装CLI并登录一次：

npm install --global @buildinternet/uploads
uploads login

上传文件并标记其显示的页面：

uploads put ./settings.png --meta path=/settings

在分支上，put 自动暂存文件。然而打开拉取请求 你通常会的。 GitHub 应用程序 将暂存文件提升为一个托管附件评论。

更多上传方式

对前后证据、开放拉取请求、 浏览器捕获，或带注释的图像：

# Pair two states from the same page in the pull request comment.
uploads put ./before.png --meta path=/settings --state before
uploads put ./after.png --meta path=/settings --state after

# See what this branch will attach when the pull request opens.
uploads staged

# Attach files directly when a pull request or issue is already open.
uploads attach ./before.png ./after.png

# Capture, annotate, and upload a page in one command.
uploads screenshot http://localhost:4321/settings --via local --annotate ./callouts.json

attach通过gh检测存储库和当前的PR，上传所有文件， 并创建或更新同一条评论。没有GitHub App，运行 uploads attach --promote 打开拉取请求以提升文件后 你早些时候上演了。所有命令在 npx @buildinternet/uploads … 下运行 无需全局安装。

使用 GitHub 或魔术链接登录，然后创建您自己的工作区或接受 邀请加入 — 请参阅 注册。托管文件是 public URLs — 私人仓库附件获得不可猜测的链接 （是如何工作的），但任何持有 URL 的人都可以 查看文件。请勿上传机密或敏感 UI。

连接您的代理

托管的 MCP 服务器在 https://agents.uploads.sh/mcp 上运行，并列在 MCP 注册表 为 sh.uploads/mcp。本地 stdio 是同一 npm 包上的 uploads mcp。

# Claude Code
claude mcp add --transport http uploads https://agents.uploads.sh/mcp

# Codex
codex mcp add uploads --url https://agents.uploads.sh/mcp

# OpenCode
opencode mcp add uploads --url https://agents.uploads.sh/mcp

uploads install 添加了代理技能和 MCP 服务器，因此未来的会话 无需询问即可捕捉每个视觉里程碑。技能也安装 独立到任何代理运行时：

npx skills add buildinternet/uploads

安装三个技能：github-screenshots（视觉效果 → PRs/issues）， uploads-cli（完整的 CLI 参考）和 annotate-screenshots（标注和 对捕获进行编辑）。

在 Claude Code 或 Codex 上，插件 捆绑了技能、MCP 服务器和预 PR 屏幕截图提醒。在 克劳德代码它还在提示上方显示了分阶段的屏幕截图并附加 当 PR 打开时。在 claude.ai 和 Cowork 中，添加来自 克劳德目录。

完整的 CLI 用法，包括注释、托管评论、公共画廊、 和更改提要（整个存储库范围或一个拉取请求），位于 docs/cli.md.

uploads feed create 在存储库上打印屏幕截图的实时页面：

_{uploads feed create --repo buildinternet/uploads.}

REST 路由位于 docs/api.md 中。

这个仓库里有什么

每个工作人员和 Web 应用程序单独部署。所有存储访问都经过 createStorage() in packages/storage — 添加提供商是一种新情况 加上同行部门，没有 API 变化。

文档

产品文档 — 安装、分阶段循环、GitHub 应用程序、限制 — 实时显示 https://uploads.sh/docs. 此存储库中的文档是同伴：CLI 和 API 参考、贡献者设置和操作员材料，全部映射自 docs/README.md.

如何设置、测试和打开拉取请求：CONTRIBUTING.md。 项目所在：VISION.md。代理工作惯例 位于 AGENTS.md，登陆此仓库的代理应该启动 在llms.txt。产品站点服务 https://uploads.sh/llms.txt 和 https://uploads.sh/llms-full.txt.

当地发展

先决条件： 节点 ≥24 且 pnpm ≥11 (corepack enable)。没有 Cloudflare 核心本地循环所需的帐户 - wrangler dev 模拟 R2、KV 和 磁盘上的 D1：

pnpm bootstrap        # one-command setup: tooling, deps, env vars, local D1, default workspace
pnpm dev              # API on :8787 (local R2 + KV + D1)

bootstrap 是幂等的，并且 pnpm doctor 无需更改即可诊断设置 它。循环的其余部分——经过身份验证的开发堆栈、检查和测试 门，以及如何打开拉取请求 - 位于 CONTRIBUTING.md.