docs: 修改文档

This commit is contained in:
2026-05-07 13:26:22 +08:00
parent c2496c1bb5
commit 1975474c94
16 changed files with 464 additions and 57 deletions

View File

@@ -26,13 +26,13 @@ _SCHEDULER_STATE_FILE = pathlib.Path(
def _get_global_scheduler():
"""获取全局 FSRS Scheduler 实例从文件加载或创建新的"""
"""获取全局 FSRS Scheduler 实例, 从文件加载或创建新的"""
if os.path.exists(_SCHEDULER_STATE_FILE):
try:
with open(_SCHEDULER_STATE_FILE, "r", encoding="utf-8") as f:
return Scheduler.from_json(f.read())
except Exception:
logger.warning("FSRS Scheduler 状态文件加载失败创建新实例")
logger.warning("FSRS Scheduler 状态文件加载失败, 创建新实例")
return Scheduler()
@@ -80,7 +80,7 @@ class FSRSAlgorithm(BaseAlgorithm):
# FSRS 特有字段
fsrs_state: int # State 枚举值: 1=Learning, 2=Review, 3=Relearning
fsrs_step: int # 当前学习步进索引, -1 表示 None (Review 状态)
fsrs_stability: float # 稳定性(秒)0.0 表示尚未计算
fsrs_stability: float # 稳定性(秒), 0.0 表示尚未计算
fsrs_difficulty: float # 难度 [1.0, 10.0], 0.0 表示尚未计算
# 标准 BaseAlgorithm 兼容字段
real_rept: int
@@ -194,7 +194,7 @@ class FSRSAlgorithm(BaseAlgorithm):
if is_new_activation:
card = Card()
logger.debug("新激活创建新 Card")
logger.debug("新激活, 创建新 Card")
else:
card = cls._algodata_to_card(algodata)

View File

@@ -611,7 +611,7 @@ def _get_global_sm():
with open(_GLOBAL_STATE_FILE, "r", encoding="utf-8") as f:
return SM.load(json.load(f))
except Exception:
logger.warning("SM-15M 全局状态文件加载失败创建新实例")
logger.warning("SM-15M 全局状态文件加载失败, 创建新实例")
sm = SM()
_save_global_sm(sm)
return sm
@@ -646,7 +646,7 @@ class SM15MAlgorithm(BaseAlgorithm):
# 毫秒精度(子日排程)
last_date_ms: int
next_date_ms: int
# BaseAlgorithm 兼容(天精度向后兼容)
# BaseAlgorithm 兼容(天精度, 向后兼容)
real_rept: int
rept: int
interval: int
@@ -694,7 +694,7 @@ class SM15MAlgorithm(BaseAlgorithm):
opt_days * 24 * 60 * 60 * 1000 if opt_days > 0 else sm.interval_base
)
# 毫秒精度优先退化至天精度
# 毫秒精度优先, 退化至天精度
last_date_ms = data.get("last_date_ms", 0)
if last_date_ms:
item.previous_date = datetime.datetime(1970, 1, 1) + datetime.timedelta(