learn/其他业务/网站设计/文档库排序策略设计.md

📄 文档learn/其他业务/网站设计/文档库排序策略设计.md

🌱 创建于2026-06-27 01:04

✏️ 修改于2026-06-27 01:04

👁️ 浏览量—

🔗 短链接/~learn/s/ed10a8af

🔐 可见性

文档库排序策略设计

概述

文档库（/~learn）需要对所有文档进行智能排序，让浏览者能优先看到最重要的内容。单纯的浏览量排序会导致新文档永远无法曝光，单纯的时间倒序又忽略了文档的长期价值。因此采用时间 + 浏览量的综合加权排序。

---

加权公式

score = log(1 + views) × 0.4 + recency × 100 × 0.6

其中：

变量	说明	示例
------	------	------
`views`	文档浏览次数	0 → log(1)=0, 100 → log(101)≈4.6
`recency`	时间新鲜度 = 1/(1+days)	今天=1.0, 7天前≈0.125, 30天前≈0.032
`days`	距今天数	基于文档最后修改时间

权重解释

时间权重 0.6：新文档天然优先，确保最新内容能被看到
浏览量权重 0.4：热门文档获得加成，但不会压倒时间因素
log 衰减：浏览量从 0→10 的效果远大于 100→110，避免马太效应

场景举例

文档状态	views	days	score	排名
----------	-------	------	-------	------
今天发布，无人看	0	0	0 + 60 = 60.0	1
今天发布，10人看过	10	0	0.96 + 60 = 60.96	2
7天前，100人看过	100	7	1.85 + 7.5 = 9.35	3
30天前，500人看过	500	30	2.49 + 1.93 = 4.42	4

---

排序层级

目录级排序

计算目录内所有文档的总浏览量 + 最新修改时间
按加权分数降序排列目录
根目录（无子目录的散文件）始终排最前

文档级排序

目录内文档按各自加权分数降序排列
分数相同时按文件名字母序

---

实现细节

数据库

表 doc_views(doc_path TEXT PRIMARY KEY, view_count INTEGER) 存储在 quant.db
每次打开文档页面时，通过 /api/doc/view?path=xxx 异步记录浏览
使用 INSERT OR REPLACE 保证幂等

缓存策略

文档列表页（/~learn）设置 Cache-Control: no-cache，禁止浏览器缓存
确保用户浏览文档后返回列表时，浏览量立即反映在排序中

目录折叠

---

更新记录

日期	变更
------	------
2026-06-27	初始版本：时间+浏览量加权排序，log衰减，目录折叠

▶ 📜 变更历史（1 次提交）

4616ca62026-06-27 01:04docs: 同步 learn/ 文档 & 工作区改动

🍃quant 知识库

by 伊甸园和枫