HadithDB

HadithDB

HadithDB（Hadith Unlocked）是一个用于阅读、搜索和引用《古兰经》与圣训的网站。你可以访问 https://hadithunlocked.com 在线浏览。

每条记录都会保留原始阿拉伯语文本，并在有译文时附上英语译文，同时提供章节列表和评级信息。对于圣训，传述链（isnād）和报告正文（matn）分别存储，因此两者都可以单独阅读和搜索。

MCP 服务

HadithDB 提供只读、无状态的 Streamable HTTP MCP 传输，端点为 POST /mcp。此版本部署后，公共端点将为 https://hadithunlocked.com/mcp。它提供《古兰经》和 tafsir 查询／搜索、 圣训搜索、完整圣训详情查询以及《古兰经》音频工具。

可通过 research_islamic_topic 和 research_quran_ayah 进行深入研究。主题工具接受 question、简短的阿拉伯语／英语 queries、用于锚定证据的可选已知 hadith_references，以及 depth（brief、standard 或 deep）。它会收集发现候选项、准确的《古兰经》／tafsir 和圣训记录、不同著作的评注，以及通过已验证内部引用关联的报告。来源编号本身绝不会被视为跨合集的唯一标识。

要解释经文，请使用 surah 和 ayah 调用 research_quran_ayah。 standard 深度会查询 Tabari、Ibn Kathir 和 Qurtubi；deep 还会加入 Baghawi、Saadi 和 Ibn Ashur。缺失的来源会被明确报告，而不会悄悄用其他来源替代。 tafsirs 可覆盖此选择。阅读返回的文本后，再使用简短、有依据的 concepts 再次调用，以研究相关《古兰经》／tafsir、圣训和 shuruh。这是在同一轮中由助手执行的工作流，而不是要求用户后续跟进。 该工具不会假装在服务端推断语义概念。

研究档案会区分直接 tafsir、准确报告、与来源关联的报告以及概念搜索候选项。它们会为每次调用返回 found、searched_no_match、not_searched 或 unavailable 状态、遗漏项和明确的后续步骤。 档案包含选定的来源字段和有长度限制的摘录：发现文本的每个字段最多 500 个字符，检索到的来源文本最多 3500 个字符，并附带截断标记和准确的查询标识符。这些档案并非穷尽式调查，也不是生成的教法裁决。总时限为 25 秒，并根据深度限制调用次数和来源数量；请检查覆盖范围，并在重要情况下检索被截断或遗漏的来源。研究深度并不决定答案长度。

list_hadith_commentaries、search_hadith_commentary 和 lookup_hadith_commentary 提供现有 shuruh 目录和索引。 搜索支持准确的评注 source 别名和／或关联圣训的 reference； 查询使用条目 id。紧凑型圣训详情现在会包含 research_inventory， 其中列出完整的关联评注列表、著作数量以及已验证的相关引用。 每种详情配置还会包含 metadata.grades（所有已存储的评级者意见）、 metadata.narrators（包括可靠性和 death_text，即存储的逝世年份 或日期描述），以及 metadata.related_reports（仅包含去重后的合集:编号 引用）。紧凑型 metadata.sharh 会列出评注身份信息，但不含文本； 完整文本请使用评注查询工具。

部署架构变更后，请更新已发布的插件／连接元数据，并在全新的客户端会话中对照 tools/list 验证可见工具。 仅发布 JSON 架构 URL 并不会刷新已安装插件的架构快照。尤其是，lookup_hadith_detail 必须像服务端一样向客户端公开 response_profile。

公共工具架构可通过 GET /mcp-server/schema.json 获取，并从 /mcp-server 链接访问。它包含服务端和协议版本，以及 MCP tools/list 返回的相同工具定义，包括输入／输出架构 和注解。该架构由运行中的服务端定义生成，无需 MCP 初始化或身份验证。 get_quran_audio 会返回完整苏拉的 audio_url、带有秒级媒体片段的 playback_url、段落的 start_ms / end_ms，以及包含毫秒边界的有序经文 segments。例如， {"surah":2,"ayah_from":255,"ayah_to":257} 默认使用 Juhani；添加 reciter 可从 list_quran_reciters 中选择别名或准确名称。省略 ayah_to 可指定单节经文。要获取整章，请提供首节和末节经文；跨章的段落则需每章调用一次。时间信息不完整时会返回错误。 这些工具提供播放数据；客户端必须播放 URL、跳转到起始位置，并在结束位置停止。媒体片段支持情况取决于播放器。

《古兰经》导航工具会公开存储的 Mushaf 布局和编辑标题：

• lookup_quran_page：传入 page，或传入 surah 和 ayah，以获取版本信息、经文范围和词语边界、重叠标题及存储的引言。 页面概览由来源标题汇编而成，并非另行撰写的叙述性摘要。经文可能跨越多个页面；词语边界会标明此处对应的部分。
• list_quran_sections：传入 surah，以发现段落（二级）和子章节（三级）的标识、双语标题、引言及准确经文范围。 请使用 next_offset 翻页；默认 limit 为 25，最大为 100。
• lookup_quran_passage：传入 surah 和 section（可选传入 subsection），或传入 surah 和 ayah 以确定所属段落。除来源标题记录外，还会返回父子关系和 Mushaf 页面链接。

这些工具会将缺失的语言字段保留为 null。response_profile 控制每个标题下引言的长度：compact 为每种语言 1000 个字符，default 为每种语言 6000 个字符，full 则不截断。引言描述的是整个标题范围，该范围可能超出请求的页面。标题和范围均会保留。收到请求时，助手可以根据这些来源材料撰写叙述性页面摘要，并明确区分其综合内容与存储的编辑文本。

如果底层记录提供阿拉伯语和英语，则会分别公开；不可用的语言字段会返回 null，而非合成内容。长篇 tafsir 和圣训详情工具支持 compact、default 和 full 响应配置。圣训详情默认使用 compact；default 会添加有长度限制的学术出处说明和评论，而 full 则是明确提供完整出处信息的模式。搜索工具会返回固定大小的页面、分页元数据和不透明游标；《古兰经》搜索会将译文匹配项合并到对应的规范经文下。分页会说明总数是否精确；当后端只获取了足以证明还有下一页的数据时，total_available 为 null。搜索会拒绝超过 500 的逻辑偏移量，每次调用最多扫描底层六页，并强制执行 10 秒期限。list_tafsirs 也会返回 total、has_more 和绑定查询的不透明游标。 《古兰经》经文、《古兰经》搜索结果、圣训搜索结果和圣训详情记录会公开 bilingual、text、text_arabic、text_english 和 truncated。完整配置下的圣训详情 sharh 条目会保留现有的 text 和 text_en 来源字段，并额外公开明确标注语言的字段。长度受限的默认配置会公开明确标注语言的评论字段，但不会重复原有的长文本字段。

该端点接受 initialize、ping、 tools/list、tools/call、skills/list、skills/get 和 resources/read 的 JSON-RPC 2.0 请求。它通过 OpenAI 的静态 MCP 技能导入扩展公布五项能够识别来源的研究技能。它不会创建会话，因此客户端不应期待收到 Mcp-Session-Id 响应头。支持通过 OPTIONS /mcp 发送浏览器预检请求；此路径的完整 CORS 响应由公共边缘负责，而应用程序会验证浏览器来源，原生客户端可以省略 Origin。其他 HTTP 方法会返回 405。

curl https://hadithunlocked.com/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}'

该端点的请求大小上限为 64 KiB，并设有按 IP 限制的速率上限。使用 MCP_RATE_LIMIT_WINDOW_MS 和 MCP_RATE_LIMIT_PER_IP 覆盖默认值。默认情况下，内部工具请求使用当前请求的主机；暂存部署可通过 HADITHDB_MCP_HADITH_BASE_URL 和 HADITHDB_MCP_QURAN_BASE_URL 覆盖后端站点。使用逗号分隔的 MCP_ALLOWED_ORIGINS 设置添加浏览器来源。有关脱敏审计日志规范和保留设置，请参阅 MCP 数据处理。

最新动态

近期的工作改善了整个站点的阅读、浏览和搜索体验：

• 阅读《古兰经》 — 在 Passage、Ayat、Mushaf、Practice 和 Mudhakkir 视图之间自然切换，同时保留阅读位置。你可以为一段经文点赞、评论、添加书签和分享，轻松切换经文与章节，并使用忠实还原页面的 Mushaf 视图及数据库支持的间隔重复功能。
• 15 行 Mushaf — 以响应式、忠实还原页面的 Digital Khatt 布局阅读全部 604 页，支持无限滚动、《古兰经》苏拉标题、可交互的单词和经文标记、页面书签、基于段落的着色以及连续诵读。
• 注释与译文 — 全页注释和译文视图、用于切换作品的标签页、作者撰写的书籍与苏拉导言、悬停说明、动态译文选择，以及并排显示阿拉伯语和英语的选项。你可以单独启用或关闭各部作品，并选择它们的显示顺序。
• 《古兰经》音频 — 选择诵读者，从指定经文开始播放，跨页连续播放，重复播放段落或子章节，并调节播放速度，同时保留同步的经文高亮和译文字幕。
• 搜索 — 全站搜索面板可在圣训和《古兰经》+《古兰经》注释之间切换，并分别记住各自的查询内容。它支持《古兰经》的规范顺序、阿拉伯语 RTL 输入、虚拟合集、书籍分组快捷方式、按作品筛选，以及针对苏拉、经文、译文、注释和圣训的统一建议。
• 丰富的圣训详情 — 单条圣训可包含多项学者评级、圣训和传述链分类、关联的传述者时间线、生僻词释义、注明来源的说明，以及相似或补充传述的参考信息。
• 大纲导航 — 响应式章节菜单和桌面端吸附式导航栏会跟随当前章、段落、子章节或元数据部分，并显示附近的标题，方便快速浏览长篇内容。
• 分享 — 响应式《古兰经》和圣训分享卡片支持编辑后复制、文字大小控制、选择译文、复制文本、复制图片以及设备的分享面板。
• MCP 访问 — 只读的 Streamable HTTP 端点向兼容客户端提供《古兰经》、注释、圣训搜索和完整圣训详情工具，且不会创建服务端会话。
• 我的设置 — 分别设置圣训和《古兰经》的起始位置，记住注释、译文和诵读者偏好，并保存书签中的段落和 Mushaf 页面以供日后阅读。

圣训功能

• 浏览原典书籍和主题虚拟合集，并使用双语章节与分节导航；引用格式稳定，采用 book:number，支持 JSON、TSV、EPUB 或 Markdown 输出（视情况而定）。
• 搜索整个圣训库，或将范围限定为单本书以及 Sahihayn、Four Sunan、Six Books 或 Nine Books 分组。虚拟合集可与原典书籍一起搜索。
• 阅读阿拉伯语传述链（isnād）和正文（matn），两者与英文译文分开显示。归属和传述链类别可识别先知、圣门弟子或再传弟子传述，以及相连或中断的传述链（视元数据是否可用而定）。
• 在增强型详情页中，比较学者的评定意见；沿着逐位诵读的传述者传述链查看传述者生平链接和可靠性说明；打开罕见阿拉伯语词汇的释义；阅读阿拉伯语或英语注释（sharḥ）；并沿着相似传述的引用返回库中查看。
• 补充来源中的传述会链接到其对应的本地主要传述，而不会作为无关的重复记录呈现。
• 为传述点赞、添加书签和评论、引用并分享。分享编辑器可调整语言内容块的大小或将其省略，并可在桌面端和移动端复制排版文本或生成的图片。
• 管理员可直接修订正文和标题，管理学术评定及有来源依据的说明，链接相似传述，从已配置的来源补充元数据，并刷新受影响的搜索缓存和渲染缓存，而不更改公开引用。

Quran Unlocked

像读书一样阅读《古兰经》，像研读文本一样探索它，并一次听完连贯诵读——一站式完成。 Quran Unlocked 将响应式的 15 行 Mushaf 与单词级学习、经文段落结构、可信的译文和 tafsīr、个性化音频，以及保存和分享重要内容的工具融为一体。

打开 Mushaf，从上次阅读的位置继续。点击单词查看释义，选择一节经文阅读译文，或让诵读无缝延续至下一页。切换到练习模式，使用相同的 15 行页面布局测试记忆，或立即跳转到指定经文或结构化段落，同时保留当前位置。

Quran 功能

五种互相关联的阅读模式

• Passage 按带标题的章节和小节呈现《古兰经》，便于按主题阅读。
• Ayat 专注于单节经文及经文重点视图。
• Mushaf 还原熟悉的逐页 15 行阅读体验。
• Practice 保留 Digital Khatt Mushaf 字体和 15 行页面布局，并将普通词语替换为带下划线的填空。basmalah 和经文标记仍会显示。
• Mudhakkir 使用经文级间隔重复计划测试到期经文。学习中的经文会优先进入队列，并通过简短的新卡片学习步骤逐步进阶，直至达到“良好”。
• 在无限滚动时，模式链接、页面副标题、URL、上一页／下一页链接和相关段落会自动跟随当前查看的内容。
• 可直接按 surah、经文、段落、小节、juz、manzil、Mushaf 页面和搜索结果导航。

响应式 Digital Khatt Mushaf

• 全部 604 页均采用 Digital Khatt《古兰经》文本，并忠实还原页面的 15 行布局。
• 页面以垂直无限滚动方式连续加载；读完第 604 页后，可继续从第 1 页阅读。
• 页面布局可适配桌面端、竖屏手机和横屏手机，不受常规文本大小控件影响，也不会溢出页面。
• 《古兰经》章标题使用 QCF 标题字体。新章开篇时，标题和太斯米与章首内容保持在一起；第 9 章则正确省略太斯米。
• 内侧边缘的细微阴影让奇数页和偶数页呈现出如同摊开的印刷书籍般的效果。
• 黑色与马鞍棕色文本交替显示，凸显 h3 子章节的边界，同时保留经文标记的《古兰经》样式。
• 每页均标明页码、卷次、章号和阿拉伯语章名。页码、卷次和章号均可直接编辑；自定义选章器会在当前章处打开。
• 页面页脚链接到实际从该页开始的段落和子章节标题，呈现 Mushaf 的主题结构，同时避免重复显示更早出现的标题。
• /quran/page 会恢复到已加入书签的 Mushaf 页；若没有页码书签，则从第 1 页开始。

练习视图

• 使用 ?memorize 打开 Mushaf 页面，例如 /quran/page/1?memorize；也可在《古兰经》阅读模式控件中选择 练习，或在《古兰经》菜单中选择 Tafsir 后的 练习 项。
• 隐藏词语会保留其精确的 Digital Khatt 宽度和位置，并分别加上下划线，从而忠实还原页面的 15 行布局。章标题、太斯米和经文标记仍保持可见。
• 点击隐藏的词语即可显示；点击已显示的词语会立即将其隐藏。启用单词自动隐藏后，被点击的词语会在 两秒后淡出，变为带下划线的空白。
• 在练习模式下，每个经文标记旁的切换箭头都包含 播放 和 显示。该节经文显示时，显示会变为 隐藏。播放使用读者默认的诵读者，自动显示整节经文，仅播放该节经文，并在音频字幕栏中显示其译文；这两项操作都不会更改记忆或 FSRS 状态。在 Mudhakkir 中仍可使用 播放，但会省略单独的 显示 和 隐藏 操作。
• 点击经文标记可在显示整节经文文本与将其替换为空白之间切换，不影响其他经文。
• 按住 Alt、Option、Command 或 Control 键并点击经文标记，可切换 Mushaf 当前页上该节经文及之前所有经文的显示或空白状态。
• 每页顶部和底部均会显示仅含图标的 页面 和 单词自动隐藏 控件。在练习模式下，底部控件会替代段落和子段落标题。
• 页面控件可显示该页的所有词语，或将该页恢复为空白。隐藏内容时也会清除单词和经文的单独显示状态。
• 单词自动隐藏控件决定单独点击的词语是在两秒后消失，还是继续保持可见。自动隐藏默认关闭，且仅控制当前页面的显示；不会作为记忆进度存储在浏览器中。
• 加号和减号控件可逐节显示下一段隐藏的经文，或隐藏最近显示的经文。
• 随着更多页面通过无限滚动加载，每页都会保留各自的状态；在页面、章、卷次、URL 以及上一页／下一页导航中，练习模式会保持启用。
• 为了让视图专注于回忆练习，音频、诵读者和译文控件、译文字幕栏以及单词翻译工具提示均会省略。

按经文记忆与间隔复习

记忆记录以章和经文编号为依据，而非 Mushaf 页码。页码仍便于导航，但每节经文都有独立的生命周期、复习计划和仅追加的复习历史。未处理的经文默认按 稍后处理，不会为每位用户创建 6,236 条记录。 六种可见的记忆状态使用与复习评分相同的回忆描述。自动恢复会在内部存储，但显示为“困难”：

状态	含义
稍后	尚未开始记忆，或该节经文已从主动记忆中移除
学习中	已开始记忆，但尚不能独立背诵完整经文
困难	已记住该节经文，但回忆不够牢固，因此仍会安排较短间隔的复习；这里也包括在“良好”复习失败后自动恢复的情况
良好	可以独立回忆完整经文，并继续进行间隔复习
容易	已熟记该节经文，视为已记住，且不会安排常规复习
已暂停	暂时暂停学习或复习，但不会删除其计划或历史记录

• 已登录的读者会对尚未接触过的 Later āyah 进行一次初始自评：Learn、Hard、Good 或 Easy。开始学习后，复习评分用于管理 Learning、Hard 和 Good；单个 āyah、页面、surah 和进度组控件还提供 Easy、Paused 和 Later。只有当某个完整页面或 surah 的所有 āyāt 都处于 Later 状态时，才能再次进行初始批量评估。未登录的读者不会看到可能让人误以为状态会保存在本地的控件。
• 没有古兰经背诵记录的新账户，会从 Surahs 1、113 和 114 的全部 18 个 āyāt 开始，状态均为 Learning。初始化具有幂等性；如果账户已记录任何背诵状态，则绝不会添加这些起始 āyāt。
• 初始评估为 Learning 时，会创建一张 New FSRS 6 卡片，并在 Learning 上限和总会话上限内逐步纳入；已纳入的 Learning 卡片具有最高队列优先级。再次评为 Again 会重置学习进度，Hard 会使其保持 Learning，连续两次成功评为 Good 后会毕业，评为 Easy 则会立即毕业。在 FSRS 根据复习历史进行调整之前，首次间隔大约为：Again 为 10 分钟至 1 天，Hard 为 1 至 2 天，Good 为 3 至 4 天，Easy 为 6 至 7 天。Memorization Progress 上的 Learning 摘要磁贴会筛选出包含 Learning āyāt 的组，并将每组直接链接到 Practice 模式下的第一个 Learning āyah。
• 初始评估为 Hard 时，会像 Hard 复习结果一样初始化该 āyah，使稳定性较低、难度较高，并设定较短的首次间隔。Hard āyāt 仍可参与常规复习。当 FSRS 难度为 6 或更低时，一次 Easy 或连续两次 Good 复习可以将 Hard 升级为 Good；难度大于 6 时则保持 Hard。
• 初始评估为 Good 时，表示读者确认自己能够独立背诵完整 āyah。FSRS 会像处理 Good 结果一样进行初始化，记录背诵日期，并根据当前记忆强度安排首次回忆。Good 并非最终归档状态：每次复习后，调度器都会继续调整间隔。
• 初始评估为 Easy 时，会像处理 Easy 结果一样初始化 FSRS 估值，记录背诵日期，清除下次复习日期，并使该 āyah 不参与常规复习。用户仍可在自定义 Surah 复习会话中主动纳入它。
• 计划复习中的 Good 或 Hard āyah，如果在一次 Good 或 Easy 复习后 FSRS 稳定性超过 730 天且难度低于 2，也会自动升级为 Easy。升级后会清除下次复习日期。已同时满足这两个阈值的现有卡片会迁移为 Easy。用户也可以直接将单个已纳入学习的 āyah 标记为 Easy。
• Hard 包含有意标记为脆弱的记忆、FSRS 回忆难度评分大于 6 的任何计划复习 āyah，以及对 Good āyah 评为 Again 后由调度器触发的恢复状态。恢复状态在内部仍与其他状态区分，以便进行调度，但使用 Hard 标签、红色、计数和进度筛选器。只有当计算出的难度达到 6 或更低时，成功复习才会使其恢复为 Good。
• Later、Easy 和 Paused āyāt 不会进入常规 Learning 或 Mudhakkir 队列。surah 的常规复习也遵循相同规则。全部 āyāt 复习会将所选 surah 中的 Later āyāt 主动纳入 Learning，并可在会话中包含 Easy 和 Paused āyāt。纳入学习后，唯一可手动更改的状态为 Easy、Paused 或 Later，且所有更改都会保留复习历史。内部恢复状态与 Later 仍有区别，并显示为 Hard，因为它表示过去背过、如今需要加强的记忆。
• Practice 和 Mudhakkir 对 Learning、Hard、Good、Easy 和 Paused 使用一致的强调色。Hard 为红色，Good 为蓝色，Easy 为绿色，与复习评分按钮的颜色一致。内部恢复状态使用 Hard 的显示样式。常规 Mushaf 不会显示背诵状态高亮。显示强调色时，会对整个 āyah 进行处理，同时不降低阿拉伯文本的对比度；标记也会显示文本状态，因此颜色并非唯一提示。 选择 Mudhakkir 可打开 /quran/review，该页面将记忆进度与学习会话启动器整合在一起。进度会根据规范的 6,236 节经文统计「现在到期」「学习中」「困难」「良好」「轻松」「已暂停」和「稍后」，而非仅计算已存储的行数。「现在到期」包括已初始化且计划时间已到的 FSRS 卡片。「学习中」包括尚未评分的 FSRS 新卡片，以及有复习记录的学习中卡片，因为「新」是 FSRS 的内部阶段，并非独立的记忆状态。自动恢复仍为内部状态，并计入「困难」的数量、筛选结果、颜色和页面摘要。系统会根据用户自述的记忆强度，立即初始化「困难」「良好」和「轻松」状态。活跃进度表会按苏拉分组显示古兰经经页；同一页包含多个苏拉时，会在每个苏拉下显示该页。每行只统计该页中属于该苏拉的经文，并显示各阶段的总数和阿拉伯语开篇词，不附带翻译。

已登录的 Mudhakkir 页面顶部会显示一年的复习活动热力图、今天已复习的经文数和复习耗时、每日平均值、已学习天数百分比、最长连续记录和当前连续记录。调度、复习和会话时间戳均以 UTC 存储。到期检查会比较 UTC 时间点，而显示日期、热力图日期、连续记录，以及今天显示为已复习的经文范围，则使用当前浏览器的时区。这样一来，深夜复习仍计入用户当地日期，同时各设备上的进度保持一致。

未登录访客会看到简明的古兰经记忆介绍、登录邀请、关于自适应间隔复习如何保持古兰经背诵熟练度的通俗说明、追踪进度的益处，以及探索《古兰经经本》的链接。只有通过身份验证后，才会显示记忆进度和复习会话控件。

尝试回忆时，固定控件记录的是复习结果，而不是直接更改永久状态：

第 1 页之后的 Mudhakkir 页面会在当前页上方的紧凑、始终可见的衔接栏中，显示前一页古兰经经本的最后一行阿拉伯语。该栏不可交互，不参与遮挡、评分、记忆状态控件或音频选择。

结果	调度含义
Again	回忆失败；「学习中」或「困难」保持当前状态，「良好」进入困难恢复状态，并允许在本次会话接近结束时重试一次
Hard	成功独立回忆，但有明显迟疑；缩短下次间隔
Good	通过正常努力成功回忆；使用常规的下次间隔
Easy	流畅且毫不费力地回忆；延长下次间隔
Skip	继续进行，但不更改生命周期、强度、计划安排或复习记录

帮助文本说明，只有尝试时需要阅读该节经文或获知缺失的后续内容，才应选择 Again；Hard 仍表示已独立回忆出完整经文。首次选择 Again 后，该经文会排入队列，在本次会话接近结束时重试一次。第二次选择 Again 会记录这次失误，但不再安排重试，因此同一节经文在每次会话中最多可选择两次 Again，也不会形成无限循环。 常规复习会话会持久化并设有数量上限。符合条件的学习中、困难和良好 āyāt 均可加入，包括自动恢复的困难 āyāt。系统会在非空类别间公平分配总上限，并优先呈现学习中类别。脆弱的困难 āyāt 与处于困难恢复阶段、此前评为良好的 āyāt 共用一个困难类别上限。新加入且尚未评分的学习中卡片会立即计入“当前到期”，但每次会话只会在学习中类别上限范围内逐步纳入。任何一次性“重来”重试都会排在原队列之后；简单 āyāt 不会加入常规会话。某个 āyah 评分或跳过后不会再次出现，除非它进入了该重试位置。我的设置 → 古兰经背诵和 Mudhakkir 设置模态框可用于配置每次会话的 āyāt 总上限（默认 10）、可选的时间预算，以及折叠的“高级会话上限”分组，其中包含学习中、困难和良好类别上限及队列顺序。

