qiniu-image-tool
是一个提升 markdown 贴图体验的实用小工具,支持windows
及 mac
。其中 qiniu-image-tool-win
为windows版本,基于AutoHotkey和qshell实现,一键上传图片或截图至七牛云,获取图片的markdown引用至剪贴板,并自动粘贴到当前编辑器。
用法
- 复制本地图片、视频、js等文件至剪贴板(ctrl+c)or 使用喜欢的截图工具截图 or 直接复制网络图片
- 切换到编辑器,ctrl+alt+v便可以看到图片链接自动粘贴到当前编辑器的光标处(同时链接也会保存在粘贴板里)
预览效果图:
- 本地图片文件上传
- 截图上传
- 其它文件上传
安装
下载源码
首先从 github 下载release版本(有两个版本:2.0 正式版
和1.0 正式版
,推荐使用2.0 正式版)并解压到任意目录
1.0 正式版 目录结构应如下:
2.0 正式版 目录结构应如下:
其中dump-clipboard-png.ps1
是保存截图的powershell
脚本,qiniu-image-upload.ahk
即完成文件上传的AutoHotkey
脚本。
安装 AutoHotkey
AutoHotkey官网下载安装最新版本,这是一款免费的、Windows平台下开放源代码的热键脚本语言,利用其通过自定义热键触发一系列系统调用从而完成自动化操作。
注册七牛账号并创建一个bucket
配置脚本
1.0 正式版配置
文件夹中选中qiniu-image-upload.ahk
文件,右键选择编辑脚本使脚本在编辑器中打开,找到下面这段代码:
;;;; config start, you need to replace them by yours
ACCESS_KEY = G4T2TrlRFLf2-Da-IUrHJKSbVYbJTGpcwBVFbz3Da
SECRET_KEY = 0wgbpmquurY_BndFuPvDGqzlnfWHCdL8YHjz_fHJa
BUCKET_NAME = fortest ;qiniu bucket name
BUCKET_DOMAIN = http://7xry05.com1.z0.glb.clouddn.com/ ;qiniu domain for the image
WORKING_DIR = E:\GIT\qiniu-image-tool-win\ ;directory that you put the qshell.exe
;;;; config end
2.0 正式版配置
文件夹中选中打开settings.ini
文件,右键选择编辑脚本使脚本在编辑器中打开,找到下面这段代码:
ACCESS_KEY = G4T2TrlRFLf2-Da-IUrHJKSbVYbJTGpcwBVFbz3Da
SECRET_KEY = 0wgbpmquurY_BndFuPvDGqzlnfWHCdL8YHjz_fHJf
BUCKET_NAME = fortest
BUCKET_DOMAIN = http://7xry05.com1.z0.glb.clouddn.com
;optional settings
UP_HOST = http://up.qiniu.com
DEBUG_MODE = false
修改这里的五个配置项的值,其中前四个配置项都与七牛账号相关:
ACCESS_KEY & SECRET_KEY
这是qshell操作个人账号的账号凭证,登陆七牛账号后在个人面板->密钥管理中查看,或者直接访问查看。
BUCKET_NAME & BUCKET_DOMAIN
在对象存储->存储空间列表
中选择或新建一个存储空间即bucket
,点击该bucket
在右边看到一个测试域名,该域名即bucketDomain是图片上传后的访问域名。这里要特别注意域名不要少了前面的 ***http头 *** 和最后的那个 斜杠。
WORKING_DIR
这是设置您的工作目录,即这些脚本所在的目录,比如我将从github上下载的release压缩包解压到了E:\TOOLS
目录下,那我的WORKING_DIR
就是 E:\TOOLS\qiniu-image-tool-win\
。注意不要少了最后那个反斜杠 。另外需要特别注意的是路径中不能包含中文,而且不能有类似Program Files这类包含空格的路径。
运行脚本
1.0 正式版运行
至此所有的安装和配置过程都结束了,右键点击 qiniu-image-upload.ahk
文件选择运行脚本(Run Script
),这时便可以在任务栏看到一个H字母的绿色图标在运行。这时便可以使用ctrl+alt+v
尝试上传图片了。
2.0 正式版运行
配置完成以后以管理员身份运行qImage.exe
,这时便可以使用ctrl+alt+v
尝试上传图片了。
调试
如果以上操作完成后没有按照预期达到图片上传的效果,感兴趣的筒子可以先自己调试找一下原因,一般报错信息会打印在cmd命令行中,但是cmd窗口一闪而过可能看不清楚,这时候将可选参数DEBUG_MODE = false
改为DEBUG_MODE = true
打开调试模式,再次尝试,这时候cmd窗口不会自动关闭,便可以看到具体的报错信息从而对症下药解决问题。
修改默认项
以下操作非必需,是对一些默认设置的修改,请根据喜好自行选择。
修改快捷键
脚本中默认的快捷键是^!V
,即ctrl+alt+v
(^代表ctrl,!为alt),如果您希望修改为其它自己习惯的快捷键,直接修改并reload脚本即可生效。
关于hotkey
的符号与按键对应关系请参考 You can use the following modifier symbols to define hotkeys
常见问题
参照: