站点:Schulte Table https://schultetable.pro/ (中文:舒尔特方格 /zh/)
本文是一次基于公开页面与前端资源的技术观察,站在实现视角介绍舒尔特方格训练站的架构取舍与关键模块设计,不涉及未公开服务端源码。
一、先看结论:这是一个「重内容、轻后端」的产品型静态站
舒尔特方格本身的规则并不复杂:在打乱的数字网格上按序点击,同时尽量盯住中心点。 难的是把它做成可长期用的产品------毫秒级计时要稳、多模式要自洽、成绩要可追踪、多语言要可维护、SEO 还要能在 12 个语种下不乱。
从公开资源可以确认的技术画像大致是:
- 框架 :Astro(产物路径为
/_astro/*.js|*.css,组件名可见Trainer.astro、PrintableGenerator.astro、BaseLayout) - 交互层:原生 ES Module + DOM,不是 Next/Nuxt,也没有把整站做成 React SPA
- 部署 :Cloudflare 边缘(响应头
Server: cloudflare,静态资源有cf-cache-status: HIT) - 数据 :训练成绩主要落在浏览器
localStorage,键名schultetable_stats - 形态:多语言静态站点 + 首页「训练器」小岛脚本 + 打印页客户端 PDF 生成
这类架构很适合「工具站 + 内容站」一体:训练器要交互,指南/FAQ/关于页要 SEO; Astro 的 islands 思路正好把大部分 HTML 预渲染出去,只给训练器注入必要 JS。
二、整体架构:静态多语言外壳 + 训练器岛屿
1. 页面分层
schultetable.pro
├── / # 英文主站:训练器 + 介绍
├── /zh/ /es/ /ru/ ... # 12 语种平行站点
├── /how-to-play/、/benefits/、/benchmarks/、/faq/ ...
├── /printable/ # 打印 / PDF 生成器
├── /attention/ # 专注力工具入口
│ ├── /cancellation/
│ ├── /trail-making/
│ ├── /digit-letter/
│ ├── /five-run/
│ └── /visual-search/
├── /_astro/ # 构建产物(hash 文件名)
├── /llms.txt # 面向生成式引擎的站点说明
├── /sitemap-index.xml
└── /site.webmanifest
语种不是运行时切换文案,而是按路径前缀输出完整页面 (例如 /zh/how-to-play/)。 这对 SEO 很友好:每个 URL 都有独立 lang、canonical、hreflang 与 JSON-LD。
2. 为什么适合 Astro
训练器只占首页的一部分;大量页面是说明文、指南、FAQ。Astro 的价值在于:
- 构建期把多语言内容压成静态 HTML
- 训练器以独立 module 加载(如
Trainer.astro_...js),并拆出timer.*.js、symbols.*.js - 导航之类的小交互直接内联极短 script,不引入整框架运行时
首页 HTML 里能看到典型「岛屿」接入方式:容器 #trainer-app + <script type="application/json" id="trainer-i18n"> 注入文案, 再由 module 读取 dataset.locale 初始化。服务端不需要为每一次点击开 API。
三、核心训练器:状态机、计时与网格算法
1. 会话状态机
从脚本行为可以还原出清晰的状态流转:
idle ──Start──▶ countdown(3→2→1→Go!) ──▶ playing ──完成──▶ idle(+ modal)
▲ │
└────── Restart / 关闭弹窗 ┘
- 首次开始可直接进入
playing;再次开始走倒计时,避免误触 - 点击正确数字才真正启动计时器(第一次命中后
start()) - 点错累加 errors,并给单元格短暂 error 样式;计时不停
- 结束后弹出结果模态框:耗时、错误、评级、是否破纪录、是否达成每日目标
2. 毫秒级计时:performance.now + rAF
计时模块是独立 chunk。实现思路很「教科书」,也足够精确:
class Timer {
startTime = 0
elapsed = 0
running = false
rafId = 0
start() {
if (this.running) return
this.running = true
this.startTime = performance.now() - this.elapsed
this.tick()
}
stop() {
this.running = false
cancelAnimationFrame(this.rafId)
this.elapsed = performance.now() - this.startTime
return this.elapsed
}
tick = () => {
this.onTick(this.getElapsed())
if (this.running) this.rafId = requestAnimationFrame(this.tick)
}
}
几个值得学的点:
- 用
performance.now()而不是Date.now(),减少系统时钟跳变影响 - 用
requestAnimationFrame驱动 UI 刷新,显示到百分之一秒((ms/1000).toFixed(2)) start支持暂停后续跑(用elapsed补偿),结构干净
对舒尔特方格这种「短会话、强反馈」工具,计时精度直接决定产品可信度。 把 Timer 抽成独立模块,也方便五连表、划消测验等其它工具复用。
3. 打乱算法:Fisher--Yates + 可种子 RNG
symbols 模块里有两套打乱:常规模式用 Math.random() 的 Fisher--Yates; Daily Challenge 则用日期种子的线性同余生成器(LCG),保证同一天全球同一张表。
// 简化示意
function lcg(seed) {
let t = seed >>> 0
return () => {
t = (Math.imul(1664525, t) + 1013904223) >>> 0
return t / 4294967296
}
}
function seededShuffle(arr, seed) {
const a = [...arr]
const rand = lcg(seed)
for (let i = a.length - 1; i > 0; i--) {
const j = Math.floor(rand() * (i + 1))
;[a[i], a[j]] = [a[j], a[i]]
}
return a
}
function dateSeed() {
const d = new Date()
return d.getFullYear() * 10000 + (d.getMonth() + 1) * 100 + d.getDate()
}
这是「每日挑战」产品化的关键:不用后端发题,也能做到同日一致、次日刷新。 种子来自本地日期,实现成本极低;若以后要做全球统一日界线,再改成 UTC 日期即可。
4. 多模式如何共用一套网格
训练器支持:
- Classic:1 → N
- Reverse:N → 1
- Schulte-Gorbov:黑升红降,逐步切换颜色序列
- Daily:固定 5×5 + 数字 + 日期种子打乱
- Symbols:Numbers / Letters(字母用 A、B、C...)
Gorbov 的序列设计值得单独说:
- 对 N×N 网格,黑数约
ceil(N²/2),红数约floor(N²/2) - 总步数仍是 N²;每一步给出「当前应点的 color + value」
- 校验时同时比对数值与颜色,避免「点对数字但颜色错」被放过
另外还有 Gaze mode (点中后隐藏格子,逼迫周边视野)与 Shuffle on click(每次正确点击后重排剩余格子)。 这两项把「记住位置」这条捷径堵掉,更接近训练意图。
5. 中心注视点的布局技巧
中心点不是简单写死在 CSS 正中。脚本会在网格渲染后,用中间四格的 getBoundingClientRect() 计算几何中心,再写回 fixation dot 的 left/top;窗口 resize 时重算。
这对响应式很重要:CSS Grid 单元格尺寸会变,硬编码百分比容易「看起来在中心、其实偏一格」。
四、成绩体系:localStorage 上的轻量「用户系统」
没有登录,不等于没有进度。站点用本地存储搭了一套够用的数据模型:
// 键:schultetable_stats
{
sessions: [
{
gridSize, mode, symbolType, gazeMode,
timeMs, errors, date // ISO
}
], // 最多保留约 30 条
dailyGoal: 3,
lastPlayDate: "YYYY-MM-DD",
streak: 0,
dailyBest: { "YYYY-MM-DD": timeMs }
}
由此派生出 UI 上的:
- 连续打卡 streak(按自然日衔接判断)
- 今日完成数 / 每日目标进度条
- 当前配置下的历史最佳(grid + mode + symbol + gaze 组合过滤)
- 今日均速、平均错误、近 7 日 sparkline
- 最近会话列表
这是典型的「工具站数据策略」:零账号摩擦、隐私友好、实现快; 代价是换设备不同步。对舒尔特方格这种短练习产品,通常是正确取舍。 若以后要云同步,现有 session schema 已经足够直接映射到后端。
评级阈值
站点内置按网格尺寸划分的时间阈值(classic 与 gorbov 两套), 把成绩映射为 Exceptional / Advanced / Intermediate / Beginner。 这让「练完」不只是看一个秒数,而有可比较的训练层级------内容页 Benchmarks 与结果弹窗共用同一套逻辑。
五、打印与分享:把训练结果产品化
1. 打印页:jsPDF + html2canvas + Blob 下载
/printable/ 是另一个岛屿组件 PrintableGenerator。 从前端依赖特征看,走的是浏览器端生成 PDF:渲染网格 → 截图/绘制 → jsPDF 分页输出 → Blob 触发 download;同时保留 window.print 路径。
好处是服务端零渲染成本;坏处是大页数时要小心内存与字体。 对「一次生成一叠练习纸」的场景,客户端方案足够。
2. 分享图:Canvas 卡片
训练结束后可生成分享卡片。脚本里有固定画布尺寸(约 1080×540)和一套金色/深色设计 token, 用 Canvas 2D 画圆角卡片、成绩与评级色带,再导出图片; 同时支持 Web Share / 复制文案 / 各社交平台分享链接。
这对增长很关键:舒尔特方格天然有「比分数」属性, 把结果做成可转发图片,比纯文本链接更利于传播。
六、多语言与 i18n 工程化
公开信息显示支持 12 种语言:
en / es / zh / ru / ja / de / fr / ko / pt / pl / tr / it
实现上能看到三层配合:
- 路由层 :非英文加前缀;英文落在根路径;
x-default指向英文 - 文档层:每页完整翻译(不只是 UI 字符串),含指南与工具页
- 运行时层 :训练器文案通过页面内 JSON 注入;日期用
Intl/toLocaleDateString按 locale 显示
路径助手逻辑类似:若 locale 在列表中,则 /${locale}${path},否则返回英文路径。 zh 在 OG/HTML 里映射为 zh-CN,与 hreflang 保持一致。
对博客园读者更有借鉴意义的是:工具站做国际化时,优先「静态副本」而不是「一个 SPA + 运行时字典」。 前者爬虫友好、首屏快、缓存简单;后者更适合强登录的应用态产品。
七、SEO / GEO:这个站不仅在给用户看,也在给搜索引擎和 LLM 看
技术细节里很「现代站点」的一部分:
- 完整
hreflang矩阵 + canonical - Open Graph / Twitter Card(含多 locale alternate)
- JSON-LD
@graph:Organization、WebSite、WebApplication、HowTo、Article、BreadcrumbList、DefinedTerm 等 WebApplication标注免费、featureList、操作系统为浏览器- 内容页有
#direct-answer/SpeakableSpecification,方便摘要抽取 - 提供
/llms.txt,用结构化文本说明站点定位、页面清单与各语言入口 sitemap-index.xml覆盖多语言 URL- PWA 清单
site.webmanifest(standalone 显示、主题色),图标用 SVG
舒尔特方格是一个「搜索意图非常明确」的词(含各国本地叫法)。 把产品做成多语言内容集群,比单页玩具更容易形成长尾流量。 对做独立工具站的人,这比纠结要不要上 SSR 更重要。
八、专注力工具集:同一设计语言下的扩展玩法
主站不止一张舒尔特表,还提供一组短练习:
- Cancellation(划消)
- Trail making(连线,含 A/B)
- Digit--letter grid(数字字母交替)
- Five-run report(五连局稳定性报告)
- Visual search(异类搜索)
技术上它们更像「同一前端基建的多个小状态机」:共享计时、历史记录、结果弹层与 i18n 模式。 产品上则把单点工具扩展成注意力训练套件,提高停留与回访。
九、性能与交付
- HTML/CSS 预渲染,训练器 JS 按需加载;静态资源 Cloudflare 缓存(可见 4 小时级
max-age) - 支持 HTTP/3(
alt-svc: h3) - 无重型前端框架运行时,主交互文件体量可控(训练器主包约数十 KB 量级,另有 timer/symbols 小组件)
- 全屏 API:开始训练时可进入 fullscreen,减少浏览器 chrome 干扰
- 无障碍细节:按钮
tabIndex、键盘 Enter/Space 触发、Escape 关闭弹层、语义化 nav/main
对这种工具站,性能优化的主旋律不是虚拟列表,而是: 少发请求、少下水合、计时别抖、移动端点按别误触。
十、若你要做同类「舒尔特方格」站,可直接抄的工程清单
- 规则引擎与 UI 解耦:next target、校验、模式切换放纯函数;DOM 只负责渲染与事件
- Timer 独立模块 :
performance.now+ rAF,统一格式化 - 打乱可测试:普通随机与 seeded 随机分支清晰,Daily Challenge 才好做
- 本地成绩 schema 先设计好:哪怕暂不登录,也要能导出/升级
- Astro/静态多语言:内容页 SSG,训练器岛屿化
- 结果可分享:Canvas 卡片比纯数字更有传播性
- 打印是第二入口:教室/家长场景很依赖 PDF
- SEO 与 GEO 同步做 :hreflang、JSON-LD、
llms.txt、本地化术语页
十一、小结
schultetable.pro 把一个古老的纸质注意力测验,做成了现代 Web 工具站: Astro 负责多语言静态外壳,原生模块负责训练器,Cloudflare 负责分发,localStorage 负责进度,Canvas/jsPDF 负责输出物。
它技术上并不「炫技」,但每个选择都贴合产品约束------ 低摩擦、可计量、可打印、可分享、可被搜索到。 做垂直工具站时,这种克制往往比上大而全的技术栈更重要。
参考站点: Schulte Table / 舒尔特方格 · llms.txt · 中文版