页面和章复习

开始复习菜单提供自定义的章复习会话。其自动补全功能接受英文名称、阿拉伯文名称、阿拉伯数字或拉丁数字形式的章编号，以及别名。建议项采用古兰经搜索结果的样式，并显示章编号、英文名称、阿拉伯文名称和 āyāt 总数。

练习模式还会在每个 Mushaf 页面下方放置一个 Mudhakkir 按钮。其上下文对话框提供仅此页面或某一章选项。选择“仅此页面”会创建一个持久化的页面复习会话，其中包含该 Mushaf 页上的 āyāt，包括由多个章节共用的页面。选择某一章会打开相同的可搜索章复习工作流，用户无需先返回“背诵进度”页面。

选择章节后，用户可选择两种复习类型之一。常规复习仅使用该章中符合条件的学习中、困难和良好 āyāt，遵循其现有到期计划和常规会话上限，不会加入或更改尚未触及的 āyāt。所有 āyāt 复习会将该章中所有缺失或标记为“稍后”的 āyah 加入学习中，并将整章加入一个持久化的古兰经顺序会话。已加入的学习中、困难、良好、简单和已暂停 āyāt 不会写入加入记录：创建会话时会保留其现有状态、计划和历史记录，只将其加入队列。用户可以选择逐 āyah或逐段落复习。段落复习会采用包含当前 āyah 的最具体“学习”范围——有 h3 范围时使用 h3，否则使用 h2 范围。段落仅作为 āyāt 批次；所选结果会为其中每个 āyah 分别记录为一次复习事件，且每个 āyah 都会单独进行 FSRS 计算，并获得各自的状态和下次复习计划。

页面复习和所有 āyāt 会话不受“当前到期”、常规类别上限或可选时间预算的限制。会话会持续进行，直到其中所有 āyah 均已评分或跳过。某一章的常规复习使用标准调度器及其上限。“重来”、“困难”、“良好”和“简单”都会作为真实的 FSRS 评估记录，因此在所有 āyāt 会话中给简单或已暂停的 āyah 评分，可能会根据结果使其重新进入计划背诵。跳过会继续进行，而不更改该 āyah 的状态、计划或复习历史。

Mushaf 复习页脚可以暂停页面或章节复习会话，同时保留当前 āyah 和队列位置；也可以结束会话，同时保留已完成的复习历史。“背诵进度”会将活动会话与已暂停会话一同列出。继续活动会话或切换到已暂停会话都需要用户明确操作；切换时会先原子性地暂停当前会话，再恢复所选会话。任何活动或已暂停的会话都可以结束。结束会关闭剩余队列，同时保留已完成的 FSRS 复习历史。

我的设置以及 /quran/review 上的模态框中提供 FSRS 6 设置：

• 目标记忆目标范围为 80% 至 95%，默认采用建议的 90%。提高目标会增加复习频率。
• 初始记忆强度用于调整新经文节的首批间隔。
• Mudhakkir 间隔倍数提供保守、标准和激进三种稳定性增长选项。
• 遗忘恢复速度提供温和、标准和严格三种在选择 Again 后施加的稳定性惩罚。
• 个性化算法在至少完成 100 次评分复习后使用官方 FSRS 优化器。它会根据用户只追加、不覆盖的历史记录训练全部 21 个 FSRS 6 参数，建议大约每月重新运行一次。

难度抑制、均值回归和当日复习平滑处理均由系统自动完成。简化控件会转换默认或个性化参数向量，不会公开底层数学权重。

Mudhakkir 有意采用专注于单个经文节的工作流，而不设置单节经文和连读模式。评分仅适用于计划复习的经文节。为保留《古兰经》上下文，当前目标、前面的经文节以及复习过程中已完成的经文节都会完整显示；未来尚未复习的经文节则保持淡化。Mudhakkir 会话和 API 响应不再存储或返回显示模式，也不再获取相邻经文节的独立上下文。旧版复习模式 URL 参数会重定向至规范的 ?review=surah:ayah 格式。

Mudhakkir 初始显示「Reveal」，而不是回忆评分选项。选择「Reveal」后，会显示计划复习的 āyah 或学习段落，然后才显示 Again、Hard、Good 和 Easy。保存评分并选择下一个已持久化的复习单元会在同一个 API 请求中完成，因此事务提交后界面会立即前进，无需等待第二次队列请求或人为设置的显示延迟。页脚中的「Undo」操作会以原子方式撤销最近一次单节经文评分，即使下一节 āyah 已加载，也会恢复先前的 FSRS 状态、复习事件、会话计数器和队列项目。当前 Mudhakkir 目标在 Mushaf 页面上方的所有 āyah 始终显示，以保持段落顺序符合《古兰经》顺序。当后续 Mudhakkir 页面显示出本日复习过程中已评分的 āyāt 时，这些 āyāt 也会继续显示，即使「Start Review」创建了替代会话；当前目标之后尚未复习的 āyāt 以及 Again 重试答案，在轮到它们完成前都会保持隐藏。导航、重新加载或切换设备后，系统会根据经过身份验证的服务端数据恢复活动会话、当前尝试、复习历史和已显示的复习列表；记忆状态绝不会存储在浏览器中。仅显示图标的「Skip」操作在 Reveal 前后均可使用，点击后会立即跳过，不会显示答案、评分，也不会永久显示答案。

调度使用 FSRS 6 的 21 参数模型和可训练的遗忘曲线衰减。每位用户的每节经文卡片会存储 FSRS 状态、稳定性、难度、计划间隔、学习步骤位置、复习次数和遗忘次数、最新评分以及上次和下次复习时间。回忆尝试会追加到单独的历史记录表，用于统计和参数优化；将经文节移至 Later、Easy 或 Paused 不会删除这些事件。

