Skip to content

Releases

Plugin-shot 0.1.0 · 一句话加功能

Choose a tag to compare

@explorer-exe-bilibili explorer-exe-bilibili released this 14 Nov 12:28

Plugin-shot 0.1.0:一句话,给截图工具加个功能

万物皆插件的截图工具,也是一个能用一句话写插件的截图框架。

缺什么功能,跟 DSH(DeepSeek Harness)说一句:它下载离线 SDK、生成工程、写代码、编译,用宿主 --test-plugin 在隔离环境里自检,再经你同意把 DLL 装进 plugins/。不用宿主源码,不用 vcpkg。

0.1.0 首发包上线后暴露了一批问题;当前资产为修复版,已重新打包并复测(--help / --capture / --test-plugin)。

一句话是怎么发生的

  1. 在 DSH 里安装 dsh-plugin-shot-dev/(设置 → 插件 → 添加插件 → 选择目录;需要 DSH 0.2.x)。
  2. 对 DSH 说清楚想要什么,例如“每次截图后在图片右下角加时间水印,字号可配置”。
  3. DSH 判断能力 → 下载 SDK → 脚手架生成工程 → 写代码、配置项、中英文案。
  4. cmake 编译 + Plugin-shot.exe --test-plugin <dll> --json-out report.json 自检;PASS 后再交付。
  5. 你确认后 DLL 进 plugins/,重启或截一张验收;卸载就是删 DLL。

两个真实 demo(原话 → 插件)

用户原话 插件 形态 自检
“每次截图后,在图片右下角加上拍摄时间水印。” demo.watermark shot.image_processor + 配置项;纯标准库,不依赖 OpenCV PASS 22 / FAIL 0 / SKIP 3
“截图保存后自动按日期归档到「年-月-日」文件夹。” demo.archive 订阅 capture.done 的 Generic 插件 + worker 线程 PASS 15 / FAIL 0 / SKIP 5

源码、配置项、中英文案、构建脚本、README 都在 SDK 的 demos/ 里。

离线 SDK 与自检

  • 核心包 0.9 MB:契约头(ABI 2.0)、shot_plugin_helpers、构建规则、11 份文档、4 个模板、2 个 demo、DSH 技能。SDK 自带 nlohmann-json 与 stb,不装 vcpkg、不 find_package 就能编译。
  • OpenCV 叠加包 13 MB:只有源码里 #include <opencv2/...> 才需要;解压 opencv/ 到核心 SDK 根。
  • --test-plugin:真实宿主加载路径(metadata → 依赖 → LoadLibrary → ABI → create → 能力包装)在隔离数据目录里检查加载状态、能力调用、配置回写回读、列表贡献、事件派发;输出 PASS/FAIL/SKIP + JSON(退出码 0/1/2)。
  • 安装门槛:插件与宿主同进程、用户权限;技能默认只生成/编译/自检,安装前必须用户确认。

下载

资产 大小 SHA-256
Plugin-shot-0.1.0-win64.zip 6,803,044 B 96485e014bf978849f0ad4ef736d4f6b29fb8a204bd84e762c77fe1fdc68aa91
plugin-shot-sdk-0.1.0-win64.zip 954,890 B cd9f6a239dd10a93c4f11df191224c2ec8de81176e4955e69995764c9394a0f6
plugin-shot-sdk-0.1.0-win64-opencv.zip 13,502,785 B 22ff0ab921fbfd70ff8e8872ea4a9b2c8573425a400b1ee5194e528126096e30

每个 zip 都有同名 .sha256(sha256sum -c / Get-FileHash 可直接校验)。宿主包解压后运行 Plugin-shot.exe,已内置 VC++ 运行库。

验证

  • Windows 11:宿主包 --help / --capture 退出 0;--test-plugin example_processor.dll 退出 0,PASS 34 / FAIL 0 / SKIP 3;versionFull = 0.1.0.190、Release/x64。
  • 两个 demo 均在真机装进宿主验证过效果(水印 / 日期归档)。
  • Linux:Ubuntu 24.04(X11)/ Ubuntu 26(Wayland,单显示器)核心链路已真机验证;本版本不提供 Linux 预编译包,按 document/BUILD_LINUX.md 从源码构建。

能做什么 / 不能做什么

能一句话:截图后改像素(时间水印、边框、调色、模糊、马赛克、缩图);截图后做别的事(按日期归档、复制路径、通知、跑命令、转格式另存);改保存目录/格式/命名/质量;加托盘菜单、功能热键、设置项;把 OpenCV 等运行库带进进程。

不能一句话:录屏/动图/多帧(契约单帧);OCR/人脸/标注编辑器(需要模型或重型 UI);上传到图床/网盘(需要地址、凭据、重试策略);改采集/区域/多屏/热键注册逻辑、新增 ABI 能力(必须改宿主源码)。

平台与限制

  • 预编译包:Windows 10/11 x64;Linux 已验证、源码构建;macOS 未验证。
  • 官方离线 SDK:目前只有 win64;Linux SDK 是 P1。
  • 长截图(Windows)是实验特性,默认在插件列表里禁用。
  • 仍未验证:X11 多显示器 / 多 X screen / 负坐标;Wayland 窗口悬停(协议限制);macOS 全部。

许可

Apache-2.0。第三方组件许可见 NOTICE 与包内 THIRD_PARTY_LICENSES/。

相关文档