github-image-hosting

该 Skill 为 GitHub 协作场景提供了轻量级图片托管解决方案，打通了本地截图、临时图床与 GitHub 平台的完整工作流。

核心用法：开发者可通过命令行工具链（screencapture/sips + curl + gh CLI）实现"截图→验证→上传→嵌入"的一站式操作。工作流程包括：使用 screencapture 捕获屏幕，通过 sips 压缩至 1MB 以内，调用 curl 上传至 img402.dev 免费接口，最后利用 gh CLI 将返回的图片 URL 嵌入 PR 描述或 Issue 评论中。整个过程无需打开浏览器或登录账号，命令行内即可完成。

显著优点：首先是零门槛接入，免费层无需注册认证，直接通过 curl 上传即可获取外链。其次是与 GitHub 生态深度集成，gh CLI 支持直接编辑 PR 正文或添加评论，无需手动复制粘贴 Markdown 语法。再者是场景适配性强，7 天的临时存储周期恰好匹配代码审查的时间窗口，既满足协作需求又避免了长期维护图床链接的负担。此外，文档提供了完整的 macOS 工具链示例，从截图到压缩都有现成命令参考。

潜在局限：主要限制在于数据持久性——免费层图片仅保留 7 天，不适合用于长期文档或 README 的永久插图。文件大小限制 1MB 对高清设计稿可能不足，需要额外的压缩处理。此外，服务依赖 img402.dev 的可用性，存在第三方服务中断或变更条款的风险。目前示例代码主要针对 macOS，Linux/Windows 用户需要自行适配截图工具。

适用人群：主要面向开源项目维护者、需要进行代码审查的开发者、以及频繁使用 GitHub Issues 进行 Bug 报告和视觉反馈的技术团队。特别适合敏捷开发中快速分享 UI 截图、错误提示或架构草图的场景。

使用风险：首先是数据隐私风险，上传至第三方服务可能导致敏感信息泄露（如截图中包含 API 密钥或内部数据），建议上传前进行内容审查。其次是服务可用性风险，依赖外部 API 意味着若 img402.dev 服务中断或域名变更，历史 PR 中的图片可能失效。此外，虽然 Skill 本身为纯文档型，但用户手动执行的命令涉及本地文件读取和网络上传，需确保执行环境可信，避免路径注入等操作风险。

核心用法

github-image-hosting 是一套面向 GitHub 协作场景的纯文档型 Skill，指导用户通过 img402.dev 免费图床快速上传图片并嵌入 PR、Issue 或评论中。工作流程简洁：获取截图 → 校验/压缩至 1MB 以下 → 通过 curl 上传 → 获得 HTTPS 直链 → 使用 gh CLI 嵌入 GitHub Markdown。

显著优点

1. 零门槛使用：无需账号注册、API Key 或支付，1MB 以下图片直接拖拽或命令行上传，1000 次/天的全局额度对个人用户充足。
2. GitHub 原生集成：与 gh CLI 深度配合，支持一键追加到 PR 描述、评论或 Issue，符合开发者日常workflow。
3. 隐私友好：上传行为由用户主动触发，服务方仅临时存储图片文件，无跟踪脚本或社交登录绑架。
4. 安全透明：纯 Markdown 文档，无实际可执行代码，外部调用仅涉及 img402.dev 的 HTTPS 端点，通过 T2 来源认证。

潜在缺点与局限

• 7天自动过期：免费 tier 图片仅保留 7 天，不适合需要长期归档的文档场景；如需永久存储需切换至付费 tier（$0.01 USDC/张，1 年有效期）。
• 单文件 1MB 限制：高分辨率 UI 截图或设计稿易超限，需预先用 sips -Z 1600 等工具压缩，增加一步手动操作。
• 第三方服务依赖：img402.dev 若发生服务变更或域名屏蔽，Skill 将失效，且开源项目无 SLA 保障。
• 无批量管理能力：上传后无账户面板查看历史图片，丢失 URL 即无法找回，依赖用户自行记录。

适合人群

• 频繁在 GitHub PR Review 中贴截图的开发者与设计师
• 需要快速分享临时 mockup 或诊断日志图片，但不想注册图床账号的敏捷团队
• CI/CD 场景下自动生成报告截图并附加到 PR comment 的自动化脚本作者

常规风险

• 链接失效风险：7 天过期可能导致历史 PR 中的图片变成死链，影响后续审计追溯。
• 敏感信息误传：用户可能不慎将含内网 IP、密钥片段的截图上传至公网图床，虽传输加密但存储在第三方服务器。
• macOS 独占工具：文档示例大量依赖 screencapture 与 sips，Linux/Windows 用户需自行寻找替代方案。