更改目标记忆目标时，系统会根据每张卡片现有的稳定性和上次复习时间，批量重新调度所有已初始化的 Learning、Hard、Good 和自动恢复卡片。此更新会立即更改存储的复习日期和 Due now 状态，不会伪造评分或复习历史记录。Easy、Paused、Later 和尚未评分的新 Learning 卡片不会被改写。 Google Analytics 会记录保护隐私的《古兰经》背诵事件，且不包含账户标识符：quran_review_session_start、quran_review_session_resume、quran_review_item_presented 和 quran_review_grade 用于衡量复习参与情况及复习过的《古兰经》经本页数。quran_memorization_enroll 会记录首次成功加入背诵计划的转化，并包含 enrollment_scope（取值为 ayah、page 或 surah）以及新加入背诵计划的 āyāt 数量。在 Google Analytics 中将 quran_memorization_enroll 标记为关键事件，即可将其报告为转化。

quran_script_default 事件和 quran_script_default 用户属性用于衡量用户所选《古兰经》书体偏好的人数，书体偏好取决于解析后的设置：uthmani、indo-pak 或 warsh。每页只会针对解析后的默认设置发出一次事件；只有当该页面上的偏好发生变化时，才会再次发出事件；事件不包含账户标识符。

这是首次部署 ayah 级 FSRS，而非从较早的 ayah 调度器升级。运行 npm run init:quran-fsrs6，初始化数据表，并将所有现有用户的《古兰经》背诵设置替换为规范的 FSRS 6 默认值。初始化程序会保留无关的用户设置。运行 npm run init:quran-fsrs6 -- --dry-run，可预览将更新的用户行数，而不会创建数据表或写入设置。

背诵数据表使用区分大小写的 ASCII 用户标识符，并为精确 ayah 查询、待复习内容筛选、近期复习过的 ayat、活跃会话和持久化会话队列建立复合索引。现有安装可以预览并应用此架构优化：

npm run quran-memorization-optimize
npm run quran-memorization-optimize -- --apply

交互式阿拉伯语与 ayah 工具

• 将鼠标悬停在单词上时，该单词会高亮显示；《古兰经》段落视图和经本视图中的交互行为一致。
• 点击《古兰经》单词可查看语料信息及该单词的翻译。在标准经本中，点击还会切换对完整 ayah 的选中状态；练习模式则会执行临时显示，不提供翻译。
• 选中的 ayat 和正在播放音频的 ayat 会以完整 ayah 高亮显示，并使用已有的《古兰经》段落颜色，而不是彼此分离的单词方框。
• 点击其他位置可取消选中 ayah。
• 段落视图和经本模式中的 ayah 标记均提供相同的精简 查看 和 播放 操作。查看会打开聚焦的 ayah；播放会从该标记开始诵读。
• 点击 ayah、单词或标记后，所选翻译会显示在页脚跑马灯中，即使音频未播放也会显示。
• Juz 起始位置以 ۞ 标记；sajdah 标记等《古兰经》元数据也可与标准 ayah 标记一同显示。

连续且理解段落边界的音频

• 诵读使用带有 ayah 时间片段的连续 surah 录音，避免拼接单独 ayah 音频文件造成的可闻停顿。
• 播放会跨越延迟加载的经本页面和段落边界继续进行，同时持续高亮当前 ayah。
• 音频从选中的 ayah 开始；若未选中任何内容，则从当前页面或段落的开头开始。
• 重复播放是真正的切换功能。它会重复当前 h3 子节；若无 h3 子节，则重复其 h2 段落，即使范围跨越页面边界也不例外。
• 播放期间可以更改当前诵读者。可选诵读者按字母顺序排列，可在“我的设置”中启用或停用，并会记住首选诵读者。
• 固定音频页脚在单行中提供上一段、重复、播放/暂停、停止、速度和下一段控制，不会换行。
• 播放速度为 x1、x1.25、x1.5、x2.0、x2.5 和 x3。浏览器会话期间会保留所选速度，并在停止、恢复、更改音源和切换页面后重新应用。
• 播放期间，固定页脚上方会显示翻译跑马灯。它会显示一次诵读者和翻译信息，使用不显眼的上标 ayah 引用，遵循 LTR 和 RTL 翻译方向，并以带空格的圆点分隔连续翻译；每条翻译会在对应音频片段开始时从中间位置开始滚动。

翻译、经注与研读

• 直接在 Passage 或 Mushaf 控件中更改当前使用的译本。
• 在经文页面上，可分别显示或隐藏阿拉伯文和译文。
• 无需离开阅读工作流，即可打开某节经文的可用译本、双语经注、阿拉伯文经注和英文经注。
• 经注标签页、译文展开区、脚注弹窗、悬停说明以及阿拉伯文与英文并排布局，既支持快速阅读，也适合深入研读。
• 经注和译本文献可包含可折叠的全书简介和苏拉简介，并提供直接链接，以及跳转至《古兰经》文本的上一项／下一项导航。
• 文献目录可按圣训、阿拉伯文和英文经注以及译本进行筛选；经注条目会标明相对篇幅，并可按作者或出版时间排序。
• 若某部文献兼具译本和经注的作用，可同时列入译本和经注目录；每个入口仍会保留相应的阅读和导航体验。
• My Settings 可设置首选译本和诵读者、启用的译本、经注和诵读者，以及译本和经注文献的显示顺序。
• 译本选择会同步至经文文本、经文主视觉、Mushaf 控件、分享卡片以及音频／选中文本字幕条。

导航、保存与分享

• 用户滚动时，无限滚动的 Passage 和 Mushaf 阅读器会更新其规范阅读上下文。
• Passage、Mushaf、经注和译本页面均提供响应式标题大纲，显示当前《古兰经》段落或子节，以及附近的上一项和下一项标题。
• 紧凑的粘性页脚提供返回、《古兰经》首页、文本控件以及根据上下文显示的上一项／下一项导航；在 Mushaf 模式下，这些链接按页跳转。
• 同一时间仅保留一个 Mushaf 页面书签；该书签会显示在 Bookmarks 页面上，并决定 /quran/page 的默认目标页面。
• 《古兰经》段落和经文支持书签、点赞、评论、心得，以及可选择译本的可分享图片卡片。
• 键盘导航和无障碍标签可配合触控、鼠标和移动端控件使用。

搜索、下载与集成

