编译与工具链
Q：可以用 MSVC / Visual Studio 编译插件吗？ 不可以。宿主唯一支持路线是 Qt 6.11.1 + MinGW-w64 GCC 13.1（x64）。MSVC 插件会被 PE 工具链预检拦截，返回 PlatformMismatch。
Q：必须用完全一样的 Qt 版本吗？ 是。Qt 大版本、小版本、编译器工具链都必须一致，否则 Qt 对象跨 DLL 边界会崩溃。
Q：需要手动运行 moc 吗？ 不需要，CMake 的 AUTOMOC 已处理。
*Q：插件要附带 Qt6.dll 或 MinGW 运行库吗？** 不要。宿主安装目录已统一部署，插件只交付自己的业务 DLL。
加载
Q：插件放进 plugins/ 却不加载？ 正式版开启了强制签名。未签名 DLL 会被拒绝（SignatureInvalid）。请走工坊测试通道签名，或使用开发者模式开关。
Q：提示 PlatformMismatch？ 插件不是 x64 Release，或不是用 MinGW 13.1 编译的。
Q：提示 WrongInterface？ 元数据 IID 不是 com.7aa7.toolbox.I7AA7Plugin/2.1，或没有 qobject_cast 到 I7AA7Plugin。
Q：怎么定位加载失败的详细原因？ 在「系统 → 插件管理」点「查看日志」，对照插件接口的错误码表。
网络与 AI
Q：插件能自己发网络请求吗？ 不能。必须通过 egressNetworkRequest 中继，并声明 network_access / network_domains 且取得用户授权。
Q：能用工具箱自带的 AI 能力吗？ 不能。内置 AI 属官方插件私有实现，第三方需自行申请 API-Key 并经中继访问。
分发
Q：怎么上架？ 把插件 ZIP（包内恰好一个 .dll）提交到官方插件工坊，由服务端签名后下发。
Q：支持 ARM64 吗？ 不支持。仅支持 x64 客户端。