ZhiCms 产品库 — emlog 版插件说明

一、插件简介

ZhiCms 产品库是一款集联盟商品搜索、选品采集、商品卡片展示、AI 导购助手于一体的 emlog 插件。支持对接大淘客和好单库两大联盟 API，覆盖淘宝/天猫、京东、拼多多、唯品会四大主流电商平台，帮助站长快速搭建好物推荐内容。

• 版本：1.0.0
• 作者：ZhiCms
• 最低 PHP：5.6
• 支持 PHP：5.6 ~ 8.4
• 演示地址：https://www.zhi.red/?plugin=zhicms
• 下载地址： https://www.zhi.red/d/emlog/zhicms.zip

二、核心功能

1. 联盟库商品搜索

接入大淘客 + 好单库双 API，支持跨平台搜索淘宝、京东、拼多多、唯品会商品。搜索结果自动合并去重，按销量排序。

2. 选品采集入库

• 单条采集：将联盟库商品一键收录到本地选品库
• 批量采集：输入关键词，一次采集多条商品
• 支持按平台筛选（全部 / 淘宝 / 京东 / 拼多多 / 唯品会）

3. 选品库管理

后台表格化管理本地商品库，支持以下操作：

• 关键词搜索商品
• 商品置顶 / 取消置顶
• 删除商品
• 清理过期优惠券商品

4. 商品卡片短代码

在文章编辑器中点击「插入商品卡片」按钮，选择商品即可插入短代码：

施华蔻专业id补色发膜固色补色锁色红色紫色蓝色去黄洗发水护发素
¥0.00

发布后自动渲染为美观的商品卡片，包含商品图、标题、价格、优惠券、销量、店铺等信息。

5. 转链跳转

用户点击商品卡片的「立即购买」按钮，插件自动通过联盟 API 完成转链，确保佣金归属。采用三层降级策略：

1. 通过转链接口获取推广链接
2. 兜底查询本地选品库
3. 最后调用商品详情 API 获取链接

6. 前端产品库展示页

访问 https://你的域名/?plugin=zhicms 即可进入完整的产品库页面，支持：

• 淘宝 / 京东 / 拼多多 / 唯品会分平台筛选
• 关键词搜索
• 选品库 / 联盟库双数据源切换

7. AI 导购助手

启用后，网站页面右下角会出现悬浮的 AI 导购按钮。用户点击可与 AI 对话：

• 智能识别购物意图，自动搜索相关商品
• 支持闲聊（调用 AI 大模型回复）
• 搜索到的商品以卡片形式展示，一键跳转购买
• 对话历史保存在本地，下次访问自动读取

8. 编辑器集成

在后台文章编辑页面，编辑器上方增加「插入商品」按钮，点击弹出商品选择弹窗，支持：

• 选品库已有商品的快速选择插入
• 联盟库关键词搜索后采集/插入
• 一键生成 [zhicmsurl] 短代码

三、安装说明

方法一：后台上传

1. 下载插件压缩包 zhicms.zip
2. 进入 emlog 后台 → 插件 → 安装插件
3. 上传 zip 文件，自动安装并激活

方法二：手动上传

1. 将插件文件夹 zhicms 上传到 /content/plugins/ 目录
2. 进入 emlog 后台 → 插件，找到「ZhiCms 产品库」点击激活

卸载

在后台插件管理中停用并删除插件，将自动清除插件创建的数据表。

四、插件设置

API 密钥配置

进入后台 → 插件 → ZhiCms 产品库 → 设置，填写以下信息：

* 至少配置大淘客或好单库其中一项，否则无法使用联盟搜索和采集功能。

AI 导购配置

注意：emlog 版插件的 AI API 地址、API Key、模型名称由 emlog 系统级「设置 → AI 模型」统一管理。

五、API 密钥获取

大淘客开放平台

1. 访问 https://www.dataoke.com/ 注册账号
2. 进入控制台 → 应用管理，创建应用
3. 获取 AppKey 和 AppSecret
4. （可选）在淘宝联盟获取 PID，填入插件

好单库开放平台

1. 访问 https://www.haodanku.com/ 注册账号
2. 进入个人中心 → API 管理
3. 获取 ApiKey

六、常见问题

Q：为什么搜索不到商品？
A：请先检查是否已配置大淘客或好单库的 API 密钥，两个 API 至少配一个。

Q：商品卡片样式错乱？
A：CSS 样式兼容主流 emlog 主题。如遇问题，可在插件设置中调整。

Q：转链跳转提示「商品链接获取失败」？
A：检查 PID 是否填写正确。同时确认 API 密钥有效且额度未用完。

Q：AI 导购不显示？
A：确认已开启 AI 导购开关，且在 emlog 系统设置中已配置 AI 模型（API 地址、Key、模型名称）。

Q：支持哪些 PHP 版本？
A：支持 PHP 5.6 至 PHP 8.4，已做全版本兼容适配。