ZhiCms 5.0

专业的电商导购 CMS 系统 · 自研 MVC 框架 · 开箱即用

ZhiCms 是一套完整的电商导购/值得买网站解决方案，覆盖商品采集、内容推广、转链跳转、佣金变现的全链路。采用轻量自研框架，支持 PC / H5 / 微信小程序多端运行，SEO 友好，集成 AI 能力与插件生态，是个人站长和企业搭建导购平台的首选。

目录

• 为什么选择 ZhiCms
• 环境要求
• 快速开始
• 后台管理详解
  • 仪表盘
  • 发现管理
  • 社区管理
  • 页面管理
  • 电商宝库
  • 用户管理
  • 系统设置（详细说明）
  • 广告管理
  • 插件管理
  • AI 开放平台
  • 管理员管理
• 使用指南
  • 第一步：完成初始化配置
  • 第二步：搭建商品库
  • 第三步：发布内容
  • 第四步：上线运营
  • 第五步：社区冷启动
  • 第六步：数据分析与 SEO 优化
• 前台功能
• 第三方 API 集成
• 插件系统
• 配置说明
• 目录结构
• 技术栈
• Web 服务器配置
• 安全建议
• 常见问题
• 更新日志

为什么选择 ZhiCms

核心优势

与同类方案对比

环境要求

快速开始

1. 上传文件

将全部文件上传到网站根目录。

2. 设置目录权限

以下目录需要可写权限（Linux 执行 chmod -R 777）：

data/
data/config/
data/cache/
data/log/
upload/

3. 访问安装向导

浏览器访问网站域名，系统检测到未安装会自动跳转到安装向导。

按提示完成三步：

1. 环境检查 — PHP 版本、扩展、目录权限
2. 数据库配置 — 主机、端口、用户名、密码、库名、表前缀
3. 管理员设置 — 账号、密码、站点名称

4. 安装完成

• 前台：http://你的域名/
• 后台：http://你的域名/index.php?r=manage

使用安装时设置的管理员账号登录。

后台管理详解

仪表盘

登录后台后的首页面板，展示关键运营数据：

仪表盘还提供：

• 版本检测：自动检查官方是否有新版本发布
• 一键清除缓存：清除模板编译缓存和数据库查询缓存，修改配置或模板后使用

发现管理

发现管理是内容运营的核心，包含两个功能：

发现列表

展示所有已发布的好物推荐文章，每篇文章关联一个或多个商品。支持：

• 关键词搜索文章标题
• 分类筛选
• 编辑文章（修改标题、内容、SEO 信息）
• 删除文章

发布线索

创建新的推荐文章。编辑器中可以：

• 撰写好物推荐文案
• 插入商品卡片（从选品库选择已采集的商品）
• 设置分类和 SEO 关键词

一键采集：点击"采集"按钮，系统自动从好单库素材库拉取朋友圈风格的营销文案和关联商品信息，一键生成并入库，大幅降低内容创作门槛。

社区管理

管理微社区的全部内容。结构与前台社区一致：板块 > 小组 > 帖子。

页面管理

创建独立单页，适合"关于我们""商务合作""用户协议"等场景。每页支持：

• 自定义标题和正文内容
• 选择不同的显示模板
• 前台通过 /page/别名 访问

电商宝库

商品管理的核心区域，分为本地选品库和联盟库两个模块：

选品库

展示所有已入库的商品，可按分类筛选和关键词搜索。支持：

• 编辑商品信息（标题、价格、图片等）
• 商品置顶（设置置顶起止时间，置顶期间显示在列表最前面）
• 清理过期商品

联盟库

通过大淘客/好单库 API 实时从电商平台拉取商品：

• 多平台切换：淘宝、京东、拼多多、唯品会四个商品来源
• 搜索筛选：关键词搜索 + 分类筛选 + 是否有优惠券
• 比价模式：同一关键词下聚合展示各平台价格，一目了然
• 单条采集：找到合适的商品，点击"采集"入库
• 批量更新：系统自动拉取商品最新数据（价格变化、优惠券状态、销量、佣金等），保持库内商品信息新鲜

用户管理

管理前台注册用户：列表查看、添加/编辑用户信息（用户名/密码/手机号/VIP 标记/锁定状态）。

系统设置（详细说明）

系统设置是所有网站配置的集中管理页面，分为 8 个标签页：

基础设置

URL 设置

SEO 设置

可以为网站每个重要页面单独配置标题、关键词和描述：

