> For AI agents: the complete documentation index is available at https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/llms.txt, the full documentation bundle is available at https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/llms-full.txt.

# 介绍

`ts-fsrs` 是用于构建 FSRS 间隔重复系统的 TypeScript 工具包。声明式 API 将模型、时间系统和可选 middleware 组合成可复用的调度器定义。

## 组成部分

**模型**是 FSRS 算法及其参数。`FSRS7Model` 是当前版本；FSRS-3 到 FSRS-6 仍然保留，用于基于它们积累的复习历史。

**时间系统**决定时间如何表示。`dateChrono` 使用 `Date`，`numericChrono` 使用以天为单位的数字，`temporalInstantChrono` 使用 `Temporal.Instant`。

**Middleware** 负责调度策略，例如 `schedulerLearningStepsMiddleware`、`schedulerFuzzingMiddleware`、`schedulerMaximumIntervalMiddleware`、`schedulerLeechMiddleware`。在创建调度器前用 `.use(...)` 组合它们。

`defineScheduler` 将这些组合成一个定义。`.create()` 会校验配置并返回独立的调度器，因此一个定义可以支撑多个调度器。


For your Agent

在 TypeScript 应用中集成 ts-fsrs

复制 Prompt

在我的 TypeScript 应用中集成 ts-fsrs。

1. 阅读文档索引 https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/llms.txt 和快速开始 https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/guide/quick-start.md。先检查项目是否已使用 ts-fsrs：若涉及 v5 → v6 或 FSRS-6 → FSRS-7 升级，必须阅读迁移指南 https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/guide/migration.md，按其中的步骤和验收要求完成迁移，保留已有卡片和日志，迁移时不重新安排卡片的下次复习时间；以下安装和新卡示例仅用于新接入。
2. 安装 `ts-fsrs` package。
3. 使用 `defineScheduler`、`FSRS7Model` 和 `dateChrono` 创建 FSRS-7 调度器。
4. 创建一张新卡片，并使用 `Rating.Good` 完成一次复习。
5. 保持实现最小化，并使用当前 ts-fsrs 公共 API。

接下来前往[快速开始](https://open-spaced-repetition.github.io/ts-fsrs/zh-CN/guide/quick-start.md)，安装 package 并在浏览器中运行调度器。