Ocard

Ocard is an Obsidian plugin that turns any text selection into a beautiful card (Claude-style), stores it in a cards folder, and helps you remember it with active recall and spaced repetition (2 → 4 → 7 → 12 days).

Ocard 是一个 Obsidian 插件：选中文字，一键制卡。把笔记里的任意片段做成卡片，存进 cards 文件夹，用精美的卡片视图翻阅，并通过主动回忆 + 间隔复习对抗遗忘。

功能

• ✅ 在笔记里选中一段文字 → 右键 →「制作为卡片」
• ✅ 弹出输入框为卡片命名（预填选中文字作为建议，可修改）
• ✅ 卡片以 .md 形式存入 vault 根目录的 cards 文件夹（自动创建），frontmatter 记录标题、创建时间、来源笔记和复习进度
• ✅ 点击左侧 ribbon 图标或命令「打开卡片浏览」，在新标签页打开卡片视图
• ✅ 卡片视图：一屏一张精美卡片（Claude 风格），支持 markdown 渲染，底部按钮：
  • 下一张 →：循环翻页，带过渡动画
  • 打开原文：跳转到来源笔记
  • 复习：进入复习模式（有到期卡片时显示数量并高亮）
• ✅ 复习模式（主动回忆）：
  1. 只显示卡片标题，正文隐藏
  2. 凭记忆把内容写出来（Ctrl+Enter 提交）
  3. 「对比答案」左右并排对比：你的回忆 vs 卡片原文
  4. 自判「记对了 ✓」或「记错了 ✗」
• ✅ 间隔复习调度：记对按 2 天 → 4 天 → 7 天 → 12 天 间隔安排下次复习，全部通过后「毕业」；记错阶段归零、立即重新排入队列。复习进度存在卡片 frontmatter 的 reviewStage / nextReview 字段
• ✅ 卡片上有复习状态徽标（新卡片 / 已通过 N 次 · X天后复习 / 待复习 / 已毕业）
• ✅ 自动适配明暗主题

安装

方式一：手动复制

1. 运行 npm run build，得到 main.js、manifest.json、styles.css
2. 把这三个文件复制到你的 vault：<你的vault>/.obsidian/plugins/ocard/
3. 在 Obsidian 设置 → 第三方插件中启用 Ocard（需先关闭安全模式/开启第三方插件）

方式二：自动部署

设置环境变量 OBSIDIAN_VAULT_PATH 指向你的 vault 根目录，构建后会自动复制到插件目录：

OBSIDIAN_VAULT_PATH="D:/MyVault" npm run build

使用

1. 打开任意笔记，选中一段文字
2. 右键 →「制作为卡片」（或用命令面板执行「制作为卡片」，可自行绑定快捷键）
3. 输入卡片名称，回车确认 → 卡片已存入 cards/
4. 点击左侧栏的 Ocard 图标（或命令「打开卡片浏览」）翻阅卡片
5. 「下一张 →」换下一张；「打开原文」回到来源笔记
6. 「复习」开始主动回忆：写回忆 → 对比答案 → 自判对错，插件按间隔自动安排下次复习

开发

npm install        # 安装依赖
npm run dev        # 监听构建（开发模式，inline sourcemap）
npm run build      # 类型检查 + 生产构建