From d3070bea5b3eb0a649732eeae8a649ee073619bd Mon Sep 17 00:00:00 2001 From: laoyang Date: Mon, 26 Oct 2026 22:30:02 +0800 Subject: [PATCH] =?UTF-8?q?3.2.49:=20=E4=BF=AE=E3=80=8C=E6=96=87=E7=AB=A0?= =?UTF-8?q?=E8=81=9A=E5=90=88=E2=86=92=E7=83=AD=E7=82=B9=E3=80=8D=E5=8F=AA?= =?UTF-8?q?=E6=98=BE=E7=A4=BA=E4=B8=80=E6=9D=A1=EF=BC=88=E6=8D=A2=E5=85=A8?= =?UTF-8?q?=E7=AB=99=E7=B4=AF=E8=AE=A1=E7=83=AD=E5=BA=A6=E7=AE=97=E6=B3=95?= =?UTF-8?q?=EF=BC=89=20#19?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 根因不是排序，是候选池：旧 SQL 先圈「最近 30 天发布」再按评论排序取 6。 本站实测 30 天只有 1 篇 post（7 天 0 / 90 天 1 / 180 天 6 / 365 天 15 / 全站 967）， 候选池只有 1 条，LIMIT 6 也只能返回 1 条。 改成全站累计热度，三项取对数加权： 3*log10(views+1) + 5*log10(love+1) + 4*log10(comments+1) · 取 log10：views 中位 4981/最大 56075，而 love 最大 40、评论最大 93， 不压缩则 views 一项吃掉全部权重。 · 权重 3/5/4（不是通用 1/3/5）：用通用值实测前 8 名 6 篇是 2009 年老随笔 —— 评论 1.97*5=9.86 > views 4.75*1=4.75，退化成「评论数排行榜」。 · 有意不加时间衰减：HN/Reddit 那套是「新内容榜」，会把老文压到看不见， 正好回到原问题。要时效榜是另一个功能。 · 仍限定 post_type='post'（用户要求只看文章，不看 page； ID 217「留言本」/522「博客时间」核查过都是 page，天然被挡掉）。 顺手修掉三处旧问题： · 删 date_default_timezone_set("PRC") —— 它会改掉整个 PHP 请求的全局时区 · 标题进属性改 esc_attr()（旧代码裸拼，含双引号会截断 title 属性） · get_posts 参数从 'numberposts=6 & offset=0' 字符串改成数组 （字符串里那个空格让参数名变成 ' offset'，offset=0 实际从未生效） 后台：「统计天数」输入框下线（它控制的就是那个缩死候选池的时间窗）， update() 不再保存 days，老实例残留值下次保存时丢掉。 验证： · 主测试 33/0（分数用独立实现重算比对，不调用产品函数算期望值） · 反向验证 20/0（基线 2 + 框架自检 2 + 注入 8 组×2） 八组注入：时间窗加回 / 去 post_type / 去 log10 / 权重改 1-3-5 / 标题退裸拼 / 全局时区加回 / 排序改升序 / 后台加回统计天数 · 真浏览器几何 22/0（1440+1180 两视口）：6 条真画出来、宽度等于面板、 图标存在、不重叠、长标题走省略号不溢出 · 发布反证 8/8、线上包校验 10/10 --- inc/theme-widgets.php | 222 ++++++++++++++++++++++++++++++++++++------ style.css | 2 +- 2 files changed, 192 insertions(+), 32 deletions(-) diff --git a/inc/theme-widgets.php b/inc/theme-widgets.php index 15d0958..8dd40ed 100644 --- a/inc/theme-widgets.php +++ b/inc/theme-widgets.php @@ -35,26 +35,163 @@ function widgets_init() } add_action('widgets_init', 'widgets_init'); -// 小工具文章聚合 - 热点文章 +/* ========================================================================== + * 热度算法（3.2.49） + * + * ── 为什么废弃旧的 most_comm_posts() ────────────────────────────────── + * 旧实现的候选池是「最近 N 天（默认 30）**发布**的文章」： + * + * WHERE post_date BETWEEN '$daysago' AND '$today' + * ORDER BY comment_count DESC LIMIT 6 + * + * 对日更站点没问题，对低频更新的站点直接失效。本站实测（2026-10-26）： + * 7 天内发布 0 篇 / 30 天内 1 篇 / 90 天内 1 篇 / 180 天内 6 篇 + * 30 天候选池只有 1 篇 ⇒ LIMIT 6 也只能返回 1 条。 + * 这就是侧栏「热点」永远只显示一条的真正原因 —— **不是排序错，是池子空**。 + * + * 而且「最近 30 天发布」本身就不是「热」的定义：热是累计互动，不是新鲜度。 + * + * ── 现在的算法 ──────────────────────────────────────────────────────── + * 候选池：全站所有已发布 post（不含 page —— 「留言本」这种页面 views 214 万， + * 它的热度对"最热文章"没有意义；`post_type='post'` 天然挡掉）。 + * 打分：三个指标各取 log10 后加权求和 + * + * score = 3*log10(views+1) + 5*log10(love+1) + 4*log10(comments+1) + * + * 为什么取 log10：本站 views 中位数 4981、最大 56075（差 11 倍）， + * 但 love 最大只有 40、评论最大 93。不取对数的话 views 一个指标就吃掉 + * 全部权重，点赞和评论等于没参与。取对数后三者量级被拉平到可比的区间。 + * + * 为什么权重是 3 / 5 / 4（不是常见的 1 / 3 / 5）： + * 用通用值实测，前 8 名有 6 篇是 2009 年的老随笔 —— 因为那批文章评论 + * 80~93 条，仅评论一项（1.97×5=9.86）就压过 views 最大值的贡献（4.75×1=4.75）， + * 结果变成"评论数排行榜"。把 views 权重提到 3 之后三个指标影响力均衡： + * 点赞最高（5）—— 点👍 是比评论更强的认可信号，且本站只有 197 篇有点赞， + * 稀缺性让它更有区分度；评论次之（4）—— 要付出打字成本；浏览最轻（3）。 + * + * 实测这组权重的排名（前 8）：Anaconda多用户安装(love=40) · kratos主题发布(love=9,评论37) + * · LaTex上划线(love=19) · 那一年2009 · LaTex字体(love=12) · Windows7自带WMP(评论93) + * → 技术文章与高互动随笔混合出现，2009 年那批也没有被完全埋掉。 + * + * ── 有意不加时间衰减 ────────────────────────────────────────────────── + * 「全站历史最热」是累计榜，不是时效榜。Hacker News / Reddit 那套 + * gravity 衰减是给「新内容榜」用的，加上去会把老文章压到看不见， + * 那就又回到"只有最近几条"的老问题。要时效榜是另一个功能，不塞在这里。 + * + * ── 顺手修掉的两个坑 ────────────────────────────────────────────────── + * ① 旧代码里 `date_default_timezone_set("PRC")` 直接改 **PHP 全局时区**， + * 影响同一请求里之后所有时间函数。已删。 + * ② 旧代码把 `$title` 原样插进 `title="..."` 属性，标题里有双引号就会 + * 截断属性（甚至注入）。已改用 esc_attr()。 + * ====================================================================== */ + +if (!function_exists('yang_hot_score')): + + /** + * 单篇文章的热度分。 + * + * @param int $views 浏览数 + * @param int $love 点赞数 + * @param int $comments 评论数 + * @return float + */ + function yang_hot_score($views, $love, $comments) + { + return 3 * log10((int) $views + 1) + + 5 * log10((int) $love + 1) + + 4 * log10((int) $comments + 1); + } + +endif; + +if (!function_exists('yang_hot_posts')): + + /** + * 取热度最高的文章。 + * + * 为什么在 PHP 里算分、不在 SQL 里 ORDER BY： + * 分值是三项 log 加权和，SQL 里要写三段 LOG10 + COALESCE + 两个 + * LEFT JOIN 到 postmeta，可读性极差，而且没法复用 yang_hot_score() + * （测试和产品必须是同一份实现，不能各写一遍）。 + * 代价是要把候选行取回来 —— 本站 967 篇 post，一次取 4 个字段 + * 内存占用可忽略；如果将来文章上万，再加 LIMIT / 缓存。 + * 为防止极端情况，SQL 侧先用 views 粗排取前 N*10（对数排序里 + * 真正的高分不会来自 views 极低的文章，这个粗排是安全的）。 + * + * @param int $nums 返回条数 + * @return array 文章对象数组，每项含 ID/post_title/views/love/comments/score + */ + function yang_hot_posts($nums = 6) + { + global $wpdb; + + $nums = max(1, (int) $nums); + // 粗排窗口：给足余量。views 前 200 名以外不可能靠 love/评论翻盘 + // （log10 域下，love 满分 1.61×5=8.05，补不回 views 差 1 个数量级的 3 分）。 + $pool = max(200, $nums * 20); + + $sql = $wpdb->prepare( + "SELECT p.ID, p.post_title, p.post_date, p.comment_count, + COALESCE(CAST(mv.meta_value AS UNSIGNED), 0) AS views, + COALESCE(CAST(ml.meta_value AS UNSIGNED), 0) AS love + FROM {$wpdb->posts} p + LEFT JOIN {$wpdb->postmeta} mv ON mv.post_id = p.ID AND mv.meta_key = 'views' + LEFT JOIN {$wpdb->postmeta} ml ON ml.post_id = p.ID AND ml.meta_key = 'love' + WHERE p.post_status = 'publish' + AND p.post_type = 'post' + ORDER BY views DESC + LIMIT %d", + $pool + ); + $rows = $wpdb->get_results($sql); + if (empty($rows)) { + return array(); + } + + $scored = array(); + foreach ($rows as $r) { + $r->views = (int) $r->views; + $r->love = (int) $r->love; + $r->comments = (int) $r->comment_count; + $r->score = yang_hot_score($r->views, $r->love, $r->comments); + $scored[] = $r; + } + + usort($scored, function ($a, $b) { + if ($a->score == $b->score) { + // 同分按浏览数兜底，保证顺序稳定（否则每次刷新顺序会跳） + return $b->views <=> $a->views; + } + return $b->score <=> $a->score; + }); + + return array_slice($scored, 0, $nums); + } + +endif; + +/** + * 小工具文章聚合 —— 热点文章 + * + * ⚠️ 这个函数名和签名保留着，因为 `widget_posts::widget()` 里有一句 + * `if (function_exists('most_comm_posts'))` 调用它。留着旧名不破兼容， + * 但内部已经完全换成 yang_hot_posts()。 + * + * @param int $days 已废弃。旧实现用它当"最近 N 天发布"的时间窗， + * 那正是只显示一条的根因。保留参数只为不破坏调用签名。 + * @param int $nums 返回条数 + */ function most_comm_posts($days = 30, $nums = 6) { - global $wpdb; - date_default_timezone_set("PRC"); - $today = date("Y-m-d H:i:s"); - $daysago = date("Y-m-d H:i:s", strtotime($today) - ($days * 24 * 60 * 60)); - $result = $wpdb->get_results("SELECT comment_count, ID, post_title, post_date FROM $wpdb->posts WHERE post_date BETWEEN '$daysago' AND '$today' and post_type='post' and post_status='publish' ORDER BY comment_count DESC LIMIT 0 , $nums"); + $posts = yang_hot_posts($nums); + $output = ''; - if (!empty($result)) { - foreach ($result as $topten) { - $postid = $topten->ID; - $title = $topten->post_title; - $commentcount = $topten->comment_count; - if ($commentcount >= 0) { - $output .= ''; - $output .= strip_tags($title); - $output .= ''; - } - } + foreach ($posts as $p) { + $output .= '' + . '' + . esc_html(wp_strip_all_tags($p->post_title)) + . ''; } echo $output; } @@ -314,8 +451,10 @@ class widget_posts extends WP_Widget public function widget($args, $instance) { - $number = !empty($instance['number']) ? $instance['number'] : '6'; - $days = !empty($instance['days']) ? $instance['days'] : '30'; + $number = !empty($instance['number']) ? (int) $instance['number'] : 6; + if ($number < 1) { + $number = 6; + } echo '
'; ?> @@ -331,16 +470,37 @@ class widget_posts extends WP_Widget
@@ -351,25 +511,25 @@ class widget_posts extends WP_Widget { $instance = array(); - $instance['number'] = (!empty($new_instance['number'])) ? $new_instance['number'] : ''; - $instance['days'] = (!empty($new_instance['days'])) ? $new_instance['days'] : ''; + $instance['number'] = (!empty($new_instance['number'])) ? (int) $new_instance['number'] : 6; + /* `days` 已废弃：旧实现拿它当「最近 N 天发布」的时间窗， + * 那正是热点只显示一条的根因。这里不再保存， + * 老实例里残留的 days 值会在下次保存时被丢掉。 */ return $instance; } public function form($instance) { - global $wpdb; $number = !empty($instance['number']) ? $instance['number'] : '6'; - $days = !empty($instance['days']) ? $instance['days'] : '30'; ?>

-

- - +

+
+