Hadith 书籍 JSON 端点（/<book>.json、/<book>?json 和 /<book>?download&json）共用整本书导出器，并包含每条记录的 metadata，其中包含所有已存储的评分者 评价（包括主要评分）、带有可靠性信息和已存储 death_text 的传述者、去重后的 related_reports 引用，以及完整的附加 sharh 列表；如有数据，还包含来源信息以及完整的阿拉伯文／英文文本。 JSON 记录响应会公开 metadata，而不是内部 metadata 属性。 相关报告仅以引用字符串形式提供；不包含原始链接记录、UI 选项列表、 序列化的传述者标记，以及重复的传述者／评分者名称别名。 书籍级别的来源和无障碍详情仅存放在 metadata 下；书籍简介仅存放在 book.description 下。

• 统一搜索覆盖阿拉伯文和翻译后的《古兰经》文本、译本及经注，并提供自动补全、筛选、高亮和经文直达功能。
• 《古兰经》内容可通过稳定的经文、范围、段落、子节、juz、manzil、译本、经注和 Mushaf 页面 URL 访问。
• 机器可读的 JSON 和 Markdown 响应支持单节经文和经文范围；如有提供，也可下载 JSON 或 EPUB 格式的译本和《古兰经》文本。
• 《古兰经》段落、注释页面、译本和所有 Mushaf 页面均包含在站点地图中。

编辑与性能支持

• 可编辑并重新编制段落和子节范围，同时保持 Passage 与 Mushaf 的映射关系。
• 标题、范围和标题名称变更会使相关 Passage 和 Mushaf 缓存失效，以免保留过时的章节引用。
• Mushaf 页面数据和章节映射会在适当情况下使用内存缓存和搜索缓存，并支持磁盘缓存版本控制，以及显式刷新更新后的内容。

《古兰经》诵读者

该网站提供以下连续、与经文同步的诵读。每位诵读者都有一个短别名，供内部选择音频和保存偏好时使用。

别名	诵读者
abbad	法里斯·阿巴德
alili	阿齐兹·阿利利
banna	马哈茂德·阿里·班纳
dusari	亚西尔·杜萨里
husari	马哈茂德·哈利勒·胡萨里
jalil	哈立德·贾利勒
juhani	阿卜杜拉·阿瓦德·朱哈尼
minshawi	穆罕默德·西迪克·明沙维
qatami	纳赛尔·卡塔米
shuraym	沙特·舒赖姆
sudays	阿卜杜勒·拉赫曼·苏代斯
yasin	萨赫勒·亚辛

《古兰经》注释与译本

该网站提供以下注释（tafsīr）和译本。每项作品都有一个用于链接的短别名和一个英文标题。

双语注释

别名	名称
ibn-kathir	《伟大的〈古兰经〉注释》
jalalayn	《贾拉莱尼注释》
mokhtasar	《〈古兰经〉精要注释》
muntakhab	《〈古兰经〉精选注释》
muyassar	《简明注释》

阿拉伯语注释与《古兰经》配套著作

别名	名称
rida	《灯塔注释》
tabari	《〈古兰经〉经文解释汇编》
samarqandi	《知识之海》
abu-zamanayn	《尊贵的〈古兰经〉注释》
makki	《引向目标之路》
mawardi	《典故与洞见》
samaani	《〈古兰经〉注释》
baghawi	《降示之标志：〈古兰经〉注释》
zamakhshari	《揭示降示奥义之真相》
ibn-al-jawzi	《注释学中的行囊》
razi	《幽玄之钥》
qurtubi	《〈古兰经〉律例与阐明大全》
baydawi	《降示之光与阐释之奥秘》
nasafi	《降示之理与阐释之真义》
ibn-juzay	《降示之学简明导论》
abu-hayyan	《汪洋之海》
thalabi	《揭示与阐明：〈古兰经〉注释》
ibn-adil	《经书之学精要》
biqaii	《珍珠编织：经文与章次的关联》
iji	《〈古兰经〉注释汇编》
suyuti-t	《传述注释汇编》
shawkani	《全能者的启示》
alusi	《意义之灵》
qinnawji	《〈古兰经〉宗旨阐释》
qasimi	《阐释之美》
irab-al-quran	《〈古兰经〉语法、词法与阐释指南》
saadi	《至仁主言辞注释：至仁主之路》
ibn-ashur	《阐释与启明》
shanqiti	《阐明〈古兰经〉：以〈古兰经〉阐释〈古兰经〉》
ibn-uthaymin	《尊贵的〈古兰经〉注释》
aysar	《至高至大的主言辞之最简注释》
ibn-atiyah	《精要阐释》
basit	《详尽注释》
tadabbur-wa-amal	《〈古兰经〉：沉思与实践》
wajiz	《简明注释》
mathur	《传述注释百科全书》
qiraat	《〈古兰经〉诵读与读法阐释指南》
irab-daas	《尊贵的〈古兰经〉语法与阐明》
shawi	《〈古兰经〉注释选读》
yasir	《〈古兰经〉简易注释》
khadiri	《明灯：阐释〈古兰经〉中的罕见词》
wasit	《尊贵的〈古兰经〉中篇注释》
dorar-t	《精编注释》

英文译本

别名	名称
en-haleem	《古兰经：新译本》
en-khattab	《清晰的古兰经》
en-saheeh-intl	《神圣的古兰经》（Saheeh International 译本）
en-hilali-khan	《尊贵的古兰经含义诠释》
en-bridges	《尊贵的古兰经十种诵读方式桥梁译本》
en-taqi-usmani	《尊贵的古兰经含义与注释》
en-itani	《英文古兰经：清晰易读》
en-bewley	《尊贵的古兰经：其含义的全新英文译本》
en-study-quran	《研读古兰经：全新译本与注释》
en-ghali	《走向理解永恒辉煌的古兰经》
en-ahmedraza	《神圣的古兰经》
en-wahiduddin	《古兰经：译文与注释（附阿拉伯语原文对照）》
en-qaribullah	《神圣的古兰经》
en-busool	《智慧的古兰经：这些是智慧经典的经文》
en-tahir-ul-qadri	《Irfan-ul-Quran》
en-rowwad	《尊贵的古兰经含义解说》
en-asad	《古兰经的讯息》
en-sarwar	《神圣的古兰经：阿拉伯语原文与英文译文》
en-daryabadi	《Tafseer-e-Majidi》
en-shakir	《古兰经》
en-pickthall	《辉煌的古兰经含义》
en-qarai	《古兰经英文意译本》
yusuf-ali	《神圣的古兰经含义》

