背景:用户反馈「上下键和逗号句号都无法选择候选词,只能用鼠标」。逐条查下去
发现是**三个各自独立的原因**叠在一起,任何一个没修都会让人觉得「还是坏的」。
① 单组按键模式让另一组键静默失效
线上 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。
270 lines
13 KiB
PHP
270 lines
13 KiB
PHP
<?php
|
||
/**
|
||
* 简航 SimpleNav —— 数据库(PDO SQLite)
|
||
* 首次访问自动建表并写入一份通用的默认数据(示例链接,可在后台随意增删)。
|
||
*/
|
||
declare(strict_types=1);
|
||
|
||
require_once __DIR__ . '/config.php';
|
||
|
||
function db(): PDO
|
||
{
|
||
static $pdo = null;
|
||
if ($pdo === null) {
|
||
if (!is_dir(DATA_PATH)) {
|
||
@mkdir(DATA_PATH, 0755, true);
|
||
}
|
||
$pdo = new PDO('sqlite:' . DB_PATH);
|
||
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
|
||
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
|
||
$pdo->exec('PRAGMA foreign_keys = ON');
|
||
db_init($pdo);
|
||
}
|
||
return $pdo;
|
||
}
|
||
|
||
function db_init(PDO $pdo): void
|
||
{
|
||
$pdo->exec(<<<'SQL'
|
||
CREATE TABLE IF NOT EXISTS groups (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
name TEXT NOT NULL,
|
||
slug TEXT DEFAULT '',
|
||
display TEXT NOT NULL DEFAULT 'grid', -- grid=普通网格板块 tabs=合集标签页
|
||
sort_order INTEGER NOT NULL DEFAULT 0,
|
||
is_visible INTEGER NOT NULL DEFAULT 1
|
||
);
|
||
CREATE TABLE IF NOT EXISTS sites (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
group_id INTEGER NOT NULL,
|
||
url TEXT NOT NULL,
|
||
name TEXT NOT NULL DEFAULT '', -- 自动抓取的网站名称
|
||
short_name TEXT NOT NULL DEFAULT '', -- 用户自定义简称(页面展示用)
|
||
icon TEXT NOT NULL DEFAULT '', -- 本地图标文件名
|
||
icon_custom INTEGER NOT NULL DEFAULT 0, -- 1=用户自定义图标("全部更新"不再覆盖)
|
||
sort_order INTEGER NOT NULL DEFAULT 0,
|
||
is_visible INTEGER NOT NULL DEFAULT 1,
|
||
created_at TEXT DEFAULT '',
|
||
updated_at TEXT DEFAULT '',
|
||
FOREIGN KEY (group_id) REFERENCES groups(id) ON DELETE CASCADE
|
||
);
|
||
CREATE TABLE IF NOT EXISTS engines (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
name TEXT NOT NULL,
|
||
slug TEXT NOT NULL,
|
||
search_url TEXT NOT NULL,
|
||
param TEXT NOT NULL DEFAULT 'q',
|
||
suggest_url TEXT NOT NULL DEFAULT '',
|
||
suggest_type TEXT NOT NULL DEFAULT '',
|
||
color TEXT NOT NULL DEFAULT '#2F6BF7',
|
||
is_active INTEGER NOT NULL DEFAULT 0,
|
||
sort_order INTEGER NOT NULL DEFAULT 0
|
||
);
|
||
CREATE TABLE IF NOT EXISTS settings (
|
||
k TEXT PRIMARY KEY,
|
||
v TEXT NOT NULL DEFAULT ''
|
||
);
|
||
CREATE TABLE IF NOT EXISTS users (
|
||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||
username TEXT UNIQUE NOT NULL,
|
||
password_hash TEXT NOT NULL,
|
||
created_at TEXT NOT NULL DEFAULT ''
|
||
);
|
||
SQL);
|
||
|
||
// 老库升级:为已存在的 sites 表补 icon_custom 列
|
||
$cols = [];
|
||
foreach ($pdo->query('PRAGMA table_info(sites)') as $c) {
|
||
$cols[(string)$c['name']] = true;
|
||
}
|
||
if (!isset($cols['icon_custom'])) {
|
||
$pdo->exec('ALTER TABLE sites ADD COLUMN icon_custom INTEGER NOT NULL DEFAULT 0');
|
||
}
|
||
|
||
// 老库升级:清掉「搜狗联想」这个已经彻底失效的默认值
|
||
// (2026-09-28 实测:suggnew/ajajjson 返回 200 但 0 字节,联想域名 w.sugg.sogou.com 已不解析)
|
||
// 只匹配默认种子里的那个 URL —— 用户自己改过的地址绝不动。
|
||
$pdo->prepare('UPDATE engines SET suggest_url=?, suggest_type=? WHERE slug=? AND suggest_url=?')
|
||
->execute(['', '', 'sogou', 'https://www.sogou.com/suggnew/ajajjson?type=web&key={q}']);
|
||
|
||
// 老库升级:把「联想词按键」的单组设置(arrows / punct)并成 'both'(两组都认)。
|
||
// 为什么:用户反馈「上下键和逗号句号都选不了词」,根因之一就是线上停在单组 'punct'
|
||
// —— 单组模式会让另一组键**静默失效**,用户不知道那是设置项在起作用,只当成坏了。
|
||
// 'both' 是 'arrows' 与 'punct' 各自行为的**严格超集**:升级不会让任何人的习惯失效
|
||
// (原来能用的键,升级后照样能用,只是多了一组)。
|
||
// ⚠️ 只改这两个已知单组值;值不在白名单里的行不动,避免误伤将来的新取值。
|
||
// ⚠️⚠️ 必须**只跑一次**:db_init() 是**每次请求**都会执行的,若无条件 UPDATE,
|
||
// 用户在后台特意选回「只认方向键」,下一个请求就被改回去 —— 设置项等于失效。
|
||
// 用 settings 里一个哨兵键把关,跑过就永不再跑。
|
||
$migDone = (int)$pdo->query("SELECT COUNT(*) FROM settings WHERE k='mig_suggest_keys_both'")->fetchColumn() > 0;
|
||
if (!$migDone) {
|
||
$pdo->exec("UPDATE settings SET v='both' WHERE k='suggest_keys' AND v IN ('arrows','punct')");
|
||
$pdo->exec("INSERT INTO settings (k,v) VALUES ('mig_suggest_keys_both','1')
|
||
ON CONFLICT(k) DO UPDATE SET v='1'");
|
||
}
|
||
|
||
// 是否为空库(用于判断是否写入默认数据)
|
||
$isEmpty = (int)$pdo->query('SELECT COUNT(*) FROM groups')->fetchColumn() === 0;
|
||
|
||
seed_settings($pdo);
|
||
seed_engines($pdo);
|
||
if ($isEmpty) {
|
||
seed_groups_and_sites($pdo);
|
||
}
|
||
}
|
||
|
||
function seed_settings(PDO $pdo): void
|
||
{
|
||
$defaults = [
|
||
'site_name' => '简航',
|
||
'subtitle' => '个人网站导航',
|
||
'default_engine' => 'bing',
|
||
'primary_color' => '#2F6BF7',
|
||
// '1' = 顶部搜索框与所有站点/合集链接都在**新标签页**打开;'0' = 都在**当前页面**打开。
|
||
// 默认 '1' 与引入该设置前的旧行为一致;老库若已有这一行不会被覆盖(INSERT OR IGNORE)。
|
||
'open_blank' => '1',
|
||
// 'both' = ↓/↑ 与 , . **两组都认**(默认);
|
||
// 'arrows' = 只认 ↓/↑;'punct' = 只认 , 和 .。
|
||
// ⚠️ 默认从 'arrows' 改为 'both'(2026-09-29):用户反馈「上下键和逗号句号都选不了词」,
|
||
// 线上设置恰好停在单组 'punct' —— 单组模式会让**另一组键静默失效**,极易被当成故障。
|
||
// 'both' 是两组各自行为的**严格超集**(想用哪组都行),没有任何损失,故取为默认。
|
||
'suggest_keys' => 'both',
|
||
];
|
||
$stmt = $pdo->prepare('INSERT OR IGNORE INTO settings (k, v) VALUES (?, ?)');
|
||
foreach ($defaults as $k => $v) {
|
||
$stmt->execute([$k, $v]);
|
||
}
|
||
}
|
||
|
||
function seed_engines(PDO $pdo): void
|
||
{
|
||
if ((int)$pdo->query('SELECT COUNT(*) FROM engines')->fetchColumn() > 0) {
|
||
return;
|
||
}
|
||
// name, slug, search_url, param, suggest_url, suggest_type, color, active, sort
|
||
// ⚠️ suggest_url 留空的含义:该引擎自己没有可用的联想接口。
|
||
// 反正默认「联想词来源 = 百度」,留空只会让 auto 模式下少一次无谓的超时等待。
|
||
// 搜狗(suggnew/ajajjson 已失效)、谷歌 / DuckDuckGo(国内不可达)都不填。
|
||
$rows = [
|
||
['必应', 'bing', 'https://cn.bing.com/search', 'q', 'https://api.bing.com/osjson.aspx?query={q}', 'bing_osjson', '#60A504', 1, 1],
|
||
['百度', 'baidu', 'https://www.baidu.com/s', 'wd', 'https://www.baidu.com/sugrec?prod=pc&wd={q}', 'baidu_sugrec', '#2100E0', 1, 2],
|
||
['谷歌', 'google', 'https://www.google.com/search', 'q', '', '', '#3B83FA', 0, 3],
|
||
['搜狗', 'sogou', 'https://www.sogou.com/web', 'query', '', '', '#FE6B14', 0, 4],
|
||
['360', 'so360', 'https://www.so.com/s', 'q', 'https://sug.so.360.cn/suggest?encodein=utf-8&encodeout=utf-8&format=json&word={q}', 'so360', '#1BB04A', 0, 5],
|
||
['DuckGo','ddg', 'https://duckduckgo.com/', 'q', '', '', '#DE5833', 0, 6],
|
||
];
|
||
$stmt = $pdo->prepare('INSERT INTO engines (name,slug,search_url,param,suggest_url,suggest_type,color,is_active,sort_order) VALUES (?,?,?,?,?,?,?,?,?)');
|
||
foreach ($rows as $r) {
|
||
$stmt->execute($r);
|
||
}
|
||
}
|
||
|
||
function seed_groups_and_sites(PDO $pdo): void
|
||
{
|
||
// 板块定义: [名称, 类型, 排序, [ [名称, 网址], ... ] ]
|
||
$data = [
|
||
['常用', 'grid', 1, [
|
||
['GitHub', 'https://github.com/'],
|
||
['阿里云', 'https://www.aliyun.com/'],
|
||
['知乎', 'https://www.zhihu.com/'],
|
||
['天翼云盘', 'https://cloud.189.cn/'],
|
||
['快科技', 'http://www.mydrivers.com/'],
|
||
['豆瓣', 'https://www.douban.com/'],
|
||
['少数派', 'https://sspai.com/'],
|
||
['红围脖', 'https://hongbowei.com/'],
|
||
]],
|
||
['工具', 'grid', 2, [
|
||
['宝塔面板', 'https://www.bt.cn/'],
|
||
['阿里云盘', 'https://www.alipan.com/'],
|
||
['网易云课堂', 'https://study.163.com/'],
|
||
['学堂在线', 'https://www.xuetangx.com/'],
|
||
['CSDN', 'https://www.csdn.net/'],
|
||
['稀土掘金', 'https://juejin.cn/'],
|
||
['淘宝', 'https://www.taobao.com/'],
|
||
['京东', 'https://www.jd.com/'],
|
||
['腾讯文档', 'https://docs.qq.com/'],
|
||
['石墨文档', 'https://shimo.im/'],
|
||
['飞书', 'https://www.feishu.cn/'],
|
||
['Gitee', 'https://gitee.com/'],
|
||
['百度网盘', 'https://pan.baidu.com/'],
|
||
['豆瓣电影', 'https://movie.douban.com/'],
|
||
['花瓣网', 'https://huaban.com/'],
|
||
['蓝奏云', 'https://www.lanzou.com/'],
|
||
['bilibili', 'https://www.bilibili.com/'],
|
||
['优酷', 'https://www.youku.com/'],
|
||
['爱奇艺', 'https://www.iqiyi.com/'],
|
||
['腾讯视频', 'https://v.qq.com/'],
|
||
['芒果TV', 'https://www.mgtv.com/'],
|
||
['draw.io', 'https://app.diagrams.net/'],
|
||
['稿定PS', 'https://ps.gaoding.com/'],
|
||
['Bitwarden', 'https://bitwarden.com/'],
|
||
['PDF工具', 'https://pdf.wps.cn/'],
|
||
['微信读书', 'https://weread.qq.com/'],
|
||
['高德地图', 'https://gaode.com/'],
|
||
['百度地图', 'https://map.baidu.com/'],
|
||
['建设银行', 'http://ccb.com/cn/home/index.html'],
|
||
['支付宝', 'https://www.alipay.com/'],
|
||
['MOOC', 'https://www.icourse163.org/'],
|
||
]],
|
||
['常用软件', 'tabs', 10, [
|
||
['WPS', 'https://www.wps.cn/'],
|
||
['Chrome', 'https://www.google.cn/chrome/index.html'],
|
||
['VS Code', 'https://code.visualstudio.com/'],
|
||
['Draw.IO', 'https://github.com/jgraph/drawio-desktop/releases'],
|
||
['火绒', 'https://www.huorong.cn/'],
|
||
['7-Zip', 'https://sparanoid.com/lab/7z/'],
|
||
['Tabby', 'https://github.com/Eugeny/tabby/'],
|
||
['GitAhead', 'https://gitahead.github.io/gitahead.com/'],
|
||
['Everything', 'https://www.voidtools.com/zh-cn/'],
|
||
['Wox', 'https://github.com/Wox-launcher/Wox'],
|
||
['BCUninstaller', 'https://github.com/Klocman/Bulk-Crap-Uninstaller'],
|
||
['DBeaver', 'https://github.com/dbeaver/dbeaver'],
|
||
['Thunderbird', 'https://www.thunderbird.net/zh-CN/'],
|
||
['FDM', 'https://www.freedownloadmanager.org/zh/'],
|
||
['GIMP', 'https://www.gimp.org/'],
|
||
['VLC', 'https://www.videolan.org/vlc/'],
|
||
['Zotero', 'https://www.zotero.org/'],
|
||
['QQ音乐', 'https://y.qq.com/'],
|
||
['微信', 'https://weixin.qq.com/'],
|
||
['TIM', 'https://tim.qq.com/'],
|
||
['Shotcut', 'https://github.com/mltframework/shotcut'],
|
||
]],
|
||
['图片资源', 'tabs', 11, [
|
||
['图标库', 'https://www.iconfont.cn/'],
|
||
['插画库', 'https://undraw.co/illustrations'],
|
||
['Pixabay', 'https://pixabay.com/zh/'],
|
||
['Pexels', 'https://www.pexels.com/'],
|
||
]],
|
||
['科研论文', 'tabs', 12, [
|
||
['DeepL翻译', 'https://www.deepl.com/'],
|
||
['Linggle', 'https://linggle.com/'],
|
||
['Netspeak', 'https://netspeak.org/'],
|
||
['Semantic Scholar', 'https://www.semanticscholar.org/'],
|
||
['LaTex Table', 'https://www.tablesgenerator.com/'],
|
||
]],
|
||
];
|
||
|
||
$g = $pdo->prepare('INSERT INTO groups (name, slug, display, sort_order, is_visible) VALUES (?,?,?,?,1)');
|
||
$s = $pdo->prepare('INSERT INTO sites (group_id, url, name, short_name, icon, sort_order, is_visible, created_at, updated_at) VALUES (?,?,?,?,\'\',?,1,?,?)');
|
||
$now = date('Y-m-d H:i:s');
|
||
foreach ($data as $row) {
|
||
[$name, $display, $order, $sites] = $row;
|
||
$g->execute([$name, slugify($name), $display, $order]);
|
||
$gid = (int)$pdo->lastInsertId();
|
||
$i = 0;
|
||
foreach ($sites as $site) {
|
||
$s->execute([$gid, $site[1], $site[0], $site[0], $i++, $now, $now]);
|
||
}
|
||
}
|
||
}
|
||
|
||
/** 生成 slug(中文退化为拼音不可用时用 md5 短串) */
|
||
function slugify(string $s): string
|
||
{
|
||
$s = trim($s);
|
||
if (preg_match('/^[a-z0-9\-]+$/i', $s)) {
|
||
return strtolower($s);
|
||
}
|
||
return 'g' . substr(md5($s), 0, 6);
|
||
}
|