---
name: easy-screenshot
description: Easy Screenshot CLI:免交互矩形截屏、贴图管理、配置读写、账号状态。安装桌面版(≥0.2.0)后任意终端直接调用,无需其他依赖。
version: 0.10.0
updated: 2026-10-03
---

# Easy Screenshot CLI

截图(Snip)、标注(Annotate)、贴图(Pin)三位一体的 Windows 桌面工具。**安装桌面版后,任意终端直接使用 `easy-screenshot` 命令**,无需 Node、无需克隆仓库。

桌面版 GUI 另含(不经 CLI,自动化截屏用 `snip --rect` 等价完成):标注工具条、长截图(滚动拼接)、OCR 文字提取、二维码识别、带壳截图(设置→外壳,卡片状壳型+底部设备名标注,导出自动合成)、WebDAV 云同步(用户自配目标)。

## 安装

- 官网 skill 下载:https://pinnadash.com/assets/skills/easyscreenshot-SKILL.md
- 产品详情页/安装包:https://pinnadash.com/easy-screenshot.html

下载并安装桌面版安装包(**v0.2.0 及以上**含 CLI):

- 安装时会把 CLI 所在安装目录加入用户 PATH(新开的终端立即可用;安装前已开的终端需重开);v0.7.7 起 CLI 为独立 exe 随主程序同目录安装,旧版 cmd 垫片由安装器自动清理
- 卸载时会自动从 PATH 移除

## 命令清单

### snip — 免交互矩形截屏

```powershell
# 截取主屏 (100,200) 起 800x600 区域,保存 PNG
easy-screenshot snip --rect 100,200,800,600 --out out.png

# 全屏截图,存 JPG(质量 85)并同时复制到剪贴板
easy-screenshot snip --out full.jpg --format jpg --quality 85 --clipboard

# 只复制到剪贴板(不落盘)
easy-screenshot snip --rect 0,0,1920,1080 --clipboard
```

- `--quality` 取 1-100 整数,仅 `--format jpg` 生效,缺省 90;越界/非数字报用法错误(退出码 2)
- 输出:JSON 一行,`{"ok":true,"width":...,"height":...,"saved":"绝对路径","clipboard":bool}`;错误与诊断走 stderr

### pin — 把图片钉成置顶贴图

```powershell
easy-screenshot pin C:\path\to\image.png
```

- 有常驻实例时:通知实例用该图创建贴图,命令立即返回
- 无实例时:启动常驻进程显示贴图(关闭贴图窗口即退出)

### unpin — 关闭全部贴图

```powershell
easy-screenshot unpin --all
```

- 仅支持 `--all`;不带 `--all` 或带其他参数报用法错误(退出码 2)

### settings — 配置读写

```powershell
easy-screenshot settings get
easy-screenshot settings set --key output.jpegQuality --value 85
easy-screenshot settings set --key hotkeys.snip --value F2
easy-screenshot settings set --key behavior.launchAtLogin --value true
```

`--value` 按 JSON 解析(失败则按字符串)。可配置路径见 `settings get` 输出结构:hotkeys.{snip,pin,togglePins,toggleClickThrough}、output.{jpegQuality,namingTemplate,quickSavePath}、behavior.{cancelOnBlur,restorePinCount,historyCount,launchAtLogin,ocrEnabled,frameShot,frameShotFrame}、sync.{enabled,serverUrl,username,remoteDir}、theme(light/dark/system,顶层)、language(顶层)。

```powershell
# 例:默认带壳截图 + 壳型选卡片式 MacBook
easy-screenshot settings set --key behavior.frameShot --value true
easy-screenshot settings set --key behavior.frameShotFrame --value card-macbook

# 例:开启 WebDAV 同步
easy-screenshot settings set --key sync.enabled --value true
```

### auth — 账号状态 / 登录 / 登出

```powershell
easy-screenshot auth status
easy-screenshot auth login
easy-screenshot auth logout
```

- `auth status` 输出机器可读 JSON:`{"configured":true,"loggedIn":true,"email":"you@example.com","member":true,"plan":"yearly","degraded":false}`(`degraded=true` 表示离线宽限中)
- `auth login` 打开系统浏览器走 Pinnadash 账号魔法链接登录,完成后应用经 `easyscreenshot://` 深链自动接住;CLI 立即返回
- `auth logout` 退出登录并吊销服务端凭证

## 注意事项

- 坐标 `--rect` 为逻辑像素,基于主显示器左上角
- 交互式截图(F1 全屏选区标注)不属于 CLI:自动化场景用 `snip --rect` 参数化等价完成
- 隐私:截屏内容为屏幕实时画面,自动化批量调用时注意屏上是否有敏感窗口
- 负值参数(如 `--wm-angle -30` 类)若被误认为选项,使用等号语法 `--参数=-30`

## 从源码运行(开发者)

桌面壳为 Tauri 2(v0.6.0 起)。开发调试与 CLI 验证:

```powershell
git clone <easy_screenshot 仓库> && cd easy_screenshot
npm install
npm run tauri dev      # GUI 开发调试

# CLI 形态(C3 双 bin,2026-09-28):CLI 是独立 exe,与 GUI 同目录,直接运行不带任何标记
npm run tauri build
./src-tauri/target/release/easy-screenshot.exe snip --rect 100,100,800,600 --out out.png
```