英文经注

别名	名称
en-maududi	《Tafhim al-Quran》
en-maarif-al-quran	《Maarif al-Quran》
en-tazkir-al-quran	《Tadhkir al-Quran》
en-easy-tajwid	《简易泰吉威德》
en-wahidi	《降示缘由》
unal	《Tafsir Ünal》
dawat	《Dawat ul Quran》
ishraq	《Tafsir Ishraq al-Ma'ani》
yusuf-ali	《神圣的古兰经含义》

书籍与合集

目录目前收录 29 部书籍与合集：26 部原始书籍（包括《古兰经》）以及从中辑录的 3 个主题合集。这些原始书籍共包含 273,324 条记录，合集另关联 4,754 条记录。

下表中，记录数表示每部作品的条目数，英文表示其中有英文译文的条目数，已评级表示带有主要评级或补充真实性评级的条目数。评级者汇总了简明的主要评级字段；补充详情页面可能包含其他学者的意见。统计数据于 2026-09-05 根据本地目录更新。

ID	别名	名称	类型	记录数	英文	已评级	评级者
0	quran	The Holy Quran	原始书籍	6,236	6,236	0	N/A
57	ibnrajab50	Jāmiʿ al-ʿUlūm wa-al-Ḥikam	虚拟合集	93	N/A	N/A	N/A
61	riyad	Riyāḍ al-Ṣāliḥīn min Kalām Sayyid al-Mursalīn	虚拟合集	2,754	N/A	N/A	N/A
15	adab	al-Adab al-Mufrad	原始书籍	1,326	1,326	1,326	Albānī, Arnaʾūṭ
32	shamail	al-Shamāʾil al-Muḥammadiyyah	原始书籍	402	402	402	Abū Dāwūd, Albānī
50	lulu-marjan	al-Luʾluʾ wa-al-Marjān (Muttafaq ʿAlayh)	虚拟合集	1,907	N/A	N/A	N/A
1	bukhari	Ṣaḥīḥ al-Bukhārī	原始书籍	7,277	7,277	7,277	Bukhārī, Luʿluʿ wa-al-Marjān
2	muslim	Ṣaḥīḥ Muslim	原始书籍	7,469	7,469	7,468	Muslim
4	abudawud	Sunan Abū Dāwūd	原始书籍	5,276	5,276	5,275	Albānī, Arnaʾūṭ
5	tirmidhi	Jāmiʿ al-Tirmidhī	原始书籍	4,052	4,052	4,052	Aḥmad, Albānī, Arnaʾūṭ, Tirmidhī, ʿAli Zaʾī
3	nasai	Sunan al-Nasāʾī	原始书籍	5,769	5,769	5,769	Albānī, Arnaʾūṭ, Ḥākim, Nasāʾī, ʿAli Zaʾī
6	ibnmajah	Sunan Ibn Mājah	原始书籍	4,345	4,345	4,345	Albānī, Arnaʾūṭ, ʿAli Zaʾī
9	darimi	Sunan al-Dārimī	原始书籍	3,547	3,546	3,547	Dārānī, Ibn Ḥibbān, Ibn Mājah
8	ahmad	Musnad Aḥmad	原始书籍	27,735	27,672	27,732	Arnaʾūṭ, ʿAli Zaʾī
7	malik	Muwaṭṭaʾ Mālik	原始书籍	1,975	1,975	1,975	Mālik
10	hakim	Mustadrak al-Ḥākim	原始书籍	8,809	8,789	8,809	Aḥmad, Dhahabī, Ḥākim, Haythamī, Ibn Ḥibbān
11	ibnhibban	Ṣaḥīḥ Ibn Ḥibbān	原始书籍	7,539	7,499	7,538	Arnaʾūṭ
17	ibnkhuzaymah	Ṣaḥīḥ Ibn Khuzaymah	原始书籍	3,282	0	3,282	N/A
16	bazzar	Musnad al-Bazzār	原始书籍	10,401	0	10,401	N/A
18	daraqutni	Sunan al-Dāraquṭnī	原始书籍	4,847	1	4,847	Arnaʾūṭ
30	abdalrazzaq	Muṣannaf ʿAbd al-Razzāq	原始书籍	21,109	0	21,109	N/A
31	ibnabishaybah	Muṣannaf Ibn Abī Shaybah	原始书籍	39,098	0	39,098	N/A
13	nasai-kubra	al-Sunan al-Kubrá, Nasāʾī	原始书籍	11,446	11,415	11,446	Arnaʾūṭ, Nasāʾī, Tirmidhī, ʿAli Zaʾī
14	bayhaqi	al-Sunan al-Kabīr, Bayhaqī	原始书籍	21,742	0	21,742	N/A
12	tabarani	al-Muʿjam al-Kabīr, Ṭabarānī	原始书籍	21,373	21,264	21,373	Aḥmad, Albānī, Arnaʾūṭ, Haythamī, Muslim
34	tabarani-awsat	al-Muʿjam al-Awsaṭ, Ṭabarānī	原始书籍	0	0	0	N/A
82	ahmad-zuhd	al-Zuhd, Aḥmad	原始书籍	2,360	2,355	2,360	N/A
33	tabarani-saghir	al-Muʿjam al-Ṣaghīr, Ṭabarānī	原始书籍	0	0	0	N/A
1000	suyuti	Jamʿ al-Jawāmiʿ, Suyūṭī	原始书籍	45,909	1,430	45,908	Albānī, Arnaʾūṭ, Bayhaqī, Bukhārī, Dhahabī, Ḥākim, Haythamī, Ibn al-Jawzī, Ibn Ḥajar, Luʿluʿ wa-al-Marjān, Mudhiri, Muslim, Nawawī, Suyūṭī, Tirmidhī

仅限管理员的内容翻译

在 ~/.hadithdb/settings.json 中将 payments.content.adminOnly 设置为 true，并重启应用，以禁用付款，并将新翻译和修订限制为经过身份验证的管理员。管理员翻译不消耗积分，也不需要 Stripe。「我的设置」中的「付款」部分会隐藏，付款端点会被禁用。所有人仍可阅读现有翻译。单独的 Tafsir 翻译开关仍然有效。

将该标志设置为 false（默认值），即可恢复现有的付费翻译流程，具体取决于 payments.enabled 和 Stripe 配置。