ZhiCms 产品库 — ZBlog PHP 版插件说明
一、插件简介
ZhiCms 产品库是一款集联盟商品搜索、选品采集、商品卡片展示、AI 导购助手于一体的 ZBlog PHP 插件。支持对接大淘客和好单库两大联盟 API，覆盖淘宝/天猫、京东、拼多多、唯品会四大主流电商平台，帮助站长快速搭建好物推荐内容。
- 版本：1.0.0
- 作者：ZhiCms
- 最低 PHP：5.6
- 支持 PHP：5.6 ~ 8.4
- 演示地址：http://zblog.zhicms.cc/zb_system/cmd.php?act=zhicms
- 下载地址： https://www.zhi.red/d/zblog/zhicms.zip
- 下载地址2：https://www.zhi.red/d/zblog/zhicms.zba
二、核心功能
1. 联盟库商品搜索
接入大淘客 + 好单库双 API，支持跨平台搜索淘宝、京东、拼多多、唯品会商品。搜索结果自动合并去重，按销量排序。
2. 选品采集入库
- 单条采集：将联盟库商品一键收录到本地选品库
- 批量采集：输入关键词，一次采集多条商品
- 支持按平台筛选（全部 / 淘宝 / 京东 / 拼多多 / 唯品会）
- 后台实时反馈采集结果
3. 选品库管理
后台表格化管理本地商品库，支持以下操作：
- 关键词搜索商品
- 商品置顶 / 取消置顶（置顶有效期 7 天）
- 删除商品
- 清理过期优惠券商品
4. 商品卡片短代码
在文章编辑器中点击「插入商品」按钮，选择商品即可插入短代码：
发布后自动渲染为美观的商品卡片，包含商品图、标题、价格、优惠券、销量、店铺等信息。同时支持在文章中直接手写短代码。
5. 转链跳转
用户点击商品卡片的「立即购买」按钮，插件自动通过联盟 API 完成转链，确保佣金归属。采用三层降级策略：
- 通过转链接口获取推广链接
- 兜底查询本地选品库
- 最后调用商品详情 API 获取链接
6. 前端产品库展示页
访问 https://你的域名/zb_system/cmd.php?act=zhicms 即可进入完整的产品库页面，支持：
- 淘宝 / 京东 / 拼多多 / 唯品会分平台筛选
- 关键词搜索
- 选品库 / 联盟库双数据源切换
- 分页加载
7. AI 导购助手
启用后，网站页面右下角会出现悬浮的 AI 导购按钮。用户点击可与 AI 对话：
- 智能识别购物意图，自动搜索相关商品
- 支持闲聊（调用 AI 大模型回复）
- 搜索到的商品以卡片形式展示，一键跳转购买
- 对话历史保存在本地，下次访问自动读取
8. 编辑器集成
在后台文章编辑页面，编辑器上方增加「插入商品」按钮，点击弹出商品选择弹窗，支持：
- 选品库 / 联盟库双 Tab 切换
- 选品库已有商品的快速选择插入
- 联盟库关键词搜索后采集/插入
- 一键生成
[zhicmsurl]短代码 - 兼容 UEditor / CodeMirror / 原生 textarea 编辑器
三、安装说明
方法一：后台上传
- 下载插件压缩包
zhicms.zip或zhicms.zba - 进入 ZBlog 后台 → 插件管理 → 安装插件
- 上传 zip 文件，激活插件
方法二：手动上传
- 将插件文件夹
zhicms上传到/zb_users/plugin/目录 - 进入 ZBlog 后台 → 插件管理，找到「ZhiCms 产品库」点击启用
卸载
在后台插件管理中停用并删除插件，将自动清除插件创建的数据表和配置。
四、插件设置
进入后台 → 插件管理 → ZhiCms 产品库右侧「设置」，或直接点击插件名称进入管理页。
API 密钥配置
| 配置项 | 说明 | 必填 |
|---|---|---|
| 大淘客 AppKey | 大淘客开放平台的应用 Key | 否* |
| 大淘客 AppSecret | 大淘客开放平台的应用 Secret | 否* |
| 大淘客 PID | 淘宝联盟推广位 ID，用于佣金归属 | 否 |
| 好单库 ApiKey | 好单库开放平台的 API 密钥 | 否* |
* 至少配置大淘客或好单库其中一项，否则无法使用联盟搜索和采集功能。
AI 导购配置
| 配置项 | 说明 | 必填 |
|---|---|---|
| 启用 AI 导购 | 开启后，网站页面右下角显示悬浮按钮 | 否 |
| AI 接口地址 | OpenAI 兼容 API 地址，如 https://api.openai.com/v1/chat/completions |
启用时必填 |
| API Key | AI 服务的 API 密钥 | 启用时必填 |
| 模型名称 | 使用的模型，如 gpt-3.5-turbo、deepseek-chat 等 |
启用时必填 |
| 系统提示词 | 自定义 AI 导购角色设定，留空使用默认提示词 | 否 |
五、API 密钥获取
大淘客开放平台
- 访问 https://www.dataoke.com/ 注册账号
- 进入控制台 → 应用管理，创建应用
- 获取 AppKey 和 AppSecret
- （可选）在淘宝联盟获取 PID，填入插件
好单库开放平台
- 访问 https://www.haodanku.com/ 注册账号
- 进入个人中心 → API 管理
- 获取 ApiKey
AI 大模型 (OpenAI 兼容)
- 直接使用 OpenAI API：https://platform.openai.com/
- 或使用国内代理/大模型服务：如 DeepSeek、通义千问、智谱等
- 获取 API 地址和 Key 填入设置
六、前端展示页配置
插件的前端产品库页面使用 ZBlog 主题的头部和底部，自动继承当前主题样式。
如需自定义展示页样式，可在主题中覆盖以下 CSS 类：
.zc-page— 页面容器.zc-header— 页面标题区.zc-search— 搜索栏.zc-tabs— 数据源切换标签.zc-plats— 平台筛选标签.zc-list— 商品列表.zcard— 商品卡片
七、常见问题
Q：为什么搜索不到商品？
A：请先检查是否已配置大淘客或好单库的 API 密钥，两个 API 至少配一个。
Q：商品卡片样式错乱？
A：编辑器插入的短代码确保在独立段落中，不要嵌套在其他标签内。
Q：转链跳转提示链接获取失败？
A：检查 PID 是否填写正确。同时确认 API 密钥有效且额度未用完。
Q：AI 导购不显示？
A：确认已开启 AI 导购开关，且 API 地址、Key、模型名称三个配置项均已填写。
Q：启用 AI 导购后 API 调用失败？
A：检查 API 地址是否能正常访问，确认 Key 有效。插件使用 cURL 发送请求，请确保服务器支持 cURL。
Q：支持哪些 PHP 版本？
A：支持 PHP 5.6 至 PHP 8.4，已做全版本兼容适配。