淘宝客独立应用

版本 v1.0.0· 胡思乱想 · 2 次获取 · 独立应用

为站点接入大淘客（淘宝联盟）导购能力的完整插件：帖内变现、独立导购站、会员资产、邀请裂变、订单返利、数据报表与运营工具。前台入口 `/taoke`，后台入口「插件 → 淘宝客」。

100.00原价

一次购买，永久使用

详情介绍

淘宝客插件使用说明

为站点接入大淘客（淘宝联盟）导购能力的完整插件：帖内变现、独立导购站、会员资产、邀请裂变、订单返利、数据报表与运营工具。前台入口 /taoke，后台入口「插件 → 淘宝客」。

1. 安装与升级

将 taoke 目录放入 plugins/。
后台「插件管理」点击安装；安装会自动创建 13 张数据表并同步静态资源到 public/static/taoke/。
已安装过旧版时，插件启动会自检缺表（taokepricelog、taokeapilog）并自动补建，无需手工执行 SQL。
卸载会删除全部 taoke_* 数据表与配置，请提前备份。

2. 基础配置（后台 → 插件 → 淘宝客 → 设置）

配置项	说明
`appkey / app``secret`	大淘客开放平台应用凭据。留空时插件降级为纯本地商品库模式，接口类功能（拉取/搜索/转链/订单核对）不可用。
`pid`	淘宝联盟 PID（`mmxxxxxx_xxx`），用于转链。
`cache_minutes`	接口数据缓存分钟数（默认 30）。
`page_size`	前台列表每页数量。
`goodskeepdays` / `goods_cap`	本地商品库保留天数 / 数量上限，超出后按最旧清理。
`postconvert / post``card_limit`	帖子内容自动变现开关；单帖商品卡上限（1–5）。
`replace_limit`	单个关键词单帖替换上限默认值。
`linkconvertlimit`	单帖淘链/淘口令自动转按钮上限（1–20）。
`rebate_rate`	返利比例：积分 = 佣金 × 比例（佣金 1 元、比例 50 → 发 50 积分）。
`rebateminamount`	返利发放门槛（佣金低于该值的订单不发放）。
`invite_rate`	邀请分成比例：被邀请人订单发放返利时，邀请人额外获得佣金 × 比例的积分。
`credit_currency`	发放资产类型：`coins` / `gold` / `cny`（依赖社区插件 Coin 体系）。
`ipratelimit`	单 IP 每分钟请求频次限制（搜索/转链/中转跳转）。
`cron_key`	计划任务密钥。留空时仅允许已登录的管理员访问 cron 地址。
`cron_pull`	计划任务是否顺带拉取精选商品入库。
`pricealert / alert``interval_days`	收藏商品降价提醒开关；同一商品提醒间隔天数。
`ordertimeoutdays`	订单核对超期天数（默认 60），超期未结算自动判无效。

3. 前台导购站

/taoke 首页：榜单、分类导航、9.9 包邮/爆款/折上折/官方活动专区入口、热词。
/taoke/search?q=关键词 搜索：接口 → 缓存 → 本地快照三级数据源；/taoke/suggest 提供搜索联想。
/taoke/zone/{zone} 专区：nine（9.9 包邮）、hot（热销榜）、explosive（爆款）、discount（折上折）、brand（品牌）、topic（官方活动）。
/taoke/detail/{goodsId} 详情页：图文、券信息、预估返利、近 30 天价格走势（SVG）、分享海报（Canvas + 二维码）、JSON-LD 结构化数据、收藏/复制淘口令/失效反馈。
/taoke/go/{goodsId} 出站转链（带点击统计与 IP 频控）；/taoke/out?url= 用于帖内淘链中转，仅允许淘宝/天猫域名。
/taoke/cate/{id} 分类列表、/taoke/sitemap 站点地图供搜索引擎收录。
/taoke/member 会员中心：我的收藏（含降价提醒状态）、浏览足迹、我的返利订单、提交订单号、邀请链接与邀请统计。

4. 帖内变现（filterHtml 钩子）

开启 post_convert 后，帖子/文章正文输出时自动处理，且不破坏 <a>/<script>/<style>/<textarea> 既有结构：

短代码

- [taoke]商品ID[/taoke] 渲染商品卡（受单帖上限约束）。

- [taoke type="search" q="关键词"] 内嵌搜索框。

- [taoke type="cate" id="分类ID" name="按钮名"] 分类直达按钮。

关键词替换（后台「关键词管理」维护）

- card：命中词替换为商品卡（可绑定指定商品 ID）。

- search：替换为内嵌搜索框。

- cate：替换为分类按钮。

- 超出单帖/单词上限时保留原文。

淘链与淘口令：正文中的 ￥xxx￥ 与淘宝/天猫裸链自动转为「领券购买」按钮，点击经 /taoke/out 中转解析为推广链接。

5. 商品调用组件

后台「商品组件」创建组件后，获得调用代码：

<div class="tk-widget" data-id="组件ID"></div>

粘贴到任意模板位置即可渲染。支持数据源：指定商品 ID、本地商品库（可按分类）、关键词搜索；布局：grid 网格 / big 大卡（可定时轮换）/ swipe 横滑 / list 列表 / search 搜索框+结果；可开关券标签、原价、销量、按钮、返利提示。数据接口为 /taoke/widget/{id}。

6. 订单返利流程

会员在 /taoke/member/order 提交淘宝订单号（防重复申报）。
计划任务核对：runCron 每小时调用大淘客订单接口，按订单号匹配申报记录；状态 3=结算、14=确认收货 视为已结算并记录佣金；超期未结算自动判无效；低于门槛判无效。
发放返利：已结算订单在事务内条件更新（防重复发放）→ 按 rebaterate 发放站点资产 → 若该会员由他人邀请注册，按 inviterate 向邀请人发放分成；任何一步失败整体回滚。
会员侧资产变动通过社区插件 Coin::change 记账，类型 taokerebate / taokeinvite。

7. 邀请裂变

分享海报、详情页邀请链接均带 ?inviter=UID；访客访问后写入 7 天 Cookie，注册/登录后自动绑定邀请关系。
邀请人可在会员中心查看邀请人数与分成明细。

8. 计划任务（重要）

在服务器/面板中添加定时任务，每小时访问一次：

http(s)://你的站点/taoke/cron?key=你的cron_key

执行内容：订单核对与返利发放、降价提醒检查（收藏商品现价低于收藏基准价时推送站内通知，同一商品按 alertintervaldays 节流）、按 cron_pull 拉取精选商品、清理过期缓存与商品。
密钥留空时仅允许已登录管理员触发；后台「缓存管理」页提供「立即执行」按钮与当前状态展示。

9. 后台功能一览

菜单	功能
概览	商品/关键词/收藏/点击/搜索统计、待核对与待发放订单、今日接口调用与失败数、API 配置/计划任务/SEO 自检
商品库	拉取精选入库、编辑、置顶/拉黑/失效处理、清理过期
关键词管理	card/search/cate 三类关键词的增删改与替换上限
订单管理	返利订单审核、手工核对、状态变更
返利管理	已结算订单的发放执行与记录
数据报表	14 天点击趋势、搜索词 TOP10、返利榜、拉新榜、失效反馈榜、接口调用看板
商品组件	组件创建与嵌入代码
缓存管理	短缓存统计与清理、商品库清理、计划任务地址与立即执行

10. 接口与数据结构速查

大淘客签名：参数 ksort 后拼接 key+value+secret 取 md5 大写；请求 version=1.2.4；SSL 默认校验，本地缺 CA 时自动降级并在接口看板记录。
价格轨迹 taokepricelog：详情页每次访问记录当日价，走势图取近 30 条。
接口看板 taokeapilog：按日聚合每个接口的调用/失败次数与最近错误。
缓存 taoke_cache：键值 + 过期时间，缓存内容统一 JSON 序列化。

11. 常见问题

搜索/拉取无结果：检查 appkey/appsecret 是否配置；查看后台「数据报表 → 接口调用看板」的最近错误。
返利没发放：确认 cron 已配置且「缓存管理」显示最近执行时间；订单需先达到「已结算」状态且佣金 ≥ 门槛。
降价提醒收不到：确认 pricealert=1 且消息插件已启用 taokeprice_drop 通知事件；未启用时降级为页面弹窗通知。
帖内不替换：确认 post_convert=1、关键词 status=1，并注意单帖各类上限；受保护的 HTML 块内不会替换。

更新记录（1）

v1.0.0 2026-11-07
正式发布