文章详情页的 SEO 信息取自文章本身，不需要在此配置。

API 设置

短信设置

SEO 推送

自动将网站 URL 推送给搜索引擎，加速收录：

互动设置

AI 对话

配置小程序 AI 导购功能：

广告管理

管理网站广告位：

插件管理

显示所有已安装的插件和待安装插件。每个插件卡片展示：

• 名称、版本、作者、描述
• 来源格式标识（原生/Z-Blog/Emlog/WordPress）
• 安装状态（已启用/已停用/文件缺失）
• 操作按钮：设置、前台预览、启用/停用、卸载

插件市场可浏览和安装远程插件。

AI 开放平台

管理多个 AI 模型的配置。支持：

• 文本对话模型：OpenAI 兼容接口的大模型（DeepSeek、通义千问、Kimi、智谱 GLM 等）
• 图像生成模型：文生图模型
• 流式输出：SSE 实时打字机效果
• 系统提示词：每个模型可配置独立的系统提示词
• 会话历史管理：多轮对话上下文

应用场景：

• 后台右下角 AI 对话悬浮按钮（管理员使用）
• 前台 AI 购物助手（用户使用）
• 用户资料页 AI 生成个性签名
• 评论 AI 辅助回复

管理员管理

添加/编辑/删除后台管理员账户。

使用指南

以下是从零开始运营一个导购网站的完整流程：

第一步：完成初始化配置

1. 登录后台，进入 系统设置 → 基础设置
2. 设置网站名称、网址、Logo、关键词和描述
3. 填写备案号（如果有）和底部版权信息
4. 进入 SEO 设置，为首页、品牌页、排行榜、优惠券页分别配置 TDK（标题/关键词/描述）
5. 如果已申请淘客 API，进入 API 设置，填入大淘客或好单库的 AppKey 和 AppSecret，以及淘宝联盟 PID
6. 进入 URL 设置，开启伪静态（需服务器支持），选择首页默认展示

第二步：搭建商品库

1. 进入 电商宝库 → 联盟库
2. 在搜索框输入目标品类关键词（如"连衣裙""无线耳机"）
3. 切换平台标签查看淘宝、京东、拼多多、唯品会的商品
4. 勾选"有优惠券"筛选高性价比商品
5. 点击商品卡片上的"采集"按钮，商品即入库到本地选品库
6. 定期点击"批量更新"，让系统自动更新商品的价格、优惠券状态和销量

技巧：建议每个品类采集 50-100 个商品，保持商品信息新鲜有利于 SEO 收录。

第三步：发布内容

方式一：手动创作（适合精品内容）

1. 进入 发现管理 → 发布线索
2. 撰写推荐文案，例如"实测 5 款百元以内无线降噪耳机，第 3 款性价比炸裂"
3. 在编辑器中插入从选品库选择的商品卡片
4. 设置文章分类和 SEO 关键词
5. 发布

方式二：一键采集（适合快速起量）

1. 进入 发现管理 → 发现列表
2. 点击顶部的"采集"按钮
3. 系统自动从好单库素材库拉取朋友圈营销文案和关联商品
4. 自动生成带商品卡片的文章，一键入库

技巧：新品上架时用一键采集快速填充内容，精品内容用手动创作打磨质量。

第四步：上线运营

1. 开通社区：进入 互动设置，打开社区开关，设置板块和小组
2. 添加广告：进入 广告管理，上传首页轮播广告图
3. SEO 推送：进入 SEO 推送，配置百度/Bing Token，开启自动推送
4. 提交搜索引擎：将网站提交到百度站长平台、Bing Webmaster、Google Search Console
5. 生成 Sitemap：开启 Sitemap 功能，系统自动生成并 ping 搜索引擎

第五步：社区冷启动

1. 进入 社区管理 → 板块管理，创建 3-5 个板块（如"数码控""穿搭日记""居家好物"）
2. 在板块下创建 1-2 个小组
3. 发布 10-20 篇种子帖子（管理员账号，带商品卡片）
4. 当有自然用户互动后，社区会自己运转起来

第六步：数据分析与 SEO 优化

1. 定期查看后台仪表盘的文章数和商品数增长趋势
2. 查看 SEO 推送 → 推送日志，确认推送是否成功
3. 在百度站长平台查看收录情况和搜索关键词
4. 根据搜索关键词调整 SEO 设置中的 TDK
5. 定期进入联盟库做"批量更新"，淘汰失效商品

