SaveImageToLink

让截图不再是一次性附件，而是放得好、找得到、能复用的本地资产。

快速开始 · 核心定位 · 源码运行 · English

核心定位

在 Windows 终端中使用 Codex 时，终端工作流通常不能像桌面聊天窗口一样直接上传截图，也不能把截图作为图片粘贴进终端输入。SaveImageToLink 提供一条本地桥接路径：

截图并复制 → 保存为本地图片 → 自动复制路径 / Markdown / file URI → 粘贴到 Codex Windows 终端

具体流程是：

1. 截图并复制到 Windows 剪贴板。
2. 通过资源管理器右键菜单或命令把剪贴板图片保存为本地文件。
3. 自动复制纯路径、Markdown 图片语法或 file:// 引用。
4. 把生成的文本粘贴到 Codex Windows 终端，让 Codex 根据本地路径读取和处理截图。

它解决的是“截图如何进入 Codex 终端工作流”，不是远程图床或独立的图片上传服务。程序只读取本机剪贴板并保存本地文件，不把图片上传到网络，也不需要绑定账号。

除 Codex 外，生成的本地引用也适用于 README、Obsidian、教程、GitHub Issue 和其他 Markdown 工作流。

为什么需要它

需求	直接上传或粘贴	SaveImageToLink
在 Windows 终端把截图交给 Codex	通常不可用或不顺手	保存本地文件并复制可粘贴引用
临时让桌面聊天窗口看见图片	直接上传更合适	不必多走一步
把图片写进 Markdown	需要手工整理	自动复制可粘贴引用
长期保存和再次使用	依赖聊天记录	文件保存在自己的目录
数据去向	可能上传到服务端	默认仅保存在本机

平台状态

平台	当前状态	系统集成
Windows 10 / 11	已实现，可打包 exe	资源管理器右键菜单
macOS 12+	源码已实现，仍需在 macOS 上完成打包验证	Finder Quick Actions

功能

• 小巧的现代设置窗口，可视化设置保存目录、文件名前缀和复制格式。
• 内置新手引导页，解释 image 文件名前缀、三种复制格式和右键保存流程。
• Windows 支持一键安装/卸载资源管理器右键菜单。
• Windows 右键菜单通过当前用户会话内的常驻 Agent 执行；Agent 登录自启、阻塞等待请求，不轮询剪贴板。
• Agent 不可用时，右键 Relay 会自动拉起并等待就绪；剪贴板读取最多重试 500ms。
• macOS 支持安装 Finder Quick Actions。
• 默认保存目录为当前用户的图片目录下 SaveImageToLink。
• 支持复制格式：纯路径、Markdown 图片语法、file URI。
• Windows exe 内置应用图标，并提供中英文快速开始说明。

Windows 使用方式

下载 SaveImageToLink-Setup-Windows-x64.exe，双击打开设置窗口：

1. 第一次使用可以先点右上角的 引导。
2. 选择图片保存目录。
3. 选择复制格式；给 Codex 终端使用时推荐 Markdown 图片或纯路径。
4. 点击 安装并启用。
5. 使用截图工具截屏，并把截图复制到 Windows 剪贴板。
6. 在资源管理器文件夹空白处打开右键菜单：
   • 保存图片到此处：保存到当前文件夹。
   • 保存图片并复制链接：保存到设置目录，同时复制图片引用。
7. 回到 Codex Windows 终端，粘贴生成的路径或引用文本。

安装后，SaveImageToLinkAgent 会在当前用户登录时后台启动。它仅监听本机回环地址、无界面且不轮询；卸载右键菜单会一并移除自启动项。

右键菜单提供两个入口：

• 保存图片到此处：保存到当前文件夹。
• 保存图片并复制链接：保存到设置目录，同时复制图片引用。

也可以使用批处理安装或卸载：

install.bat
uninstall.bat

三种复制格式

格式	示例	适合场景
纯路径	D:\Images\image-001.png	CLI、脚本、文件管理
Markdown		README、Obsidian、教程、Issue
file URI	file:///D:/Images/image-001.png	支持 URI 的工具和工作流

默认保存目录是当前用户图片目录下的 SaveImageToLink，也可以在设置中修改。

从源码运行

python -m pip install -r requirements.txt
python .\save_image.py

源码依赖 Pillow 和 CustomTkinter。发布版 exe 已包含运行依赖，普通用户不需要安装 Python。

常用命令：

python .\save_image.py --install-context-menu
python .\save_image.py --uninstall-context-menu
python .\save_image.py --save-default --copy
python .\save_image.py --save-here "D:\Images"

设置右键菜单语言：

python .\save_image.py --install-context-menu --menu-language zh-CN
python .\save_image.py --install-context-menu --menu-language en

中文版本默认注册中文菜单；英文安装流程使用 --menu-language en。菜单不会同时堆叠两种语言。

打包 Windows exe

python -m pip install -r requirements-dev.txt
.\build_exe.bat

生成文件：

dist\SaveImageToLink.exe

macOS 使用方式

macOS 源码位于 macos/。

运行设置窗口：

cd macos
python3 -m pip install -r requirements.txt
python3 save_image_to_link_macos.py --settings

安装或卸载 Finder Quick Actions：

python3 install_finder_actions.py
python3 install_finder_actions.py --uninstall

在 macOS 上打包 .app：

./build_app.sh

更完整的 macOS 说明见 macos/README.md。

隐私与本地数据

SaveImageToLink 只读取当前剪贴板中的图片，并把它保存到你选择的本地目录。当前版本：

• 不上传图片
• 不连接图床
• 不要求登录
• 不内置个人绝对路径
• 不读取或内置个人账号凭据
• 不把个人绝对路径写入发布文档
• 不在后台同步素材

%USERPROFILE%、$HOME 和测试中的示例路径仅用于运行说明或测试。

开发验证

python -m unittest test_windows_gui.py test_save_image.py test_macos_save_image.py

English

Read the English documentation in README.en.md.

License

MIT License © 2026 DOIT-Ben