karuo-ai/05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md

name, description, group, triggers, owner, version, updated

name	description	group	triggers	owner	version	updated
全站捆绑分销体系	将「30天捆绑 + 全站消费分销」机制提取为可复用 SCALE，支持套用到其他网站/小程序。触发词：全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目。	土	全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目、捆绑机制、分销机制	土砖	1.0	2026-03-08

全站捆绑分销体系

归属：土砖（技能复制）
来源：一场soul的创业实验-永平 实战提炼
用途：可复用到任意有「全站消费 + 分销」需求的网站、小程序、付费内容项目。

---

能做什么（Capabilities）

• 提取：从实战项目提炼 30 天捆绑 + 分销的完整规格（SCALE）
• 复用：按 SCALE 快速套用到新项目（数据库、API、定时任务、提现）
• 查阅：快速定位核心规则、表结构、接口逻辑、复用 checklist
• 打包：本 Skill 已导出为基因胶囊，可 unpack 继承到其他 Agent/项目

---

怎么用（Usage）

触发词：全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目、捆绑机制、分销机制

典型场景：

1. 「新项目要做分销，参考永平的 30 天捆绑机制」
2. 「帮我把分销体系做成可复用的 scale」
3. 「全站消费捆绑，类似 soul 那套，怎么设计」

---

核心规格（SCALE 摘要）

30 天捆绑规则

规则	说明
动态绑定	用户点击谁的链接即绑定谁，可随时切换
佣金归属	购买时佣金给当前绑定推荐人
30 天有效	绑定日起 30 天，同一推荐人再次点击可续期
自动解绑	30 天到期且无购买 → 自动解绑

关键表

• referral_bindings：referee_id、referrer_id、status(active/cancelled/expired)、expiry_date、purchase_count、total_commission
• users：referral_code、pending_earnings
• orders：referrer_id、referral_code

关键接口

• POST /api/referral/bind：绑定/切换/续期
• 下单时：先查 binding → 写 orders.referrer_id
• 支付回调：查 binding → 分佣（90%）→ 累加 purchase_count
• 定时任务：每天解绑 purchase_count=0 且过期的记录

---

执行步骤（Steps）

1. 查 SCALE 文档

主文档：开发/3、自营项目/一场soul的创业实验-永平/开发文档/9、手册/全站捆绑分销体系-SCALE.md

含：核心理念、数据库设计、API 逻辑、概念区分、提现流程、复用 checklist。

2. 套用到新项目

1. 按 SCALE 建表（referral_bindings、users/orders 扩展、withdrawals）
2. 配置 referral_config（分成比例、bindingDays、minWithdrawAmount）
3. 实现 bind 接口（动态切换 + 30 天）
4. 下单/支付逻辑：写 referrer_id、分佣、累加
5. 配置定时任务：每天解绑过期无购买
6. 前端：分享链接 ref=邀请码，登录后调 bind

3. 参考源项目文档

文档	路径
新分销逻辑设计方案	开发文档/8、部署/新分销逻辑设计方案.md
邀请码分销规则说明	开发文档/8、部署/邀请码分销规则说明.md
分销与绑定流程图	开发文档/8、部署/分销与绑定流程图.md
分销提现流程图	开发文档/8、部署/分销提现流程图.md

---

相关文件（Files）

文件	说明
开发/3、自营项目/一场soul的创业实验-永平/开发文档/9、手册/全站捆绑分销体系-SCALE.md	主 SCALE 文档
开发文档/8、部署/新分销逻辑设计方案.md	详细设计
开发文档/8、部署/分销与绑定流程图.md	流程图
基因胶囊	卡若Ai的文件夹/导出/基因胶囊/全站捆绑分销体系_*/

---

依赖（Dependencies）

• 前置技能：无
• 外部工具：无
• 源项目：一场soul的创业实验-永平（soul-api、miniprogram）

---

基因胶囊

本 Skill 已打包为基因胶囊，可 unpack 继承到其他 Agent 或项目：

cd /Users/karuo/Documents/个人/卡若AI
python3 "05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py" unpack 全站捆绑分销体系_*.json