前台功能

首页展示

• 最新文章列表（30 分钟内），按时间倒序
• 按月/分类筛选文章
• 侧边栏（热门文章、推荐商品）
• 分页浏览

商品搜索与比价

• 五大数据源：本地库 + 淘宝 + 京东 + 拼多多 + 唯品会
• 跨平台比价：同一关键词聚合各平台最低价
• 淘宝链接识别：粘贴淘宝商品链接直达详情页
• 支持优惠券筛选、价格排序、销量排序

商品详情页

• 商品图片、标题、原价/券后价/优惠券金额
• 月销量、店铺名称、佣金信息
• 一键领券 + 购买跳转
• 自动走联盟推广链接，佣金归站长所有

商品跳转与转链

• 用户点击"去购买" → 系统调用淘客 API → 获取联盟推广链接 → 302 跳转
• 支持淘宝/京东/拼多多/唯品会四种平台转链
• 跳转链接带 PID，佣金自动计入站长账户
• 跳转结果缓存，减少 API 调用

风云榜

• 对接大淘客实时榜单接口
• 实时榜/全天热销榜/热推榜/综合热搜榜
• 按分类筛选，展示商品排行

品牌中心

• 品牌列表浏览（大淘客品牌栏目）
• 品牌详情页（品牌下商品列表）
• 支持分类筛选

优惠券商城

• 仿"什么值得买"精选页面
• 分类筛选 + 关键词搜索
• 展示优惠券商品（券后价/优惠券金额/销量）

移动端（H5）

• 自动 UA 检测，移动设备自动跳转 H5
• 三种移动端风格可选
• Vue 3 + Swiper 滑动交互
• ?pc=1 参数强制访问 PC 版

AI 购物助手

• 用户描述需求 → AI 识别购物意图 → 搜索站内商品推荐
• 全网比价模式：跨平台找最优价
• 非购物问题自动转 AI 大模型对话

用户中心

• 用户名/手机号/密码修改
• 我的收藏（帖子+文章）
• 评论历史

互动系统

• 文章评论：登录用户和匿名访客均可评论
• 嵌套回复：无限级嵌套回复
• 点赞：文章点赞 + 评论点赞
• 评论审核：可配置审核后显示
• 防刷机制：评论间隔秒数控制

第三方 API 集成

系统通过 ZhiCms/ext/Tjk/ 聚合层统一对接两大淘客平台：

大淘客 (DTK)

• 商品搜索/商品详情/转链
• 品牌栏目/排行榜/线报
• 最新商品拉取（定时更新）
• 分类列表

好单库 (HDK)

• 淘宝/京东/拼多多/唯品会商品搜索
• 商品详情/转链
• 朋友圈素材库（文案采集用）

转链说明

后台可选择大淘客或好单库作为转链引擎。你的 API Key 需要与转链方式匹配：大淘客密钥对应 DTK 转链，好单库密钥对应 HDK 转链。

插件系统

ZhiCms 独有的四合一插件兼容引擎：

支持的插件格式

目录结构

plugins/{插件别名}/
├── plugin.json       # 原生格式：元信息 + 配置
├── Plugin.php        # 主入口类，继承 BasePlugin
└── ...               # 其他插件文件

生命周期

安装 → 启用 → 注册钩子 → 运行 → 停用 → 卸载

系统钩子

配置说明

数据库配置

data/config/db.php — 安装时自动写入，支持读写分离：

'DB' => array(
    'default' => array(
        'DB_TYPE'    => 'MysqlPdo',   // MysqlPdo | Mysqli
        'DB_HOST'    => 'localhost',
        'DB_USER'    => 'root',
        'DB_PWD'     => '',
        'DB_PORT'    => '3306',
        'DB_NAME'    => 'zhicms',
        'DB_CHARSET' => 'utf8mb4',
        'DB_PREFIX'  => 'yun_',
        'DB_CACHE'   => 'DB_CACHE',
    ),
),

路由配置

data/config/rule.php — 自定义伪静态规则：

'REWRITE_ON' => 1,
'REWRITE_RULE' => array(
    'index.html'           => 'index/index/index',
    'view-<id>.html'       => 'index/index/view/id=<id>',
    'shequ.html'           => 'index/forum/index',
    'shequ-<gid>.html'     => 'index/forum/group/gid=<gid>',
    'tiezi-<id>.html'      => 'index/forum/view/id=<id>',
    // ... 更多规则
),

