心灵之桥 · 使用说明

1 这是什么应用

心灵之桥 的核心不是"打卡 App"，而是一项 意外留言传递服务：

• 你预先写下一句话/一段留言（例如给家人的话），并设置定期打卡作为"我还平安"的生命确认；
• 系统按你设定的周期提醒你打卡；
• 若你超时未打卡 → 进入警告期 → 仍无响应 → 进入终止期，系统向你的监督人发送你预设的留言；
• 需要人工确认的任务，留言可端到端加密，只有你掌握密码才能解密查看（详见第 7 章）；
• 分享你的推广链接，朋友通过链接注册并付费，你获得 399 元/人 奖励。

图 1-1　首屏登录/注册界面（线上真实截图）

2 整体使用流程

已付费的老用户，第 ③ 步会被自动跳过（直接发验证码）。

3 邮箱注册与登录（含获取验证码）

本应用没有独立"注册密码"，全程用 邮箱 + 邮箱验证码 完成注册与登录，验证码即"授权码"。

3.1 新用户（从未付费）完整流程

1. 首屏输入你的 邮箱，点击 获取验证码。
2. 服务端返回 402（需要付费），自动弹出支付方式选择框（微信 / 支付宝）。
3. 选择支付方式完成 799 元 付款（见第 4 章）。
4. 支付成功后，系统自动把验证码发到你的邮箱（无需再点"获取验证码"）。
5. 回到首屏，在"验证码/授权码"框填入邮件中的 6 位码，点击 验证并进入 →。
6. 验证通过即注册成功并进入任务清单。

3.2 已付费老用户（或测试邮箱）

1. 输入邮箱，点击 获取验证码 → 直接收到邮件验证码（不触发支付）。
2. 填入验证码，点击 验证并进入 → 即可。

图 3-1　获取验证码 → 验证并进入（线上真实截图）

4 支付操作（微信 / 支付宝）

服务费为 799.00 元（终身服务，金额由后端返回，弹窗标题也会显示具体金额）。

1. 微信： 选择后服务端生成订单并返回二维码，弹窗展示。手机微信扫码 → 支付成功 → 弹窗提示"支付成功，正在发送验证码" → 自动关闭并发码。
2. 支付宝： 选择后跳转到支付宝支付页，完成支付后跳转回应用。
3. 支付状态由前端每 3 秒 轮询检测；订单超时则提示重新获取验证码。

5 任务清单与一键打卡

登录后进入任务清单，最多可建 7 个 任务。每个任务卡显示名称、状态徽章、周期/警告/终止天数、最近打卡时间。

图 5-1　任务清单页（右上角"👤 用户中心"可进入奖励与推广，线上真实截图）

• 一键打卡： 点 一键打卡 一次性更新所有任务的最近打卡时间（状态恢复正常）。
• 切换账号： 退出当前登录回到首屏，可换邮箱登录。

6 如何设置普通打卡任务

1. 任务清单页点 新建任务（或点已有任务卡进入编辑）。
2. 填写 任务名称（如"每日报平安"）。
3. 设置三个时间参数：
   • 周期：你设定的打卡周期（1 / 2 / 3 天可选）——多久该打一次卡；
   • 警告：超过周期未打卡后，再过几天触发警告提示；
   • 终止：警告期后再过几天，触发终止通知发给监督人。
4. 警告邮件发至：固定为你的登录邮箱（只读）。
5. 终止通知发至：填写监督人邮箱（家人/朋友），意外时留言发到这里。
6. 点 编辑终止通知 编写发给监督人的留言内容（这就是"意外留言"本身）。
7. （可选）勾选 需要人工确认：超时后不直接自动发，先由人工/客服二次确认（见第 7 章关联加密）。
8. （可选）填 警告内容（给自己），如"请及时打卡"。
9. 点 保存任务。之后可用 手动打卡 立即确认一次，或 删除任务。

图 6-1　任务编辑页（普通任务，线上真实截图）

7 如何设置加密任务（端到端加密留言）

加密任务 = 在任务的"终止通知（意外留言）"上开启加密。开启后，这条留言被 AES-256-GCM 端到端加密，只有你输入正确密码才能解密；即便服务器被攻破也无法读取明文。管理员仅在"确认意外"后可通过应急解密查看。

7.1 设置全局加密密码

1. 进入 用户中心 → 找到 🔐 留言加密保护 区块。
2. 点 设置加密密码。
3. 输入 加密密码（至少 6 位）+ 确认密码 + 密码提示（帮你回忆密码，不会泄露给他人）。
4. 点 保存密码。状态点变绿，显示"已加密保护"。

7.2 在任务上开启加密留言

