7AA7 插件体系让第三方开发者为「7AA7 工具箱」扩展能力:插件以独立 DLL 交付,经官方工坊签名后在客户端内安全加载运行。
这是什么
7AA7 工具箱是一款 Windows 本地优先的桌面效率工具。除内置功能外,它提供一套插件接口(Plugin SDK),允许开发者用 C++ / Qt 编写插件,把自定义功能挂载到工具箱的「功能分类 → 插件中心」下。
- 产品名称:7AA7 工具箱插件体系(7AA7 Plugin SDK)
- 宿主:7AA7 工具箱桌面客户端(官网 EXE 版 / 微软商店 x64 版)
- 接口版本:
com.7aa7.toolbox.I7AA7Plugin/2.1 - 工具链:Qt 6.11.1 + MinGW-w64 GCC 13.1(x64 Release)
- 交付物:单个
插件名.dll
插件能做什么
插件继承宿主公开接口 I7AA7Plugin,即可获得一个由工具箱托管的独立界面,以及一组受控的宿主能力:
| 能力 | 接口 | 说明 |
|---|---|---|
| 自定义界面 | getPluginWidget() | 返回一个 QWidget,嵌入工具箱内容区 |
| 私有配置 | getPluginConfig / setPluginConfig | 按 pluginId 隔离的键值持久化 |
| 沙箱文件 | pluginDataDir | 只能写自己的 plugins/data/<id>/ |
| 文件对话框 | chooseOpenFile / chooseSaveFile | 与宿主统一风格的导入导出 |
| 诊断日志 | logPlugin | 统一写入工具箱诊断日志 |
| 网络中继 | egressNetworkRequest | 唯一合法出网通道(加密中继) |
| 托管线程 | createManagedThread | 由工具箱统一管理的后台线程 |
加载流程
宿主在加载插件时依次执行:PE 工具链预检 → IID 匹配 → 版本校验 → 接口转换 → 数字签名校验。任一环节不通过,插件都会被拒绝加载,并给出对应的诊断错误码(见插件接口)。
信任分级
| 分级 | 来源 | 能力 |
|---|---|---|
Official | 官方内置 / 已签名 | 默认可中继网络等敏感能力 |
ThirdParty | 外部导入 | 仅开放公共安全接口,敏感能力需用户显式授权 |
正式版客户端启用强制签名:未经官方工坊签名的第三方插件无法加载。详见签名与分发。