FEATURES

功能与工作流

从导入到导出，22 项已经落地的能力。先看核心与五步链路，需要时再展开完整索引。

下载桌面版在线试用

01 / PRINCIPLES

两条底线。

InteFlow 不做“什么都能聊”的学习助手。它先把确定的事做对，再把可选的 AI 放在你明确按键之后。

LLM 不在主链路。

导入、解析、判分、复盘、导出默认都是确定性的本地计算；AI 只作为显式操作，或你主动开启的兜底出现。

PDF / DOCX / Markdown 默认本地转换，0 token
AI 识别兜底仅在开启且确定性解析失败时尝试
关闭开关、无 key 或调用失败时回退本地并说明

数据留在本机。

题库、作答、分析、生词表都存在 data/ 下：一个 SQLite 文件，加上每套试卷的 doc.ifmd.md 与图片。默认不上传云端。

没有账号，没有云端同步
备份 = 复制 data/ 文件夹
断网时，除了可选 AI，一切照常

02 / WORKFLOW

五步，从文件到笔记。

没有隐藏的同步步骤，也没有必须在线的工作台。每一步都能单独停下来，改完再继续。

01
导入题库

拖入 PDF、DOCX、.md 或 .ifmd.md，逐页报告；扫描页自动走 OCR。
0 token
02
补齐答案

字母网格、多选、填空与批量粘贴；保存前可预览，保存后回写源文件。
write-back
03
全屏刷题

正计时或倒计时、题号面板、键盘操作、自动判分；多选和填空都能作答。
fullscreen
04
逐题复盘

2-of-4 工作台里写解析、问 AI、拖词入生词本；编辑器约 0.9 秒自动保存。
core
05
沉淀与导出

Mistakes、Starred 与 Sessions 汇总练习；导出 md / docx / pdf 与词表 xlsx。
portable

03 / CORE FEATURES

六项最常用的能力。

覆盖导入、练习、复盘、词汇与导出。完整 22 项在下方展开。

IMPORT

多格式导入

PDF、DOCX、Markdown 与 InteFlow-MD，60 MB 以内；逐页报告，可疑页面可暂停复核。

IMPORT

PDF 结构识别

双栏版面、题号、选项、答案表回填与图片抽取；识别不到选项时按填空题处理。

PRACTICE

全屏练习与判分

考试式全屏、计时、题号面板与键盘操作；多选全对、填空归一化后比较，0 token。

REVIEW

2-of-4 复盘工作台

题目、分析、AI Tutor、生词本四选二；Pages 式编辑器自动保存，布局与比例会记住。

VOCABULARY

本地词典与生词本

韦氏 92,006 条离线索引，支持自定义词典；从题目或选项拖词入表，可导出 xlsx。

OUTPUT

导出套件

复盘笔记本导出 md / docx / pdf，整套试卷导出 PDF / DOCX，词表导出 xlsx。

查看全部 22 项能力展开

导入与整理 7

多格式导入: PDF、DOCX、.md 或 .ifmd.md，逐页报告。
PDF 结构识别: 双栏、题号、选项、答案表回填与图片抽取。
扫描件 OCR: macOS Vision 优先，其他系统走 Tesseract。
题库导入: ZIP（manifest + 单元，或散装 .ifmd.md）安装到我的题库，逐套 Add 或一键全加；安装包不含版权题目。
Library 与学科: 题数、答案状态一览；自定义学科、颜色与筛选。
答案录入: 字母网格、多选、多可接受答案与批量粘贴。
InteFlow-MD: 纯文本中间格式，公式、图片、多选与填空都有确定语法。

练习与判分 2

全屏练习: 计时、题号面板、Mark for review、键盘操作与交卷确认。
确定性判分: 多选必须全对，填空 NFKC 归一化；答案提交前不下发。

复盘与收藏 5

复盘工作台: 题目 / 分析 / AI Tutor / 生词本四选二分屏。
分析笔记本: Markdown、KaTeX、图片与自动保存；支持分析模板。
Mistakes + Starred: 错题按题去重保留最近一次；手动标星；搜索与筛选。
Sessions 作答历史: 只记录已提交作答，可搜索、复盘与删除。
AI Tutor（显式）: 点击才调用；19 家服务商、两套协议与连通性测试。

词汇与词典 4

本地韦氏词典: 自备 Eudic .eudb，首次查词建 SQLite 索引。
我的自定义词典: 手动增删或导入 CSV / TSV / JSON / TXT，优先命中。
生词本与拖词: 一套试卷一份词表；拖词入表，可选 AI 选义。
单词考试: EN↔ZH 双向、随机或全测、宽松判分与二维码结果。

