自我了解（suicide）使用文档

作者：kuakeba.cn | 版本：1.0.0 | 适用于 Zsens Admin 3.0+（PHP 8.2+）

一、插件简介

支持用户一键注销账号：

• 插件启用后，用户资料页（账号设置）底部显示「危险操作」区域与 自我了断 按钮
• 点击按钮后弹窗提示使用后果（文案可在后台自定义）
• 用户输入登录密码校验通过后执行注销流程
• 注销采用软删除（与后台删除用户的系统行为一致），会话立即登出并跳转首页
• 管理员身份不支持前台注销

二、环境要求

三、安装步骤

1. 将 suicide 目录放入 plugins/ 下
2. 进入后台 应用中心，找到「自我了解」，点击 安装
3. 确保已安装 社区（community） 插件；若未安装，用户资料页不存在，插件入口不会出现

四、配置项

后台 应用中心 → 自我了解 → 配置：

默认提示文案：

1. 账号注销后无法登录，且无法自行恢复，请务必谨慎操作；
2. 您发布的主题与回复将保留展示，不会随账号一起删除；
3. 账户余额、金币等资产将随账号一并作废，请提前妥善处理；
4. 注销即视为您放弃本账号下的全部权益；
5. 如仍有疑虑，请先联系管理员咨询后再决定。

五、用户使用流程

1. 登录后进入 用户资料页（账号设置），页面底部红色「危险操作」区域点击 自我了断
2. 弹窗展示注销后果说明
3. 输入登录密码，点击 确认注销
4. 密码正确：账号软删除 → 权限缓存清理 → 会话登出 → 约 1 秒后自动跳转首页
5. 密码错误：弹窗内提示「登录密码校验失败」，可重新输入

六、接口说明

POST /suicide/execute

执行账号注销（需前台登录）。

请求参数（form-urlencoded）

成功返回

{
    "code": 1,
    "msg": "账号已注销，感谢一路相伴",
    "data": {
        "redirect": "/community"
    }
}

失败返回：code = 0，msg 为原因（功能未启用 / 未登录 / 管理员身份 / 未填密码 / 密码错误 / 注销失败等）。

七、技术说明

• 账号删除使用软删除（delete_time），数据库层面保留记录，管理员可在后台用户管理查看/处理
• 发布的主题、回复等数据保留展示（与后台删除用户的系统约定一致）
• 注销成功后立即清空会话（含前台会员态与后台管理员态）
• 已提交表单中不再包含任何密码明文；接口仅在插件启用时可用

八、常见问题

Q：资料页没有出现「自我了断」按钮？

1. 确认插件已安装并启用
2. 确认社区（community）插件已安装，且当前登录的是前台会员账号（管理员身份不显示）
3. 强制刷新浏览器缓存（Ctrl+F5）

Q：点击确认后提示「注销失败，请稍后重试」？

数据库写入异常，请检查数据库连接与用户表状态后重试。

Q：误注销了账号能恢复吗？

前台无法自助恢复。数据库中账号为软删除状态，管理员可在数据库中清空该用户的 delete_time 字段恢复账号（密码与会话需重新处理）。

Q：想修改弹窗提示文案？

后台插件配置中的「注销后果提示文案」即可，一行一条，保存后立即生效。