mcpField
G
github-image-hosting

github-image-hosting

github.com/img402开发257 次安装6 周前更新
代码仓库

关于 github-image-hosting

github-image-hosting 是将图片上传到 img402.dev，并把返回链接嵌入 GitHub Markdown 的技能。它说明按文件大小划分的保留期限、上传命令，以及在拉取请求和议题中添加图片的流程。

主要功能

  1. 01上传图片至 img402.dev
  2. 02返回可嵌入 Markdown 的链接
  3. 03说明按大小划分的保留期限
  4. 04通过 gh CLI 操作拉取请求和议题
  5. 05支持 PNG、JPEG、GIF 和 WebP

适用场景

  1. 01在拉取请求描述中添加截图
  2. 02在 GitHub 议题评论中发布图片
  3. 03在 README 中嵌入图表
  4. 04分享有大小期限限制的审查截图

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/img402/skills --skill github-image-hosting

安装后在 Claude Code 中输入/github-image-hosting确认已加载。

详细介绍

为 GitHub 上传图片

将图片上传到 img402.dev，并在 GitHub Markdown 中嵌入返回的 URL。

截图免费且永久保存。 UI 截图通常为 100–400 KB，远低于免费托管永不过期的 1 MB 门槛，因此你在 PR 中添加的链接，六个月后也不会变成失效图片。你几乎不需要为此购买付费套餐。

选择套餐

上传大小价格保留期限适用场景
≤ 1 MB$0永久PR 截图、问题评论、模型图、README 图表
1–10 MB$030 天仅在审核期间需要的大型截图
Up to 10 MB$0.01 USDC永久大型 README 主图、公开博客图片

* 付费永久保存是指在服务生命周期内保留，并提供 90 天的站点关闭通知——参见 Terms § 2A。

快速参考

# Upload (multipart)
curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png

# Response — expiresAt is null for images 1MB and under
# {"url":"https://i.img402.dev/aBcDeFgHiJ.png","id":"aBcDeFgHiJ","contentType":"image/png","sizeBytes":182400,"expiresAt":null}

工作流

  1. 获取图片：使用现有文件，或截取屏幕截图： 
    screencapture -x /tmp/screenshot.png        # macOS — full screen
screencapture -xw /tmp/screenshot.png       # macOS — frontmost window
  2. 上传： 
    curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png
  3. 检查 expiresAt：null 表示永久保存。时间戳表示文件超过 1 MB，将在该时间删除——如果图片需要保留更久，请将其缩小到 1 MB 以下并重新上传： 
    sips -Z 1600 /tmp/screenshot.png  # macOS — scale longest edge to 1600px
  4. 嵌入：在 GitHub Markdown 中嵌入返回的 url： 
    ![Screenshot description](https://i.img402.dev/aBcDeFgHiJ.png)

GitHub 集成

使用 gh CLI 在 PR 和问题中嵌入图片：

# Add to PR description
gh pr edit --body "$(gh pr view --json body -q .body)

![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# Add as PR comment
gh pr comment --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# Add to issue
gh issue comment 123 --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

限制

  • 最大大小：10 MB（所有套餐）
  • 格式：PNG、JPEG、GIF、WebP
  • 速率限制：全球每天 100,000 次免费上传，每个 IP 每天 1,000 次
  • 无需身份验证

提示

  • UI 截图优先使用 PNG（文字清晰）。照片使用 JPEG。
  • 有意将截图控制在 1 MB 以下很值得：这决定了 URL 是永久有效，还是 30 天后过期。sips -Z 1600 通常能在不造成明显画质损失的情况下达到要求。
  • 向 PR 正文或评论添加图片时，使用 gh pr comment 或 gh pr edit，并附上图片 Markdown。

付费套餐

对于超过 1 MB 且需要永久保存的图片，请通过 x402 付款以获取令牌，然后使用该令牌上传：

# Step 1: Get an upload token
POST https://img402.dev/api/upload/token   # $0.01 USDC → permanent, up to 10MB
# → {"token": "a1b2c3...", "expiresAt": "..."}

# Step 2: Upload with the token
curl -s -X POST https://img402.dev/api/upload \
  -H "X-Upload-Token: a1b2c3..." \
  -F image=@/tmp/screenshot.png
# → {"url":"...", "expiresAt":null}   # null = permanent

POST /api/upload/token/permanent 仍然可用，价格为 $1.00 USDC——这是旧版别名，原本的功能现在只需 $0.01。新工作请勿使用它。

x402 付款由支持 x402 的客户端处理（Payments MCP tool、@x402/client 或类似工具）。参见 https://img402.dev/blog/paying-x402-apis。

公开访问

任何拥有 URL 的人都可以访问已上传的图片——提供图片时无需身份验证，而且目前大多数上传内容都会永久保存。切勿上传包含内部系统、凭据、令牌或客户数据的截图。要删除图片，请发送电子邮件至 [email protected]。

评论

支持 Markdown