Super Reviewer

Super Reviewer 是一个移动端优先的 Obsidian 复习插件。它在独立界面中随机展示 Markdown 标题章节、整篇笔记以及 Canvas 文本/文件节点，并允许直接编辑或追加想法。

当前版本

当前 MVP（0.1.4，要求 Obsidian 1.7.2 或更新版本）已包含：

• 独立复习视图与移动端底部操作栏。
• Markdown 文件和标题章节索引。
• Canvas 文本节点和文件节点索引。
• 文件优先或单元等概率随机、防连续重复、会话回退。
• Markdown 渲染阅读态。
• Markdown 章节、整篇文件和 Canvas 文本节点编辑。
• 保存前来源复核与冲突阻止。
• 快速追加想法、文件夹过滤与索引重建。
• Canvas 子节点管理：即使没有关联节点，也可展开关联区并新增文本子节点；新节点自动放在父节点右侧的空位并创建有向连线。
• 点击子节点进入阅读；长按、右键或点击“⋯”打开编辑/删除菜单。文件子节点的编辑会修改其引用的笔记内容。
• 删除需确认：移除选中的 Canvas 节点及全部关联连线，保留下级节点和引用的笔记文件；Canvas 来源变化时阻止新增和删除。

使用

在 Obsidian 中启用插件后，通过左侧功能区图标或命令面板中的“打开复习视图”进入工作台。使用“上一条”“下一条”浏览，点击“编辑”修改正文并保存，点击“来源”打开原笔记或 Canvas。

“信息流”按双列显示候选内容；“配置”用于保存和切换过滤范围。Canvas 节点可展开“关联节点”，点击子节点阅读，点击“新增子节点”创建文本节点，长按、右键或点击“⋯”编辑或删除已有子节点。

手动安装时，从 GitHub Releases 下载同一版本的 main.js、manifest.json、styles.css，放入仓库的 .obsidian/plugins/super-reviewer/ 目录，然后在 Obsidian 的社区插件设置中启用插件。更新后关闭再启用插件以载入最新版本。

开发

npm install
npm run dev

生产构建：

npm run build

插件运行需要根目录下的 manifest.json、main.js 和 styles.css。

请在独立测试仓库中开发和验证写入行为。

模块结构

• src/app：跨模块应用契约。
• src/core：共享数据类型与无状态工具。
• src/filter：候选范围判断。
• src/index：索引生命周期和候选集合。
• src/sources：Markdown、Canvas 发现、读取与定位。
• src/scheduler：随机、冷却和会话回退。
• src/reader：Markdown 阅读渲染。
• src/editor：追加格式与安全写回。
• src/navigation：打开原生来源。
• src/session：插件数据持久化。
• src/settings：设置界面。
• src/ui：工作台、编辑面板和移动布局。

详细边界见 ARCHITECTURE.md。

许可证

本项目使用 MIT 许可证。