airsnip README

项目的 README,来自 github.com/bd-dxg/airsnip。合并为一个 markdown 文件:README.md。

AirSnip(轻截)

2 MB 以内的 Windows 截图标注工具。 待机不占 CPU、常驻内存个位数 MB、按热键 0.1 秒级出画面—— 标注、二次编辑、长截图、贴图、多格式另存,功能一样不少。

纯 CPU 渲染,不依赖 GPU、不套 Electron、不装运行时。解压即用的绿色单文件,在核显迷你主机、虚拟机、远程桌面里同样流畅。

AirSnip 截图覆盖层:冻结屏幕、框选区域、底部标注工具栏

按 F1 后的样子:屏幕冻结、框选区域,底部一行就是全部标注工具。图中选中了一个矩形标注(可拖动 / 改色 / 删除),另有一条箭头。

几条硬指标

指标 表现 说明
体积 单文件 < 2 MB 绿色免安装,一个 exe 就是全部(zip 包更小)
待机内存 < 5 MB 常驻托盘时的 Private Working Set(实测 1 MB 量级)
待机 CPU 0% 事件驱动、无定时轮询,不截图时完全不占 CPU
热键 → 可用画面 ≤ 150 ms 2560×1440:抓屏 + 暗化 + 覆盖层就绪(0.1 秒级)
拖框重绘 ≥ 60 FPS 每帧个位数毫秒,16.7 ms 预算留有多倍余量

截图会话期间会按屏幕大小临时分配位图(1440p 约 15 MB),退出覆盖层立即释放——不截图时它几乎不占资源。 以上为上限口径(不会随每次发版漂移);精确数值与测量方法见 docs/perf-m5.md。

为什么能这么小: 没有 Electron / WebView / .NET 运行时,界面与标注全部由 Rust 直接绘制(tiny-skia 矢量栅格化 + DirectWrite 文字),抓屏走 GDI BitBlt,常驻部分只做「等热键」一件事。不少同类工具自带运行时或基于 Electron,安装包在数十至上百 MB、常驻内存数百 MB 量级——AirSnip 把安装包压到 2 MB 以内、常驻内存压到 1 MB 量级。

适合谁

功能

截图

标注(10 个工具,箭头支持直线与曲线)

工具栏第一个按钮是移动(指针):框选完成后的默认态。点其它按钮(或按数字键)才进入绘制。

工具 能做什么
矩形 描边颜色、线宽、线型(实线 / 虚线 / 点划线)、填充、圆角
箭头 直线或曲线(三次贝塞尔),头部随线宽缩放;Shift 吸附水平 / 垂直 / 45°
文本 中文输入法、系统全部字体、粗体 / 斜体、字号,双击再编辑
荧光笔 正片叠底半透明色块,不遮挡底图文字
高斯模糊 拖动区域即模糊,强度滚轮可调
聚光灯 选区内整体暗化、绘制区域恢复原亮,可叠加多块
序号标记 按下放圆形徽标(1、2、3…自动递增),拖出箭头指向目标;双击徽标可改编号
直线 无箭头纯线段,Shift 吸附水平 / 垂直 / 45°
椭圆 拖出外接矩形画椭圆,可填充,Shift 画正圆
手绘 按住鼠标自由涂画,点列贝塞尔平滑,颜色 / 线宽可调

曲线箭头:选中后 1/3、2/3 处出现控制柄,拖出 S 形,双击恢复直线。 矩形、荧光笔、模糊、聚光灯都支持圆角:拖包围框内侧角的小圆柄即可,所见即所得。

二次编辑

输出

长截图

贴图(Pin)

设置

快捷键

截图界面(覆盖层):

按键 动作
Enter / Ctrl+C / 选区内双击 复制到剪贴板并退出(双击可在设置里改为「贴到屏幕」)
Ctrl+S 另存为(PNG / JPEG / WebP)
Alt+S 快速保存:按路径模板直接落盘,不弹对话框(可改)
F3 把选区贴到屏幕
S 长截图(当前选区为视口,可改)
F 全屏:把鼠标所在那块显示器的整屏选上(无选区时生效,可改)
R 上次区域:复用本次运行里上次框选的区域(无选区时生效,可改)
Shift+F1 再次截图:把当前画面当作新底图重新框选(用于截取本软件界面,可改)
V 回到「移动选区」态(可改):拖选区内空白平移选区(标注跟随),拖对象移动该对象
1–9、0 切换工具(矩形 / 箭头 / 文本 / 荧光笔 / 模糊 / 聚光灯 / 序号 / 直线 / 椭圆 / 手绘,可改)
Ctrl+Z / Ctrl+Y · Ctrl+Shift+Z 撤销 / 重做
Del / Backspace 删除选中的那个标注(一步撤销可恢复,不影响其它标注)
方向键(Shift ×5) 微调选中对象;无选中时移动选区框
Shift + 拖动 正方形 / 箭头方向吸附 / 轴向锁定 / 等比缩放
按住空格 + 拖动 移动整个选区(移动态下直接拖即可,空格只是另一种按法)
滚轮 调线宽 / 模糊强度 / 字号(悬停对象或空白处)
Esc 取消截图

贴图窗口:左键拖动、滚轮缩放、Ctrl+滚轮透明度、双击 / Esc 关闭、右键菜单、Ctrl+F3 边框开关、方向键移动。

