jaycelu_Smart-Review/apps/smart-review-plugin
2026-06-29 14:06:45 +08:00
..
ai-cards.ts Rename plugin to Smart Review 2026-05-29 09:25:44 +08:00
ai-examiner.ts Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
analytics-service.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
analytics-types.ts Release Smart Review 0.2.1 2026-06-23 20:19:42 +08:00
esbuild.config.mjs Rename plugin to Smart Review 2026-05-29 09:25:44 +08:00
heatmap.ts Release Smart Review Center 0.2.0 2026-06-23 15:48:53 +08:00
i18n.ts Simplify lifecycle copy and parent folder selection 2026-06-29 14:06:45 +08:00
main.ts Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
manifest.json Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
markdown-export.ts Release Smart Review Center 0.2.0 2026-06-23 15:48:53 +08:00
mastery-exam-modal.ts Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
mastery-exam.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
model-picker-modal.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
package.json Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
pause-review-modal.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
README.md Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00
review-actions.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
review-center-view.ts Simplify lifecycle copy and parent folder selection 2026-06-29 14:06:45 +08:00
review-lifecycle.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
scanner.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
settings.ts Simplify lifecycle copy and parent folder selection 2026-06-29 14:06:45 +08:00
status-bar.ts Release Smart Review Center 0.2.0 2026-06-23 15:48:53 +08:00
styles.css Keep review lifecycle shortcuts visible 2026-06-29 12:15:15 +08:00
tsconfig.json Rename plugin to Smart Review 2026-05-29 09:25:44 +08:00
utils.ts Add AI mastery exams and review lifecycle controls 2026-06-29 09:58:08 +08:00
versions.json Fix AI settings and review center usability 2026-06-29 10:46:39 +08:00

Smart Review Plugin

Smart Review 插件本体负责完整复习闭环:扫描 Properties / YAML frontmatter、打开 Smart Review Center、写回复习反馈、暂停与恢复、追加历史并可选调用用户配置的模型完成掌握检验。

UI 支持 English / 简体中文,默认跟随 Obsidian 应用语言,也可以在插件设置中手动切换。样式使用 Obsidian 官方主题变量,适配浅色和深色模式。

动态复习间隔

插件保留基于当前间隔和 review_ease 的动态算法,并允许在设置页调整:

  • Again 重置天数,默认 1
  • Hard 间隔倍率,默认 1.2
  • Good ease 附加倍率,默认 1.0
  • Easy ease 附加倍率,默认 1.3

Review Center 的评分按钮会显示每篇笔记当前计算出的实际间隔。点击评分后,写入 next_review 的结果与按钮预览使用同一个共享计算函数。

暂停与 AI 掌握检验

  • 暂停笔记保留在 Review Center 的独立折叠区,可直接恢复。
  • 同一篇文章的每次掌握检验都追加到同一个 Markdown 成长记录。
  • AI 检验显示参考答案、原文证据、缺失点和高/中/低置信度。
  • 支持 OpenAI-compatible、OpenAI、Anthropic、Gemini、Azure OpenAI 和 Ollama。
  • 掌握记录目录是相对当前 Vault 根目录的路径,可在设置中直接选择已有目录。
  • OpenAI-compatible 支持基础地址和完整 chat-completions 地址;如果中转站不开放模型列表,可以手动填写模型名后直接测试连接。
  • API Key 保存在 Vault 内的插件 data.jsonObsidian 不会加密该文件;同步 Obsidian 配置时它也可能被同步。
  • 只有用户主动发起检验时,当前文章和回答才会发送到所选服务商;不包含其他笔记或客户端遥测。

构建

cd smart-review
pnpm install
pnpm --filter @smart-review/obsidian-plugin build

构建产物:

apps/smart-review-plugin/main.js

安装到 Obsidian

复制以下文件到你的 Vault

<Vault>/.obsidian/plugins/smart-review/manifest.json
<Vault>/.obsidian/plugins/smart-review/main.js
<Vault>/.obsidian/plugins/smart-review/styles.css

启用插件后,点击 Ribbon 图标打开 Smart Review Center。Generate Review Widget Data 命令用于手动覆盖更新 review-index.json

文件策略

  • review-index.json:覆盖写入的当前索引快照。
  • review-history.jsonl:追加写入的复习动作事件日志。
  • review-ai-cards.json:覆盖写入的当前 AI 复习卡片 Payload。
  • 00-总览/今日复习.md:覆盖写入的 Obsidian 原生今日复习中心。