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 — это инструмент для Windows для создания скриншотов и аннотаций, написанный на Rust. Весит чуть больше 1 МБ, в простое использует 0% процессора, а оверлей с захватом появляется примерно через 120 мс после нажатия горячей клавиши.
Как установить и начать пользоваться?Скачайте airsnip-v-win-x64.zip с GitHub Releases, распакуйте в любую папку и запустите 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 МБ и не зависит от видеокарты (GPU).
Какие есть похожие проекты?quickscan, gyotaku, snow-shot, Meltype, ShareX, TranslucentTB, tendedero, lightcraft
Автор
bd-dxg
Размер
2.7 MB
Звёзды
588
Возраст
1 мес
Коммиты · 90 дней