成员导入与账号认领（Member Import & Account Claim）

带着旧数据（微信群、Excel）搬到星港时，用这套功能把老成员和他们的余额一次性接进来，而不是让几百号人重新一个个注册。分两步：

成员导入：在后台用一张 CSV 表格，把老成员名单 + 预存款 + VIP 积分批量建档，一次导入几十上百人，本人不用动手。
账号认领：导进来的账号先挂在公会名下（代建、本人还没领），账号和余额先建着、先记着，不依赖本人在不在线；哪天他回来，用自己的手机号或邮箱过一次验证码，账号就归他自己登录管理。

星港只接"人和钱"，不导历史订单流水——过去的成交记录留在旧账里备查，星港从导入这一刻开始记账。

1. 核心概念

概念	业务解释
期初余额	导入时给成员录入的"开张余额"，即旧系统 / 线下结转过来的预存款。它是钱包里的第一笔记录，作为账实相符的起点。
预存款（星币）	玩家存在公会、还没消费掉的钱。导入表里的 `balance` 列。
期初 VIP 积分	成员在旧系统里攒下的积分。导入表里的 `vip_points` 列，导入后按积分当场定出 VIP 等级。
未认领账号（代建 / 托管）	公会替成员建的、本人还没接手的账号。正常可用（能登录、下单、消费），只是还没人证明"这就是我"。
认领	本人用自己的手机号或邮箱过一次验证码后，账号就归本人自助登录。认领是独立的状态维度，跟账号是否启用无关。
免密登录链接	客服给某个账号生成的一次性链接，发给本人，本人点开就能登录，登录后在门店里完成认领。

星币是余额的默认叫法，会跟随你公会在「门店与品牌」里设置的货币称呼。期初余额如何接进钱包、在流水里怎么查，见钱包与资金流。

导入只建成员、不建陪玩，也不接公会欠陪玩的待结佣金——那一笔等他入驻成陪玩后单独补记（见场景「导进来的陪玩」）。

2. 典型流程

星海公会原来用微信群 + Excel 记账。老板手上有份名单，其中玩家张三预存了 200 星币没花完，老客户李四攒了 1200 VIP 积分。

下载模板：后台侧栏左下角齿轮进入设置，「设置 → 团队 → 成员导入」，页面右上角点「下载模板」，得到一张 CSV 表格。
填表：每行一个人。张三填一行（balance 填 200），李四填一行（vip_points 填 1200）。手机号、微信号有就填、没有留空。
先预览：在「成员导入」页上传表格，点「解析并预览」。预览页只校验、不写库，逐行告诉你"将新建 2 人、跳过 0、错误 0"。一份文件最多 1,000 行（不含表头，整行空着的不算），超过的名单预览页不受理——拆成几份（每份不超过 1,000 行）分别导入。
正式导入：核对无误后在预览页点「确认导入」。张三、李四的账号建好，200 星币作为期初余额挂进张三的钱包（钱包流水第一笔就能查到），1200 积分记到李四名下并定出 VIP 等级。
此时这两个账号是未认领——星港只是替公会记着，本人还没接手。
张三照常能下单消费这 200 星币；但未认领的账号发起不了提现，因为系统还不能确认是本人在取钱。
让张三认领：表里填了他的手机号，他在门店登录页用这个手机号收验证码登录，就算认领完成。没留手机号的，老板打开他的详情页 →「账号管理」→「免密登录链接」，把链接发到他微信；他点开登录后，门店顶部会提示「立即认领」，绑定自己的手机号或邮箱即可。

整条线：导入（人 + 预存款 + 积分）→ 期初余额入账 → 未认领托管 → 本人认领 → 解锁自助登录与提现。

3. 常见业务场景

填表说明（每行一人，姓名是唯一必填项）：

列（表头）	填什么	必填
姓名 `name`	成员名字	✅ 必填
手机号 `phone`	11 位大陆手机号，有就填	选填
微信号 `wechat_id` / 微信名 `wechat_name`	有就填	选填
性别 `gender`	男 / 女 / 其他	选填
VIP 积分 `vip_points`	旧系统里攒下的积分，非负整数	选填，没有留空或填 0
预存款 `balance`	玩家存的、没花完的钱	选填，没有留空或填 0
备注 `note`	只有后台员工看得到的内部备注	选填

表头用模板里的英文列名，别改。预存款按你公会的钱包币（星币）计，不是人民币。如果设了兑换比例，填的是币的数量，别把人民币金额直接填进去。

联系不上的老用户：照常导入即可，账号和余额先建着、状态一直是未认领，钱安静挂在他钱包里。哪天他回来，发一条免密登录链接，他登录后认领就能领回去用。

余额填错：某行预存款填了文字或负数、积分填了小数，这一行会在预览页标为错误、不会被导入，其它正常行照常导。改好那几行单独再导一次即可（已导成功的、带手机号或微信号的行会按"已存在"跳过；两样都没填的行不查重，别重复导）。

重复导入 / 手机号重复：表格里有重复的人，或某个手机号 / 微信号系统里已经有了，系统自动跳过这些行并在预览页说明。它不会把余额合并到已有账号、也不会覆盖谁。想给已存在的账号补余额，去那个成员的用户页单独调整。

导进来的陪玩怎么变成真正的陪玩：导入只建成员账号，不建陪玩。一个你当陪玩用的成员导进来后还只是普通成员；导入后让他照常走陪玩入驻（分组、佣金比例、押金与实名都在那一步定）。公会欠他的旧佣金不在导入表里：等他成了陪玩，由有「提现 · 成员奖惩」权限的员工在他的陪玩页「调整余额」里补记进可提现的佣金。见陪玩招募与实名认证。