1. 任务清单 → 进入任务编辑 → 点 ✉️ 编辑终止通知。
2. 编写你的意外留言内容。
3. 勾选 🔐 加密留言内容，下方展开密码/确认/提示输入框。
4. 输入你设置的加密密码 + 确认 + 提示（此处提示可与全局提示不同，针对本条）。
5. 点 保存。该任务的终止通知即被加密存储。

图 7-1　设置全局加密密码（用户中心 · 留言加密保护，线上真实截图）

图 7-2　开启"加密留言内容"并填密码（编辑终止通知弹窗，线上真实截图）

7.3 查看已加密留言 / 重置密码

• 自己查看： 在需要解密的位置输入密码 → 点 解密查看。输错会提示"密码不对"。
• 重置密码： 用户中心点 重置密码，重新走 7.1 流程（会重新生成密钥材料）。
• 应急解密： 仅后台管理员在确认意外后使用，普通用户无需操作。

8 用户中心：推广链接、奖励、加密管理

任务清单右上角 👤 用户中心 进入。包含四块：① 我的推广链接；② 奖励余额与记录；③ 留言加密保护；④ 收款账号。

图 8-1　用户中心（奖励余额 + 奖励记录 + 推广链接 + 加密保护，线上真实截图）

• 我的推广链接： 形如 https://你的域名/?ref=你的专属码，点复制分享。
• 奖励余额： 显示你累计获得的奖励总额（见第 11 章"奖励额计算"）。
• 奖励记录： 每条推荐明细 + 状态（待付 / 已付）。
• 收款账号： 在用户中心填写你的收款账号类型（微信等）与账号，用于管理员给你打款发奖励。
• 留言加密保护： 即第 7 章的加密密码管理入口。

9 用二维码生成器制作推广二维码

应用内置 灵动二维码 工具（codemaker.html，任务清单页点 🎨 二维码 打开，或浏览器直接访问该文件）。把你的推广链接做成二维码，印在海报/名片上更方便传播。

图 9-1　灵动二维码生成器（白底工具页，线上真实截图）

1. 打开二维码生成器（应用内 🎨 二维码 按钮，或访问 codemaker.html）。
2. 在 内容 框粘贴你的推广链接（来自用户中心"我的推广链接"）。网址需含 http(s)://
3. （可选）设置 尺寸 / 边距 / 前景色 / 背景色，或上传 中心 Logo（透明背景 PNG 最佳，建议 <2MB）。
4. 点 ⚡ 制二维码 生成预览。
5. 保存：
   • 电脑： 点 💾 电脑保存 直接下载 PNG；
   • 手机： 点 📱 手机保存，再长按生成的图片"保存图像"到相册。
6. 支持中 / English 切换（右上角）。

10 推广码购买与奖励机制

• 推荐关系如何记录： 朋友通过你的链接打开注册页时，URL 里的 ?ref=你的码 会被前端读取，随"获取验证码"请求一起发给服务端，写入该邮箱的 referrer_email / referral_code。
• 何时发奖励： 仅当被推荐人完成付款（在线回调或后台确认收款）时才生成佣金，防止白嫖。
• 状态： 刚生成是 待发放(pending)；你实际打款后，后台点"标记已发放"变为 已发放(paid)。
• 风控： 同一被推荐人复购会再次发佣；系统仅对测试邮箱做了自推特例，真实双账号互推暂无自动拦截（运营中需注意）。

11 奖励额计算逻辑

11.1 核心公式

• 单次奖励 = 固定 399 元（代码中硬编码为 39900 分，即 399.00 元）。每成功推荐 1 位付费用户，得 399 元。
• 奖励总额 = commission_balance（累计值，每次发佣 +399，永不扣减）→ 即"你使用以来总的奖励金额"。
• 待发放 = 所有状态为 pending 的佣金金额之和 = 奖励总额 − 已发放。

11.2 示例

11.3 税务提示

用户协议第 4.5 条说明：推荐奖励为含税金额，平台依法按月度累计并代缴税务。实际到账以你与平台约定为准。

12 后台管理（管理员）

后台通过带 ?token=管理员令牌 的地址访问。主要 four 个模块：待确认任务、待授权邮箱、邮箱管理、奖励管理。与用户侧最相关的是下面两项：

1. 确认收款： 在"待授权邮箱"中，对线下/后台确认已付费的邮箱点 确认收款 → 生成授权并触发佣金（等同在线支付成功）。
2. 标记已发放： 在"奖励管理"中，对 待发放 的佣金点 标记已发放 → 弹窗"确认已经给推荐人转账？" → 确认后该条变 已发放，用户端"待发放"随之下降。
3. 发送授权码： 可手动给某邮箱重发验证码。
4. 停用/恢复/删除邮箱： 管理异常账号。
5. 各列表均支持 导出 Excel/CSV（绿色按钮）。

13 常见问题 FAQ