YuReader

为硬核学习者构建的本地认知作战室 · Local Cognitive Operating Environment

“读书不是在字里行间漫步，而是带着猎矛在文本丛林中精准突刺。”

---

✦ 缘起：为什么我们厌倦了主流学习工具？

在现代学习场景中，每一个严肃学习者几乎都在经历一种认知割裂的酷刑：

• 在 PDF 阅读器里看教材，昏昏欲睡，读完三章脑中依然一片空白；
• 去刷题 App 里刷客观题，答案对了就滑过，做错了解析只有孤立的一两句话，与教材正文完全脱节；
• 打开笔记软件试图总结，变成了机械的“复制 - 粘贴 - 排版”，在知识管理软件里堆积了一堆从未真正内化过的“知识尸体”；
• 旁边放着番茄钟或手机计时器，动辄弹出的数字与震动不断制造焦虑，工具切换的摩擦力吞噬了大半心力。

YuReader 的诞生，就是为了终结这种碎片化。

它不是又一个平庸的 Electron 阅读器，也不是又一个套壳题库。它是一套以书籍为本位、本地优先（Local-First）、严谨典雅的个人认知操作系统。它将「通读教材」、「带着问题主动回忆」、「真题实战」、「即时错题攻坚」与「本地知识库镜像」熔铸为一体，让深阅读与硬核应试形成严密咬合的飞轮。

---

✦ 核心机制与精妙架构 (Core Architecture & Clever Craft)

抛开繁琐的技术参数，YuReader 真正让人上瘾的，是围绕**「高强度笔记沉淀」与「无处不在的双侧边栏协同」**构建的认知中枢：

1. 「上下文绑定的全维度原子笔记网络」：告别信息孤岛，直通 Obsidian 神经外脑

“笔记不该是剪贴板的简单搬运，而是在阅读正文、推导考点与实战解题时，大脑与文本碰撞出的火花。”

• 四维情境笔记织网：
  • 小节精读笔记（Section Notes）：阅读教材时，右侧抽屉随手唤出，实时绑定当前章节稳定 ID，记录原书机理思考与逻辑框图；
  • 考点记忆随手记（Flashcard Mnemonics）：在背诵名词解释与论述时，随手记弹窗记录自创口诀与串记线索，打通长效记忆通道；
  • 解题复盘个人解析（Question Analysis）：做错题目时，不盲从原卷官方套话，而是在原题下方直接沉淀属于自己的陷阱剖析；
  • 主观题作答与反思（Subjective Reflection）：翻译与大作文独立作答区，记录词句锤炼与框架得失。
• Obsidian 实时双向呼吸：
  • 所有笔记、解析、作答全部以极简 Markdown 格式原子级保存在本地 data/，并自动通过规范的 YAML Frontmatter 与深链接（obsidian://open）双向镜像进你的 Obsidian Vault。
  • 在阅读器里输入，在 Obsidian 里编织双链知识图谱，资产 100% 归你所有，数据永不丢失。

2. 「双翼中枢：左锚心流 · 右翼 AI Sidecar 私教协同」

“真正的专注不是把屏幕塞满，而是左手掌控全局，右手直通私教。”

• 左侧静默控制台（The Command Sidebar）：
  • 68px 极致窄化折叠，呼吸般轻盈。悬停即展开全学科导航（今日 / 学习库 / 回顾 / 记录 / 统计），点击即穿透到任何知识坐标。
  • 自适应任务指标微光环：将当前任务完成度（阅读学时、错题斩杀、背诵进度）化为徽标同心细线，0 屏幕文字干扰，悬停知全貌。
• 右翼上下文抽屉（Contextual Dock）+ 侧边栏 AI 协同：
  • 不遮挡正文的双栏/浮动抽屉，随时展开小节笔记、考点清单与错题解析；
  • 原生适配侧边栏 AI 私教（AI Sidecar Co-pilot）：专为浏览器侧边栏大模型（Gemini / Claude）量身优化。正文与题目上下文高度结构化，提供一键格式化复制与专用提示词模板（“理解这道题 / 闭卷口述 / 按点批改”）。阅读器是严谨的客观事实基石，侧边栏 AI 是随时可以探讨反刍的苏格拉底。

3. 「带着问题读」：把教材直接变成靶场

• 章节考点自动映射：系统内部建有一套章节知识图谱映射引擎，将 2,200+ 道高频考题（名解、论述、重点）高保真锚定回每一本官方教材的具体章节。
• 主动回忆（Active Recall）折叠设计：点击顶部「带着问题读」，抽屉滑出本章考题。这里没有直接剧透的标准答案，只有星级和干文。先在大脑中检索回忆、带着考点研读正文，再展开对比核对——阅读不再是被动的信息灌输，而是一场主动的侦察与验证。

4. 「正文与题库的量子纠缠」：打破切屏地狱

• 完形填空的原位点选：不再是“上面一段文章、下面翻来翻去找题”。YuReader 将 20 个空位直接无缝融合进正文段落，点击某空，下方仅浮现该空选项，沉浸感如在真实纸面批注。
• 长篇阅读的双栏工作台：左侧完整原文、右侧全组试题。原文段落与题目选项同屏对照，提交前完全封锁答案解析防剧透；提交后直出原书解析与个人复盘区。
• 主观题盲打与双重对比：翻译与作文工作台左侧展示材料，右侧提供独立作答区与实时字数提示。只有完成独立构思后，才允许展开权威参考译文与解析。

5. 「艾宾浩斯抗遗忘 + 错题斩杀营」

• 重点卡片无缝翻转：名词解释与简答论述采用类 Anki 的极速卡片流（Flashcards），支持正反面翻转、遮挡填空（Cloze）与重点星标。
• 智能记忆间隔调度：依据「完全遗忘 / 模糊犹豫 / 熟练掌握」自动排程复习周期。
• 错题二刷攻坚：每一道做错的客观题都会自动收录进专属错题本，提供独立的“消灭错题”集训模式，直到将错题本彻底清零。

---

✦ 真实一日：硬核学习者的 24 小时认知飞轮 (A Day in the Life)

“最好的系统不是让你感觉‘在用工具’，而是让你在整日的自然心流中，不知不觉完成从知识输入、主动回忆、真题淬炼到外脑生长的全过程。”

下面是 YuReader 如何贯穿并支撑一名硬核学习者全天真实学习的全景认知看板：

