学习一个集合

forne learn <set-file>.json -m <method>

上述命令可以用来在给定的文件集（如上所述使用forne new创建）上启动一个新的学习会话。你需要提供方法，该方法将被检查是否与创建集时使用的相匹配（如果不匹配，将返回错误以防止数据丢失）。此命令的输出将是一个问题，根据学习方法分配的权重随机选择，按下回车后，你可以说明你的表现（对此问题的回答由学习方法决定），方法将相应调整权重。默认情况下，Forne会一直展示卡片，直到你按下Ctrl+D，或者直到所有卡片的权重为0，这表示你已经学会了这个集合。或者，你可以在上述命令的末尾添加-c <max-count>以在查看一定数量的卡片后停止，这对于日常复习等情况很有用。

如果你想只针对困难或标记的卡片，你可以在上述命令的末尾添加-t <difficult|starred>。

默认情况下，Forne会在你每次查看卡片时保存学习会话的进度，但如果你想从头开始，你可以在上述命令的末尾添加--reset。请注意，这是不可逆的，并且你之前的进度将永远丢失！

对集合进行自我测试

forne test <set-file>.json

一旦你学会了一个集合，你可能想确保你了解一切，这就是测试的用武之地：它们将只展示每张卡片一次，任何答错的卡片都会被标记，以便你可以稍后专门复习。与其他作用于集合的命令一样，你可以在上述命令后添加-t <difficult|starred>以仅针对特定类型的卡片，或者添加--reset以取消之前测试中可能取得的任何进度，因为默认情况下Forne会保存你做的所有事情，以便你可以稍后回来继续。

与学习系统一样，你可以在该命令的末尾添加-c <max-count>以限制你被要求查看的卡片数量。

请注意，你不需要提供测试的方法，因为Forne的测试逻辑是内部且非常简单的：你会展示每张卡片一次，答错的卡片会被记录为标记（你可以使用--no-star禁用此功能）。

测试系统的一个复杂之处在于，如果你答对了一张卡片，而且之前它是被标记的，那么它会被立即取消标记，这可能导致你失去了之前标记的卡片。如果你在进行最终复习之前进行测试，这可能会成为一个问题！如果你想禁用此行为，可以在上述命令中添加--no-unstar。如果你不想在测试中让Forne标记或取消标记任何卡片，可以添加--static。

适配器

使用Forne的第一个挑战是将您的集合导入其中。Forne接受问题/答案对列表，但这并不意味着它不能用于更特殊的使用场景，比如三语种集合。因为Forne允许您编写自己的导入逻辑，所以您可以非常容易地将一个三元词转换为六个单独的卡片（每个卡片以两种方式指向另一个卡片）。这也使得像cloze词这样的功能可以轻松支持，并且是以适合您的方式。Forne提供了一个非常简单的机制来显示术语并帮助您学习它们：您可以完全控制它们是如何创建的。

适配器是用Rhai编写的，这是一种简单的类似Rust的脚本语言，编写起来相当简单！如果您之前从未进行过任何编程，您可能需要寻求ChatGPT的帮助，并使用我们的常见适配器示例，否则就尽情发挥吧！所有适配器都编写为简单的脚本，其中将有一个常量字符串SOURCE，即给定源文件的内容，可用，并且它们预期返回一个问题/答案对数组（例如[["foo", "bar"], ["q", "a"]]）。大多数情况下，您可以使用正则表达式来完成此操作，而Forne为您提供了几个用于处理正则表达式的实用工具。

• is_match(regexp,text) -> bool
• matches(regexp,text) ->Array
• captures(regexp, text) -> Array（这是一个数组数组的数组，其中每个子数组是正则表达式找到的一系列捕获；每个子数组的索引0是匹配的完整文本）
• replace_one(regexp,replacement,text) ->string
• replace_all(regexp,replacement,text) ->string

还有一个辅助函数用于简单情况，允许您插入一个带有问题答案捕获组的正则表达式，您提供索引，它们将被返回。如果您不需要进行任何进一步的处理，您的整个适配器脚本可能如下所示

return regexp_to_pairs(`my-regexp-here`, 1, 2, SOURCE);

在这里，1, 2表示第一个捕获组包含问题，第二个包含答案。0将表示整个匹配。请注意，我们用反引号将正则表达式括起来，以避免任何转义字符。

我们建议使用https://regex101.com测试您的正则表达式，并且非技术（和技术的！）用户都应该知道ChatGPT在生成正则表达式方面非常出色，甚至可以从您的笔记中创建问题！

有关Rhai语言的更多文档，您可以参考Rhai书籍，特别是关于字符串操作的部分。如果您需要编写自己的适配器的任何帮助，请不要犹豫，打开一个新讨论并提问，我们将很乐意为您提供帮助！

方法

学习方法在很多方面类似于适配器，但是Forne有多个内置的，并且您可以通过名称来使用它们（例如 -m speed-）。然而，如果您想编写自己的，以定制学习过程以更适合您，这很容易做到。首先，您可能更愿意调整现有方法而不是编写自己的，您可以在这里找到所有内置方法的源代码。

const RESPONSES = ["y", "n"];

fn get_weight(data, difficult) {
   return data.weight;
}
fn adjust_card(res, data, difficult) {
   if res == "y" {
       data.weight -= 0.5;
   } else {
       data.weight += 0.5;
   }

   return [data, false];
}
fn get_default_metadata() {
   return #{ weight: 1.0 };
}