laoyang
853e4dd7c6
按反馈逐条处理： ① 界面美化 - 前台重做：品牌区（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 项假「缺失文件」。
5.1 KiB
5.1 KiB
SimpleNav · 简航
简航（SimpleNav），一个面向个人的轻量级网站导航系统。PHP + SQLite，零外部依赖、无需 Composer，上传即用。
特点
- 轻量：纯 PHP + SQLite，不依赖 MySQL / 框架 / Composer；前端无 Bootstrap / jQuery，原生 CSS + JS。
- 个人向：单管理员，页面就是「你自己常用网站的起始页」。
- 搜索引擎可切换 + 联想下拉：后台勾选喜欢的搜索引擎即可显示在顶部；输入时下拉联想词由服务端代理（规避跨域）。后台的「显示/隐藏」按钮点一下原地生效、不跳页，且无 JS 时也能正常提交。
- 添加即补全：填网址后先访问该网址拿到标题，再按「高清优先」的顺序去网上找相关图标（
manifest512 →apple-touch-icon→<link rel=icon>→ 第三方聚合服务），下载后统一规范化为 128×128 PNG 存到服务器本地。 - 图标可自定义，且自定义后不再被覆盖：可为任一网站上传图标或直接填图标地址；一旦自定义，该网站的图标会被标记保护，「一键全部更新」只刷新它的名称、跳过图标。
- 显示简称：每个网站有「名称（自动）」和「简称（手动）」两个字段，页面展示你自定义的简称。
- 自定义排序：网站 / 板块 / 搜索引擎都可上移下移排序。
- 一键全部更新：批量刷新所有网站的图标与名称，不会改动你自定义的简称，也不会覆盖你自定义的图标。
- 合集标签页：把「合集」做成标签页，点标签平铺该合集下的全部链接。
- 前后台永远一致：所有动态页面都发
Cache-Control: no-store, no-cache，静态资源走「长缓存 + 版本号」（文件名不变、URL 带?v=mtime-size）。
页面结构（复刻 n.yangyq.net 风格）
- 顶部：搜索引擎切换 + 搜索框（带联想下拉）
- 中部：网格板块（如「常用」「工具」）
- 下部：「合集」标签页
目录结构
SimpleNav/
├─ index.php 前台首页
├─ suggest.php 搜索联想代理（多引擎，服务端请求）
├─ login.php / logout.php 管理员登录 / 首次初始化
├─ db.php 数据库初始化（建表 + 默认数据 + 幂等列迁移）
├─ config.php 基础配置
├─ functions.php 公共函数（抓取元信息、下载图标、资源版本号、不缓存响应头）
├─ .htaccess 根目录安全规则（禁止访问 data/ 与 .git/）
├─ admin/ 后台（网站 / 板块 / 搜索引擎 / 设置）
│ ├─ index.php 后台页面
│ ├─ actions.php 增删改 / 排序处理（支持 AJAX 原地切换）
│ ├─ fetch_meta.php 添加网站时自动抓取名称与图标
│ └─ update_all.php 一键“全部更新”（分批）
├─ assets/ CSS / JS / 图标 / logo
│ └─ .htaccess 静态资源长缓存（配合 ?v= 版本号）
├─ uploads/icons/ 抓取到的网站图标（需可写）
└─ data/ SQLite 数据库（需可写，禁止 Web 访问）
部署
- 上传全部文件到站点目录（如
/www/wwwroot/n.yangyq.net/simplenav）。 - 确保 web 用户对
data/与uploads/icons/有写权限。 - 服务器需开启 PHP 的 GD 扩展（图标规范化要用）与
curl。 - 浏览器打开站点 → 首次访问进入「初始化管理员」，创建账号后即可在后台管理。
- 若服务器是 Apache（宝塔默认可能装 Apache 或 Nginx），
data/的访问拦截由仓库自带的data/.htaccess+ 根目录.htaccess完成，无需改 vhost；若是 Nginx，请把nginx-simplenav-deny-data.conf（见本机_tooling/simplenav-deploy/）里的规则加进server{}。
服务器上创建最小权限部署账号：以 root 运行 setup-simplenav-user.sh（同样在 _tooling/simplenav-deploy/）。
需要额外说明的是：服务器上若装了宝塔「网站加速」之类的页面缓存插件，本站也不需要为它做任何特殊配置。 动态页发的
Cache-Control: ... no-cache ...会被这类插件视为「不缓存」而直接跳过写入。
搜索引擎联想接口说明
联想接口需服务端代理（浏览器直接调用会跨域）。内置解析类型：
| 类型 | 平台 | 联想接口 |
|---|---|---|
bing_osjson |
必应 | https://api.bing.com/osjson.aspx?query={q} |
baidu_sugrec |
百度 | https://www.baidu.com/sugrec?prod=pc&wd={q} |
google_firefox |
谷歌 | https://suggestqueries.google.com/complete/search?client=firefox&q={q} |
sogou_ajaj |
搜狗 | https://www.sogou.com/suggnew/ajajjson?type=web&key={q} |
so360 |
360 | https://sug.so.360.cn/suggest?encodein=utf-8&encodeout=utf-8&format=json&word={q} |
ddg |
DuckDuckGo | https://duckduckgo.com/ac/?type=list&q={q} |
注：国内服务器访问 Google / DuckDuckGo 可能不通，联想会优雅降级为空（不影响搜索跳转）。
许可
Apache License 2.0