flowchart LR
    subgraph S1 ["🌅 07:30 晨光闪击 · 考点抗遗忘"]
        direction TB
        A1["<b>今日主页唤醒</b><br/>查验艾宾浩斯到期考点量"]
        A2["<b>开启 Due Session</b><br/>专科核心名解与论述汇流"]
        A3["<b>闪卡翻转 Active Recall</b><br/>闭卷口述·填空模式测记忆"]
        A4["<b>随手记笔记弹窗</b><br/>侧边记录自创谐音口诀要点"]
        A5["<b>艾宾浩斯三阶评分</b><br/>熟记/模糊/遗忘·智能排程"]
        A6["<b>原子镜像入库</b><br/>卡片清零·同步Obsidian考点库"]
        A1 --> A2 --> A3 --> A4 --> A5 --> A6
    end

    subgraph S2 ["☀️ 09:00 教材深研 · 理论靶向精读"]
        direction TB
        B1["<b>进入官方教材书架</b><br/>选择《牙体牙髓》精读小节"]
        B2["<b>呼出「带着问题读」</b><br/>全章高频考题先导锚定"]
        B3["<b>正文沉浸深度研读</b><br/>3.5s慢呼吸·微光环1s步进"]
        B4["<b>小节深度笔记抽屉</b><br/>右下呼出·记录机理架构推演"]
        B5["<b>考点反刍自测</b><br/>结合全章题靶即时印证"]
        B6["<b>侧边栏AI私教追问</b><br/>一键复制上下文·模拟临床追问"]
        B1 --> B2 --> B3 --> B4 --> B5 --> B6
    end

    subgraph S3 ["⚡ 14:00 真题实战 · 跨学科深度刷题"]
        direction TB
        C1["<b>英语真题工作台</b><br/>试卷导览·题号范围全景呈现"]
        C2["<b>完形原位点选作答</b><br/>正文内嵌空位·联动展示选项"]
        C3["<b>长篇阅读双栏同屏</b><br/>左长文右题组·交卷前锁答案"]
        C4["<b>主观题盲打对比</b><br/>译文构思·字数统计·范文核对"]
        C5["<b>个人独家解析笔记</b><br/>原题下撰写干扰项陷阱剖析"]
        C6["<b>政治客观刷题</b><br/>30题综合刷·错题自动入库"]
        C1 --> C2 --> C3 --> C4 --> C5 --> C6
    end

    subgraph S4 ["🎯 17:30 错题歼灭 · 靶向二刷攻坚"]
        direction TB
        D1["<b>查验今日攻坚指标</b><br/>今日页徽章提示剩余错题数"]
        D2["<b>进入错题攻坚集训营</b><br/>跨科目汇流白天错题靶标"]
        D3["<b>深度二刷死磕</b><br/>重审原题与选项·拒绝凭印象"]
        D4["<b>追加反思警示笔记</b><br/>在个人解析中补记认知误区"]
        D5["<b>斩杀出库彻底清零</b><br/>重新做对即出库·错题数递减"]
        D6["<b>欢庆横幅点亮</b><br/>今日攻坚全达标·完成纠偏"]
        D1 --> D2 --> D3 --> D4 --> D5 --> D6
    end

    subgraph S5 ["🌙 21:00 知识沉淀 · 跨学科汇流外脑"]
        direction TB
        E1["<b>微光环100%圆满闭合</b><br/>今日有效学时稳健达成8.0h"]
        E2["<b>进入回顾工作台</b><br/>阅读+答题+4类笔记全景汇流"]
        E3["<b>分学科结构化检视</b><br/>医学+政治+英语全天痕迹拼合"]
        E4["<b>侧边栏AI综合诊断</b><br/>一键生成摘要·输出诊断与规划"]
        E5["<b>撰写每日跨学科复盘</b><br/>完成今日沉淀反思并保存"]
        E6["<b>Obsidian知识图谱长成</b><br/>原子镜像写入Vault·双链交织"]
        E1 --> E2 --> E3 --> E4 --> E5 --> E6
    end

    S1 ==> S2 ==> S3 ==> S4 ==> S5

    classDef default fill:#fbfbfa,stroke:#d0cfc7,stroke-width:1px,color:#1e1e1e;
    classDef stageStyle fill:#f7f6f0,stroke:#c4783c,stroke-width:1.5px,color:#8c4314;
    class S1,S2,S3,S4,S5 stageStyle;

Loading

闭环流转详解：从晨光到深夜的认知闭环

1. 🌅 07:30 · 晨起唤醒与考点抗遗忘

   • 查验到期考点：清晨起床，打开首页查看今日待办，艾宾浩斯抗遗忘算法已自动汇聚今日到期的专科核心考点（如 35 题待复习）。
   • 进入 Due Session：一键开启复习会话，闪卡正反翻转进行主动回忆（Active Recall），支持开启「挖词填空（Cloze Mode）」屏蔽高频关键词检验记忆深度。
   • 随手记弹窗与智能排程：侧边随时呼出随手记弹窗写下自创的谐音口诀或串记要诀；依据「熟记 / 模糊 / 遗忘」三阶自适应排程下一次复查，队列清零时自动原子同步至 Obsidian 考点库，点亮清晨绿徽。

2. ☀️ 09:00 · 深度研读与理论靶向精读

   • 带着问题进入正文：打开《牙体牙髓病学》，拒绝催眠通读。点击顶部呼出「带着问题读」考点抽屉，无冗余解析干扰，全章核心考题（序号、星级、题干、一键复制图标）轻装先导锚定在大脑中。
   • 沉浸静默心流：左上角 40px 徽标激活 6px 暖色慢呼吸微点，微光环以 1 秒为步长随有效阅读平滑推进医学 2.0h 阅读目标。
   • 小节笔记与侧边栏 AI 追问：右下角常驻操作栏一键唤出「小节笔记抽屉」沉淀机理图解，点击 obsidian://open 原生直达本地独立笔记；读毕在小节笔记中梳理机理框架，并可一键复制题目给侧边栏私教大模型（Gemini / Claude）进行临床病例延伸追问。

