操作手册

邮箱账号管理系统的日常使用说明。

1. 企业微信登录

在登录页点击“企业微信登录”，通过统一身份页面完成验证后自动返回号池管理。企业微信只负责确认本人身份，管理员、编辑员角色及导入导出权限仍以本系统用户管理设置为准。首次登录会按“企业微信登录标识”匹配并绑定；未开通、已停用或标识不一致时会拒绝登录，请联系管理员。管理员应急登录仅用于 SSO 故障或首次绑定排查。

2. 新增、排序与编辑账号

点击“新增账号”录入资料，密码、辅助邮箱、2FA、Session、XY、邮箱 Token 均可留空。已有记录可点击“编辑”，空字段也可直接点击“—”填写。列表按最新更新时间倒序排列，最新修改、新增或导入的账号显示在最上方；更新时间相同时按账号 ID 倒序排列。

3. 查看、复制与 2FA

点击邮箱、密码、辅助邮箱、2FA、Session、XY 或邮箱 Token 会直接复制完整内容。有效 Base32 2FA 会显示六位动态验证码及“刷新”按钮；无效、过短或含非法字符的 2FA 不显示动态验证码。点击 Session 下方的 chatgpt.com/…/session 只复制网址。

4. Session 管理与邮箱校验

Session 支持新增、修改和单独删除。保存新 Session 时会读取其中的 email 字段；缺少 email 或与当前账号邮箱不一致时弹出警告。“确定”可忽略警告继续保存，“取消”返回修改。

5. XY 与邮箱 Token 管理

XY 和邮箱 Token 均支持缩略显示、点击复制、空值点击填写、单独修改和删除，并显示最后修改人及系统时间。XY 内容必须以小写 xy 开头，例如 xyhelpertoken...，否则系统拒绝保存。邮箱 Token 用于保存导入表格中的 email_token 内容。两者与密码、2FA、Session 一样采用加密存储。

6. 状态分类与状态管理

管理员和编辑员可新增、改名、启用或停用状态分类。未被账号使用的自定义分类可以删除；已被使用时禁止删除并提示数量。分类内状态可新增、编辑、停用或删除；状态正在使用时，可选择取消，或无视占用继续删除。继续删除系统固定状态时，相关账号自动切换到同分类其他状态；自定义状态则清空。状态分类继续同步到账号列表、编辑和批量修改；是否显示为顶部筛选栏由“设置筛选栏”独立管理。

7. 筛选与分页

点击“设置筛选栏”中的“新增筛选栏”，可直接填写筛选栏名称及初始选项，系统会同时创建对应状态分类并同步到账户列表、编辑页面和批量修改；也可选择引用尚未显示的已有状态分类。筛选卡片内可改名、启停、新增或编辑选项。删除筛选栏只会隐藏顶部筛选控件，不会删除状态分类、状态选项或账号已保存的状态数据，重新添加后可继续使用。支持组合使用多个状态筛选及负责人筛选，并支持每页 10、20、50 或 100 条。

8. 批量操作

勾选邮箱左侧复选框后出现批量操作栏，表头复选框可全选当前页。支持批量分配负责人、批量修改任意启用状态、批量导出 Session 和导出 XY 直连。状态修改会记录操作用户和系统时间。

9. 负责人和多图备注

管理员和编辑员均可分配负责人。负责人备注支持文字及连续粘贴多张 PNG、JPG、WebP 图片，数量不限，每张最大 5MB；图片可逐张移除。

10. 导入账号

点击“导入”可上传 Excel、ODS、CSV、TSV、TXT 表格，使用腾讯文档链接，或粘贴文本。带表头的表格会按第一行名称自动匹配，不限制列顺序：

Product、Variant、SKU 等无关列会被忽略。文本字段可使用 ----、半角 | 或全角 ｜ 分隔，支持邮箱与密码、辅助邮箱、2FA 的多种组合。系统通过邮箱格式和 Base32 特征自动识别；只有一个邮箱时作为主邮箱。没有邮箱或重复邮箱的行会跳过。单次最多 20,000 行，表格文件最大 15MB。

11. 批量导出 Session

勾选账号后点击“导出 Session”。勾选多少条就导出多少条，不限制状态；Session 为空时保留空列。文件仅包含“邮箱”和“Session”两列。

12. 导出 XY 直连

勾选账号后点击“导出 XY 直连”。所选账号必须全部为“已充值 Pro”，并且密码非空、XY 非空且以 xy 开头；任一账号不符合时会阻止整批导出并提示数量。文件无表头，每行格式为：

PRO20260720-1-1,邮箱,密码,XY

PRO 为固定前缀；日期跟随系统当天日期；日期后的第一个数字是该账号在本次导出中的序号；第二个数字是当天第几批导出，当天每成功导出一批自动加一，服务重启后不会重置。导出文件为 UTF-8 纯文本 .txt，没有表头，每个账号一整行，字段使用英文逗号分隔。文件可使用 Word、WPS 或记事本打开。

13. 用户和权限

管理员可新增管理员或编辑员、设置企业微信登录标识、调整角色、启用状态、导入导出权限并重置应急密码。登录标识可填写 Casdoor 用户名、企业微信 UserID 或统一登录邮箱；留空时优先使用系统账号匹配。标识修改后原绑定会自动清除，下次登录重新绑定。管理员和编辑员均可使用账号业务功能及状态配置；用户管理、回收站和账号恢复为管理员专属；管理员和编辑员均可删除账号。系统始终至少保留一个启用管理员。

14. 删除、日志与数据安全

管理员和编辑员删除的账号均进入回收站，管理员可恢复。企业微信登录与绑定、应急登录、修改、敏感信息查看、状态配置、导入、导出和批量操作等关键行为写入操作日志。密码、辅助邮箱、2FA、Session、XY 和邮箱 Token 均采用加密存储；OAuth 访问凭证只用于读取登录身份，不写入数据库。

15. 局域网运行

系统供同一局域网使用。使用固定访问地址发起企业微信登录，不要在 IP、localhost 和其他域名之间切换，否则回调校验可能失败。Mac 登录后服务自动启动、异常自动重启并阻止空闲休眠；Mac 关机、手动休眠、断网或局域网 IP 变化时，其他设备可能暂时无法访问。