UrlNav 更新日志(CHANGELOG)
本文件由历次改动的备份目录 +修改记录.md+ 工作区日志汇总而成。
当前包内版本:Plugin.php→@version 1.13.3(历史备份目录另有 1.14 / 1.15 / 1.16 / 1.17 命名,版本号未随改动同步更新,故本日志以日期 + 主题为索引)。
备份根目录:UrlNav\备份\;约定命名日期-时分秒-主题前,内含改动前的完整文件快照与修改记录.md。
统计范围:2026-10-23 23:51 起共 86 个备份目录,其中 28 个带修改记录(下表「记录」列标注)。
一、变更总览
| 日期 | 主题 | 涉及文件 | 备份目录 | 记录 |
|---|---|---|---|---|
| 10-25 17:40 | RSS 保留时间前后台严格执行 | Plugin.php / Front.php | 20261025-保留时间严格执行前 | 日志 |
| 10-25 18:07 | 网址管理统计改 24 小时网址口径 + 失败列表图标 + 分类列对齐 | Plugin.php / Manage.php | 20261025-网址管理统计优化前 | ✅ |
| 10-25 18:23 | RSS 文章跨站去重(同一篇只留个人站) | Plugin.php / Front.php | 20261025-RSS文章跨站去重前 | ✅ |
| 10-25 18:32 | 失败网址列表加「编辑 / 删除 / 新窗口」+ 弹窗层级修复 | Manage.php | 20261025-失败列表加编辑删除前 | ✅ |
| 10-25 23:16 | 「已阅」图章误改后台(已回滚) | Rss.php | 20261025-已阅图章前 | ✅ |
| 10-25 23:21 | 前台 RSS 列表「已阅」图章(浏览器存储) | page-urlnav.php | 20261025-前台已阅图章前 | ✅ |
| 10-25 23:35 | 前台双击「不读」图章 + 左侧计数联动 | page-urlnav.php | 20261025-前台不读图章前 | ✅ |
| 10-25 23:42 | 侧栏徽章改「未读数」,「已阅」更名「已读」 | page-urlnav.php | 20261025-侧栏未读数前 | ✅ |
| 10-26 01:07 | 前台 CSS 整体优化(按钮/统计条/圆角/hover) | page-urlnav.php | 20261025-CSS整体优化前 | ✅ |
| 10-26 01:23 | 对齐 sagrre 主题基础样式(字体/灰阶/字号/圆角) | page-urlnav.php | 20261026-对齐sagrre基础样式前 | ✅ |
| 10-26 01:36 | 文章计数口径统一 + 顶栏冗余清理 | Front.php / page-urlnav.php | 20261026-计数口径与顶栏优化前 | ✅ |
| 10-26 01:49 | 分类计数二次修复 + 分类顶栏精简 + 筛选行对齐 | Front.php / page-urlnav.php | 20261026-分类计数对齐与顶栏精简前 | ✅ |
| 10-26 02:01 | 计数彻底统一(统一取数入口 fetchFeedRows) | Front.php / page-urlnav.php | 20261026-计数彻底统一前 | ✅ |
| 10-26 02:10 | 开关按钮与筛选 chip 对齐 + 单站顶栏删除 | page-urlnav.php | 20261026-开关对齐与单站顶栏删除前 | ✅ |
| 10-26 02:21 | 筛选 chips 去数字 + 统计条统一 + 图章可读性 | page-urlnav.php | 前台筛选与图章优化前 | ✅ |
| 10-26 02:28 | 开关与筛选合并为一个共用下边框模块 | page-urlnav.php | 20261026-筛选开关合并模块前 | ✅ |
| 10-26 02:45 | 文章筛选「七日内」→「三天前」 | Front.php / page-urlnav.php | 20261026-七日内改三日前 | ✅ |
| 10-26 02:52 | 左侧分类默认全部收起 | page-urlnav.php | 20261026-分类默认收起前 | ✅ |
| 10-26 02:57 | 置顶在所有筛选项下都排最前 | Front.php | 20261026-置顶全筛选豁免前 | ✅ |
| 10-26 03:03 | 置顶 / 精华由图标改描边文字徽章 | page-urlnav.php | 20261026-置顶精华改文字边框前 | ✅ |
| 10-26 03:10 | 「审核结果」按钮加图标 | page-urlnav.php | 20261026-审核结果加图标前 | ✅ |
| 10-26 03:13~03:21 | sagrre 搜索按钮图标居中(已恢复原样) | menu.php / style.css | sagrre\备份\20261026-搜索按钮图标居中治本前 | ✅ |
| 10-26 08:23 | 建立当前完整基准快照 | 6 个主文件 | 20261026-082323-当前完整基准快照 | ✅ |
| 10-26 12:22 | 筛选条新增第二行:不限 / 未读 / 已读 / 不读 | page-urlnav.php | 20261026-122002-新增已读未读不读筛选前 | ✅ |
| 10-26 12:35 | 状态筛选由「按页」改为「按总量 + 分页」 | page-urlnav.php | 20261026-123105-状态筛选改为按总量分页前 | ✅ |
| 10-26 12:47 | 状态筛选下分页点击无反应(第 1 次修复) | page-urlnav.php | 20261026-124521-状态筛选分页点击修复前 | ✅ |
| 10-26 12:52 | 分页「只能点一次」(第 2 次修复,最终方案) | page-urlnav.php | 20261026-125113-分页点击二次失效修复前 | ✅ |
| 10-26 13:01 | 列表与分页之间出现两条边线 | page-urlnav.php | 20261026-125935-状态筛选双边线修复前 | ✅ |
二、2026-10-26 · 阅读状态筛选体系(最新)
12:22 筛选条新增第二行:不限 / 未读 / 已读 / 不读
- 目的:在既有「全部 / 今日 / 昨日 / 三天前 / 精华」之外,再按阅读状态筛一层。
- 实现:
state参数贯通站点链接、分类链接、时间筛选、翻页链接;服务端只负责日期 / 精华的 SQL 条件,状态由前端按localStorage过滤文章行(applyStateFilter(),挂在window.urlnavApplyStateFilter)。 - 样式:状态 chips 直接复用
.un-range,与时间筛选逐像素一致;.un-ranges-bar改为纵向两行容器,两行共用同一条底部边线。 - 备份:
20261026-122002-新增已读未读不读筛选前(6 文件完整快照)
12:35 状态筛选改为「按总量」筛选 + 分页
- 问题:初版只在当前 20 条里过滤,分页数和总数仍是全部文章的量,口径错误。
- 根因:阅读状态只在本机
localStorage,服务端LIMIT/OFFSET无法按状态切分。 - 修复:
state != all时 PHP 不分页、一次性取回该范围全部文章(上限 800,受 SQLiteIN(...)999 变量限制),所有行预置is-state-hidden防闪动;前端过滤后按每页条数本地切页,并自渲染.un-pager(页码省略号规则与 PHP 版一致)。选「不限」仍走服务端分页。 - 附带:状态筛选下的翻页改为本地切页 +
pushState,不再请求服务器;补<noscript>出口。 - 备份:
20261026-123105-状态筛选改为按总量分页前(6 文件完整快照)
12:47 分页点击无反应(第 1 次)
- 原因:
pushState排在切页之前且未捕获异常,浏览器限流抛SecurityError时重绘被整段跳过;页码只存在 DOM 属性里,写失败即静默失效。 - 改动:点击改绑到分页链接自身(目标阶段)、成功才
preventDefault;新增localPage+goLocalPage(),先切页再try{pushState};页码夹紧后写回;换范围重置页码。 - 备份:
20261026-124521-状态筛选分页点击修复前
12:52 分页「只能点一次」(第 2 次,最终方案)
- 原因:分页条每次过滤都
slot.innerHTML = ''重建,绑在节点上的监听随之消失;#un-articles的MutationObserver与重建互相触发形成 60ms 抖动。 - 改动:① 点击改回
document捕获阶段委托(不依赖节点,早于#unPage冒泡接管);② handler 先preventDefault/stopPropagation,再用setTimeout(0)重绘,不在事件派发过程中销毁目标节点;③renderPager加lastPagerSig签名去抖;④!mode分支清空前判空。 - 备份:
20261026-125113-分页点击二次失效修复前
13:01 列表与分页之间两条边线
- 原因:隐藏行仍占
li:last-child位置,.un-art:last-child{border-bottom:none}落不到「最后一条可见行」,它的下边线与.un-pager的border-top并成两条(不限模式正常,正是这个差异暴露了原因)。 - 改动:新增
.un-art.is-state-last{border-bottom:none;padding-bottom:2px};applyStateFilter()放出当前页后标记最后一可见行,「不限」分支清理该类。 - 备份:
20261026-125935-状态筛选双边线修复前(6 文件完整快照)
三、2026-10-26 · 前台视觉与筛选体验
01:07 前台 CSS 整体优化
- 顶部三按钮(网站广场 / 审核结果 / 提交网址)统一描边风格(29px 高、8px 圆角、hover 走主题色),删除实心 primary 变体;统计条数字加粗、圆角统一 8px;控件圆角由胶囊改 8px(数字徽章保留胶囊);文章行 hover 负边距外扩 + 浅底。
- 备份:
20261025-CSS整体优化前
01:23 对齐 sagrre 主题基础样式
- 提取主题规范:HarmonyOS-Sans 字体、
#24292f / #57606a / #8b949e灰阶、#dc2626红强调、#faf8f1奶油底、圆角 6/10/12px + 胶囊、字号 12/13/14/16。 - 实施:变量层换肤(蓝 → 红强调、深色对齐 GitHub 灰阶)、字号 11 种归一为 4 档(文章标题 15→16)、圆角 11 种归一为三档、图章与 guest 标签配色对齐。
- 备份:
20261026-对齐sagrre基础样式前
01:36 → 02:01 计数口径统一(三轮迭代,最终修复)
- 01:36:左侧 SQL
COUNT无跨站去重 vs 右侧去重后计数 → 新增Front::getBadgeCounts();默认视图顶部「全部文章 / 共 X 篇 / 页码」整行移除,开关移入筛选行。 - 01:49:分类徽章偏小 → 根因是「先全局去重再分组」砍掉跨分类重复文章,改为原始行分组、组内去重;分类视图顶栏只留标题;筛选行与搜索框对齐(
padding 0 0 10px、chip 32px 高)。 - 02:01:真正根因是
dedupRssRows()结果依赖行序,三处手写 SQL 的ORDER BY不一致 → 新增统一取数入口fetchFeedRows()(WHERE / ORDER 与getFeeds完全一致),getFeeds/getBadgeCounts/getRangeCounts全部改走它;getRangeCounts重写为每个 chip 单独取数去重。 - 备份:
20261026-计数口径与顶栏优化前、20261026-分类计数对齐与顶栏精简前、20261026-计数彻底统一前
02:10 开关按钮与筛选 chip 对齐 + 单站顶栏删除
- 错位根因:32×32 化时残留为 26px 补的
margin-top: 3px,改为margin: 0 8px 0 0。 - 单站 / 不可用视图的
un-main__head整块删除,清理 6 条无用 CSS。 - 备份:
20261026-开关对齐与单站顶栏删除前
02:21 筛选 chips 去数字 + 统计条统一 + 图章可读性
- 筛选 chips 不再显示文章数(并删掉
getRangeCounts()的预统计调用);顶部左侧统计条改为与右侧按钮同款(同高、同圆角、同底色、同 hover)。 - 图章:不透明度 0.8 → 1、加
z-index: 2、标题右侧预留 66px,长标题换行不再钻到图章底下。 - 备份:
前台筛选与图章优化前
02:28 开关与筛选合并为一个模块
- 下边框从
.un-ranges上移到.un-ranges-bar,开关与 chips 共用一条分割线,内容水平居中。 - 备份:
20261026-筛选开关合并模块前
02:45 「七日内」→「三天前」
- 口径改为
pub_date < 昨天 00:00(前天及更早的全部文章),与「今日」「昨日」互补零重叠;URL 参数键仍为week,旧链接不失效。广场「最近更新」的「七天内」是站点维度,未动。 - 备份:
20261026-七日内改三日前
02:52 左侧分类默认收起
- 服务端不再输出
<details open>(删除$navOpenCatId),点击 / 搜索命中 / 无刷新切换时的展开保留。 - 备份:
20261026-分类默认收起前
02:57 置顶在所有筛选项下都置顶
- 根因:排序本来就置顶优先,但「今日 / 昨日 / 三天前 / 精华」是硬过滤,置顶文章若不在该窗口就根本不出现。给筛选条件统一加
OR IFNULL(f.is_pinned,0)=1豁免,一处改动(fetchFeedRows)全链路生效。 - 备份:
20261026-置顶全筛选豁免前
03:03 置顶 / 精华改描边文字徽章
- 标题前小图标 → 22px 高的描边文字「置顶」(橙)/「精华」(青),
vertical-align: middle与标题行对齐,描边走currentColor。 - 备份:
20261026-置顶精华改文字边框前
03:10 「审核结果」按钮加图标
- 加 check-circle 描边图标(12×12、
currentColor),与「网站广场」「提交网址」同规格。 - 备份:
20261026-审核结果加图标前
08:23 建立当前完整基准快照
20261026-082323-当前完整基准快照:6 个主文件(Action / Front / Manage / Plugin / Rss / page-urlnav)原样复制,作为后续每轮「完整备份」的干净基准。
四、2026-10-25 · RSS 数据正确性与前期功能
17:40 保留时间前后台严格执行
- 现象:设置 72 小时保留,前后台仍出现几年前的文章。
- 根因:前台查询完全没有
is_fresh = 1;清理任务只在 cron 触发且只软删;抓取入库无任何发布时间过滤;maxCachePerSite是死配置。 - 修复:
Plugin.php新增getRssKeepCutoff();入库前按保留时间过滤;后台getAllRssFeeds、前台getFeeds/ 站点卡片「最近 5 篇」全部加is_fresh=1 + pub_date >= 截止点(置顶 / 精华豁免);补齐keepBadgeFilter()接入左侧分类树徽章、广场feed_count/last_pub(条件放LEFT JOIN ON)、导出清单。 - 备份:
20261025-保留时间严格执行前
18:07 网址管理统计优化
- 状态检查面板成功 / 失败 / 成功率改为 24 小时网址口径(新增
getStatusHealthStats(),基于last_status_check + is_online);失败网址列表每行加新窗口访问图标;分类名称列左对齐 + 前台隐藏标识贴右。 - 备份:
20261025-网址管理统计优化前
18:23 RSS 文章跨站去重
- 聚合站与个人站同一篇文章在列表出现两次。新增
normalizeDedupLink/normalizeDedupTitle/dedupRssRows(链接或标题规范化相同即视为同一篇,保留排序最前一条)。后台列表与前台列表共用,两段式(轻量字段判重 → 分页切片 →IN取全量)防内存膨胀。 - 已知:标题判重有撞标题误伤风险;当时站点徽章 / 广场
feed_count未去重(后由 10-26 计数统一解决)。 - 备份:
20261025-RSS文章跨站去重前
18:32 失败网址列表加管理按钮 + 弹窗层级
- 「有问题网站」每行按钮组改为 编辑 / 删除 / 新窗口,编辑与删除复用列表同一套弹窗与流程。
- 追加修复:编辑弹窗被状态检查弹窗遮挡 →
#url-modal-overlay{z-index:20000}。 - 备份:
20261025-失败列表加编辑删除前
23:16→23:42 前台阅读状态体系
- 23:16:误将「已阅」图章做在后台
Rss.php,已回滚(20261025-已阅图章前保存有误改前版本)。 - 23:21:前台
page-urlnav.php实现「已阅」:localStorage un_read_articles({链接: 时间戳},上限 2000)、.un-art.is-read::after印章(右上角rotate(-10deg)、四前缀深色适配)、点击委托 +MutationObserver应对 AJAX 替换。 - 23:35:双击「不读」灰章(
un_skip_articles,与已读互斥),bumpSiteCount联动左侧站点计数。 - 23:42:侧栏徽章改「未读数」(本地计数
un_read_counts/un_skip_counts,data-unread-init防重复扣减、归零隐藏不移除、负数截 0);「已阅」更名「已读」。 - 备份:
20261025-前台已阅图章前、20261025-前台不读图章前、20261025-侧栏未读数前
五、2026-10-24 及更早(仅代码快照,无修改记录)
以下备份目录只保留了改动前的代码快照,未留详细记录,条目按当时的目录主题名整理:
2026-10-24
| 时间 | 主题 |
|---|---|
| 00:26 | 修复 RSS 解析(Atom published / updated 优先级问题) |
| 12:08 | 后台深色主题适配 |
| 12:21 | 统计 / 日志弹窗深色 |
| 12:34 | 统计改 24 小时口径 |
| 12:59 | 事件口径调整 |
| 15:32 | 失败列表删除与图标 |
| 16:22 | 滚动条深浅色 |
| 16:53 | 统计与图标修复 |
| 17:20 | 全部入口与图标修复 |
| 17:45 | 阅读弹窗与分割线 |
| 18:10 | 表头边框与深浅色同步 |
2026-10-25 早段(00:52 – 10:07)
| 时间 | 主题 |
|---|---|
| 00:52 | 分类可点与状态居中 |
| 01:05 | 定时任务状态卡片化 |
| 01:35 | 前台页面模板(page-urlnav.php)建立 |
| 01:50 | 主题集成与「全部文章」入口 |
| 02:17 | 前端五项修复 |
| 06:29 | 前台提交网址与审核结果 |
| 07:12 | 置顶 / 精华与前端筛选 |
| 07:34 | 入围理由与按钮横排 |
| 08:09 | 后台标记筛选与审核记录 |
| 08:48 | 无刷新广场与审核公开 |
| 09:24 | 广场筛选与导出 |
| 09:48 | 广场筛选下拉样式 |
| 10:07 | 广场下拉边框与分类展开 |
更早的版本快照(2026-10-23 23:51 归档,无日期前缀)RSS初始正常版、基础检查正常版、手动检查正常版、没有RSS正常版、RSS筛选不正常版、RSS自动更新优化前、计划任务错误修复前正常版、修复抓取不完全版前、修复编辑保存前、导入导出前、导入导出正常、网址统计新增前、1.10取消30天限制前版、1.11检查分批前、1.11分批检查正常版、1.11修复选中网址前、1.11 选中正常没选中不正常、11.11 1156 选中不正常版、1.12添加收藏前、1.12收藏正常,展开全文前、1.12修复RSS逻辑前、1.12 前端清除锁前、1.13白名单前版、1.13访问失败抓取原文前、1.13访问失败抓取原文、1.14优化解析前、1.14增强解析前、1.14导出记录csv版、1.14星级前、1.15刷新日志完善前、1.15 修复cron卡死前(10.24)、1.16 双击已读失效菜单一致、1.17 全文存储修改前
六、附:sagrre 主题侧改动
| 时间 | 主题 | 结果 |
|---|---|---|
| 10-26 03:13 | 搜索按钮图标居中(第 1 版:menu.php 去 pt-2 + style.css 固定 36×36) | 按钮变成正圆,不符 |
| 10-26 03:21 | 第 2 版:按钮类名与导航链接完全一致、去掉 cat-search 类、#search button flex 居中、宽高 auto | 仍不满意 |
| 10-26 08:23 | 按用户要求全部恢复原样,menu.php / style.css 已 diff 校验与改动前逐字节一致 | 保留诊断结论,用户自行调试 |
| 10-26 08:23 | 建立主题基准快照(menu.php / style.css / page-urlnav.php) | — |
保留的诊断结论:.cat-search 基础 padding: .7rem 1rem .3rem 上下不对称、menu.php 又叠 pt-2 手调、iconify-icon 自带 vertical-align: -0.125em 走匿名行盒——三者叠加导致图标位置随各页行高变化,所以 post / index / sulan / ruiping / lishi / guidang / archives 每页都在写各自的 padding !important 补丁。
七、当前版本部署清单
插件(覆盖到 usr/plugins/UrlNav/)
Action.php Front.php Manage.php Plugin.php Rss.php page-urlnav.php主题(如需同步前台模板)
sagrre/page-urlnav.php(当前为旧副本,未随插件同步)生效注意:page-urlnav.php 的样式与脚本改动较多,上传后务必 Ctrl+F5 强刷。
八、已知边界与注意事项
- 阅读状态是本机的:已读 / 不读存在访客浏览器
localStorage,换设备 / 清缓存即丢失,也不会同步到服务器。 - 状态筛选上限 800 篇:受 SQLite
IN(...)999 变量限制,超出时页面会提示「只统计最近 N 篇」。按 72 小时保留策略正常达不到。 - 状态筛选下的分页在前端计算:页码、总数按过滤后的量算,翻页不请求服务器;
state=all仍走服务端分页。 - 前台「最近同步」=
MAX(cached_at):含义是「最近有新文章入库」,不是定时任务心跳。任务在跑但没有新文章时该时间不动,属正常现象(后台的「上次刷新」才是任务执行时间)。 - 跨站去重的标题判重:同名标题的不同文章会被误判为同一篇(退路:去掉标题键,只用链接判重)。
- 筛选 chip 已不显示文章数:
Front::getRangeCounts()方法仍保留但页面不再调用。 - 广场「最近更新」的「七天内」是站点维度筛选,与文章筛选的「三天前」无关,未改动。
Plugin.php的@version仍是 1.13.3,与实际功能进度不同步,发版前建议统一。
九、备份与回滚约定
- 每次改代码前先做完整备份(含同模块未修改的文件),目录命名
日期-时分秒-主题前,如20261026-125935-状态筛选双边线修复前。 - 备份目录内必须写
修改记录.md:改动文件清单、每处改动内容与原因、验证方式、回滚方法。 - 回滚方式:把备份目录里的对应文件覆盖回插件目录即可(备份是改动前的原样快照)。
- 干净基准点:
20261026-082323-当前完整基准快照(插件)、sagrre\备份\20261026-082323-当前完整基准快照(主题)。