名片管理配置使用教程
一、功能主界面与改名总开关
页面顶部为改名功能总控开关，勾选对应选项即可启用对应能力：
- 入群改名：新成员入群时，自动按照设定格式修改群名片
- 改名提示：修改成员名片时，自动发送改名通知消息，告知成员名片变动
- 发言改名：成员发言时自动检测并修正名片格式，确保存量成员名片也符合规范
- 过滤字符：自动过滤名片中的特殊符号、违规字符，净化昵称格式
- 名片锁定：锁定成员群名片，成员无法自行修改，仅系统可调整名片内容
二、名片格式自定义配置
支持按性别区分设置三套名片格式，格式内可插入系统变量，自动替换为成员对应账号信息。
1. 格式分类
- 格式-男：性别为男的成员，自动套用该名片格式
- 格式-女：性别为女的成员，自动套用该名片格式
- 格式-人妖：性别识别为未知/其他的成员，自动套用该名片格式
- 系统默认示例格式：
[会员级别]-[昵称]
2. 内置变量说明
格式中支持插入多种系统变量，自动匹配成员账号信息，常用变量参考如下：
| 变量名 | 功能说明 | 获取失败返回值 |
|---|---|---|
[昵称] |
调用成员QQ原昵称 | 无 |
[性别] |
调用成员QQ设置的性别 | 未知 |
[年龄] |
调用成员QQ填写的年龄 | -1 |
[城市] |
调用成员资料填写的所在城市 | 空 |
[会员级别] |
调用成员会员身份，返回SVIP/VIP/普通用户 | 普通用户 |
提示：变量需严格保留
[]括号格式，自定义文字与变量可自由组合，例如【VIP】[昵称][城市]-[昵称]
三、昵称截取设置
1. 截取昵称
填写数字，设置从原昵称中截取的字符长度，填写0代表不截取，保留成员完整原昵称。
2. 截取QQ位数
设置名片中QQ号的截取展示规则，填写0代表不截取、完整展示，具体规则示例：
- 仅展示前4位：填写
4 - 仅展示后4位：填写
|4 - 展示第1位到第3位（截取中间片段）：填写
1|3
四、违规昵称检测
自动检测成员群名片中的违规关键词，命中后自动处理，拦截广告、违规类昵称。
1. 违规检测开关
- 昵称检测：勾选开启后，系统按间隔轮询检测所有成员名片中的违禁词
- 踢出违规：勾选开启后，检测到名片含违禁词时直接将成员踢出群聊；不勾选则仅自动修改为统一违规名片
2. 违禁词
填写需要拦截的违规关键词，多个关键词用空格分隔，名片中包含任意词汇即判定为违规。
3. 检测间隔
填写数字，单位为秒，设置违规昵称的轮询检测频率，示例默认60分钟检测一次。
4. 统一名片
设置违规昵称的统一替换名称，检测到违规名片后，自动将其群名片修改为该内容，系统默认示例为违规名片。
五、改名提示语自定义
可自定义名片变动时的通知文案，支持内置变量动态替换内容：
[QQ:A-Q]：自动@对应成员[原名片]：替换为修改前的旧名片内容[新名片]：替换为修改后的新名片内容
系统默认模板示例：
===== 名片变动 =====
QQ 号码: [QQ:A-Q]
原名片: [原名片]
新名片: [新名片]
六、保存配置与配置示例
所有参数设置完成后，点击页面右上角保存配置，所有规则立即生效。
通用社群配置参考
- 改名开关：勾选「入群改名」「改名提示」「名片锁定」
- 名片格式：男女通用
[会员级别]-[昵称] - 截取昵称：
0（保留完整昵称） - 违规检测：开启昵称检测，违禁词填写
加群 微信 引流 广告 - 统一名片：
违规昵称 - 检测间隔：
120
七、注意事项
- 名片格式中的变量必须严格使用
[]包裹，拼写错误会导致变量无法正常替换，原样显示在名片中 - 开启「名片锁定」后，管理员手动修改名片也可能被系统还原，如需批量调整请先临时关闭锁定
- 违规违禁词建议使用精准词汇，避免过短的通用字词导致误判正常昵称
- 群名片修改有平台频率限制，短时间大量改名可能触发限制，建议合理设置检测间隔
- 「发言改名」适合清理存量成员的不规范名片，配合「入群改名」可实现新老成员全量覆盖