成员说他提不了现：导入的账号是"公会代建、本人还没领"的，没认领系统还不能确认是本人在取钱，所以不允许提现——这是保护资金安全的硬规则，对所有发起方一样。让他认领就解锁：

表里填了他的手机号：他用这个手机号收验证码登录（或走找回密码），过了验证码就算认领。
表里没留手机号：客服打开他的详情页 →「账号管理」→「免密登录链接」，把链接发给他；他点开登录后，门店顶部提示「立即认领」，绑定自己的手机号或邮箱即可。

账上留了手机号的账号，只有拿着那个手机号的人认领得了——换一个号认领会被拒。

4. 谁能做什么

谁	成员导入 / 下载模板	生成免密登录链接	认领
有「用户 · 日常操作」权限的员工	✅	—	—
有「用户 · 账号接管」权限的员工	—	✅	—
两格都没有的员工	❌ 看不到入口	❌ 看不到入口	—
成员本人	—	—	用自己的手机号或邮箱过验证码

认领只能由本人完成，后台没有"替他认领"的按钮。

「用户 · 日常操作」之外还得看得见用户列表（「用户 · 查看」）。表格里带钱或带积分时，还要另外两格权限：

表格里填了	另需权限
预存款（任意一行大于 0）	「财务 · 余额修正」
VIP 积分（任意一行大于 0）	「门店 · 发放与撤销权益」

缺哪一格，预览页会直接说明是哪一列、缺哪项权限，这份文件导不进去；两列都没填数的纯名单，只要「用户 · 日常操作」就能导。

成员导入与下载模板在「设置 → 团队 → 成员导入」，免密登录链接在单个用户详情页「账号管理」里。

5. 生成登录链接

"发个链接就能领回去用"里的链接，就是免密登录链接：生成一条有时限的一次性链接，发给本人，他点开就自动登录、不用输密码。它和账号认领是互补的两条协助路径，常一起用：

未认领 / 后台代建的账号（比如刚导入的张三，本人从没设过密码）：发他一条免密登录链接点开就进来，进来后点门店顶部的「立即认领」，绑定本人手机号或邮箱，就完成了认领（提现随之解锁）。
忘了密码的老玩家（账号早就是本人的，只是登不进来）：不用重置密码走找回，直接发一条免密登录链接，点开即用。

入口：用户详情页 →「账号管理」→「免密登录链接」，点生成，复制整段话通过微信等私密渠道发给本人——复制出来的内容自带一句提醒（这是个人登录链接、几点前有效、只能用一次、别转发），可以直接粘贴发送。「免密登录链接」和「登录为此用户」在同一按钮组里，别点混：前者是把链接发给本人、让他自己登录；后者是你自己临时切成他的身份看界面。

派单详情页发单人那一行也有「免密链接」，发的是同一种链接，只是他登录后直接落到这一单的详情页，挑人、聊天、充值、找客服都在。他登录过一次之后再点聊天记录里那条旧链接，会直接回到这一单。

这条链接的规矩：

规矩	说明
一次性	只能用一次，本人点开登录后立刻作废——所以务必只发给本人。
有时限	生成后 60 分钟内有效，生成时不用填。
一人一条	给同一个人再生成一条，上一条当场作废（用户页发的和派单页发的算同一条）。还在有效期内的那条，回到同一屏可以再复制。
过期 / 用过即失效	到点没用会自动失效，用过也失效，不会长期躺在聊天记录里。
可撤销	发出去反悔了（发错人、怕泄漏），只要还没被点用，随时可撤销、当场作废。
全程留痕	谁生成的、什么时候被谁用掉、从哪个 IP / 什么设备登录，系统都记着。

一条免密登录链接约等于把这个账号临时交到别人手里，所以它挂在「用户 · 账号接管」权限下（和「登录为此用户」同一把钥匙），不是谁能导入成员（「用户 · 日常操作」权限）谁就能发——建议只给信得过的管理员，别随手开给一线兼职客服；链接只发本人；怀疑发错或外泄第一时间撤销。

套餐与开关：「免密登录链接」每一档都能用、默认开着，在「公会设置 → 门店 → 登录方式」里自行开关——它就是手机号、邮箱之外的第三种进门方式，只不过由管理员代为签发。关闭后用户详情页与派单详情页都不能再签发新链接；此前已生成、没到期的链接照常到期后失效，历史记录仍可查。

6. FAQ

Q：导入会把我旧系统的历史订单也搬过来吗？ 不会。只接"人和钱"（名单 + 预存款 + VIP 积分），不导历史订单流水。旧成交记录留在原账里备查，星港从导入这一刻起记账。

Q：余额填的是人民币还是星币？ 填星币（你公会钱包币的数量），不是人民币。设了兑换比例就按币的数量填。

Q：导入的账号能直接登录、下单、消费吗？ 能。未认领不等于禁用——账号正常可用，本人拿到登录链接就能用、能消费。唯一被拦的是提现，认领后放开。

Q：导入后发现某人余额录错了怎么办？ 不要靠重复导入改（会被当重复跳过），去那个成员的用户页单独调整（需要「财务 · 余额修正」权限）。建议点「确认导入」前在预览页逐行核对。

Q：一个人没有手机号也没有微信，能导吗？ 能。姓名是唯一必填项，其它可空。这种账号等本人来认领时再绑手机号或邮箱，你可以在他的详情页生成「免密登录链接」发给他。