Repository navigation
Releases
Releases · explorer-exe-bilibili/Plugin-shot
Plugin-shot 0.1.0 · 一句话加功能
Plugin-shot 0.1.0:一句话,给截图工具加个功能
万物皆插件的截图工具,也是一个能用一句话写插件的截图框架。
缺什么功能,跟 DSH(DeepSeek Harness)说一句:它下载离线 SDK、生成工程、写代码、编译,用宿主 --test-plugin 在隔离环境里自检,再经你同意把 DLL 装进 plugins/。不用宿主源码,不用 vcpkg。
0.1.0 首发包上线后暴露了一批问题;当前资产为修复版,已重新打包并复测(
--help/--capture/--test-plugin)。
一句话是怎么发生的
- 在 DSH 里安装
dsh-plugin-shot-dev/(设置 → 插件 → 添加插件 → 选择目录;需要 DSH 0.2.x)。 - 对 DSH 说清楚想要什么,例如“每次截图后在图片右下角加时间水印,字号可配置”。
- DSH 判断能力 → 下载 SDK → 脚手架生成工程 → 写代码、配置项、中英文案。
cmake编译 +Plugin-shot.exe --test-plugin <dll> --json-out report.json自检;PASS 后再交付。- 你确认后 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/。
相关文档
- 插件开发手册:https://github.com/explorer-exe-bilibili/Plugin-shot/blob/main/document/AUTHORING.md
- 自检:https://github.com/explorer-exe-bilibili/Plugin-shot/blob/main/document/PLUGIN_TEST.md
- SDK:https://github.com/explorer-exe-bilibili/Plugin-shot/blob/main/document/README_SDK.md
- Linux 编译:https://github.com/explorer-exe-bilibili/Plugin-shot/blob/main/document/BUILD_LINUX.md