本插件专为子比主题设计，解决虚拟商品自动发货场景下，商品手工库存与卡密池库存相互独立的问题。通过自动同步和统一计算有效库存，实现防超卖、精准管控，并支持多规格独立绑定与后台可视化管理，让库存管理更高效可靠。
插件简介：子比商品库存绑定优化插件
本插件针对子比主题虚拟商品自动发货场景中，“商品手工库存”与“卡密/邀请码池可用数量”相互独立的问题，补全两者联动能力，实现统一库存管理。主要功能特点如下：
1. 库存联动与有效库存计算
- 绑定商品（含多规格）的手工库存基线与对应卡密池或邀请码池的可用数量。
- 有效库存：自动取“手工库存基线”与“卡池可用数量”的最小值，实时同步到商品配置，确保前端展示和下单校验使用统一库存。
2. 多规格细粒度绑定
- 支持按商品规格分别绑定不同卡密池或邀请码池，每个规格可独立设置库存基线和绑定备注。
- 自动识别子比主题中的“自动发货”配置（卡密或邀请码），无需额外配置，开箱即用。
3. 订单生命周期自动同步
- 监听订单创建、关闭、退款等事件，自动扣减或回补手工库存基线，重算有效库存。
- 前端动作（购物车添加、下单确认、商品页加载等）触发时，实时同步商品运行时库存，保证数据最新。
4. 后台管理面板
在 WordPress 设置菜单中新增“子比工具”页面，包含三个标签页：
- 设置：全局启用/禁用库存绑定功能及商品编辑页库存提示。
- 卡密列表：汇总所有已绑定库存的商品规格，展示卡池可用数、待支付占用数、手工基线、有效库存，支持分页和详情查看（含待支付订单明细）。
- 日志：记录设置变更、库存同步等操作，便于排查问题，支持清空日志。
5. 商品编辑页增强提示
- 在商品编辑侧边栏增加“卡密库存提示”元数据框，显示该商品各规格的绑定类型、卡池可用、待支付占用、手工基线和最终有效库存，帮助管理员快速了解库存状态。
6. 诊断与兼容性
- 内置诊断功能：扫描所有商品，识别配置了自动发货但未正确绑定卡密/邀请码池的商品，并给出原因说明。
- 自动检测子比主题相关函数和类的存在性，未满足条件时自动降级，避免报错。
- 支持邀请码的“自动生成”模式（
auto_add）：该模式下不限制卡池数量，有效库存完全由手工基线决定。
7. 性能优化
- 对后台卡密列表查询结果进行缓存（5分钟），减少重复计算，提升加载速度。
- 使用静态缓存和全局变量缓存商品配置、库存状态，避免重复数据库查询。
适用场景
适用于子比主题中使用“卡密”或“邀请码”作为虚拟商品自动发货方式的站点，需要实现商品库存与发卡池库存统一控制，防止超卖或库存不同步问题。
