laoyang/SimpleNav
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
11 Commits 1 Branch 0 Tags
13b12a3d6784e382bf8ef0182125791d098c6dad
Commit Graph
7 Commits
Author SHA1 Message Date
laoyang 13b12a3d67 后台新增「联想词按键」设置：可用 , 和 . 代替 ↑/↓ 选联想词 
输入法手感 —— 习惯中文输入法的话，手不用离开主键区就能在联想下拉里选词。

- 设置项 suggest_keys：arrows（默认，等同改造前）/ punct（, 和 .）/ both。
  后台为三选一下拉，保存走白名单回退（非白名单一律 arrows），默认值 = 旧行为。
- app.js 认**物理键**（e.code 的 Comma / Period）而不是字符 —— 中文输入法下按逗号
  打出来的是全角「，」，e.key 会变成「，」，但物理键不变；「跟输入法一样」就该这么认。
- ⚠️ 逗号和句号同时是搜索框的合法输入字符（如「python, pandas」）—— 所以只在
  **联想下拉打开时**才把它们当选词键；没有下拉时放行，照常输入。这条边界写进了
  后台说明（想输入逗号本身先按 Esc 关掉下拉）。
- 「,」= 上一条（同 ↑）、「.」= 下一条（同 ↓），首尾循环、与方向键行为完全一致。
- 前台输出两处同源标记：#search-form 的 data-keys（供断言/排查）与
  window.SIMPLENAV.suggestKeys（JS 实际读它决定用哪组键）。

验证：
- jsdom 交互测试 54/54 —— arrows / punct / both 三种模式各跑一遍；覆盖全角「，」「。」
  （中文输入法场景）、「没有下拉时 ,/. 不被拦截」（关键回归）、
  以及上一轮的核心回归「直接回车用原文」在三种模式下都成立。
- 反向验证两个变体：把回车改回旧行为 → 「直接回车不改动输入框」精确失败（27 项）；
  把「没下拉放行」改坏 → 恰好只失败「没有下拉时按 ./, 不被拦截」那两条（2 项），
  其余全过 —— 两条核心断言各自有效、定位精准。
- e2e 128/128（新增联想按键场景：保存 → data-keys / suggestKeys 同步、
  非法值回退 arrows、保存不动其它设置）。
- 线上部署 0 FAIL（77 条静态断言、38 文件哈希逐字节一致）；线上几何 25/25；
  直连线上核验 data-keys / suggestKeys / app.js 内容均已就位。
 2026-09-28 20:25:33 +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 34473d0120 fix: 联想建议词改成「统一来源 + 自动兜底」，任何引擎都能出词 
问题：除百度/360 外，其它引擎的联想下拉基本是空的。

实测（2026-09-28 在站点服务器上逐个探测）：
  百度 sugrec        200 / 0.12s / 1137B  ✅ 最快最稳
  360 sug.so.360.cn  200 / 0.20s /  714B  ✅
  必应 api.bing.com  200 / 0.5~1.6s      ✅ 可用但明显慢
  搜狗 ajajjson      200 / **0 字节**     ❌ 联想域名 w.sugg.sogou.com 已不解析
  谷歌 suggestqueries  连接超时            ❌ 国内不可达
  DuckDuckGo          连接超时            ❌ 国内不可达

按「联想统一取百度、搜索仍走各自引擎」实现：
- 新增设置 suggest_source（设置页可选 百度/必应/360/各引擎自己的接口），默认百度。
- 任何情况下都带自动兜底链：首选来源取不到词（接口挂/超时/返回空）
  就依次回退 百度 → 必应 → 360；单个候选 3 秒超时，绝不让下拉框卡住。
- 候选来源不过滤 is_active —— 作为联想来源的引擎可能在前台被隐藏。
- 响应里带 src 字段标明这次实际用的是谁，便于排查。

顺带修一个更隐蔽的 bug：前台 <form id="search-form"> 原本**没有 data-slug**，
而 JS 只在「点击引擎标签」时才把它写上 → 一进站、没点过引擎时 slug 为空，
suggest.php 查不到引擎，联想**全都不出词**。现在表单自带默认引擎的 slug。

其它：
- 清掉种子里已失效的搜狗联想地址；加一条幂等迁移，只匹配默认种子值，
  用户自己改过的地址不动。谷歌/DDG 也不再预设（前端不可达）。
- app.js：请求加序号，防止先发的慢响应覆盖后发的快响应；切换引擎时
  若输入框已有内容就顺带换一份建议。
- e2e 新增「联想来源」场景（本地桩服务器 + 独立端口，不依赖外网）：
  8 条断言覆盖 默认来源 / auto 模式 / 回退 / 空关键词 / 响应头。

验证：本地 e2e 57/57；部署 38 文件哈希逐字节一致、双版本 php -l、37 条
静态断言全过；线上实测 google/sogou/ddg 三个「自家接口不可用」的引擎
均返回 10 条百度建议（src=baidu），中英文都正常。
 2026-09-28 17:13: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