v2.0 拍板:统一 25% + 累计满 ¥10,000 后特别奖励 8%(总 33%) + 2 级销售(上 1 级 5% / 上 2 级 3%)
状态:上线,端到端跑通(申请 / 审批 / 拒批 / 佣金 / 月对账全链路)
| 角色 | 名称 | 入门条件 | 折扣 | 佣金 | 上线佣金 |
|---|---|---|---|---|---|
| 客户 | 普通工厂 | 工厂注册 | 0% | 0% | - |
| L1 | 销售合伙人 (Sales Partner) | DiggerChat 申请 + 1 工作日审核 | 25% | 25% | 上 1 级 5% |
| L1+ | 达标合伙人 | 累计销售 ≥ ¥10,000 | 25% | 33%(25% + 8% 奖励) | 上 1 级 5% |
佣金分配链:
客户注册并付费(享 25% 折扣)
↓ 佣金基数 = 订单额
L1 销售合伙人:直接佣金 25%(累计满 ¥10,000 后 33%)
↓ 该笔直接佣金的 5%
上 1 级合伙人
↓ 该笔直接佣金的 3%
上 2 级合伙人
↓ 3 级及以上:0%
| 关系 | 费率 | 基数 |
|---|---|---|
| 直接销售 | 25% | 订单额 |
| 直接销售(达标后) | 33% | 订单额 |
| 上 1 级 | 5% | 该笔直接佣金 |
| 上 2 级 | 3% | 该笔直接佣金 |
| 3 级及以上 | 0% | — |
跨线规则:累计销售跨过 ¥10,000 的那一笔仍按 25%,下一笔开始 33% —— 不追溯,避免争议。
| 项 | 规则 |
|---|---|
| 入门 | DiggerChat 申请 → 自动 4 位临时码 → 1 工作日人工审 → active |
| 折扣率 | 统一 25%(不分档,不分地区) |
| 佣金比例 | 基础 25%,达标后自动升 33% |
| 结算周期 | 每月 15 日对账,15 日前打款(T+15) |
| 累计计算 | ytd_sales = Σ 当月起 12 个月的客户实付金额 |
| 累计重置 | 不重置 —— 累计到 ¥10,000 后 33% 永久锁定,除非 inactive |
| 退出 | 3 个月 ytd_sales = 0,自动 inactive,可重激活 |
佣金计算公式(v13):
base_rate = 0.25
if ytd_sales_usd + amount_usd >= 10000:
rate = 0.33 # 25% 基础 + 8% 特别奖励
else:
rate = 0.25
discount = amount_usd * rate
final = amount_usd - discount # 客户实付
commission = discount # 代理赚的
platform = final # 平台拿的
| 项 | 规则 |
|---|---|
| 入门 | 自动 —— ytd_sales 累计 ≥ ¥10,000 系统自动检测 |
| 佣金 | 33%(25% 基础 + 8% 特别奖励) |
| 折扣 | 25%(客户不变) |
| 永久性 | 一旦达标,33% 永久,不会降回 25% |
| 通知 | 平台发邮件:"恭喜累计 1 万,从下笔起佣金提升到 33%" |
| 资金来源 | 平台让利比例变大(75% → 67%),客户不变 |
单笔 ¥1999 客户(原 Pro 价)对比:
| 代理等级 | 客户付 | 代理拿 | 平台拿 | 客户省 |
|---|---|---|---|---|
| L1(25%) | ¥1499.25 | ¥499.75 | ¥1499.25 | ¥499.75 |
| L1+(33%) | ¥1499.25 | ¥659.67 | ¥1339.58 | ¥499.75 |
客户体验不变(始终 25% 折扣),代理多赚 32%,平台少赚 11%。
直接佣金:
| 项 | 规则 |
|---|---|
| 基础佣金 | 订单额的 25% |
| 达标奖励 | 累计销售 ≥ ¥10,000 后额外 +8%(总 33%) |
| 跨线处理 | 跨过 ¥10,000 的那笔仍按 25%,下一笔起 33% |
| 佣金基数 | 订单额(不是折扣额) |
上线佣金(2 级):
| 层级 | 费率 | 基数 |
|---|---|---|
| 上 1 级 | 5% | 该笔直接佣金 |
| 上 2 级 | 3% | 该笔直接佣金 |
| 3 级及以上 | 0% | 不再往上分配 |
上线佣金在销售发生时在线写入,不依赖离线重算。嵌套佣金的基数是下线的实际佣金,不是订单额。
apply-discount 收到一笔订单agent.ytd_sales_usd(当前累计)ytd + amount >= 10000 → 切到 33%sale 时 rate=0.33 / bonus_active=True| 日期 | 动作 | 责任 |
|---|---|---|
| 1 日 00:00 | 系统自动出对账单 | 系统 |
| 1-3 日 | 代理自助确认订单 + 客户信息 | 代理商 |
| 4-7 日 | 平台复核(异常订单 24h 反馈) | 平台财务 |
| 8 日 | 平台出对账单 + 发票 → 代理确认 | 双方 |
| 8-10 日 | 代理确认 → 双方签字 | 代理商 |
| 11-14 日 | 财务复核 + 准备打款 | 平台财务 |
| 15 日 | T+15 打款 | 平台财务 |
============================================================
GoldDigger Textile 代理商月度对账单
============================================================
代理商: 王芳代理(盛泽家纺)
分销码: 6799 · 等级:L1+(已解锁 33% 佣金)
月份: 2027-03
本笔触达: ¥10,000 累计门槛
--- 客户订单明细(共 5 笔)---
1. push-5 ¥6748.50 → 折扣后 ¥5051.50 25%(未达标)
2. push-6 ¥7873.50 → 折扣后 ¥5905.12 25%(未达标)
3. push-7 ¥9448.50 → 折扣后 ¥6321.13 33%(首笔达标)
4. push-8 ¥10989.50 → 折扣后 ¥7362.96 33%
5. push-9 ¥12664.50 → 折扣后 ¥8485.21 33%
--- 计算 ---
达标前(笔 1-2)佣金: ¥(6748.5+7873.5) × 25% = ¥3,655.50
达标后(笔 3-5)佣金: ¥(9448.5+10989.5+12664.5) × 33% = ¥10,917.93
月佣金小计: ¥14,573.43
代扣个税(海外,< 800/月): ¥0
实付: ¥14,573.43
汇率: USD 1 = CNY 7.15
应付 USD: $2,037.27
============================================================
| 项 | 规则 |
|---|---|
| 客户折扣 | 统一 25% |
| 直接佣金 | 订单额的 25%;累计满 ¥10,000 后 33% |
| 上线佣金 | 上 1 级 5% / 上 2 级 3% / 3 级及以上 0% |
| 结算 | 每月 1 日出账 → 代理确认 → 平台复核 → 15 日前打款(T+15) |
| 分销码 | 4 位码终身锁定,介绍下线自动绑定 |
| 推广支持 | 宣传材料 + 佣金规则文档 + 对账单 |
| 项 | 规则 |
|---|---|
| 客户沟通 | 客户直接跟工厂谈,平台不撮合收钱(0 抽佣) |
| 数据归属 | 客户数据留客户自己服务器,代购 Token 自付 |
| 对账确认 | 收到月对账单后 7 个工作日内确认,逾期视为确认 |
| 异议处理 | 对账有疑问须在出账后 7 个工作日内提出 |
| 合规 | 不得刷单、不得虚报销售额、不得跨区恶意抢单 |
| 项 | 说明 |
|---|---|
| 结算周期 | T+15(每月 1 日出账,15 日前打款) |
| 结算币种 | CNY(平台按 USD 记账,按月汇率折算) |
| 发票 | 对公转账可开票,联系 factorihub@outlook.com |
| 税务 | 代理佣金收入的税务申报由代理自行处理;平台按要求提供佣金明细 |
⚠️ 代理审批、佣金条款与财务口径需法务、税务及支付合规复核后再大规模推广。
| 主体 | 无代理 | L1(25%) | L1+(33%) | ||
|---|---|---|---|---|---|
| 客户实付 | ¥1999 | ¥1499.25 | ¥1499.25 | ¥1399.30 | ¥1299.35 |
| 客户省 | 0 | ¥499.75 | ¥499.75 | ¥599.70 | ¥699.65 |
| 代理佣金 | 0 | ¥499.75(25%) | ¥659.67(33%) | ¥599.70(30%) | ¥699.65(35%) |
| 平台实收 | ¥1999 | ¥1499.25 | ¥1339.58 | ¥1399.30 | ¥1299.35 |
| 平台让利比例 | 0% | 25% | 33% | 30% | 35% |
乐观(100 个 L1 + 5 个上 1 级,月 100 单,平均 ¥1500):
基准(20 L1,月 30 单,平均 ¥1500):
目标:6 个月内月 50 单,9 个月内 30 个代理累计 1 万触发 33% 升级
结论:L1+ 奖励是用户增长投资,买来 30% 复购率与长期合作。
| 模块 | 状态 | 端点 |
|---|---|---|
| Chatbot 申请 | ✅ 跑通 | POST /api/agent/apply |
| 4 位码生成 | ✅ 撞码重试 | 内部 _gen_code() |
| 管理员审批 | ✅ 跑通 | POST /api/agent/approve |
| 代理查自己 | ✅ 跑通 + ytd_bonus_unlocked | GET /api/agent/me?code= |
| 分销链接追踪 | ✅ 跑通 | GET /api/agent/track/{code} |
| 客户注册折扣 | ✅ 跑通 + 自动 33% 升级 | POST /api/agent/apply-discount |
| DiggerChat 入口 | ✅ 跑通 | 关键词 "代理/分销/渠道" |
| 数据存储 | ✅ 3 个 JSON 文件 | _agents/{agents,clicks,sales}.json |
代理商:王芳代理(盛泽家纺)
4 位码:6799 · 等级:L1+(33% 佣金)
ytd_sales: ¥18,493.5
ytd_clicks: 1
ytd_signups: 13
bonus_unlocked: True
触发笔:push-7(第 7 笔,ytd 累计到 ¥10,989.50)
| 优先级 | 模块 | 工作量 |
|---|---|---|
| P0 | 客户注册表单加 4 位码输入框 | 2h |
| P0 | /?ref=XXXX 自动 banner | 1h |
| P0 | 月对账单 PDF 自动生成 | 4h |
| P0 | 月打款自动化(银行转账) | 8h |
| P1 | L1→L1+ 自动通知邮件 | 1h |
| P1 | L1+ 达标自动升级(¥10K 触发) | 已上线 |
| P1 | 2 级上线佣金分配(5%/3%) | 已上线 |
| P2 | 客户 dashboard 显示分销来源 | 2h |
| P2 | L1 嵌套下级代理关系 | 4h |
| P2 | 当地语言版本(越南/泰/印) | 12h |
| P3 | 代理审批 + 拒批流程 | 已上线 |
| P3 | 数据迁移 SQLite(> 30 代理) | 4h |
/opt/golddigger-textile/api/
agent_api.py · 11KB · 5 个核心函数(v13 含 33% 自动升级)
agent_route.py · 2KB · 5 个 FastAPI 路由
diggerchat_textile.py · +1 条代理分销 deterministic
textile_api.py · +12 行挂载点
/opt/golddigger-textile/sites/_agents/
agents.json · 1 个 demo 代理(盛泽家纺 · 6799)
clicks.json · 1 个 click
sales.json · 13 笔销售,累计 ¥18,493.5
| 风险 | 概率 | 缓解 |
|---|---|---|
| 代理刷单(自己注册虚假客户) | 中 | 33% 触发前必须先到 ¥10K,洗单成本提高 3 倍 |
| L1+ 升级后代理放弃 | 低 | 33% 永久,激励足够大 |
| 客户投诉折扣不一致 | 低 | 客户始终 25% 折扣,平台控制 |
| 平台让利过多 | 中 | 监控 L1+ 占比,< 30% 安全,> 50% 考虑降 L1+ 比例 |
| 月对账争议 | 中 | 14 天争议期 + 平台 1-3 工作日复审 |
| 汇率波动 | 中 | 美元结算 + 月对账固定汇率 |
| 月份 | 动作 | 目标 |
|---|---|---|
| 2026-11 | L1 申请开放 + 5-10 个招商 | 10 个 L1 · 5 单成交 |
| 2026-12 | 1 个 L1 触发 L1+ 33% | 15 个 L1 + 20 单/月 |
| 2027-01 | 越南/泰国本地化 | 5 个国家覆盖 |
| 2027-02 | L1 100 个目标 / 印度/巴西/中东 | 50 个 L1 · 30 单/月 |
| 2027-03 | 第 1 个合伙人达标(ytd ≥ ¥10K) | 5 个达标 + 50 单/月 |
| 2027-04 | L1+ 占代理 30%,2 级上线佣金跑量 | 收支平衡 / 月 50 单 |
附录 A · v1 → v1.1 变更
下一步等 user 拍板 7 个 ⏳ 决策点。
赋码原则:
referrer_code(上线代理 4 位码):_referrer_code_downlines 列表 push 自己的 code2 级嵌套佣金:
| 关系 | 触发 | 比例 | 资金来源 |
|---|---|---|---|
| 客户 → L1(直接) | 客户注册 | 25% (L1+ 触发后 33%) | 客户折扣款 |
| L1 → 上 1 级 L1(下线佣金) | 下线 L1 推 1 笔 | 5% | 下线月佣金的 5% 给上 1 级 |
| L1 → 上 2 级 L1(2 级下线) | 下线的下线推 1 笔 | 3% | 2 级下线的月佣金 3% 给上 2 级 |
| 3 级及以上 | 不返 | - | 避免套娃太深 |
示例:
6799(王芳) → 1983(张三) → 6944(李四) → 客户 1001
6944 推 1 笔 Pro ¥1999
├ 6944 自己拿 25% = ¥499.75
├ 1983 拿 5% = ¥24.99(1 级嵌套)
└ 6799 拿 3% = ¥14.99(2 级嵌套)
6799 月入:¥499.75(自己) + ¥24.99(张三) + ¥14.99(李四) = ¥539.73
防环检测:
A → B → A 检测后,新申请报错"无效推荐人")API 改动:
POST /api/agent/apply 加 referrer_code 字段(可选,4 位码)GET /api/agent/me?code= 多了 _downlines / _ytd_nested / nested_sales 字段_ytd_sales + _ytd_nested 两条线分别打款实测数据(2026-10-23):
6799(王芳) ytd_sales=¥55,480.50 ytd_nested=¥49.98
└ 1983(张三) ytd_sales=¥2,998.50
└ 6944(李四) ytd_sales=¥0 (1 笔失败重试)
api/v14_nested.py · 4.9KB · 2 级嵌套 + 防环 + 统计api/agent_api.py · 加 referrer_code 字段api/agent_route.py · apply 端点接收 referrer_code
POST /api/agent/apply 申请(可填 referrer_code)
POST /api/agent/approve 审批
GET /api/agent/me?code=XXXX 查自己 + _downlines / _ytd_nested
GET /api/agent/track/{code} 分销链接追踪
POST /api/agent/apply-discount 客户注册 + 嵌套佣金自动分配
POST /api/chat DiggerChat 入口