分享赚钱 (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

Crab Claw 内置全局分享赚钱营销体系，让每个用户都能成为推广者。通过邀请链接分享 Crab Claw，当被邀请人购买付费服务时，推广者自动获得佣金奖励——从分享到佣金到提现，全链路自动化。

为什么选择分享赚钱

注册即代理

新用户注册时自动创建代理身份，无需额外申请。每个人都是潜在的推广者，零门槛参与。

递减式佣金

公平的多级分佣算法——上级消耗的佣金从下级可分配额度中扣除，避免金字塔式无限膨胀。

自动归因追踪

从点击邀请链接到注册到购买，全链路自动归因。LocalStorage 4 字段持久化，跨会话不丢失。

提现闭环

佣金实时到账数字钱包，一键申请提现。管理端审核→自动打款→到账通知，全流程透明。

渠道码管理

每个推广者拥有专属渠道码，支持多码多标签。不同渠道码可追踪不同推广渠道的效果。

对话分享裂变

分享 AI 对话到社交平台时自动附带邀请码，实现内容传播与用户增长的双重效果。

系统架构

shell

┌──────────────────────────────────────────────────────────────┐
│                     用户旅程                                  │
│                                                              │
│  推广者分享链接 → 新用户点击 → 注册 → 购买服务                 │
│       │                │         │        │                  │
│       ▼                ▼         ▼        ▼                  │
│  ┌─────────┐    ┌──────────┐ ┌──────┐ ┌──────────┐          │
│  │ 渠道码   │    │ 归因绑定  │ │ SSO  │ │ 支付回调  │          │
│  │ 生成管理 │    │ 写入本地  │ │ 注册 │ │ 触发佣金  │          │
│  └────┬────┘    └────┬─────┘ └──┬───┘ └────┬─────┘          │
│       │              │          │           │                │
│  ┌────▼──────────────▼──────────▼───────────▼────────────┐   │
│  │              佣金管道 (Commission Pipeline)             │   │
│  │                                                        │   │
│  │  注册即代理 → 归因绑定 → 支付触发 → 递减计算 → 入账      │   │
│  │       │                                    │           │   │
│  │       ▼                                    ▼           │   │
│  │  AgentRegistration      CommissionCalculationHandler    │   │
│  │  Service                (AFTER_COMMIT 事务隔离)         │   │
│  │  · 创建 member           · effectiveBps 递减算法        │   │
│  │  · 生成邀请码             · 多级 while 循环              │   │
│  │  · 分配角色               · 幂等 uk_member_subject      │   │
│  └────────────────────────────────────────────────────────┘   │
│       │                                                      │
│  ┌────▼──────────────────────────────────────────────────┐   │
│  │              钱包与提现 (Wallet & Withdrawal)           │   │
│  │                                                        │   │
│  │  佣金入账 → 钱包余额 → 申请提现 → 审核 → 打款           │   │
│  │             (credit)    (debit)   (review) (transfer)  │   │
│  └────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────┐
│                     用户旅程                                  │
│                                                              │
│  推广者分享链接 → 新用户点击 → 注册 → 购买服务                 │
│       │                │         │        │                  │
│       ▼                ▼         ▼        ▼                  │
│  ┌─────────┐    ┌──────────┐ ┌──────┐ ┌──────────┐          │
│  │ 渠道码   │    │ 归因绑定  │ │ SSO  │ │ 支付回调  │          │
│  │ 生成管理 │    │ 写入本地  │ │ 注册 │ │ 触发佣金  │          │
│  └────┬────┘    └────┬─────┘ └──┬───┘ └────┬─────┘          │
│       │              │          │           │                │
│  ┌────▼──────────────▼──────────▼───────────▼────────────┐   │
│  │              佣金管道 (Commission Pipeline)             │   │
│  │                                                        │   │
│  │  注册即代理 → 归因绑定 → 支付触发 → 递减计算 → 入账      │   │
│  │       │                                    │           │   │
│  │       ▼                                    ▼           │   │
│  │  AgentRegistration      CommissionCalculationHandler    │   │
│  │  Service                (AFTER_COMMIT 事务隔离)         │   │
│  │  · 创建 member           · effectiveBps 递减算法        │   │
│  │  · 生成邀请码             · 多级 while 循环              │   │
│  │  · 分配角色               · 幂等 uk_member_subject      │   │
│  └────────────────────────────────────────────────────────┘   │
│       │                                                      │
│  ┌────▼──────────────────────────────────────────────────┐   │
│  │              钱包与提现 (Wallet & Withdrawal)           │   │
│  │                                                        │   │
│  │  佣金入账 → 钱包余额 → 申请提现 → 审核 → 打款           │   │
│  │             (credit)    (debit)   (review) (transfer)  │   │
│  └────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────┘

注册即代理

新用户通过 SSO 注册时，系统自动完成代理身份创建：

步骤	说明
创建 Member 记录	在分销系统中创建会员身份
生成默认邀请码	自动创建首个渠道码，开箱即用
分配代理角色	赋予 `dist_agent` 角色和相应权限
绑定上下级关系	如果是通过邀请链接注册，自动绑定推荐人

零门槛：不需要额外申请、不需要填写表单、不需要等待审核。注册完成即可开始分享赚钱。

邀请链归因

归因数据采集

当用户点击邀请链接（如 https://example.com/i/ABC123）时，前端自动写入 localStorage：

字段	说明
`inviteCode`	邀请码
`invitedByMemberId`	邀请人 Member ID
`timestamp`	点击时间
`source`	来源（链接/二维码/对话分享）

归因绑定流程

shell

点击邀请链接 → ShareAttribution 写入 localStorage
       │
       ▼
注册/登录时 → AttributionBinder 读取归因数据
       │
       ▼
自动绑定 → invitedByMemberId → parentMemberId
       │
       ▼
后续购买 → 佣金自动结算到推荐人
点击邀请链接 → ShareAttribution 写入 localStorage
       │
       ▼
注册/登录时 → AttributionBinder 读取归因数据
       │
       ▼
自动绑定 → invitedByMemberId → parentMemberId
       │
       ▼
后续购买 → 佣金自动结算到推荐人

优先级：invitedByMemberId（直接邀请人）优先，parentMemberId（间接关系）回退（兼容旧数据）。

递减式佣金算法

Crab Claw 采用递减式佣金分配（V22 版），确保多级分佣的公平性：

核心公式

shell

effectiveBps = ownRateBps - consumedSoFar
effectiveBps = ownRateBps - consumedSoFar

ownRateBps：当前层级的佣金费率（基点，1 BPS = 0.01%）
consumedSoFar：已被下级消耗的佣金总额
effectiveBps ≤ 0 时佣金链停止，剩余归机构

计算示例

假设平台给机构总配额 4000 BPS（40%），三级代理费率分别为 30%、20%、10%：

shell

买家支付 100 元
  │
  ├─ 三级代理 (10%): effectiveBps = 1000 - 0 = 1000 → 获得 10 元
  │
  ├─ 二级代理 (20%): effectiveBps = 2000 - 1000 = 1000 → 获得 10 元
  │
  ├─ 一级代理 (30%): effectiveBps = 3000 - 2000 = 1000 → 获得 10 元
  │
  └─ 机构剩余: 4000 - 3000 = 1000 BPS → 获得 10 元
买家支付 100 元
  │
  ├─ 三级代理 (10%): effectiveBps = 1000 - 0 = 1000 → 获得 10 元
  │
  ├─ 二级代理 (20%): effectiveBps = 2000 - 1000 = 1000 → 获得 10 元
  │
  ├─ 一级代理 (30%): effectiveBps = 3000 - 2000 = 1000 → 获得 10 元
  │
  └─ 机构剩余: 4000 - 3000 = 1000 BPS → 获得 10 元

安全保障

机制	说明
AFTER_COMMIT 隔离	佣金计算在支付事务提交后触发，异常不回滚支付
幂等保护	`uk_member_subject` 唯一索引 + `selectListByOrderId` 防重复
环路检测	多级 while 循环 + Set 集合检测循环引用
BPS 统一	`commissionRateBps (INTEGER)` 替代 `commissionRate (DECIMAL)`，精度无损
executeIgnore	首查跨租户查找用户，业务计算在指定租户上下文内执行

渠道码管理

默认码自动创建

注册时自动创建一个默认渠道码，用户可直接使用：

shell

https://example.com/zhuanqian/i/ABC123
https://example.com/zhuanqian/i/ABC123

多码多标签

支持创建多个渠道码，每个码可设置标签用于追踪不同推广渠道：

操作	说明
创建新码	可自定义标签，如"朋友圈"、"公众号"、"群聊"
切换状态	toggle 启用/停用（软操作，不硬删）
设置过期	expire 操作设置过期时间
查看统计	每个码的点击量、注册量、付费转化

分享链接格式

分享链接必须包含 /zhuanqian basePath，确保路由正确：

shell

${origin}/zhuanqian/i/${code}
${origin}/zhuanqian/i/${code}

对话分享裂变

Crab Claw 支持将 AI 对话分享到社交平台，分享时自动附带邀请码实现裂变增长：

分享流程

用户在对话中点击"分享"按钮
系统生成分享令牌（22 字符 URL-safe base64）
创建分享卡片（QR 码 + 对话摘要 + 邀请码）
用户分享到微信/朋友圈/社交平台
访客查看对话公开页 → 看到内容 → 感兴趣 → 注册
归因管道自动绑定 → 访客购买 → 分享者获得佣金

分享卡片功能

功能	说明
QR 码	自动生成，扫码直达对话公开页
对话摘要	AI 自动提取对话核心内容
保存图片	html-to-image 渲染为 PNG
复制链接	一键复制分享链接
系统分享	调用系统分享 API（微信/Twitter 等）

钱包与提现

佣金入账

佣金计算完成后实时入账到推广者的数字钱包：

shell

支付事务提交 → AFTER_COMMIT 触发 → 佣金计算 → wallet.credit(amount)
支付事务提交 → AFTER_COMMIT 触发 → 佣金计算 → wallet.credit(amount)

提现流程

shell

推广者申请提现
    │
    ▼
创建提现记录 (debit 扣减钱包 + insert 提现单, 原子操作)
    │
    ▼
管理端审核 (review)
    ├─ 通过 → 打款
    └─ 拒绝 → wallet.credit 自动退还
推广者申请提现
    │
    ▼
创建提现记录 (debit 扣减钱包 + insert 提现单, 原子操作)
    │
    ▼
管理端审核 (review)
    ├─ 通过 → 打款
    └─ 拒绝 → wallet.credit 自动退还

安全保障：

提现申请时 debit + insert 原子操作，防止余额不一致
审核拒绝时自动 credit 退还，不丢失余额
通知 markRead 必须 userId.equals 防越权

代理商管理端

推广者拥有独立的代理商管理后台，通过 H5 页面访问：

功能面板

页面	功能
数据概览	今日/本月佣金、团队人数、订单数
推广中心	渠道码管理、分享素材、推广数据
佣金明细	逐笔佣金记录、结算状态
提现管理	申请提现、提现历史
我的团队	下级成员列表、层级关系
个人中心	web-view 内嵌 C 端套餐页（同源共享登录态）

配置参数

参数	默认值	说明
`platform-default-rate-bps`	1000 (10%)	平台默认代理费率
`default-org-quota-bps`	4000 (40%)	机构默认总配额
`commissionRateMax`	—	单人佣金上限

快速开始

作为推广者，只需三步：

注册账号 — 注册即自动成为代理，获得默认邀请码
分享链接 — 通过社交平台分享邀请链接或对话分享卡片
坐等收益 — 被邀请人购买服务时自动获得佣金，钱包余额可随时提现

相关文档：技能商店 · 媒体智能体