laoyang/SimpleNav
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
16 Commits 1 Branch 0 Tags
aac6d3e0f406ecdd7ffd412a51ba1117104ce73c
Commit Graph
7 Commits
Author SHA1 Message Date
laoyang aac6d3e0f4 联想词键盘选词彻底修复：上下键 / 逗号句号 / 输入法组合上屏四条路径全通 
背景：用户反馈「上下键和逗号句号都无法选择候选词，只能用鼠标」。逐条查下去
发现是**三个各自独立的原因**叠在一起，任何一个没修都会让人觉得「还是坏的」。

① 单组按键模式让另一组键静默失效
   线上 settings.suggest_keys 停在 'punct'（只认 , 和 .）—— 是该模式的正确
   行为，但用户不知道那是设置项在起作用，只当坏了。
   改法：默认值改为 'both'（↓/↑ 与 , . 都认）。'both' 是 'arrows' 与 'punct'
   各自行为的**严格超集**，升级不会让任何人的习惯失效，只是多了一组。
   老库用**一次性迁移**（哨兵键 mig_suggest_keys_both 把关）把已知单组值并成
   'both'。⚠️ 迁移必须只跑一次：db_init() 每次请求都执行，无条件 UPDATE 会把
   用户在后台特意选回的 'arrows' 于下一个请求改回去 —— 设置项直接失效。
   同时同步三处默认值：index.php / admin/index.php / admin/actions.php。

② 【元凶】beforeinput 只认 insertText，漏了 insertCompositionText
   输入法把标点当**组合内容**提交时，beforeinput 的 inputType 是
   insertCompositionText，旧代码直接 return → 这条路径完全失效。
   修法：两种 inputType 都认。

③ 【真机实测的硬限制】insertCompositionText 的 beforeinput cancelable = false
   Chromium 里这条事件**不允许** preventDefault（CDP 实测记录：
   beforeinput it:insertCompositionText comp:true data:"，" pd:false cc:false），
   所以「命中就拦」对这条路根本无效 —— 标点会被真的插进搜索框。
   修法：加「事后收口」——beforeinput 记下快照与该移到的目标下标，
   等这一帧事件洪峰过去（setTimeout 0）再把标点从输入框里撤掉、并补上选词移动。
   目标下标必须**当场算好**：收口跑在宏任务里，那时 input 的 `active = -1`
   已经把选中清掉了，再从 active 起算会每次都回到第一条（不累加）。
   顺带把标点判定抽成共用函数 punctDir/keyPunctDir（e.key 与 e.code 互为兜底），
   并修掉「方向键也无差别置去重闸门」——方向键不产生 beforeinput，置了纯属副作用，
   反而会误挡紧随其后的真实标点。

测试与验证（全部实跑，非推断）：
- jsdom 交互测试 89 项全过，新增「真实浏览器形态」场景（cancelable=false +
  组合上屏），并**纠正了旧版一条在断言 bug 本身的断言**（原写「组合上屏不该被拦」）。
- 反向验证 6 变体全部精确挂掉对应断言（含新增的「只认 insertText」与
  「方向键置闸门」两个变体）；旧变体引用的 isComma/isPeriod 已随重构更新。
- **真实浏览器**（Playwright + msedge + CDP IME）21/21：上下键 / 半角 / 全角
  insertText / IME 组合上屏四条路径全部能选词。
- 真实浏览器反向验证：基准全绿，删掉「事后收口」或改回只认 insertText 都精确报红。
- 迁移语义测试 16 项全过（真实 db_init，含「用户改回 arrows 后不再被覆盖」）。
- 静态断言空跑 155 条全过；线上部署 0 FAIL，诊断页 57 条断言全过。
- 线上真机直连 n.yangyq.net 21/21。
 2026-09-29 08:10:22 +08:00
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 47b45cfa23 后台新增「搜索与链接的打开方式」，并让站点链接跟随设置 
原先的设置项只作用于顶部搜索框，文案也写作「搜索结果新窗口打开」；而站点格
与合集里的链接 target 是写死的 _blank —— 于是切到「当前页面打开」时会出现
半生效：搜索留在本页，点网站却仍然弹新标签。

- index.php：把打开方式收敛成一个 open_target()，搜索框与所有站点格共用同一
  来源，任何一处都不再写死 target；页面输出 data-open="blank|self" 便于断言与排查。
- admin/index.php：后台由含义含糊的复选框改为明确的二选一（新标签页 / 当前页面），
  并补一段说明它管哪两处、不影响后台管理界面。
- admin/actions.php：保存走白名单回退 —— '0' 之外（含字段缺失、被篡改成怪值）
  一律回到 '1'（新标签页）。默认值与改造前的旧行为一致，老库不受影响。
- 当前页面模式下不再输出无意义的 rel="noopener"。

验证：php -l 4 个文件通过；e2e 113/113（新增 20 项，并做了反向验证——把链接
改回写死 _blank 后，相关断言精确失败 4 条）；线上部署 0 FAIL（双版本语法检查、
62 条静态断言、38 文件哈希逐字节一致、HTTP 冒烟、真机上切换两种模式并已复原）。
 2026-09-28 19:28:57 +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 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