三股水
Typeho RSS信息阅读聚合插件近期升级日志

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:40RSS 保留时间前后台严格执行Plugin.php / Front.php20261025-保留时间严格执行前日志
10-25 18:07网址管理统计改 24 小时网址口径 + 失败列表图标 + 分类列对齐Plugin.php / Manage.php20261025-网址管理统计优化前✅
10-25 18:23RSS 文章跨站去重(同一篇只留个人站)Plugin.php / Front.php20261025-RSS文章跨站去重前✅
10-25 18:32失败网址列表加「编辑 / 删除 / 新窗口」+ 弹窗层级修复Manage.php20261025-失败列表加编辑删除前✅
10-25 23:16「已阅」图章误改后台(已回滚)Rss.php20261025-已阅图章前✅
10-25 23:21前台 RSS 列表「已阅」图章(浏览器存储)page-urlnav.php20261025-前台已阅图章前✅
10-25 23:35前台双击「不读」图章 + 左侧计数联动page-urlnav.php20261025-前台不读图章前✅
10-25 23:42侧栏徽章改「未读数」,「已阅」更名「已读」page-urlnav.php20261025-侧栏未读数前✅
10-26 01:07前台 CSS 整体优化(按钮/统计条/圆角/hover)page-urlnav.php20261025-CSS整体优化前✅
10-26 01:23对齐 sagrre 主题基础样式(字体/灰阶/字号/圆角)page-urlnav.php20261026-对齐sagrre基础样式前✅
10-26 01:36文章计数口径统一 + 顶栏冗余清理Front.php / page-urlnav.php20261026-计数口径与顶栏优化前✅
10-26 01:49分类计数二次修复 + 分类顶栏精简 + 筛选行对齐Front.php / page-urlnav.php20261026-分类计数对齐与顶栏精简前✅
10-26 02:01计数彻底统一(统一取数入口 fetchFeedRows)Front.php / page-urlnav.php20261026-计数彻底统一前✅
10-26 02:10开关按钮与筛选 chip 对齐 + 单站顶栏删除page-urlnav.php20261026-开关对齐与单站顶栏删除前✅
10-26 02:21筛选 chips 去数字 + 统计条统一 + 图章可读性page-urlnav.php前台筛选与图章优化前✅
10-26 02:28开关与筛选合并为一个共用下边框模块page-urlnav.php20261026-筛选开关合并模块前✅
10-26 02:45文章筛选「七日内」→「三天前」Front.php / page-urlnav.php20261026-七日内改三日前✅
10-26 02:52左侧分类默认全部收起page-urlnav.php20261026-分类默认收起前✅
10-26 02:57置顶在所有筛选项下都排最前Front.php20261026-置顶全筛选豁免前✅
10-26 03:03置顶 / 精华由图标改描边文字徽章page-urlnav.php20261026-置顶精华改文字边框前✅
10-26 03:10「审核结果」按钮加图标page-urlnav.php20261026-审核结果加图标前✅
10-26 03:13~03:21sagrre 搜索按钮图标居中(已恢复原样)menu.php / style.csssagrre\备份\20261026-搜索按钮图标居中治本前✅
10-26 08:23建立当前完整基准快照6 个主文件20261026-082323-当前完整基准快照✅
10-26 12:22筛选条新增第二行:不限 / 未读 / 已读 / 不读page-urlnav.php20261026-122002-新增已读未读不读筛选前✅
10-26 12:35状态筛选由「按页」改为「按总量 + 分页」page-urlnav.php20261026-123105-状态筛选改为按总量分页前✅
10-26 12:47状态筛选下分页点击无反应(第 1 次修复)page-urlnav.php20261026-124521-状态筛选分页点击修复前✅
10-26 12:52分页「只能点一次」(第 2 次修复,最终方案)page-urlnav.php20261026-125113-分页点击二次失效修复前✅
10-26 13:01列表与分页之间出现两条边线page-urlnav.php20261026-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,受 SQLite IN(...) 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 计数口径统一(三轮迭代,最终修复)

  1. 01:36:左侧 SQL COUNT 无跨站去重 vs 右侧去重后计数 → 新增 Front::getBadgeCounts();默认视图顶部「全部文章 / 共 X 篇 / 页码」整行移除,开关移入筛选行。
  2. 01:49:分类徽章偏小 → 根因是「先全局去重再分组」砍掉跨分类重复文章,改为原始行分组、组内去重;分类视图顶栏只留标题;筛选行与搜索框对齐(padding 0 0 10px、chip 32px 高)。
  3. 02:01:真正根因是 dedupRssRows() 结果依赖行序,三处手写 SQL 的 ORDER BY 不一致 → 新增统一取数入口 fetchFeedRows()(WHERE / ORDER 与 getFeeds 完全一致),getFeeds / getBadgeCounts / getRangeCounts 全部改走它;getRangeCounts 重写为每个 chip 单独取数去重。
  4. 备份: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 前台阅读状态体系

  1. 23:16:误将「已阅」图章做在后台 Rss.php,已回滚(20261025-已阅图章前 保存有误改前版本)。
  2. 23:21:前台 page-urlnav.php 实现「已阅」:localStorage un_read_articles({链接: 时间戳},上限 2000)、.un-art.is-read::after 印章(右上角 rotate(-10deg)、四前缀深色适配)、点击委托 + MutationObserver 应对 AJAX 替换。
  3. 23:35:双击「不读」灰章(un_skip_articles,与已读互斥),bumpSiteCount 联动左侧站点计数。
  4. 23:42:侧栏徽章改「未读数」(本地计数 un_read_counts / un_skip_counts,data-unread-init 防重复扣减、归零隐藏不移除、负数截 0);「已阅」更名「已读」。
  5. 备份: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 强刷。


八、已知边界与注意事项

  1. 阅读状态是本机的:已读 / 不读存在访客浏览器 localStorage,换设备 / 清缓存即丢失,也不会同步到服务器。
  2. 状态筛选上限 800 篇:受 SQLite IN(...) 999 变量限制,超出时页面会提示「只统计最近 N 篇」。按 72 小时保留策略正常达不到。
  3. 状态筛选下的分页在前端计算:页码、总数按过滤后的量算,翻页不请求服务器;state=all 仍走服务端分页。
  4. 前台「最近同步」= MAX(cached_at):含义是「最近有新文章入库」,不是定时任务心跳。任务在跑但没有新文章时该时间不动,属正常现象(后台的「上次刷新」才是任务执行时间)。
  5. 跨站去重的标题判重:同名标题的不同文章会被误判为同一篇(退路:去掉标题键,只用链接判重)。
  6. 筛选 chip 已不显示文章数:Front::getRangeCounts() 方法仍保留但页面不再调用。
  7. 广场「最近更新」的「七天内」是站点维度筛选,与文章筛选的「三天前」无关,未改动。
  8. Plugin.php 的 @version 仍是 1.13.3,与实际功能进度不同步,发版前建议统一。

九、备份与回滚约定

  • 每次改代码前先做完整备份(含同模块未修改的文件),目录命名 日期-时分秒-主题前,如 20261026-125935-状态筛选双边线修复前。
  • 备份目录内必须写 修改记录.md:改动文件清单、每处改动内容与原因、验证方式、回滚方法。
  • 回滚方式:把备份目录里的对应文件覆盖回插件目录即可(备份是改动前的原样快照)。
  • 干净基准点:20261026-082323-当前完整基准快照(插件)、sagrre\备份\20261026-082323-当前完整基准快照(主题)。
😊
提交