🚀 免费图床神器：使用 zxgpcli 将图片上传到 GitHub 并生成 CDN 链接！
在撰写技术博客或文档时，图片管理是个常见难题。找不到稳定的图床？不想付费？担心图挂？
现在你只需一个 GitHub 账号和一个开源工具 —— zxgpcli，即可一键上传图片并获取 CDN 链接，永久免费、稳定可靠。
✨ 工具简介：zxgpcli
zxgpcli是一个命令行工具，支持将本地图片上传到 GitHub 仓库，并生成 jsDelivr 的 CDN 链接。
✅ 支持命令行交互
✅ 支持配置缓存
✅ 支持路径自定义上传
✅ 支持多种调用方式
✅ 自动返回可用链接
📦 安装方式
使用 npm / pnpm / yarn 安装：
npm install -g zxgpcli
# 或者
pnpm add -g zxgpcli
# 或者
yarn global add zxgpcli
🛠 初始化配置
首次使用，你需要配置 GitHub 仓库信息和 Token：
1. 创建仓库（推荐私有仓库）
建议新建一个仓库专门存储图片，例如：images
并创建你希望上传的子目录，例如 blog/covers、assets/icons 等。
2. 生成 GitHub Token
访问：github.com/settings/to…
选择：Tokens (Classic) → Generate new token (classic)
必须勾选权限：
- ✅
repo（全选） - ⏱ 设置有效期（可设为 90 天）
建议保存 token，因为 GitHub 不会再次显示。
3. 配置 CLI 工具
执行以下命令：
zxgpcli config --token <your_token> --owner <your_github_username> --repo <your_repo>
例如：
zxgpcli config --token ghp_xxx123456 --owner zhouxuios --repo images
📤 上传图片
你有两种方式上传图片：
✅ 推荐写法（带参数）
zxgpcli upload --file ./github-token.png --dir blog/covers
✅ 向后兼容写法（位置参数）
zxgpcli upload ./github-token.png blog/covers
上传成功后，你将看到如下输出：
✅ 上传成功: https://cdn.jsdelivr.net/gh/zhouxuios/images@main/blog/covers/github-token.png
你可直接将这个链接插入 Markdown 或 HTML 中。
🔍 查看当前配置
zxgpcli check
输出示例：
🔍 当前配置状态:
- Token: ✅ 已配置
- Owner: ✅ 已配置
- Repo: ✅ 已配置
💡 示例场景
- 博客中插入封面图或代码截图
- Notion / Obsidian 图片上传
- Markdown 文档引用图示
- 前端页面插入小图标
📁 CDN 链接说明
所有图片将托管在你配置的 GitHub 仓库中，并可通过 jsDelivr CDN 访问：
https://cdn.jsdelivr.net/gh/<owner>/<repo>@<branch>/<path>/<filename>
你可以在 GitHub 仓库中随时查看上传的图片或批量删除。
🧠 技术原理简述
zxgpcli 的核心逻辑包括：
- 使用 GitHub REST API 将文件以 base64 编码上传
- 自动拼接 CDN 访问路径
- 支持配置持久化（保存到 .zxgpclirc.json）
- 使用 Node.js + @octokit/rest 实现文件上传
📦 开源地址
👉 GitHub 源码：github.com/zhouxuios/z…
👉 NPM 包：www.npmjs.com/package/zxg…
欢迎 Star / Fork / PR！
🧩 后续计划
- ✅ 支持图片压缩（未来支持）
- ✅ 支持图片去重上传
- ✅ 多配置文件支持（多仓库）
- ✅ 图片批量上传
- ✅ 图片预览功能（web UI）
🧾 LICENSE
本工具遵循 MIT 开源协议，完全免费使用。
如果你正在寻找一款稳定好用的免费图床方案，zxgpcli 绝对值得一试！
动手试试，享受无需图床烦恼的创作自由吧。
