laoyang/SimpleNav
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
21 Commits 1 Branch 0 Tags
ae75058de10462d1497913e09202cf3ebbe346e4
Commit Graph
8 Commits
Author SHA1 Message Date
laoyang 717a8877bb 后台排序改造：按板块标签页 + 拖拽排序 + 顺序完全固定 
- 后台网站列表按板块分标签页，每个板块单独调顺序；用 URL hash
  (#sgroup-<gid>) 定位，上移/下移提交后回跳到原来的板块
- 支持鼠标拖拽排序（原生 HTML5 拖拽，零库依赖）：拖动时实时重排预览，
  松手后整组落库（Ajax 动作 site_reorder，带 CSRF 校验与板块归属校验，
  防止跨板块搬条目）
- 稀疏排序：新增链接的顺序号 = 同板块 MAX + SORT_STEP(1000)，天然排最后；
  拖拽落库、历史数据迁移时整组归一化为 index * SORT_STEP
- 修复真根因：旧机制靠「交换两条 sort_order」上移/下移，一旦历史数据里
  出现重复值，交换即无效、位置退化为按 id 排序 —— 这正是「排了顺序又被
  打乱」的来源。新增一次性归一化迁移，用 settings.mig_sort_sparse 作哨兵，
  避免每次请求重复覆盖用户设置
- 新增/修改链接不再用 MAX+1（MAX+1 会落进已有间隙、插到用户排好的中间）
- 改变所属板块时，该条目自动排到新板块的最后
- 后台页面 + 拖拽手柄做了配套样式，触屏设备降级为上下移按钮
 2026-09-29 09:21:51 +08:00
laoyang 92eb9d90be 后台上传站点图标：首页品牌图 + favicon + PWA 图标一起换 
需求：后台新增设置，允许管理员上传自己的图标；上传后首页品牌图标与浏览器
标签页 favicon（以及「添加到手机主屏」图标）一起换成它。

要点：
- 一张上传图服务端居中裁剪成正方形，生成 16/32/48/64/180/192/512 +
  maskable 192/512 整套尺寸，并手工拼装多帧 favicon.ico。
- 单一来源 site_icon_url() 统一取址；site_icon_head() 被首页/登录页/后台
  三处共用；PWA manifest 改由 manifest.php 动态输出、maskable 也跟随 ——
  三处防线共同杜绝「首页换了、标签页还是旧的」这类半生效。
- 目录可写则落静态文件（最快）；不可写的保守环境整套压进设置、由
  site-icon.php 按需输出，功能不因权限限制整块不可用。
- 与「网站列表里每个网站自己的图标」是两个维度：目录与设置键都分开，
  清理时互不误伤。

顺手修掉两个真问题：
- login.php / admin/_auth.php 各留了一行写死的 favicon，与新的
  site_icon_head() 并存 → head 里两条 rel="icon"，是「上传了却没换」的
  温床。已删掉写死那两行。
- 自定义 favicon.ico 原先只塞 16+32 两帧，而内置是 16/32/48/64 四帧 ——
  换图标反而退步。已补齐 icon-64 并统一为 4 帧。
- setting() 的请求内缓存导致「同请求写后再读」拿到旧值（真实坑）：
  settings_cache() 支持强制重载 + settings_reload()，写入后立即失效。

验证：单测 44/44（含只读目录动态回退）、HTTP 56/56、e2e 174/0、
反向验证 5 变体全部被抓住（含「写死残留」与「ico 只塞两帧」两个新哨兵）、
真机几何 360/390/768/1440 无溢出、线上直连桌面+移动端几何全绿、
线上诊断页走通「上传→前台全换→复原」。
 2026-09-28 22:28:23 +08:00
laoyang 2dfecef116 修复手机端站点格布局塌陷 
根因：百分比宽度写在 flex item 内部的 <a> 上，而 li 自身没有宽度，
a 的 25% 无法解析、li 的宽又由内容 a 反推，循环依赖下浏览器把格子
塌成 min-content（实测约 12px）—— 42px 图标撑破格子、站点名被裁到
只剩几像素，整页错位。

修法：width:25% + margin:0 写在 li.site 自身，内部 a 改 width:100%；
margin 归零可避免 4 x (25% + 左右 margin) 超出一行宽、把第 4 个挤到
下一行。

验证：Playwright 真机宽度 360/375/390/414 直连线上全部通过
（格子 76~90px、名称 scrollWidth==clientWidth、无横向溢出）；
桌面 768/1280/1920 零回归。
 2026-09-28 21:30:41 +08:00
laoyang 9225113dae 搜索框：修复「直接回车被套用第一条联想词」的问题 
原实现只要联想下拉开着，回车就把输入框内容替换成第一条建议 —— 用户自己输入、
而建议里没有的词会被悄悄换掉。现在只有**用 ↓/↑ 选中**（或鼠标划过）某条建议时，
回车才按它搜索；没选中就一律用输入框原文。

- app.js：引入选中项状态（items / active）。↓/↑ 在下拉里循环移动高亮、Escape 关闭、
  一开始打字就取消选中；鼠标划过同步高亮，回车即可确认。选中态只动高亮、不动输入框，
  回车时才落到输入框。
- style.css：键盘高亮复用 hover 的样式（#word li:hover, #word li.active）。

验证：
- jsdom 交互测试 25/25 —— 喂的是**真实渲染出来的首页 HTML**，并显式执行仓库里
  的 app.js 源码（jsdom 不会自己加载外部 script）。核心断言是「直接回车不改动输入框」。
- 反向验证：把回车逻辑改回旧行为后，该核心断言确实失败（连同 9 项方向键断言），
  说明这套测试真能抓住这个 bug。
- e2e 113/113 无回归；线上部署 0 FAIL（68 条静态断言，含负向断言「旧行为已移除」；
  38 个文件哈希逐字节一致）；线上几何 25/25；
  再直连线上核验 app.js / style.css 内容与版本号均已更新。
 2026-09-28 20:01:25 +08:00
laoyang 273074218c chore: 清除仓库中的开发者个人信息 
面向公开仓库做一次脱敏，去掉与开发者个人绑定的域名、内网入口与环境路径。

- db.php：默认数据里的个人地址全部换成通用示例（原先是开发者的私有基础设施：
  带路径令牌的面板地址、若干内网服务入口，以及暴露学校身份的校内系统如教务 / BB / VPN / 财务）。
  分组结构（2 个网格板块 + 3 个合集板块）与条目数量保持不变，新装仍是一份可用的示例导航。
- README.md：去掉「复刻某站风格」的表述与示例路径里的个人域名；部署步骤改为通用写法
  （不再指向仓库外的私有脚本目录），并补上 Nginx 的 /data/ 拦截规则。
  顺带修正一处与实际不符的描述：原文档称「页面缓存插件无需任何特殊配置」，实测该插件读不到
  FastCGI 的 Cache-Control，实际是靠根 .htaccess 在请求侧注入 X_CACHE=1 才旁路掉的。
- .htaccess / config.php / functions.php / assets/css/style.css：注释里的个人域名改为通用表述。
- .gitignore：去掉开发者本机目录约定。
- LICENSE：版权署名由个人昵称改为 The SimpleNav Authors。

默认数据只在空库时写入，线上现有数据不受影响；本次无运行期行为变更。

验证：本地 php -l 全过；e2e 93/93；部署（双版本 php -l + 静态断言 + 文件哈希逐字节一致 +
HTTP 冒烟 + 缓存旁路自检 + Web 身份诊断）全绿，退出码 0。
 2026-09-28 18:34:44 +08:00
laoyang c3ba71c4ac feat: 合集区支持「全部平铺 / 标签页折叠」两种展示方式 
后台「设置 → 合集显示方式」一键切换，只影响底部「合集」区，
中间那些普通网格板块不受影响：

- tabs（默认，标签页折叠）：一次只平铺当前这一个合集（原行为）。
- flat（全部平铺）：每个合集各占一块，和网格板块同构，一眼看全、不用点。
  适合「每个合集里条目都不多」的情况；合集一多就切回标签页折叠。

实现：
- index.php 先收集「有内容的合集」，空合集不再占位（标签页模式下也不会
  多出一个空标签），再按设置渲染成标签页或平铺区块；
  输出 data-layout="tabs|flat" 便于断言与排查。
- admin/index.php 新增选择框 + 说明；admin/actions.php 白名单校验，
  非法值一律回退成 tabs。
- style.css 新增 3 条 .collections.flat 规则（平铺区块间距、最后一块不留底边距）。
- README 更新「页面结构」与特点说明。

验证：
- e2e 新增场景 6（93/93 通过）：两种模式各自的结构断言、非法值回退、
  保存该项不会弄丢其它设置、空合集不占位。
- 真实几何检查（flat / tabs 各 5 个视口，30/30 通过）：无横向溢出、正文列宽度正常。
- 部署诊断段在线上真机切 flat → 抓首页 → 断言 → 切回 tabs 并断言已复原。
 2026-09-28 17:51:10 +08:00
laoyang 853e4dd7c6 feat: 图标策略升级 + 引擎显隐就地切换 + 前后台一致性；界面美化 
按反馈逐条处理：

① 界面美化
- 前台重做：品牌区（logo + 站名 + 副标题）、胶囊式引擎切换、圆角卡片与
  悬停浮起、聚焦光晕、合集标签页淡入动画；版心改为 shell 变量
  （--pad-x = max(gutter, (100% - wrap)/2)），与顶栏左右边缘严格对齐。
- 后台：表格窄屏可横向滚动、状态胶囊、自定义徽章、图标预览框。

② 自动更新图标质量差 + 允许自定义图标
- 抓取改为阶梯择优：manifest 512/192 → apple-touch-icon → <link rel=icon>
  （按 sizes 降序，SVG 视为最高清）→ 第三方聚合服务（favicon.yandex.net
  实测 100% 可用；icon.horse 可达时最高 256px）→ 站点自身 /favicon.ico。
- 逐个候选实测像素，达到 120px 即停；候选上限 8 个 + 10s 总预算，避免超时。
- 用 GD 只缩不放，统一存成 128×128 PNG；识别并丢弃第三方服务的
  「灰底字母」占位块。
- 新增 sites.icon_custom 列（带幂等迁移）：可上传图标或填图标地址；
  一旦自定义，「全部更新」只刷新名称、跳过图标。

③ 后台引擎「可见/不可见」不好用
- 小图标换成内联 SVG（原来用 emoji，跨字体显示成方块）。
- 切换改为 AJAX 原地生效 + 状态胶囊同步，不再点一下就跳页；
  所有切换/移动表单都带 p 参数，无 JS 时也能正确回到当前页。
- 修掉一个隐蔽的成因：本站此前完全不发 Cache-Control/Expires/ETag，
  浏览器只能自行猜测缓存策略，导致「改完刷新还是旧的」。现在所有动态页
  统一发 no-store/no-cache。

④ deploy/ 与 data/ 误入版本库
- 两目录整目录忽略，部署脚本移出仓库（存 _tooling/），已 git rm --cached。
  （历史提交里仍含这些文件，如需彻底抹除需 git filter-repo，待确认。）

附带修复（线上实测驱动）
- 服务器侧页面缓存：宝塔「网站加速」Apache(mod_lua) 版是一层基于 memcached
  的 30 秒整页缓存，且**读不到 FastCGI 返回的 Cache-Control**，所以 no-store
  挡不住它；唯一信号是请求 cookie X_CACHE=1。已在根 .htaccess 用
  RequestHeader 在请求侧注入该标记（实测任何访客均 X-Cache: MISS），
  PHP 侧另发一颗 cookie 作为 Nginx 环境的兜底（BYPASS_PAGE_CACHE 开关）。
- 静态资源改为「长缓存 + 版本号」：asset()/icon_src() 拼 mtime+size，
  assets/.htaccess 与根 .htaccess 给出 max-age=31536000 immutable。
- 修 absolutize() 未还原 JSON 转义 \/ 导致部分图标 URL 抓不下来的问题。
- 修部署脚本 md5sum 在 Git Bash 下输出 "hash *path" 导致 38 项假「缺失文件」。
 2026-09-28 16:43:10 +08:00
laoyang 6e83cc3ecc feat: 简航 SimpleNav 个人网站导航系统（PHP + SQLite） 
- 前台：搜索引擎切换+联想下拉、网格板块（常用/工具）、合集标签页
- 后台：初始化/登录、网站/板块/引擎增删改、上下移排序
- 添加网站自动抓取名称与图标（存储于服务器），支持自定义简称
- 一键全部更新（批量刷新图标+名称，保留自定义简称）
- 搜索联想服务端代理（必应/百度/谷歌/搜狗/360/DuckDuckGo）
- 零依赖：原生 CSS/JS，PDO SQLite
 2026-09-28 15:48:35 +08:00