望远系列 · wangyuan_cms_v3.1 版本发布公告
望塬·远家族 · 望远系列 正式发布 v3.1 版本
一、命名体系说明
场景 写法 示例
家族名 中文 望塬·远家族
系列名 中文 望远系列
文件夹名 字母名 wangyuan_cms_v3.1_20260715
压缩包名 字母名 wangyuan_cms_v3.1_20260715.zip
网站标题 中文 + 字母 望远 · wangyuan_cms_v3.1_20260715
文件头注释 中文 + 字母 望远系列 · wangyuan_cms_v3.1_20260715
版本号 短版本 v3.1
版权信息 完整名称 望塬·远家族 · 望远系列
注意：本次版本号由 wangyuanjing_cms_v3.0 统一简化为 wangyuan_cms_v3.1，更简洁易记。
二、实验站
五站（wyjxq5.com） 已率先完成 v3.1 版本部署并稳定运行，所有新功能均经过真实环境验证。
三、版本升级指南（v3.0 → v3.1）
3.1 升级前准备
步骤 操作 说明
1 备份数据库 使用 phpMyAdmin 或 mysqldump 导出全部数据
2 备份文件 备份 data/ 目录（含所有图片附件）
3 下载新版 获取 wangyuan_cms_v3.1_20260715.zip 压缩包
3.2 核心改动与升级要点
① 首页分页重构（原有无限滚动）
项目 v3.0（旧） v3.1（新）
分页方式 无限滚动（自动加载） 传统页码分页
每页条数 固定 20 条 后台可设置（默认 30 条，必须为 3 的倍数）
页码导航 无 首页/上一页/数字页码/下一页/末页
升级注意事项：
请在后台 admin_setting.php 重新设置 每页显示条数
建议设置为 30、60、90、120 等能被 3 整除的数字
② 排序逻辑优化
项目 v3.0（旧） v3.1（新）
首页排序 按发帖时间 dateline 按最后活动时间 GREATEST(dateline, lastpost)
新帖排序 新帖可能沉底 新帖和新回复自动置顶
③ 假性置顶修复（重要）
问题 修复方式
删除评论后帖子仍被置顶 delete_comment.php 增加 lastpost 恢复逻辑
无回复帖子的 lastpost 被错误更新 执行批量修复 SQL
升级后必须执行（一次性修复，解决历史遗留问题）：
sql
UPDATE pre_forum_thread
SET lastpost = dateline
WHERE replies = 0 AND lastpost > dateline;
④ 评论系统增强
功能 v3.0（旧） v3.1（新）
评论排序 正序（旧评论在上） 倒序（最新评论在最上面）
评论编辑 不支持 评论作者和管理员可编辑
⑤ 编辑器体验优化
功能 v3.1 新特性
首行黑点 正文框首行左侧显示黑点（•），回车后不跟随，纯视觉辅助
⑥ 后台功能增强
功能 v3.0（旧） v3.1（新）
每页条数设置 无 新增，自动校验必须为 3 的倍数
三列图文数量 固定 3 后台可调（必须为 3 的倍数）
3.3 升级步骤
步骤 操作
① 备份数据库和 data/ 目录
② 解压 wangyuan_cms_v3.1_20260715.zip 覆盖到网站根目录
③ 执行上述 SQL 修复历史数据
④ 登录后台 /admin/admin_setting.php，设置每页条数
⑤ 访问首页验证分页和排序是否正常
⑥ 如有异常，恢复备份并联系技术支持
3.4 文件变更清单
文件 变更类型 说明
index.php 重构 无限滚动 → 分页，排序逻辑优化
view.php 增强 评论倒序 + 评论编辑
post.php 增强 首行黑点
edit_post.php 增强 首行黑点
admin_setting.php 增强 新增每页条数设置
delete_comment.php 修复 删除评论后恢复 lastpost
四、版本功能全景介绍
4.1 核心功能
分类 功能 说明
兼容性 Discuz! 数据无缝迁移 直接读取原表，零数据迁移
内容发布 富文本编辑器 WangEditor，支持图片上传、UBB 解析
内容展示 三列图文 + 标题列表 支持左图右文/上图下文切换
分页导航 传统页码分页 每页条数后台可设，三列完美对齐
用户系统 登录/注册/头像 兼容 Discuz! 密码加密
评论系统 发布/删除/编辑 最新评论在前，作者/管理员可编辑
搜索功能 标题关键词搜索 站内搜索，分页展示
管理后台 系统设置/广告/用户/照片墙 可视化配置，Logo/背景上传
附件管理 分类存储 帖子图/头像/Logo/背景 分目录管理
4.2 核心优势
优势 说明
零迁移成本 直接读取 Discuz! 原表，无需导入导出
轻量高效 只保留核心表（19张），移除冗余功能
三列完美对齐 每页条数强制为 3 的倍数，无空缺
动态排序 新帖和新回复自动置顶，社区活跃度一目了然
评论可控 作者/管理员可编辑删除，内容质量有保障
数据安全 删除评论时自动恢复 lastpost，杜绝假性置顶
移动适配 手机/电脑自适应，随时随地访问
4.3 适用场景
类型 适用说明
公益寻亲 信息发布与匹配，寻亲进度追踪
企业官网 品牌展示、新闻动态、产品介绍
个人博客 文章发布、分类归档、读者互动
技术社区 技术分享、问答讨论、经验交流
图片社区 摄影作品展示、视觉分享
地方门户 信息聚合、分类展示、便民服务
4.4 版本对比总览
对比项 v3.0 v3.1
分页方式 无限滚动 传统页码分页 ✅
每页条数 固定 20 后台可设（3的倍数） ✅
首页排序 仅发帖时间 发帖/回复混合置顶 ✅
评论排序 正序 倒序（最新在上） ✅
评论编辑 不支持 支持 ✅
假性置顶 存在 已修复 ✅
首行黑点 无 有 ✅
系统代号 wangyuanjing_cms wangyuan_cms ✅
五、下载与支持
项目 信息
当前版本 wangyuan_cms_v3.1_20260715
实验站 五站（wyjxq5.com）
家族 望塬·远家族
系列 望远系列