xnx_invite 邀请注册

功能

• 邀请码注册：两种模式 — 可选（无码也能注册）/ 强制（必须填写邀请码）

• 邀请码可配置长度、有效期、最大使用次数（支持多次使用码，用完自动失效）

• 邀请奖励：邀请人与被邀请人均可配置积分或金币奖励，通过 CreditsService 发放

• 购买邀请码：扣减积分/金币生成新码，受最大持有数（max_hold_count）上限控制

• 新用户注册自动生成初始邀请码；老用户首次进入邀请中心自动补发初始码（幂等）

• 邀请中心前台：有效/失效邀请码列表、邀请统计、专属邀请链接、最近邀请记录、邀请排行榜

• 邀请成功后向邀请人发送站内通知（notify_create）

• 后台管理：邀请码列表（按码/用户名/状态筛选）、邀请记录列表（按码/邀请人/被邀请人/IP C 段/日期范围筛选）

• 邀请排行榜（300s 缓存，聚合查询）、最近邀请记录（60s 缓存）

• 接入发现页（DiscoverService）配置

文件结构

plugin/xnx_invite/
├── conf.json
├── install.php / uninstall.php
├── setting.php + setting.htm
├── model/InviteService.php
├── route/
│   ├── center.php
│   └── api.php
├── hook/
│   ├── index_route_case_end.php
│   ├── header_nav_admin_page_after.htm
│   ├── user_create_password_after.htm
│   ├── user_create_post_start.php
│   ├── user_create_post_end.php
│   ├── index_side_after.htm
│   ├── my_end.htm
│   └── lang_zh_cn_bbs.php
├── view/htm/invite_center.htm
└── lang/zh-cn.php

配置流程

1. 后台启用插件

2. 进入「插件设置」→ 选择注册模式（可选/强制）、邀请码长度/有效期/最大使用次数

3. 配置邀请奖励（邀请人/被邀请人的积分或金币数额），按需开启「购买邀请码」并设置价格与持有上限

4. 测试：用户注册时填写邀请码（强制模式必填）→ 注册成功后自动发奖并通知邀请人；登录用户访问「邀请中心」查看邀请码与统计