模板引擎配置

data/config/global.php：

'TPL' => array(
    'TPL_PATH'   => '',
    'TPL_SUFFIX' => '.html',
    'ENGINE'     => 'legacy',  // 'legacy' 或 'think'（ThinkTemplate）
),

模板开发

• 路径：app/{模块}/view/{控制器}/{方法}.html
• Legacy 语法：{$var} / {foreach $list as $v} / {if $cond}
• Think 语法：{$var} / {volist name="list" id="v"} / {include file="..."}
• 编译缓存：data/cache/tpl/，缓存 365 天，修改模板后需在后台清除缓存

目录结构

zhicms/
├── index.php                 # 入口文件
├── composer.json             # Composer 依赖
│
├── ZhiCms/                   # 核心框架
│   ├── core.php              #   框架启动（常量、自动加载、辅助函数）
│   ├── bootstrap.php         #   前置引导（Session、编码、Gzip）
│   ├── base/                 #   基础类库
│   │   ├── App.php           #     应用调度（路由→控制器）
│   │   ├── Config.php        #     配置管理
│   │   ├── Route.php         #     URL 路由
│   │   ├── Hook.php          #     钩子系统
│   │   ├── Controller.php    #     基础控制器
│   │   ├── Model.php         #     基础模型（CRUD + 分页）
│   │   ├── PluginManager.php #     插件管理器
│   │   ├── Template.php      #     Legacy 模板引擎
│   │   ├── ThinkTemplate.php #     Think 引擎适配
│   │   ├── compat/           #     多平台兼容层
│   │   ├── db/               #     数据库驱动（PDO/MySQLi）
│   │   ├── cache/            #     缓存驱动（File/Memcache/Memcached）
│   │   └── plugin/           #     插件基类
│   └── ext/                  #   扩展工具库
│       ├── Install.php       #     数据库安装
│       ├── Tjk.php           #     淘客 API 聚合层
│       ├── Tjk/Dtk.php       #     大淘客 API
│       ├── Tjk/Hdk.php       #     好单库 API
│       ├── Http.php          #     HTTP 请求库
│       ├── Upload.php        #     文件上传
│       ├── Image.php         #     图片处理
│       ├── Auth.php          #     权限认证
│       ├── Email.php         #     邮件发送
│       ├── Dbbak.php         #     数据库备份
│       ├── Page.php          #     分页组件
│       ├── Encrypter.php     #     加密解密
│       └── Pinyin.php        #     中文转拼音
│
├── app/                      # 应用模块
│   ├── index/                #   前台（24个控制器）
│   │   ├── controller/       #     首页/搜索/详情/社区/用户/移动端
│   │   └── view/             #     前台模板（80+ HTML）
│   ├── manage/               #   后台（15个控制器）
│   │   ├── controller/       #     仪表盘/文章/商品/插件/设置
│   │   └── view/             #     后台模板（45个HTML）
│   ├── api/                  #   API 模块（移动端/小程序）
│   ├── install/              #   安装向导
│   ├── base/                 #   基础共享模块
│   │   ├── controller/       #     基础控制器/错误处理
│   │   ├── model/            #     基础模型
│   │   └── hook/             #     系统钩子
│   ├── go/                   #   商品跳转模块
│   └── plug/                 #   插件前端模块
│
├── data/                     # 数据目录
│   ├── config/               #   配置文件
│   │   ├── db.php            #     数据库配置
│   │   ├── global.php        #     全局配置
│   │   ├── rule.php          #     路由规则
│   │   ├── siteconfig.php    #     站点设置
│   │   ├── seo.php           #     SEO 配置
│   │   ├── apiset.php        #     API 密钥
│   │   ├── version.php       #     版本号
│   │   ├── zhicms.sql        #     完整建表 SQL
│   │   └── install.lock      #     安装锁文件
│   ├── cache/                #   缓存文件
│   │   └── tpl/              #     模板编译缓存
│   └── log/                  #   系统日志
│
├── plugins/                  # 插件目录
├── public/                   # 静态资源
│   ├── web/                  #   PC 端（CSS/JS/图片）
│   ├── manage/               #   后台资源（emlog UI/JS）
│   ├── global/               #   全局资源
│   └── vendor/               #   前端依赖
│
├── upload/                   # 用户上传
├── vendor/                   # Composer 依赖
└── mini/                     # 微信小程序源码（uni-app）

技术栈

Web 服务器配置

