Ordkort

为什么选择 Ordkort

Anki 功能强大，但初始内容为空，你必须自己创建每一套卡组。大多数其他应用都要求你注册账号、订阅服务或交出个人数据。Ordkort 为你提供涵盖 29 个主题和 A1–C1 级别的现成词表，使用与 Anki 相同的 FSRS 计划算法，还配有词典、语法书和能逐词讲解的翻译器。卡片由 AI 编写，并且会对照真实词典进行核验：挪威语使用 ordbokene.no 的官方词典，其他语言使用 Wiktionary。一切都保留在你的浏览器中；设备之间无需账号即可同步，并采用端到端加密。

功能

Ordkort 是一款轻量级网站，可让你用几乎任何语言学习几乎任何其他语言：

• 按主题学习抽认卡，采用间隔重复算法（FSRS-4.5）——新词选择“认识 / 不认识”，复习时选择“记得 / 忘了”。点击翻面、滑动、键盘快捷键、语音朗读。 还有五种学习模式：选择题、输入（屏幕上提供特殊字母行；一个拼写错误，或非拉丁文字的拼音 / 罗马字拼写仍算正确；用另一种形式写出正确词语算半对：不算错误，但卡片会再次出现）、听力、在例句中填空，或混合模式。拼音、罗马字和其他罗马化拼写不会显示在卡片正面（点击一次即可显示），因此学习时要读字符本身。每种语言每天都有各自的新词上限，语言切换器会显示每种语言待复习的卡片数量。
• 主题：内置 29 个主题，分为 6 组（入门、人际、日常生活、周围世界、工作与社会、语法集），还可创建任意自定义主题，或使用空卡组添加自己的词语。 AI 会为 A1–C1 级别挑选真实、常用的词语；“+20 个词”可持续扩充卡组且不会重复。
• 词典，理念与 ordbokene.no 和 Lexin 类似：包含翻译、词形变化表、释义和例句、固定表达、复合词。对于挪威语，会并列显示官方的书面挪威语 Bokmål / 新挪威语 Nynorsk 词典数据，并将其作为 AI 词条的事实依据；每张 AI 编写的名词卡和动词卡都会据此检查一次：错误的冠词或词形会得到修正（修正会应用于所有人共用的词库，也会通过浏览器中的后台检查修正之前保存的卡片）。对于其他语言，服务端会以相同方式对照 Wiktionary 检查名词和动词：冠词必须与名词的性相符（“die Hund” → “der Hund”）；对于本身不显示词性的词语，会确认其词性（“книга”）；Wiktionary 未收录的词形则会被删除。这些语言的词典页面会并列显示 Wiktionary 词条和 AI 词条（词性、关键词形、发音、简短例句释义、词源；英文说明），并将 Wiktionary 作为 AI 词条的事实依据，同时链接到该语言的主要词典（RAE、Duden、Larousse、Treccani、Jisho……）。翻译仍完全由 AI 提供。
• 语法书：按词性分为 15 章（名词、形容词、动词、语序……），包含表格、例句、常见错误和练习，此外还可自由提问语法问题。
• 带讲解的翻译器：每个词都按词性标色，并说明其形式以及解释该词为何恰好在此处使用的规则。
• 阅读：粘贴任意文本；词语会按新词 / 学习中 / 已掌握着色。点击词语即可查看它在当前语境中的含义，并将其添加到卡片中。
• 统计数据和每日目标：连续学习天数、30 天内的复习记录、14 天预测、各阶段的词数，以及最常忘记的词语。
• 双向支持 Anki：可从任意 Anki 导入 .apkg（也支持当前格式），包括图片、录音（点击扬声器按钮即可播放卡片自己的音频），以及你选择保留的学习进度；也可将卡组导出为 Anki 可打开的 .apkg，包含学习进度（包括 FSRS 记忆状态）、图片和录音。支持 CSV 导入和导出，也可通过链接或 QR 码分享卡组——只分享词语，绝不包含学习进度。
• 每张卡片都有语音：没有自带录音的卡片会播放 Wiktionary 上母语人士的录音（来自 Lingua Libre 和 Wikimedia Commons 上的其他资源），或在每日字符数预算内播放 Workers AI 的合成语音（MeloTTS，使用网站自己的 Cloudflare 账户），支持英语、西班牙语、法语、中文、日语和韩语；每段录音只会获取一次，供所有人使用。你仍可在 Settings 中选择设备语音。
• 根据你的记忆习惯调整：Settings → Fit to my memory 会根据你在此设备上的作答，找出 FSRS 权重（依据之前的作答学习，仅当其对之后作答的预测效果优于默认值时才会保留）。
• 卡组库：发布卡组，供学习相同语言组合的所有人使用（Deck → ⋯ → Publish in the library）；按标题搜索其他人的卡组，按最佳或最新排序，投票并添加。在卡组上架前，一个获知卡组库政策的模型会检查其中的词语，另一个能够识别图片的模型会查看封面；不安全的卡组会被拒绝，检查无法运行时也不会发布任何内容。收到三人的举报后，卡组会被隐藏，直到网站所有者查看；发布者也可以将其下架。
• 带填空和自定义字段的卡片：可像在 Anki 中一样标记填空（Jeg {{bor}} i Oslo、{{c1::bor::verb}}），卡片会以填空形式进行学习；每张卡片最多可包含八个命名字段。Anki 的填空笔记和笔记的其他字段都可以这样导入，也可以导出回 Anki。
• 情境短语：选择现成情境（药店、咖啡馆、医生、求职面试……）或自定义情境，即可获得一组在该情境中会说和听到的内容，每条短语都附有回应它的句子。
• 仅保存在设备上的提醒：在你选择的时间，如果当天尚未学习，通知会告知有多少张卡片到期——通知来自打开的标签页，或者在网站安装为应用后由 service worker 发出。没有推送服务：提醒计划保存在浏览器缓存中。
• 主题封面和手机预览：为现成主题新建的卡组会免费获得一张封面图片；Settings → Appearance 会以手机屏幕宽度显示网站，并应用你正在编辑的外观。
• 补全空字段：导入的卡组如果没有例句或语法，或翻译字段并非翻译，AI 会为其补全，每次请求处理 20 张卡片（计入当天的 AI 请求次数）；共用词库中已有的词语不计入费用，且只会修改空字段。大型卡组会先询问是否继续，也可以改为每天填充 10 个词。
• 卡片配图：使用按词语找到的免费开放许可图片、自己的图片，或粘贴的图片；图片保存在设备上。系统会使用词语本身的语言在 Wikidata 中查找，因此“hus”会先找到 Wikimedia Commons 上的房屋图片，然后再找 Pixabay（设置 PIXABAY_KEY 后）和 Openverse 中的图片；Openverse 使用英文搜索。
• 卡组封面：用小方图替代卡组的表情符号（点击表情符号即可）；图片可按主题查找、使用自己的图片，或粘贴图片。图片会以 128-px JPEG 格式保存在卡组中，因此可以同步，也会随卡组一起分享；AI 可通过 MCP 提供封面（cover_url）。
• 自定义外观：可使用 HTML 和 CSS 编写卡片模板（{{term}}、{{image}}、{{#example}}…{{/example}}……），从现成模板开始并实时预览；也可为整个网站编写 CSS。脚本不会运行。
• 更好地记忆：可选择两种或四种评分（Again / Hard / Good / Easy）、设置自己的目标记忆保持率，将总是忘记的词语单独列出，以及使用 What goes wrong：系统会回顾你的作答并整理发现，每条发现都会附带一项行动建议。
• 通过 MCP 使用你自己的 AI：将 Claude、ChatGPT 或任意 MCP 客户端连接到 https://ordkort.com/mcp，让它为你创建带图片的卡组或卡片外观；它会返回一个添加该内容的链接（参见 MCP）。
• 离线可用：service worker 会缓存网站，因此无需联网也能打开卡片。 部署更新后，应用会自动检测新版本——在手机上安装后即使仅被唤醒也能检测——并在下次切换到其他屏幕时加载新版本。
• 举报错误：可举报任意 AI 词条；收到独立举报后，该词条会为所有人重新生成。
• 支持 60 种学习和讲解语言。界面已由人工翻译为英语、俄语、乌克兰语、挪威语、阿拉伯语（RTL）和中文；其他界面语言则由 AI 翻译一次并供所有人使用。

MCP

Ordkort 也是一个 MCP 服务，因此你自己的 AI 可以为它制作卡组和外观。 地址：https://ordkort.com/mcp（Streamable HTTP；无需账户或密钥）。 它已列入官方 MCP Registry，名称为 com.ordkort/ordkort。

• Claude（claude.ai、桌面版）：Settings → Connectors → Add custom connector → 粘贴地址。
• Claude Code：claude mcp add --transport http ordkort https://ordkort.com/mcp
• ChatGPT：Settings → Apps & Connectors → Create（开发者模式）→ 粘贴地址。
• 其他工具（Cursor、VS Code、LM Studio……）：使用该地址添加远程 / HTTP MCP 服务。

该地址、这些步骤和示例请求也可在应用的 Settings → Your own AI (MCP) 中找到。

然后可以这样提问：“为我制作一套配有图片的 A2 挪威语厨房词汇卡组”，或 “设计一张顶部带图片的深色静谧卡片”。AI 会生成一个链接；打开后即可查看卡组或外观，并且只有在你同意后才会添加。它不会看到或更改你的卡片。

工具	功能
list_languages	60 种语言及其代码
list_topics	内置主题及其 ID
ready_words	共享词库中适用于某个主题和级别的词汇，并经过词典核验
find_pictures	查找某种语言中某个词的免费图片：优先显示 Wikidata 条目中的 Commons 图片，然后显示 Pixabay 和 Openverse 的图片，并附上署名信息
design_guide	AI 重新设计网站所需的全部信息：外观的应用和清理方式、卡片结构、字段、图片、字体、每个 CSS 变量、各屏幕的组成部分（每个屏幕对应的 body 类）、浅色和深色主题、注意事项、完整示例及检查清单
create_deck	创建最多包含 500 张卡片的卡组，可包含图片和封面 URL → 生成一个添加卡组的链接
create_design	创建 HTML/CSS 卡片模板和站点 CSS → 生成一个可查看、可在整个网站上试用并应用该设计的链接；还会说明哪些效果无法按预期实现

设计中的脚本不会运行。设计通过 https 地址指定的图片（例如背景照片）会经由站点的图片代理一次性全部获取，因此 CSS 无法判断页面上显示的内容；卡片本身的图片使用 <img src="{{image}}"> 或 var(--card-image)。系统会要求 AI 在回答末尾加上 "Powered by ordkort.com"。调用次数受每个客户端的每小时限额限制。

架构

public/            the site: HTML, CSS, JS, fonts — served by Cloudflare as static assets
  _headers         security headers (CSP etc.)
  sw.js            service worker for offline use
  js/build.js      the version of the site, written at every deploy (not in git)
  js/bundle.js     all the scripts of the app in one minified file, written at every deploy (not in git)
src/               Cloudflare Worker — runs only for /api/*
  worker.js        routing and same-origin check
  mcp.js           the MCP server: tools an AI uses to make decks and looks
  core/            what every part uses
    shared.js      code shared with the site (languages, topics…), the language pair of a request
    db.js          D1: the schema is created automatically on the first request; the shared cache
    limits.js      burst, hourly, daily and site-wide limits
    util.js        small helpers: JSON answers, errors, hashing, codes
  ai/              everything that asks the AI
    routes.js      AI requests: shared cache → word bank → limits → Groq
    prompts.js     all prompts and validation of AI output
    facts.js       verified Norwegian Bokmål grammar facts used to ground the AI
    groq.js        AI client over several providers with model fallback, and the moderation check
    warm.js        a base of ready decks: every 15 minutes, while the site is quiet, the cron fills one more
                   group of the shared word bank, from the decks used most to the rarer ones
  sources/         other sites the Worker reads
    wiktionary.js  Wiktionary for other languages: checks cards, the dictionary entry, recordings
    images.js      free pictures (Wikidata/Commons, Pixabay, Openverse) and the picture proxy
    voice.js       a voice for cards without a recording
  decks/           decks that leave the device
    share.js       decks shared by link
    library.js     the public library and its moderation
    sync.js        device sync and one-time codes (the server only ever sees ciphertext)
    preview.js     link previews for chat apps
scripts/build.mjs  writes public/js/bundle.js (the scripts listed in scripts/bundle.mjs, minified by esbuild)
                   and public/js/build.js; wrangler runs it before every deploy and `wrangler dev`
scripts/landing.mjs  plain pages about the site for search engines (public/<lang>/, 6 languages)
scripts/seo-pages.mjs  static Norwegian pages for search engines, in English, Russian, Ukrainian and Norwegian:
                   29 topic word lists (/<ui>/<learn>/<topic>/), ~530 dictionary entries (/<ui>/ordbok/nb/<word>/),
                   two hubs and a page for teachers per language (texts in scripts/teachers-text.mjs),
                   the pages above and sitemap.xml. Content in data/seo/ (see its README);
                   run `npm run seo` after changing it (a test checks the files are up to date)
data/seo/          the words, translations and examples of those pages, official forms from Bokmålsordboka
tests/             node:test suites (see below)
wrangler.jsonc     Cloudflare configuration

用户数据——卡片、进度、设置——存放在浏览器的 IndexedDB 中（不支持 IndexedDB 的浏览器则存放在 localStorage 中；旧状态会迁移一次）。每个回答的历史记录（“哪里出了问题”读取的内容）、卡片的图片和录音也都存放在其中。历史记录只保留在该设备上；从网上找到的图片会由每台设备重新获取，你自己的照片和 Anki 录音则会逐个文件同步到已关联的设备，并像其他数据一样加密。只有 AI 请求（单词、主题或文本，加上语言对）会发送到服务端，此外还有你选择通过链接分享的卡组（保留一年）和匿名错误报告（保留 30 天）。回答会存储在共享库中，因此下一个人可以立即获取，无需消耗自己的限额。

Groq 密钥仅存放在 Worker 密钥中。浏览器发送的是参数，而不是提示词，因此 API 无法被他人当作免费聊天机器人使用。

限额（在 wrangler.jsonc → vars 或 Cloudflare 控制面板中更改）： AI_PER_HOUR = 每人每小时 40 次，AI_PER_DAY = 每人每天 120 次，AI_DAILY_BUDGET = 全站每天 2500 次。系统通过每天更换的盐值对 IP 地址进行哈希，以此识别用户；IP 地址本身绝不会被存储。学校或办公室中的整个班级会共用一个地址，因此只要今天的消耗还不到 AI_DAILY_BUDGET 的一半，该地址最多可以使用自身限额的 AI_SHARED_TIMES = 5 倍；超过一半后，所有人都会恢复普通限额。已存在于共享缓存中的回答永远不会计入限额。

AI 可处理的内容。 Groq 免费方案的三种模型每天各提供 200,000 个令牌。单词列表需要 5,000–7,000 个令牌，词典条目或翻译需要几千个，因此全站每天大约能获得 100–150 条新的 AI 回答；已生成的内容（共享缓存和词库）都无需消耗令牌。这就是现成卡组库如此重要的原因：定时任务会缓慢填充卡组库（WARM_PER_DAY，每天 24 个列表，约占总容量的五分之一），而 npm run warm 最多处理 25 个列表。Groq 付费方案会提高限额。

无需账户的同步。 一个随机的 32 字节密钥只存在于用户的设备上。它会派生副本 ID、写入令牌和 AES-256-GCM 密钥。服务端存储密文和令牌的哈希值。设备通过一次性 16 字符代码（有效期 3 分钟，首次读取后即失效）或二维码链接关联，其中密钥部分位于 # 之后，绝不会发送到服务端。也可以进行不使用云存储的一次性传输。54 字符的恢复密钥可在所有设备上的浏览器数据被清除后恢复加密副本。副本只保存你自己的照片和 Anki 录音的名称：每个文件都会单独加密并上传到 /api/media，使用同一密钥（每个副本最多 5,000 个文件、约 110 MB），设备会获取其卡片所需的文件。删除副本时，这些文件也会一并删除。

用户可以在网站的“工作原理”页面（#/about）上阅读通俗易懂的说明。

保护数据安全

• 清除浏览器缓存不会影响卡片；清除网站数据 / Cookie 则会。
• iPhone 和 iPad 上的 Safari 会删除 7 天未打开的网站数据，除非将网站添加到主屏幕。该网站支持安装（Web 应用清单），并会在“设置”中对此进行说明。
• 网站会请求浏览器启用持久化存储，以免磁盘空间不足时数据被清除。
• 保险措施：使用已保存的恢复密钥进行同步，或创建 JSON 备份文件（“设置” → “数据”）。

本地运行

npm install

将 .dev.vars.example 复制为 .dev.vars，并在其中填入你的 Groq 密钥，然后运行：

npm run dev

网站将在 http://localhost:8787 运行，并使用本地 D1 数据库。

测试

npm test

测试套件涵盖 FSRS 调度、设备间数据合并（编辑、删除、每日统计）、同步加密和恢复密钥、二维码（由独立阅读器解码）、CSV 导入/导出、界面翻译的完整性、离线文件列表、在 Wrangler 本地运行时中端到端测试 Worker API（共享牌组、一次性链接代码、版本化同步），以及面向搜索引擎的静态页面：内容及时更新、标题和规范链接唯一、hreflang 相互对应、没有失效链接、站点地图中包含每个页面，且每个页面都有至少 150 个字的原创内容。不会调用 AI。 GitHub Actions 会在每次推送和拉取请求时运行这些测试。

部署到 Cloudflare，并通过 GitHub 自动更新

1. Cloudflare 控制面板 → Workers & Pages → Create → Import a repository → 选择此仓库。将构建命令留空；部署命令为 npx wrangler deploy。
2. 首次部署后：Worker → Settings → Variables and Secrets → 添加密钥 GROQ_API_KEY（以及可选的：GEMINI_API_KEY，免费；CEREBRAS_API_KEY，试用版——账户添加付款方式后，可获得 $5 额度，有效期 30 天，之后服务会停止，且不会自动扣费——每个密钥都会为相同模型添加各自的每日限额；无法使用的密钥会被跳过；DEEPINFRA_API_KEY，付费备用服务，仅在所有免费模型都达到限额时才会调用，每日上限由 PAID_DAILY_TOKENS 设定；IP_SALT，任意长随机字符串；以及 PIXABAY_KEY，免费的 Pixabay API 密钥，可将 Pixabay 添加到图片搜索中；还有 ADMIN_TOKEN，任意长随机字符串，允许网站所有者下架资料库中或通过链接分享的任何牌组）。
3. D1 数据库 ordkort 会在首次部署时自动创建，其数据表则在收到首次请求时创建。

此后，每次推送到 main 都会自动部署。

也可以在终端中执行相同操作：

npx wrangler login

npx wrangler secret put GROQ_API_KEY

npx wrangler secret put PIXABAY_KEY   # optional

npx wrangler secret put ADMIN_TOKEN   # optional: taking down decks

下架牌组，以及因举报而隐藏的牌组：

curl -X DELETE -H "X-Admin-Token: $ADMIN_TOKEN" https://YOUR-SITE/api/library/DECKID   # or /api/share/DECKID
curl -H "X-Admin-Token: $ADMIN_TOKEN" https://YOUR-SITE/api/library/hidden

npm run deploy

安全

• 所有输入都会在服务器端验证（语言白名单、长度限制）；AI 输出在进入共享数据库前会检查格式和大小。
• 拒绝跨站请求（检查 Origin）；API 仅接受 JSON。
• 突发请求会在内存中限流，生成次数会记录在 D1 中，此外还有全站每日预算。
• 数据库空间：同步副本及其文件、链接代码、共享牌组和牌库牌组、外观和语音使用每日配额。每人每天的 STORE_PER_DAY_MB = 100，全站每天的 STORE_SITE_DAY_MB = 1000，因此脚本无法在一小时内填满 D1。请求正文以及抓取的图片和录音都会以流的形式读取，并在达到限额时截断。
• 牌库审核会统计其对审核模型的请求次数（每人每天 GUARD_PER_DAY = 60，全站每天 GUARD_SITE_DAY = 400），因此发布大型牌组不会耗尽所有人的 Groq 每日令牌额度。系统会告知模型，牌组文本是数据，而牌组中要求将其称为安全的内容并不安全。
• 浏览器发送的已有单词只有看起来像单词（或短语）时，才会以 JSON 列表的形式加入提示词：没人能把给 AI 的指令写进共享词库。
• 分享的外观会在预览中应用 CSS，且作用范围仅限示例卡片；只有点击“使用此外观”后，才会应用到网站的其他部分。如果外观隐藏了控件，请使用 ?nolook 打开网站 （https://ordkort.com/?nolook#/settings）并重置外观。
• CSP 禁止第三方脚本和框架；字体由本站托管。仅 SQLite 可以使用 WebAssembly（'wasm-unsafe-eval'）；SQLite 可读取和写入 Anki 数据包，并在首次导入或导出时从本站加载。浏览器唯一的第三方请求是面向挪威语的开放 ordbokene.no API。服务器会在 Wiktionary 中查询单词（仅发送单词，并按 Wikimedia 的要求附带 User-Agent），并缓存结果 30 天。卡片图片也由服务器搜索（Wikidata、Wikimedia Commons、Pixabay、Openverse）并抓取，因此访问者的 IP 不会暴露给其他网站：仅使用 https，栅格图片大小最多为 5 MB，并且每人每小时有请求限额。
• Worker 请求日志已关闭。限流计数器、链接代码和已放弃的同步副本会由每日定时任务删除。
• 发现漏洞？请发送邮件至 [email protected]，而不要创建公开问题 （也可查看 /.well-known/security.txt）。
• Cloudflare 的网络可抵御大流量攻击。使用自定义域名时，还可以为 /api/* 启用 WAF 速率限制规则和 Bot Fight Mode。

贡献

最简单的帮助方式，无需编写代码：将界面翻译成你的语言（一个文件，约 550 条简短字符串）、通过任意卡片或词典条目上的按钮报告错误单词，或就任何让你困惑的内容创建问题。也欢迎贡献代码；请参阅 CONTRIBUTING.md。问题和想法可发布到讨论区，也可以发送邮件至 [email protected]；如果你不想公开发言，也可以选择邮件（教师通常会这样做）。post@、help@ 和 [email protected] 都会联系到同一个人；除此之外，没有其他地址属于 Ordkort。Ordkort 绝不会通过邮件索要密码或金钱。

如果 Ordkort 帮助你学习，请在 GitHub 上点个 ⭐，让其他学习者也能发现它。

许可证

GNU AGPL-3.0。你可以使用、研究、修改和分享代码；如果你将修改后的版本作为公共服务运行，就必须按照相同许可证发布你的修改。

致谢

官方挪威语词典数据：ordbokene.no（Språkrådet 和卑尔根大学）。AI：Groq。字体：Geologica、Literata、Readex Pro、Noto Naskh Arabic——SIL Open Font License 1.1。二维码：移植自 Project Nayuki 的 QR Code generator（MIT License）。Anki 软件包：sql.js（基于 WebAssembly 的 SQLite，MIT）和 fzstd（MIT）。图片：Wikimedia Commons（通过 Wikidata 查找）、Pixabay 和 Openverse， 各自遵循其许可协议并注明出处。