套餐限制提示排查指南：快速区分功能版本限制、账号/成员配额已满与7天试用到期状态

概览

WAthink 以多租户 SaaS 方式运行，因此每一项高级能力都由工作区的套餐门控。强制在服务端分层完成 — 在界面上隐藏按钮从来不是真正保护功能的手段。三层共同发挥作用：

• 上下文内校验 — 发生受限操作时，代码在唯一的地方询问「这里允许吗？」。
• 整页门控 — 以声明方式保护整个功能页面。
• 试用门控 — 免费试用到期后的硬性拦截。

升级提示与小型高级标识读取与服务器完全相同的套餐数据，因此界面显示的内容与服务器允许的内容绝不会不一致。

有效套餐的解析

每个门控最终都问同一个问题：这个工作区的有效套餐是否允许该操作？答案按固定顺序解析：

1. 按工作区覆盖。如果管理员为该工作区设置了自定义值，则以它为准 — 无论限额还是功能开关。
2. 套餐。否则取值来自工作区的套餐。
3. 回退。如果两者都未定义（例如套餐尚未更新的新设置），使用安全默认值。

WAthink 无论套餐如何保存都能可靠地查询到它，并在本次请求的剩余时间内记住结果，避免重复计算。

账号范围 vs. 按工作区计费。默认情况下，每个工作区按自己的套餐计费。如果管理员在 Admin → Settings → General 下把计费切换为账号范围（account-wide），则所有者名下所有工作区中最优的付费套餐会应用到每一个工作区 — 因此购买一个付费套餐即可解锁整个账号，避免撞上第二次试用门控。

上下文内校验（计数与功能）

凡是发生受限操作的地方，代码都会先就地校验套餐，然后才放行。它可以：

• 校验计数限额 — 达到套餐限额后拦截（因此当你要创建的那一个会超限时就会阻止你）。限额为零或未设置表示无限制。
• 校验功能开关 — 如果套餐不包含该功能则拦截。

被拦截时，应用或自动化调用方会收到清晰的「已达上限」错误响应；普通页面提交则会带着升级提示返回。

这些上下文内校验覆盖没有独立页面的功能 — 例如看板视图、消息表情回应与编辑、内部备注、轮播模板、使用自己的 AI 密钥、营业时间与滴灌营销活动。它们恰好在操作发生的位置强制执行。

整页门控

拥有独立页面的功能在页面级别受到保护。一个页面可以要求一项或多项功能（若为多项，套餐必须全部包含）。功能缺失时的行为取决于用户想做什么：

付费墙与皇冠标识

两个屏幕元素把缺失功能变成升级提示，且二者读取与服务器完全相同的套餐数据：

• 付费墙 — 覆盖在受限页面上的上滑面板。它会加载实际包含你所需功能的套餐，让你不必离开页面就能选择并结账。
• 皇冠标识 — 当前套餐未包含的功能旁显示的小金冠。点击它会带你到账号的 Plans 页面。

这一页面级门控覆盖拥有独立页面的功能 — 营销活动、广播、流程、AI 助手与训练、商店、数据分析、集成等。没有独立页面的功能则如上所述在上下文内校验。

试用门控

这是免费试用过期后的硬性拦截。一旦工作区的免费试用用完，用户不能再使用任何功能：打开功能页面会把用户带到 Plans 页面并显示警告（对应用 / 自动化请求则返回「需要付款」响应并附升级链接）。功能仍出现在菜单中（让用户看到购买套餐能解锁什么），但打开或保存都会被拦截。

为避免用户被困住，试用过期时以下区域始终保持可达：

• 账号、套餐、个人资料、计费与发票
• 结账与付款确认（以便付款）
• 支持工单、邮箱验证与上手步骤
• 切换到另一个（未过期）工作区，以及登出
• 公开的营销与定价页面

设计上故障开放（Fails open）。如果试用门控内部出现任何问题，请求会被放行而不是拦截 — 因此门控的 bug 永远不会意外锁死整个应用。付费套餐以及没有到期日的免费套餐永远不会「过期」，因此门控对它们不做任何事。

管理员绕过

平台管理员永远不会被自己的产品拦截。三层强制遵循同一规则：拥有 Super Admin 或 Admin 角色的用户绕过所有校验。

建议：管理员绕过范围很广 — Super Admin 与 Admin 角色会覆盖所有套餐限额与试用门控。请只把这两个角色授予真正运营平台的人员。日常工作中应使用权限更窄的 Platform Support 或 Auditor 角色，这样即使账号被攻破，也无法悄悄进行无限量发送。