3. ⚡ 14:00 · 真题实战与跨学科深度刷题

   • 全真试卷工作台：下午进入真题实战。打开 2024 考研英语二工作台，试卷导览全景呈现题号范围与答题进度。
   • 原位交互与防剧透长文：完形填空在正文段落中原位点击空格联动展示选项；长篇阅读左侧完整原文、右侧题目同屏互动，交卷前完全封锁答案解析。
   • 主观题盲打与独家个人解析：翻译与作文工作台左审材料、右侧盲打输入译文草稿与大作文，字数实时统计，写毕展开高分范文深度核对；原题下方撰写个人解析笔记剖析做错诱因，系统底层自动将错题捕获截流进专属错题本；无缝衔接政治 30 题综合题单连续刷题。

4. 🎯 17:30 · 错题歼灭与靶向二刷攻坚

   • 查验攻坚指标：傍晚精力回落，回到今日页查看「错题攻坚」卡片，徽章精准提示“剩余 5 题待消灭”。
   • 二刷死磕到底：一键进入「客观错题攻坚集训营」，跨科目汇流白天错题靶标，重审原题与选项，严禁凭模糊印象选答案。
   • 反思补记与斩杀清零：在之前的个人解析笔记中追加醒目的红色盲点反思警示；重新答对斩杀的题目立即移出本库，错题数递减直至清零，首页欢庆横幅点亮，完成一天中最关键的认知纠偏。

5. 🌙 21:00 · 知识沉淀与跨学科汇流外脑

   • 微光环圆满闭合：夜幕降临，徽标同心环 100% 优雅闭合，今日总学时稳健达成 8.0 小时。
   • 全景汇流与结构化检视：进入「回顾」工作台，系统已将今日跨学科的所有教材阅读轨迹、口腔背诵卡片、英语真题、政治刷题与 4 类笔记自动汇流拼合。
   • 侧边栏 AI 综合诊断与 Obsidian 图谱生长：一键生成摘要交由侧边栏 AI 综合诊断，输出今日得失点评与明日攻坚规划；你撰写今日跨学科总结并一键保存。全天产生的 4 类笔记、主观著作文与每日学习记录（YYYY-MM-DD.md）以原子级 Markdown 写入本地 Obsidian Vault，双向链接交织入库，心智零负担安睡。

---

✦ 无限潜力点 (The Horizon & Future)

YuReader 不仅仅是一套为特定考试打造的利器，它验证了一种全新的个人学习基础设施范式：

1. AI 原生学习副驾（AI-Native Sidecar Agent）：
   • YuReader 的页面上下文以极高保真度结构化暴露。右侧可直接无缝挂载大语言模型（如 Claude 或 Gemini），AI 扮演的不再是虚无缥缈的聊天机器人，而是坐在你书桌旁的苏格拉底式私教——随时对你读到的段落提问、按考点评分你的口述录音、为你的主观题逐句批改润色。
2. 专业级领域知识的工业级治理管道：
   • 包含从扫描版教材 OCR、目录边界识别、专科生僻字符修复（如口腔医学特有字符的清洗），到试题原题/解析的智能拆解，具备将任意硬核学科书籍快速转化为“可阅读、可检索、可练习”交互资产的能力。
3. 终身外脑操作系统：
   • 当数月的学习轨迹、数千道题目的攻坚心流、数百条深入骨髓的章节笔记汇聚于此，它便演化为你专属的“第二大脑”。所有知识不是散落的书签，而是伴随时间维度生长沉淀的个人认知结晶。

---

✦ 快速启动

依赖环境

• Python 3.10+
• （可选）现代主流浏览器，推荐 Chrome / Edge

启动服务

# 1. 运行主服务
python app.py

# 2. 访问控制台
浏览器打开 http://127.0.0.1:8775

或直接双击项目根目录下的 启动 YuReader.bat。

---

YuReader · 把专注留给自己，把知识铸成武器。