Nginx

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/zhicms;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 禁止访问 data 目录
    location ~ /data/ {
        deny all;
    }
}

Apache

项目内置 .htaccess，确保 Apache 开启 mod_rewrite。

IIS

导入 web.config 或手动配置 URL Rewrite 模块。

安全建议

1. 安装完成后删除 /app/install/ 目录
2. Nginx 添加 deny all 规则禁止访问 data/ 目录
3. 使用强密码作为管理员密码
4. 定期备份 data/config/ 和数据库
5. 及时更新插件和框架版本
6. 生产环境将 rule.php 中 DEBUG 设为 0
7. 设置 PHP open_basedir 限制文件访问范围

常见问题

安装相关

Q: 安装时提示"数据库连接失败"？ 检查主机地址、端口、用户名、密码是否正确，确认 MySQL 服务已启动。如果数据库不存在，安装向导会自动创建。

Q: 安装后访问页面空白？ 检查 data/config/db.php 数据库配置是否正确，查看 data/log/ 错误日志，确认 PHP 版本 >= 7.0。

Q: 如何重新安装？ 删除 data/config/install.lock 文件，访问网站会自动跳转到安装向导。

运营相关

Q: 如何对接淘宝客？ 后台 → 系统设置 → API 设置，填入大淘客或好单库的 AppKey 和 AppSecret，以及淘宝联盟 PID。

Q: 商品没有佣金？ 确保已配置正确的 PID，转链方式与 API 密钥匹配（大淘客密钥 → DTK 转链，好单库密钥 → HDK 转链）。

Q: 如何添加新商品？ 方式一：后台 → 电商宝库 → 联盟库 → 搜索商品 → 点击"采集"按钮入库 方式二：后台 → 电商宝库 → 联盟库 → "批量更新"拉取最新商品

Q: 如何发布文章？ 方式一：手动发布 — 后台 → 发现管理 → 发布线索 方式二：一键采集 — 后台 → 发现管理 → 顶部"采集"按钮

Q: 首页如何显示内容？ 确保已发布文章，且文章状态为正常。可在 URL 设置中选择首页默认展示哪个频道。

Q: 如何让搜索引擎快速收录？ 后台 → 系统设置 → SEO 推送 → 配置百度/Bing Token → 开启自动推送 → 手动推送全站一次 → 等待 24-48 小时。

技术相关

Q: 如何切换模板引擎？ 修改 data/config/global.php，TPL.ENGINE 设为 legacy 或 think。修改后需清除缓存。

Q: 修改了模板但没生效？ 进入后台首页，点击"清除缓存"按钮。模板编译缓存默认有效 365 天，修改模板后必须手动清除。

Q: 如何添加自定义伪静态规则？ 在 data/config/rule.php 的 REWRITE_RULE 数组中添加正则匹配和路由映射。

Q: 如何开发插件？ 在 plugins/ 下创建目录，添加 plugin.json 和 Plugin.php，继承 BasePlugin 并实现 register() 方法。也可直接放入 WordPress/Z-Blog/Emlog 格式的插件，系统自动识别。

Q: 如何开启调试模式？ data/config/rule.php 中设 DEBUG 为 1，错误信息直接在页面显示。生产环境务必关闭。

Q: 如何备份网站？ 方式一：后台 → 数据库备份 方式二：导出 MySQL 数据库 + 压缩打包整个网站目录

更新日志

v5.0.0

• 重构框架核心，全面兼容 PHP 7.0 ~ 8.x
• 新增四合一插件兼容引擎（原生 + WP + ZB + Emlog）
• 新增微社区 v2 系统（板块/小组/帖子 + 多层嵌套回复 + 点赞 + 商品卡片）
• 新增图形化安装向导（环境检测 + 一键安装）
• 新增 AI 开放平台（多模型管理 + 对话 + 图像生成）
• 新增 AI 购物助手（智能导购 + 全网比价）
• 双模板引擎支持（Legacy + ThinkTemplate）
• 微信小程序（uni-app）
• SEO 推送系统（百度 + Bing + Sitemap + 自动/手动推送）
• 云端配置存储（配置持DB化 + 文件兜底）
• 伪静态 URL 自定义管理
• 移动端多风格切换
• WebP 上传自动转换
• 后台 Bootstrap 4 + SB Admin 2 现代化 UI
• 安全管理增强（CSRF 防护、XSS 过滤、SQL 注入防御）
• 前后端移动端全面适配