← 返回首页
POST /api/setting/setFlashcard

设置闪卡配置

需要认证 管理员权限 非只读模式

接口描述

更新闪卡(制卡和复习)相关的配置信息。这些配置项对应于思源笔记 "设置 - 闪卡" 面板中的选项。

成功调用此接口后,相关配置将保存到 conf.json 文件中的 flashcard 部分,并返回更新后的配置对象。如果 NewCardLimitReviewCardLimit 小于0,将被重置为默认值(新卡20,复习卡200)。

请求参数 (JSON Body)

请求体需要包含一个完整的 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, ..." // 示例值
    }
}

在线测试