From ce70d60188d827f8232cb19cbd2f8095dd691d85 Mon Sep 17 00:00:00 2001 From: karuo Date: Sun, 8 Mar 2026 10:53:07 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=84=20=E5=8D=A1=E8=8B=A5AI=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=202026-03-08=2010:53=20|=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=EF=BC=9A=E5=8D=A1=E5=9C=9F=E3=80=81=E6=80=BB=E7=B4=A2=E5=BC=95?= =?UTF-8?q?=E4=B8=8E=E5=85=A5=E5=8F=A3=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD?= =?UTF-8?q?=E6=9E=A2=E5=B7=A5=E4=BD=9C=E5=8F=B0=20|=20=E6=8E=92=E9=99=A4?= =?UTF-8?q?=20>20MB:=2011=20=E4=B8=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../土砖_技能复制/全站捆绑分销体系/SKILL.md | 119 ++++++++++++++++++ SKILL_REGISTRY.md | 1 + 运营中枢/工作台/gitea_push_log.md | 1 + 运营中枢/工作台/代码管理.md | 1 + 4 files changed, 122 insertions(+) create mode 100644 05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md diff --git a/05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md b/05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md new file mode 100644 index 00000000..d64e6445 --- /dev/null +++ b/05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md @@ -0,0 +1,119 @@ +--- +name: 全站捆绑分销体系 +description: 将「30天捆绑 + 全站消费分销」机制提取为可复用 SCALE，支持套用到其他网站/小程序。触发词：全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目。 +group: 土 +triggers: 全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目、捆绑机制、分销机制 +owner: 土砖 +version: "1.0" +updated: "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 或项目： + +```bash +cd /Users/karuo/Documents/个人/卡若AI +python3 "05_卡土（土）/土砖_技能复制/基因胶囊/脚本/gene_capsule.py" unpack 全站捆绑分销体系_*.json +``` diff --git a/SKILL_REGISTRY.md b/SKILL_REGISTRY.md index b5818b4a..2653d7bd 100644 --- a/SKILL_REGISTRY.md +++ b/SKILL_REGISTRY.md @@ -131,6 +131,7 @@ |:--|:---|:---|:---|:---|:---| | E01 | 商业工具集 | 土基 | 商业分析、竞品 | `05_卡土（土）/土基_商业分析/商业工具集/SKILL.md` | 竞品分析、商业画布 | | E02 | 技能工厂 | 土砖 | 创建技能、生成Skill | `05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md` | 批量创建/复制 SKILL | +| E02a | **全站捆绑分销体系** | 土砖 | **全站捆绑、30天捆绑、分销体系、消费捆绑、referral、复用到其他项目** | `05_卡土（土）/土砖_技能复制/全站捆绑分销体系/SKILL.md` | 30天捆绑+分销可复用 SCALE，可套用到其他网站/小程序 | | E07 | 基因胶囊 | 土砖 | **基因胶囊、打包技能、解包胶囊、继承能力、查胶囊、胶囊列表、pack-all** | `05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md` | Skill 打包为可遗传胶囊，pack/unpack/list/pack-all | | E03 | 流量自动化 | 土渠 | 刷流量、SEO | `05_卡土（土）/土渠_流量招商/流量自动化/SKILL.md` | SEO、流量投放自动化 | | E04 | 手机流量自动操作 | 土渠 | 手机自动化、AutoGLM | `05_卡土（土）/土渠_流量招商/手机与网页流量自动操作/SKILL.md` | 手机 App 自动化操作 | diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index c2109bc4..6dad6dbd 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -252,3 +252,4 @@ | 2026-03-08 00:32:16 | 🔄 卡若AI 同步 2026-03-08 00:32 | 更新：金仓Gitea脚本与配置、运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-08 08:27:32 | 🔄 卡若AI 同步 2026-03-08 08:27 | 更新：金仓Gitea脚本与配置、运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-08 09:02:30 | 🔄 卡若AI 同步 2026-03-08 09:02 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | +| 2026-03-08 09:14:27 | 🔄 卡若AI 同步 2026-03-08 09:14 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index 38b59189..fc192d8c 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -255,3 +255,4 @@ | 2026-03-08 00:32:16 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-08 00:32 | 更新：金仓Gitea脚本与配置、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-08 08:27:32 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-08 08:27 | 更新：金仓Gitea脚本与配置、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-08 09:02:30 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-08 09:02 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | +| 2026-03-08 09:14:27 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-08 09:14 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |