图床管理与图片工具
管理自己的图床，处理图片，把链接带回文章。
原生桌面应用、独立 CLI 与 Agent Skill，支持 macOS、Windows 和 Linux。
下载桌面版 · 下载 CLI · 官网 · 文档 · English
img 使用 Rust 构建，桌面端采用 GPUI，内置同版本 CLI。桌面上传、编辑器集成和自动化任务共享存储配置与图片处理能力；独立 CLI 无需启动桌面应用或安装语言运行时。
- 快捷上传：支持文件、剪贴板、截图和外链导入。快捷键可直接上传，完成后自动复制 URL、Markdown 等格式的链接。
- 自有存储：连接 R2、S3、OSS、GitHub、WebDAV 或 HTTP 图床，沿用现有存储和公开域名，支持按项目选择存储源。
- 统一图库：索引图床已有图片，与新上传记录一起搜索、预览和管理。支持跨搜索多选、批量复制、下载和明确确认后的远端删除；清理缓存不会清空图库。
- 独立图片工具：转换与压缩、尺寸与裁剪直接位于侧边栏。处理 PNG、JPEG 和静态 WebP，预览实际输出大小，直接保存、复制或上传；无需先配置图床。
- 迁移与文章维护：复制图片到另一个图床，验证后生成新旧链接映射；逐文件预览 Markdown 修改，备份后替换。默认保留源端图片，失败项可重试。
- 跨设备同步：用自己的 WebDAV 或 S3 同步配置、索引和预设，桌面与 CLI 共用本机数据。缓存图片不参与同步；同步的图床凭据不额外加密。
- 自动化接口：原生 CLI 提供 JSON 输出、逐文件结果和退出码，配套 Skill 支持 AI Agent 调用。
0.4 使用指南介绍统一图库、同步、图片工具和文章修复。PicGo / PicList 配置导入、重复图片复用、链接诊断、备份恢复和目录监听见工作流说明。
从安装页下载最新稳定版。桌面安装包包含 CLI，也可单独下载命令行版本，无需从源码编译。
| 系统 | 桌面版（包含 CLI） | 独立 CLI |
|---|---|---|
| macOS 13+ | Apple silicon / Intel · DMG、ZIP | ARM64 / x64 |
| Windows 10/11 | x64 · EXE 安装向导、便携 ZIP | x64 |
| Ubuntu 24.04 / Debian 13+ | x64 · DEB | Linux ARM64 / x64 |
安装包由 GitHub Actions 在各平台构建、测试并发布，附 SHA-256 校验文件。全部发行版本 · 实际验收记录
社区包首次打开与平台说明
- macOS 社区版未经过 Apple 公证。确认下载来源后，可在「系统设置 → 隐私与安全性」选择「仍要打开」。完整安装说明
- Windows 社区包未进行代码签名。Linux GUI 需要图形桌面、Vulkan 驱动和已解锁的 Secret Service。
- Linux 全局快捷键需要 X11，Wayland 可使用窗口入口；截图需要系统截图工具。Windows 当前截图为全屏。macOS 提供菜单栏后台上传。
- 「设置 → 关于与更新」检查并下载校验后续版本，升级保留配置与图库。独立 CLI 可重新运行安装器升级。
- 安装并打开 img，在「存储源」添加图床，设为默认。
- 复制一张图片，按下快捷键直接上传。
- 上传成功后粘贴链接。在设置中选择 Markdown、URL 等输出格式。
| 快捷操作 | macOS | Windows / Linux X11 |
|---|---|---|
| 上传剪贴板并复制链接 | ⌘⌥U |
Ctrl+Alt+U |
| 截图上传并复制链接 | ⌘⌥S |
Ctrl+Alt+S |
也可从窗口选择文件、粘贴图片或添加外链，确认队列后点击上传。
从安装页下载独立 CLI，或在桌面版「关于与更新」中添加终端命令：
img init # 连接自己的图床
img photo.png --format markdown --copy # 上传并复制 Markdown 链接
img upload a.png b.jpg --format json # 批量上传，供脚本读取
img rewrite article.md --stdout # 转存文章图片，输出改写后的 Markdown上传示例输出（地址取决于你的存储配置）：
Cloudflare R2 / OSS / GitHub 配置示例 · 完整命令与配置手册
CLI 可独立用于脚本、编辑器和 AI Agent。使用 JSON 输出读取每张图片的上传结果，结合退出码处理失败；批量上传部分失败时，成功链接仍会返回。
img upload ./assets/chart.png --format json --no-copy配套的 img-uploader Skill 提供上传、图片处理、图库查询、同步状态和迁移预览流程。支持 Agent Skills 且具备本地命令执行能力的助手，可通过 Skill 将截图或图表上传并引用到文档中。
npx skills add liyown/img --skill img-uploader使用前需安装 CLI；上传前配置存储源，本地图片处理无需图床配置。凭据沿用本地配置，无需写入提示词。Skill 使用说明 · JSON 输出与退出码
| 场景 | 接入方式 |
|---|---|
| Markdown 写作 | 截图上传后自动复制图片链接 |
| Typora | 自定义上传命令：img "${filepath}" |
| Obsidian | 运行 img serve，通过 Image Auto Upload 插件连接 PicGo 兼容服务 |
| 文章迁移 | img rewrite 批量转存图片并替换引用 |
| AI Agent | 安装 Skill，通过 CLI 获取结构化上传结果 |
集成示例 · Agent Skill · GitHub Action
使用已有存储服务时，在 img 中添加对应配置，验证上传与公开 URL 后，将编辑器的上传入口指向 img。更换客户端不影响已有文章链接。
支持导入 PicGo / PicList 的存储配置，并预览支持项及冲突；导入不会运行原客户端的插件。PicGo 历史记录导入不在支持范围内。详见迁移与管理指南。
Cloudflare R2 · S3 兼容服务 · 阿里云 OSS · GitHub 仓库 · WebDAV · 自定义 HTTP 接口
支持 PNG、JPEG、GIF、WebP、SVG、AVIF。可以为不同项目选择不同存储源，配置默认输出格式与图片处理选项。存储配置指南
遇到问题，欢迎提交系统版本、img 版本和复现步骤；请勿附上存储密钥。报告问题或提出需求
git clone https://github.com/liyown/img.git
cd img
cargo test --locked --workspace