更新闪卡(制卡和复习)相关的配置信息。这些配置项对应于思源笔记 "设置 - 闪卡" 面板中的选项。
成功调用此接口后,相关配置将保存到 conf.json
文件中的 flashcard
部分,并返回更新后的配置对象。如果 NewCardLimit
或 ReviewCardLimit
小于0,将被重置为默认值(新卡20,复习卡200)。
请求体需要包含一个完整的 Flashcard
配置对象。以下是该对象的字段说明及其默认值 (参考 conf.NewFlashcard()
):
参数名 | 类型 | 描述 | 默认值 |
---|---|---|---|
newCardLimit |
number | 每日新卡上限。如果传入小于0的值,API会将其重置为20。 | 20 |
reviewCardLimit |
number | 每日复习卡上限。如果传入小于0的值,API会将其重置为200。 | 200 |
mark |
boolean | 是否启用标记块(高亮、加粗等)作为制卡来源。 | true |
list |
boolean | 是否启用列表项作为制卡来源。 | true |
superBlock |
boolean | 是否启用超级块作为制卡来源。 | true |
heading |
boolean | 是否启用标题块作为制卡来源。 | true |
deck |
boolean | 是否启用卡包(文档标题带有 #卡包 标签)作为制卡来源。 |
false |
reviewMode |
number | 复习模式:0 : 新旧混合1 : 新卡优先2 : 旧卡优先 |
0 |
requestRetention |
number | FSRS 算法参数:期望记忆保留率 (0.0 ~ 1.0)。 | (来自 fsrs.DefaultParam().RequestRetention ) |
maximumInterval |
number | FSRS 算法参数:最大复习间隔天数。 | (来自 fsrs.DefaultParam().MaximumInterval ) |
weights |
string | FSRS 算法参数:权重列表,逗号分隔的浮点数值字符串 (例如 "1.00, 1.50, ...")。 | (来自 fsrs.DefaultParam().W ) |
操作成功时,返回包含更新后 Flashcard
对象的标准响应结构:
{
"code": 0,
"msg": "",
"data": {
"newCardLimit": 20,
"reviewCardLimit": 200,
"mark": true,
"list": true,
"superBlock": true,
"heading": true,
"deck": false,
"reviewMode": 0,
"requestRetention": 0.9, // 示例值,实际来自 FSRS 默认
"maximumInterval": 36500, // 示例值
"weights": "1.00, 1.50, ..." // 示例值
}
}