7AA7 / 开放文档
返回首页

概览

更新于 2026-10-12
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外部导入仅开放公共安全接口,敏感能力需用户显式授权
正式版客户端启用强制签名:未经官方工坊签名的第三方插件无法加载。详见签名与分发。

文档导航

  1. 快速开始 —— 跑通 SDK 自带 Demo;
  2. 编译规范 —— 工具链、工程模板与自检清单;
  3. 插件接口 —— I7AA7Plugin 与元信息结构;
  4. HostApi 参考 —— 宿主对外开放的全部安全 API;
  5. 安全红线 —— 必须遵守的边界与禁区;
  6. 签名与分发 —— 如何上架插件工坊。