全局热键默认 F1 截图、F3 贴图,可在设置面板修改(也支持 PrtScn 这类只发松键消息的系统键);无修饰键会抢占其他程序按键,建议用 Ctrl / Alt 组合。 「再次截图」(默认 Shift+F1)只在截图过程中生效:按一下就把当前画面(含工具栏、选区、已有的标注)当作新底图重新框选,用来截 AirSnip 自己的界面。 鼠标中键与两个侧键可当截图 / 贴图 / 贴图边框键(Raw Input 订阅,不抢占其他程序):不支持鼠标 + 修饰键组合,也无需担心按键被吞。

系统要求

下载与使用

  1. 从 Releases 下载 airsnip-v*-win-x64.zip,解压到任意目录(绿色单文件,无需安装)
  2. 双击 airsnip.exe:程序需要管理员权限(否则无法覆盖管理员权限的窗口,见 ADR 0003),首次运行会弹 UAC,请选「是」
  3. 启动后托盘常驻(无主窗口),按 F1 截图 / F3 贴图
  4. 托盘左键打开设置,右键为「设置 / 退出」
  5. 配置位置:%APPDATA%\airsnip\config.toml

自动更新:启动后 3 秒静默检查一次新版本(可在设置 → 关于页关闭),发现新版本时弹托盘气泡提示;到「关于 → 版本更新」点一下即可下载并自动替换重启。清单与安装包优先走国内加速镜像,GitHub 直连兜底;清单用 ed25519 签名 + SHA-256 校验,验签不过不会安装。

首次运行提示:exe 未做代码签名,Windows SmartScreen 可能提示「已保护你的电脑」——点「更多信息」→「仍要运行」。

从旧版 jietu(v0.5.0 及更早)升级:本版改名为 AirSnip,不做自动迁移,请手动完成三件事——

  1. 删除旧的开机自启任务(管理员 PowerShell):schtasks /delete /tn jietu /f
  2. 退出并删除旧版 jietu.exe:新旧版的单实例互不排斥,同时运行会抢同一组热键
  3. 设置需重设一次(新配置在 %APPDATA%\airsnip\config.toml);旧截图仍在 图片\jietu,不会自动搬家

构建与开发

cargo run                 # 开发版(不提权,可调试)
cargo build --release     # 发布版(manifest 要求管理员权限,单文件)
cargo test                # 单测(336 项,另 7 项需 --ignored 手动触发)
cargo fmt --check         # 格式化检查
cargo deny check          # 依赖许可证 / 安全公告 / 来源检查
pwsh scripts/package.ps1  # 打包 dist\airsnip-v{版本}-win-x64.zip / .exe
pwsh scripts/gen-latest-json.ps1 -Notes "说明"  # 生成并签名自动更新清单 latest.json

技术栈:Rust 1.98(edition 2024)、windows-rs 0.62、tiny-skia 0.12(矢量栅格化)、DirectWrite(文字)、serde / toml、png / jpeg-encoder / image-webp。MSVC 运行时静态链接,exe 不依赖 VC++ Redistributable。当前版本 v0.13.0。

Star History

Star History Chart

已知限制

文档

许可

GPL-3.0-only。源文件均带 SPDX 标注;依赖均为宽松许可证(MIT / Apache-2.0 / BSD / Zlib / IJG 等),与 GPL-3.0 兼容。

感谢 LinuxDo 社区

airsnip (bd-dxg/airsnip)

正在搜索数据库…

这是什么?AirSnip 是一款用 Rust 编写的 Windows 截图和标注工具,体积略超 1 MB,空闲时 CPU 占用为 0%,按下热键后约 120 毫秒即可显示截图覆盖层。
我怎么安装并开始使用?从 GitHub Releases 下载 airsnip-v-win-x64.zip,解压到任意文件夹,然后运行 airsnip.exe。由于需要管理员权限才能覆盖管理员窗口,首次启动时会弹出 UAC 提示,之后它会驻留在系统托盘中,等待按下 F1 或 F3。
我需要先安装 .NET、Electron 或其他运行时吗?不需要。它是一个单独的原生 exe,不捆绑任何运行时;界面和标注由 Rust 直接绘制,使用 tiny-skia 和 DirectWrite,而不是 Electron 或 .NET。
有哪些已知限制我应该留意?它始终以管理员权限运行,无法截取独占全屏游戏或受 DRM 保护的内容(会显示为黑屏),目前界面仅支持中文,并且 exe 没有代码签名,因此首次运行时 SmartScreen 会发出警告。
它包含哪些标注工具?共六种工具:矩形、箭头(直线或贝塞尔曲线)、支持 IME 输入的文本、荧光笔、高斯模糊和聚光灯。所有工具都带有圆角手柄,并可对选中对象实时编辑颜色和线宽。
它能截取长页面的滚动截图吗?可以。按 S 键,以当前选区作为视口开始滚动截图;它会自动滚动、拼接重叠区域、识别重复出现的页眉和页脚,并在拼接过程中显示实时缩略图预览。
贴图功能是做什么的?按 F3 可将当前选区(连同其标注)固定为一个浮动的置顶窗口,可拖动,用滚轮调整大小,按住 Ctrl 并滚动滚轮可调节透明度;同时最多可打开 20 个贴图。
为什么它比其他截图工具小这么多?它完全不使用 Electron 和 .NET,而是用 Rust 自行绘制界面,矢量渲染使用 tiny-skia,文字渲染使用 DirectWrite,并通过普通的 GDI BitBlt 截取屏幕。正因如此,它能保持在 1.1 MB 以内,且不依赖 GPU。
作者
bd-dxg
大小
2.7 MB
星标
588
时长
1个月
提交 · 90 天