输出与系统 4

导出套件: 笔记本 md / docx / pdf，试卷 PDF / DOCX，词表 xlsx。
五套界面主题: Clear Blue、Paper & Ink、Minimal Light、Midnight Navy、Warm Editorial。
设置与 AI 开关: 用户名、分析模板、AI 识别兜底、选义、评分等，默认值与回退写清。
本地数据与可测试性: SQLite + 文件系统，MIT 开源，后端与前端都有自动化测试。

ZIP题库导入

0随包 SAT 题目

92,006词典条目

19LLM 服务商

69API 端点

447自动化测试

04 / FORMAT & STACK

确定的格式，确定的链路。

每次导入都先变成 InteFlow-MD，再由确定性状态机解析。没有隐藏的二次整理，也没有“看起来像”的猜测。

                
                
                
                
              

                ---
ifmd: 1
title: "2024 International School Final"
answers: none
---

:::q {#Q001 sec=rw no=1 difficulty=m}
@material
Despite the committee's reservations, the new policy was adopted
without amendment.

@stem
The author's attitude toward the committee is best described as

- A. undisguised contempt
- B. cautious approval
- C. outright indifference
- D. blunt hostility
! answer: B
:::

                # macOS / Linux
git clone https://github.com/JasonSun2009CN/InteFlow.git
cd InteFlow
./start.sh

# Windows PowerShell
.\start.ps1

# first run: create .venv, install deps, start both, open browser
# backend  → http://localhost:8000
# frontend → http://localhost:5173

                data/
├── app.db                 SQLite: documents, questions,
│                          sessions, analysis_pages, subjects
├── docs/<id>/
│   ├── doc.ifmd.md        source of truth
│   └── assets/            extracted figures
├── dictionary/mw.db       rebuildable MW index
├── exports/               notebook + document exports
└── jobs/ · tmp/           import pipeline scratch
              

                DETERMINISTIC STATE MACHINE
                format v1
              

BROWSER React 19 SPA Vite · TypeScript · Tailwind 4

/api/*

BACKEND FastAPI 13 routers · 65 endpoints

SQLite app.db

Files ifmd + assets

LLM explicit only

BackendFastAPI · Python 3.11+
FrontendReact 19 · Vite 7 · Tailwind 4
StorageSQLite + local files
ConvertPyMuPDF · python-docx · OCR
ExportWeasyPrint · openpyxl · MathJax

05 / QUESTIONS

还有疑问？

这里先回答最容易卡住的几件事。更细的规格与格式说明都在仓库文档里。

在 GitHub 提问

01只支持 SAT 吗？

不是。题目的 sec 是自由标签（rw、math、physics、history……），不是固定枚举。任何“题号 + 两个以上选项”的题库都能导入；没有识别到选项的题会按填空题处理。安装包不附带任何 SAT 真题；示例题库只存在于源码开发环境，发布会自动排除。你可以导入自己的题库 ZIP。

02必须联网或配置 API Key 吗？

不需要。导入、解析、判分、复盘、生词本、导出都不依赖网络。只有 AI 讲解、连通性测试、以及你主动开启的单词考试 AI 评分会调用外部模型；无 key 或调用失败时会回退本地并提示。

03我的数据存在哪里？

全部在仓库的 data/：app.db 存结构化数据，docs/<id>/doc.ifmd.md 存原始题目与答案，assets/ 存图片，导出文件在 exports/。备份就复制整个目录，重置就删掉它。

04需要装哪些系统依赖？

桌面版不需要 Python / Node。从源码运行时需要 Python 3.11+ 与 Node.js 18+；PDF 导出额外需要 pango / cairo / gdk-pixbuf / harfbuzz；扫描件 OCR 可选安装 tesseract，macOS 也可用 Vision。缺哪一项，只有对应功能降级或提示。

05能用我自己的词典吗？

可以。Settings 里的 My dictionary 支持手动增删，也能导入 CSV / TSV / JSON / TXT，查词时优先于韦氏。若要英英韦氏释义，把 Eudic .eudb 放进 dictionary/，首次查词会自动建索引。版权词典文件不会随仓库分发。

06导出的笔记本包含什么？

一套试卷对应一套复盘笔记本：封面带用户名与分数，正文按题序包含所有已写解析的题目（题干、图表、你的分析）。支持 Markdown / DOCX / PDF，浏览器直接下载，同时在 data/exports/ 留一份副本。

READY WHEN YOU ARE

看完功能，
试一下真的。

先在线做四道题，或者直接下载桌面版。主链路不需要账号，也不需要 API key。

下载桌面版在线试用看看五套主题