feat: global ⌘K command palette + punctuation-insensitive search everywhere / 全局 ⌘K 命令面板与全站忽略标点搜索

[functionstackx]

Summary

Two usability upgrades aimed at making the app dramatically faster to navigate and search:

1. Global command palette (⌘K / Ctrl+K)

A keyboard-first launcher in the header that jumps to any destination in the app from anywhere:

• All top-level pages (Home, AgentX, Overview, Comparisons, Articles, About, AI Chips, Rankings, Glossary, Supporter Quotes, API Reference)
• All primary dashboard tabs (Inference Performance, Accuracy Evals, Historical Trends, TCO Calculator, Fleet Lifecycle, Chip Specs, Submissions)
• Every active model dashboard (/inference/<model>)
• Every chip page (/chips/<slug>)
• Quick actions: switch theme, switch language, star on GitHub

Details:

• Fully bilingual — on /zh pages the palette renders Chinese labels and navigates to the /zh sibling routes
• Full keyboard support (↑/↓/Home/End/Enter/Esc), ARIA combobox/listbox semantics, aria-activedescendant, scroll-into-view
• Uses the same commit-retry navigation as header links (extracted as pushInApp from navigateInApp) so the first dashboard transition commits reliably
• PostHog events: command_palette_opened / command_palette_selected
• Trigger button in the header with platform-aware ⌘K / Ctrl K hint (rendered post-mount for hydration safety)

2. Punctuation-insensitive, order-insensitive search everywhere — closes #406

New shared matchesSearch utility (packages/app/src/lib/search-match.ts): lowercases, folds separator punctuation to spaces (CJK preserved), and requires every query token to match. Applied to:

• SearchableSelect (model/queue pickers) — "B300 vllm" now matches "B300 (vLLM)"
• MultiSelect (both filter paths)
• DataTable global filter
• The new command palette

Tests

• search-match.test.ts — normalization, tokenization, Search optimizations (Not SEO) / 搜索优化（非 SEO） #406 regression cases, CJK
• command-palette-items.test.ts — registry pinned against chip-pages.ts, dashboard routes, and model slugs so the palette can't silently drift
• command-palette.test.tsx — open via trigger/Ctrl+K, filtering, Enter navigation, arrow keys, empty state, /zh behavior
• searchable-select.test.ts — new parenthesis/word-order case

bun run typecheck ✓ · bun run lint ✓ · bun run fmt ✓ · bun run test:unit ✓ (254 files, 4486 tests)

Verified in a live dev server (desktop 1440px, mobile 375px, / and /zh): palette opens via shortcut and button, filters, navigates to pages/tabs/models/chips, and the header hint renders on one line.

中文说明

两项可用性升级，让站内导航与搜索显著提速：

1. 全局命令面板（⌘K / Ctrl+K）

页眉新增键盘优先的启动器，可从任意位置跳转到应用内所有目标：全部顶层页面、主要仪表板标签页（推理性能、精度评测、历史趋势、TCO 计算器、机队生命周期、芯片规格、提交记录）、每个模型仪表板（/inference/<model>）与每个芯片页面（/chips/<slug>），并提供快捷操作（切换主题、切换语言、GitHub 加星）。

• 完整双语支持——在 /zh 页面上面板显示中文标签，并跳转到对应的 /zh 路由
• 完整键盘支持（↑/↓/Home/End/Enter/Esc）与 ARIA combobox/listbox 语义
• 复用页眉链接的导航重试逻辑（从 navigateInApp 提取为 pushInApp），确保首次仪表板跳转可靠提交
• PostHog 事件：command_palette_opened / command_palette_selected

2. 全站搜索忽略标点与词序——修复 #406

新增共享工具 matchesSearch：转小写、将分隔标点折叠为空格（保留中文字符）、要求每个查询词均命中。已应用于下拉搜索、多选、数据表格全局筛选与新命令面板。例如 "B300 vllm" 现可匹配 "B300 (vLLM)"。

测试

新增/扩展四组单元测试；typecheck、lint、fmt、test:unit（254 个文件，4486 个用例）全部通过，并在本地开发服务器上完成桌面端、移动端与中文站的可视化验证。

---

Note

Medium Risk
Touches app-wide navigation and in-app routing retry logic, plus search behavior in shared UI controls; risk is mitigated by extensive unit tests but edge cases around dashboard URL state remain possible.

Overview
Adds a global command palette (header trigger + ⌘K / Ctrl+K) that searches and jumps to site pages, dashboard tabs, model routes, and chip pages, with quick actions for theme, locale, and GitHub. Navigation reuses the header’s commit-retry behavior via new pushInApp, preserves dashboard query params (e.g. unofficialruns), skips re-navigating to the current route, and is bilingual on /zh. The palette trigger is hidden below 360px width to keep narrow headers usable.

Introduces shared matchesSearch (token-based, punctuation-normalized, order-independent) and wires it into SearchableSelect, MultiSelect, DataTable filtering, and the palette—fixing #406 (e.g. B300 vllm matches B300 (vLLM)).

TAB_LABELS_EN moves to tab-meta.ts for reuse by tab nav and palette; palette destinations live in test-backed command-palette-items. Unit tests cover search matching, palette behavior, and registry drift vs chip pages and model slugs.

^{Reviewed by Cursor Bugbot for commit 275bec5. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
inferencemax-app	Ready	Preview	Aug 28, 2026 12:46am

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6fa7e56. Configure here.}