技能图谱 G4–G9 + 闯关题有图了 · Skill Graph for Grades 4–9, Quizzes with Figures

这一版加了什么

四到九年级换成「技能图谱」来学。 以前一条大纲条目就是一节课、一个题库、一个掌握状态；现在每个年级拆成 11–17 个主题、每个主题下 3–8 个小技能，G4–G9 共 77 个主题、369 个技能。每个技能都有自己的微课、闯关题库和先修关系，做错了按误区（340 条登记在册）指回该补的那一课。原来的大纲条目课全部保留，家长报告仍按 BC 官方条目汇总。

随包内容：972 节课（中英各 486）、11 910 道闯关题、242 张单元卷、4 534 条预烘自然语音，装完不需要 AI 引擎、不需要联网。

闯关题现在有图了

读统计图、象形图、饼图、分数条的题，数据直接画在图上让孩子自己读（以前是把图翻译成一段文字）。图上不印答案、按刻度打格子、只标整倍数的标签——和试卷一样要自己数。

其他改动

• 闯关结算改由服务端判对错：每场发一张场次票，凭票结算、一票一结，客户端报的对错不作数。
• 完整报告把技能层的进度算进对应的大纲条目；中途退出的单元卷不再算成绩。
• 年级选择改成自绘弹层，不再把卡片顶下去；宽屏下清单放宽。
• 内容审计修复：税务题按「确定缴两税」的商品出、豁免只在为真时明说；L3「他错在哪」类题的正确项不再天然最长；解析不再说「选项 B」而是说内容。
• 语音朗读把 Ms. / Mr. / Dr. 换成读音送合成。

从旧版升级

直接装新版。账号、学习进度、攒下的题库都在系统用户目录，升级不丢。技能图谱是新增的学习入口，旧的年级条目课照旧能用。

说在前面

• 包体明显变大（语音从 1 742 条涨到 4 546 条）：Windows 安装包 725 MB、免安装 zip 741 MB、macOS 781 MB（上一版 347 / 359 / 400 MB）。
• G8、G9 的技能微课这一版还没有预烘语音（240 节），这些课会退回系统自带的朗读；G4–G7 技能课和所有大纲条目课都有自然人声。
• 三个包都没有代码签名：Windows 会弹「未知发布者」，选「仍要运行」；macOS 需要先把 app 拖进「应用程序」，再执行 xattr -dr com.apple.quarantine /Applications/圆圆数学.app。
• 拍照出题、FSA 模拟卷、完整家长报告仍需要自己装一个 AI 引擎（Ollama 免费离线）。

内容包 v2.4：题图 v3（169 道带图）+ G8/G9 技能图谱（369 技能 / 11 910 题）

内容包 v2.4 · 题图 v3 + G8/G9 技能图谱 · 2026-09-12

给 AITutor-APPLE 的完整内容包（node tools/export_apple.mjs 直出，zip 根即包根，无顶层目录）。源码基准 dev@849e18a。

相比 content-v2.3 变了什么

• 题图（Question.visual，契约 v3）首次随包：闯关题库 140 道、单元卷 29 道带图（issue #5 / #6）。结构同 steps[].visual，多一个可选 step（统计图一格代表多少 / 象形图一个符号代表多少）。新增图型 pictograph（apple:false，不认识就降级成无图）；balance 的 nums 可写 [倾斜, 左盘值, 右盘值]（issue #4）。「两张不同刻度的图」一律只画一张、另一张留在题干（issue #6 3️⃣）。规则见 docs/qbank-standard.md §7。
• 配图契约 v3（curriculum/visual-contract.json）：count 规则含 0、stepFits / pictoSymbols 两条新规则；非 allowNeg 统计图拒负数、nums 必须全是数字。两端校验器请对齐同版本。
• 技能图谱到 G9：g8.json（14 主题 / 71 技能）、g9.json（49 技能）新增，全图 369 技能 / 77 主题 / 600 先修边 / 340 条误区（v2.3 是 249 技能 / 238 误区）。配套 G8 142 + G9 98 节微课、同数题库、主题卷 G8 28 张 + G9 16 张。
• 课文修订：en/YY.MATH.FRAC.EQUIV.SAME_WHOLE 第 3 步改为不配图、只留 headline（issue #7）；09-05 审查改了 8 个课程文件的配图参数（明细在 handoff.md §2）。
• 题库：issue #3 的 x5_as_double_double 误区补进 en 题库；8 道题干里的 statBar 枚举名已清掉。

数量

课程 972（标准 117×2 + 技能 369×2）· 题库 11 910 题（技能 738 份 + 条目 234 份）· 单元卷 242（主线 88 + 主题 154）· 语音 4 534 条。

注意

• 语音未补烘：G8 142 节 + G9 98 节技能微课（中英各半）没有预烘音频，voice/index.json 里对应步是 null，按设计退回系统 TTS；voice.missing en 724 / zh 728 步。补烘后另发 tag。
• ContentLibraryTests 断言建议改读 manifest.json 的 counts，别钉常量：技能库 en/zh 各 369，总数 369 + 117 = 486 份/语言；主题卷 77/语言。
• qbank 每题 tags 与选项位置对齐（正确项 ok），只供诊断，不能下发客户端；visual 可以下发。
• 上游正在按 issue #8 改英文出题管线（docs/qbank-pipeline-plan.md），本包不含该改动。

内容包 v2.3：技能题库 498 份全覆盖 + 平方数主题 + 3D_BY_1D 竖式新课

内容包 v2.3 · 技能图谱补齐 + 平方数主题 · 2026-09-02

给 AITutor-APPLE 的完整内容包（node tools/export_apple.mjs 直出，zip 根即包根，无顶层目录）。

相比 content-v2.1 变了什么

• 技能题库 498 份全覆盖：en/zh 各 249。补齐了 11 个拓展技能的 zh 题库（此前 zh 冻结在 234），core 未动。
• 新主题「平方数与平方根」（g7.json · square-numbers，4 技能，均 core:false）：primary 挂 BC.MATH.G7.FLU.01，supporting 记 BC.MATH.G8.NUM.01/02。配套 8 节微课、8 组题库、skills-g7-square-numbers 主题卷中英各 1。误区登记表 234 → 238（sq.* 四条）。
• YY.MATH.FLU.MULT.3D_BY_1D 课文重做（en/zh）：从 G4 拆分法直接升到紧凑竖式，坑步换靶到进位丢失（ops.regroup_forget），不再是 G4 那节的放大版。节点 rep 改为 placeValue,symbolic。
• 上一轮（09-01）的 L3 选项配平 533 道、54 技能 108 条误区回填、8 条先修边、MULTDIV 难度对调，本包首次随 Release 发出。
• 配图契约 v2（curriculum/visual-contract.json，41 图型）随包。

数量

课程 732（标准 117×2 + 技能 249×2）· 题库 8960 题（技能 498 份 + 条目 234 份）· 单元卷 198（主线 88 + 主题 110）· 语音 4534 条。

注意

• 语音未补烘：新课 3D_BY_1D（en/zh）和平方数 4 节 × 2 语言共 58 步没有预烘音频，按设计退回系统 TTS。旧 3D_BY_1D 的 12 段音频已成孤儿、不在包内。
• 上游 pack.mjs / pregen.mjs 自本版起技能图谱默认随包（--no-skills 才关）。
• ContentLibraryTests 断言要改：技能库 en/zh 各 249、总数 249 + 117 = 366 份/语言；SkillGraphTests 的 banked == core 两语言都改成全集。
• qbank 每题 tags 与选项位置对齐（正确项 ok），只供诊断，不能下发客户端。

内容包 2026-08-24：全量语音（4547 条）+ 课程/题库

Warning

此版本已过时，请改用 content-v2.1。

本包发布于 08-24 16:40，其中的课文和题库有一批会误导学生的内容错误，当天晚些时候的全量审计已全部修复：中文 BC.MATH.G4.NUM.01 的乱码练习与空答案、BC 税务规则错误（20 题 + 2 篇课，童装/童鞋/书其实只收 5% GST）、4 处与渲染器打架的配图、7 处答案位置泄漏（YY.MATH.NUM.LCM|en 12 道题答案全是 A）。题库同时从 8 517 题补到 8 583 题，语音补烘 12 段（4 547 → 4 546 条）。

已经下载过本包的同学请重新下载 content-v2.1，完整的差异清单（含 12 加 13 删的语音文件名）在那边的说明里。

---

给 iOS 组的内容包（build/apple-export 打包，707.5 MB）。

语音（本次重点）

• 4,547 条 m4a，覆盖率 100%（AAC 48k 单声道 24kHz，统一响度 -16 LUFS）
• 引擎 CosyVoice 2，经孩子两轮盲听确认（CosyVoice 3 / Qwen3-TTS 都试过并落选）
• 中文按句切段合成（≤90 字符/块，块间 0.32s 停顿）后拼接；英文整段
• 修复：解除 600 字符截断，219 段英文长旁白此前被拦腰截断，现已完整
• voice/index.json：index[lang][lessonId][stepIndex] = 文件名或 null，不需要复刻哈希

	中文	英文
BC 主线课	866	876
YY.MATH 技能微课	1,399	1,406

其余内容

724 节课（117 主线 + 245 技能微课 × 中英）、8,517 道题、196 张单元卷、大纲与技能图谱。

不在包里

AoPS 书籍课程、AOPS.* 题库（版权）、孩子的进度与做题记录。BC 大纲原文为 BC 省 Crown copyright，展示时请保留 source.url / version 标注。

内容包 v2.1：审计修复（8 583 题）+ 语音补烘（4 546 条）

给 iOS 组的内容包（build/apple-export 打包，709 MiB）。接替 voice-2026-08-24，请用这一版。

上一版（08-24 16:40）的课文和题库里有一批会误导学生的内容错误，外部全量审计发现后已当天全部修复并通过 17 项复检；语音随之补烘。数据结构、目录布局、字段全部没变，整包替换即可。

相对 voice-2026-08-24 的变化

	上一版	本版
题目	8 517	8 583（+66，补齐每级 ≥4 的缺口）
语音	4 547 条	4 546 条（+12 补烘，−13 旧文本孤儿）
课文	含乱码练习 / 税规错误 / 错误配图	已修复

主要修了：中文 G4.NUM.01 的乱码练习和空答案；BC 税务规则（童装/童鞋/书只收 5% GST、基本食材免税，12% 只用于确实缴两税的商品，共 20 题 + 2 篇课）；4 处配图与渲染器打架；LCM 英文题库 12 题答案全是 A 等 7 处位置泄漏；23 条「选项 A/B」式解析改为引用选项内容；11 份主题卷补齐 8 题 3/3/2。

iOS 侧唯一需要写代码的一项

areaModel 渲染器因数上限 99 → 999。 两篇三位数乘法课传入 [253,3] / [234,3]，旧钳位会画成 99×3，图和讲解对不上。算法：

钳位：a ∈ [2,999]，b ∈ [2,99]
拆分：n → [百,十,个]，丢弃 0 段；全 0 则 [n]
      253→[200,50,3]  602→[600,2]  45→[40,5]  20→[20]
列宽：w_i = max(minW, 300·v_i/a)，a 拆成 3 段时 minW=52，否则 70；
      Σw > 388 时整体按 388/Σw 缩放（画布宽 460，左边距 64）
行高：b 沿用原规则（≤99 拆十/个，h_i = max(54, 150·v_i/b)）

校验向量（部分积从左到右）：253×3 → 600/150/9、234×3 → 600/90/12、602×6 → 3600/12、45×15 → 400/50/200/25。两位数行为与原版逐像素一致，存量课零回归。

语音差异（做增量同步用）

音频在 voice/<sha1>.m4a（平铺一层），voice/index.json 的 index[lang][lessonId][stepIndex] 映射到文件名。全部差异就是下面 12 加 13 删，其余 4 534 个文件一字未动：

语言	课程	步	新增	删除（旧文本）
en	BC.MATH.G8.PAT.01	0	8d579196904614808e6b2adbda322bd41cad2d81	035fb119b116b9e60a951c0ac19c487024aef519
en	BC.MATH.G8.PAT.01	1	90bb11600dd8ab7041c72eef78de11dc04d2588b	b2efae79b66eea6d45ce81656451460ba68d6e1c
en	BC.MATH.G8.PAT.01	3	a427ef0b068b69168da6f54e0431412814ef1589	275f8fba29c099766034d52c9160d4680fe00b77
en	BC.MATH.G8.PAT.01	4	01c3f172226ba6476f38ee501e556d2bd4179124	e5f7e5e56f9ff7c922a15e51b2683d4e31366af5
en	YY.MATH.FIN.PCT.TAX	1	9445cf37277736e4755347d39affe6be96d277a4	e6a5506aa900c096210d58ebdd9142a95cd7ad2a
en	YY.MATH.FIN.PCT.TAX	2	1da25ca7a2d2a07969ae9894caf3142c2d46ef09	e3dd7a1fe83b191e3e9fe295e75bb04379c00869
en	YY.MATH.FIN.PCT.TAX	5	acb13b07723dbb01e8ba24c85d0cc6c3d5b39cc7	baca728a6e3c296bd15601b12668dd70effa53da
zh	BC.MATH.G4.NUM.01	6	1c5963ea263efefa0e5e6ebf5065a2abe4687809	0e53333b56e851454731577ed3bc7856462089e6
zh	BC.MATH.G4.NUM.04	3	8170ceb00f61f945cc8ff34b118d20baa927a868	ed04acb67c206112fbeb5a8f7a8212810c57fd8d
zh	BC.MATH.G4.NUM.04	原 4	—（两步并作一步，无对应新段）	b65fe97f84ebf0734bf395fcc552fe5381e8b366
zh	BC.MATH.G8.FLU.01	0	e5d44772fde813dfec5d914778ef8831c59df4e9	85395be01deb5e0f54f6de09ca48ede7b1cdf189
zh	YY.MATH.FIN.PCT.TAX	1	591af676f2fb60b1e587c16e8ee25f89f1a94c90	ca1ec56b54a5dbe46a11ef150d1e10adc67616a4
zh	YY.MATH.FIN.PCT.TAX	2	0989ec8c1f302098974de8dfa4696bf40bf45280	0679e28895c077a7f9b4c40e917ca7e5a38a2f5d

删那 13 个不是必须的（留着只占 2.5 MB 死重，index.json 不会再引用）。若你们也在启动时扫目录建索引，替换后必须重启 App，否则新文件取不到——Node 版实测踩过这个坑。

语音参数未变：CosyVoice 2，AAC 48k 单声道 24 kHz，统一 −16 LUFS，中文按句切段（≤90 字符/块、块间 0.32 s）后拼接、英文整段。

验收自查

题库：702 文件 / 8 583 题；无重复 qid；YY.MATH.NUM.LCM|en 答案分布 3/3/3/3
课程：724 文件；无空练习或单边练习
单元卷：196 份 / 1 568 题；所有 skills-* 卷 = 8 题、难度 3/3/2
语音：4 546 条；voice/index.json 724 课 4 546 步、无 null
manifest：counts.qbank.questions = 8583，counts.voice.files = 4546，无 voice.missing 项

不在包里

AoPS 书籍课程与 AOPS.* 题库（版权）、孩子的进度与做题记录（usedAt 已剥离）。BC 大纲原文为 BC 省 Crown copyright，展示时请保留 source.url / version 标注。题库里的 tags 是误区诊断用的，与选项位置对齐、正确项为 "ok"，绝不能下发给客户端。

课程内容包 v2.0 · 技能图谱（G4-G7）

见 docs/handoff-apple.md

从四年级到十二年级 · Now Covering Grades 4-12

这一版加了什么

课程从 4–7 年级一路补到 12 年级。 除了原有的 BC 四到七年级，现在还有：

• BC Grade 8、Grade 9（核心课，五大主线照旧）
• 高中理工主干三门课：Foundations of Mathematics and Pre-calculus 10 → Pre-calculus 11 → Pre-calculus 12（按官方课程的单元编排，不再是五大主线）

新增 48 个知识点，96 节课（中英各一份）、1151 道闯关题、48 张单元测验卷，全部随包发出，装完不需要 AI 引擎、不需要联网就能上课和闯关。加上原有内容，包里现在是 234 节课、234 组闯关题库、88 张单元卷、1742 条预烘自然语音。

大纲数据来自 BC 教育厅官网（K–9 是 June 2016 版，10–12 分科课是 June 2018 版），英文条目保留官方原文，中文层是逐条对照写的。

讲课有什么不一样

• 语气按年级分层：八九年级换成初中口吻，十到十二年级是高中口吻——例子从「分披萨」换成兼职工资扣税、手机套餐、开车油费、存大学学费。
• 新增四种高中配图：函数图像（一次/二次/指数/对数/三角/有理函数都能画，含渐近线）、直角三角形、一般三角形、单位圆（标注参考角）。
• 题干、选项和解析现在支持行内公式，分式、根式不再显示成代码。

内容是怎么把关的

课文和题目由本地模型批量生成，然后逐节逐题人工复核并修正：课文改了 376 处、题库打了 132 条补丁，其中约 60 处是真的数学或答案错误（答案标错、「正确选项」数值算错、两个选项等价、超出年级范围）。所有公式都实际渲染验证过，配图参数逐个核对过。

从旧版升级

直接装新版。账号、学习进度、攒下的题库都在系统用户目录，升级不丢。

• 从 1.1.x：装上即可。
• 从 1.0.0：首次启动会自动把旧数据迁到用户目录，细节见 v1.1.0 的说明。

说在前面

• 包体比上一版大不少（安装包 347 MB），大头是语音：预烘的自然人声从 1075 条涨到 1742 条。
• 三个包都没有代码签名：Windows 会弹「未知发布者」，选「仍要运行」；macOS 需要先把 app 拖进「应用程序」，再执行 xattr -dr com.apple.quarantine /Applications/圆圆数学.app。
• 高中课程同样是「装完就能用」的离线内容；拍照出题、FSA 模拟卷、完整家长报告仍需要自己装一个 AI 引擎（Ollama 免费离线）。

即时讲解也有自然音 · Natural Voice for Ad-hoc Questions

这一版解决什么

「自己出题」的即时讲解不再是机械音（Windows，联网时）。 跟大纲学的课程语音是随包预烘的自然人声，但孩子自己出的题、拍照问的题是现场生成的，语音包里没有对应音频，以前只能落回浏览器的机械朗读。

现在 Windows 启动器会优先用 Edge 应用窗口打开（装了 Edge 就用，没装照旧开默认浏览器，行为不变）：Edge 的朗读自带微软「Natural」在线音色，界面会自动选中它——联网时，即时生成的讲解也是自然人声。

几个边界，说在前面：

• 自然音色是微软的在线服务，离线时仍回到系统语音（预烘的大纲课语音不受影响，离线照常自然音）。
• 服务器上配了本地 CosyVoice 的家庭不受影响，本地引擎仍然最优先。
• mac 包本次只是版本同步，行为没变。

从旧版升级

• 从 1.1.0：直接装新版。数据在系统用户目录，升级不丢。
• 从 1.0.0：也是直接装新版，首次启动会自动把旧数据迁到用户目录——细节见 v1.1.0 的说明。

升级不丢数据 · Upgrades Keep Your Data

这一版解决什么

升级、重装再也不丢数据。 账号、学习进度、攒下的题库、配置、语音缓存现在存在系统的用户数据目录：

• Windows：%APPDATA%\YuanyuanMath
• macOS：~/Library/Application Support/YuanyuanMath

升级、卸载重装、换新包都不会碰它们。随包预生成的新题会在启动时自动并入你已有的题库（按题干去重、每级封顶），你攒下的题和改过的配置永远不会被覆盖。

macOS 安装包三个修复（Apple Silicon 真机实测）：

• Apple Silicon 上不再被 Rosetta 带偏，原生 arm64 启动。此前 uname -m 在 Rosetta 下谎报架构会挑错内置 Node，没装 Rosetta 的机器直接起不来。
• 浏览器等服务真的就绪才打开（首次启动可能要十几秒，以前会打开一个连不上的空页）。Windows 启动器同步改了。
• 安装说明改用 xattr -dr com.apple.quarantine 去掉下载隔离标记——「右键 → 打开」macOS 15 起已被苹果移除；另外务必先把 app 拖进「应用程序」再打开，否则系统会把它放进只读位置运行，数据存不进去。

从 1.0.0 升级

• Windows：直接装新版（zip 版解压覆盖旧文件夹）。第一次启动自动把老数据接管到 %APPDATA%\YuanyuanMath（只拷不删，旧文件原样保留）。
• macOS：1.0.0 把数据存在 .app 包内部，替换 .app 之前请先救数据——右键旧 圆圆数学.app →「显示包内容」，把 Contents/Resources/app/ 里的 data 文件夹和 config.json、qbank.json 拷进自己新建的 ~/Library/Application Support/YuanyuanMath/，然后再装新版。此后所有升级全自动。

装哪个

系统	文件	怎么装
Windows 安装版	YuanyuanMath-1.1.0-win-x64-setup.exe	双击下一步装完
Windows 免安装	YuanyuanMath-1.1.0-win-x64.zip	解压双击 圆圆数学.bat
macOS（Intel / Apple Silicon 通用）	YuanyuanMath-1.1.0-mac.tar.gz	解压 → 拖进「应用程序」→ 终端跑一次 xattr -dr com.apple.quarantine "/Applications/圆圆数学.app"

装完不用 Node、不用 AI 引擎、不用联网：跟大纲学、闯关、单元测试、真人感语音全部开箱即用。

---

English summary

Upgrades and reinstalls no longer lose data. Accounts, learning progress, the accumulated quiz bank, config and voice cache now live in the system per-user data folder — %APPDATA%\YuanyuanMath on Windows, ~/Library/Application Support/YuanyuanMath on macOS. New pre-generated questions shipped with each release merge into your existing bank automatically; nothing you accumulated is ever overwritten.

macOS package fixes: native arm64 launch on Apple Silicon (previously Rosetta made uname -m lie, so the launcher picked the x64 Node — machines without Rosetta could not start at all); the browser now opens only once the server actually responds (Windows launcher got the same fix); install instructions switched to xattr -dr com.apple.quarantine "/Applications/圆圆数学.app" — the right-click → Open trick was removed in macOS 15, and you must drag the app into Applications first or macOS runs it from a read-only location where nothing can be saved.

Upgrading from 1.0.0: Windows — just install the new version; the first launch takes over your old data automatically (copy, never delete). macOS — 1.0.0 kept data inside the .app bundle: before replacing it, right-click the old app → Show Package Contents, and copy the data folder plus config.json / qbank.json from Contents/Resources/app/ into a new ~/Library/Application Support/YuanyuanMath/ folder, then install. Every upgrade after this one is automatic.

v1.0.0 · Ready for Class Right After Installation (Offline Installer)

这个 release 标了 Pre-release，原因只有一个：macOS 包还没在真 Mac 上启动过。
Windows 两个包已经在一台干净环境（无 Node、无 AI 引擎、无登录态）里端到端验收过，
可以放心用。等 macOS 版有人验证通过，就转正式版。

Marked as a pre-release for one reason only: the macOS build has never been launched on real
Mac hardware. The two Windows builds were verified end-to-end on a clean machine and are solid.

给孩子的 AI 数学小老师，跑在你自己的电脑上。这一版装完就能上课——不用装 Node，不用装 AI，不用联网，不用在任何服务器上注册账号。

An AI math tutor for kids that runs on your own computer. This build teaches out of the box — no Node, no AI setup, no internet, no account on anyone's server.

---

下载 / Download

系统	文件	怎么装
Windows	YuanyuanMath-1.0.0-win-x64-setup.exe	双击安装。装在你自己的用户目录，不需要管理员权限。
Windows（免安装）	YuanyuanMath-1.0.0-win-x64.zip	解压到任意文件夹，双击里面的 圆圆数学.bat。
macOS	YuanyuanMath-1.0.0-mac.tar.gz	双击解压，把 圆圆数学.app 拖进「应用程序」。

装完浏览器会自动打开 http://localhost:8434，先注册家长账号，再给孩子建账号就能开始。
同一个 Wi-Fi 下的 iPad / 手机也能用，地址看窗口里打印的 On your LAN。

第一次打开会被系统拦一下，这是因为这个包没买代码签名证书（Windows 一年几百刀、苹果 99 刀/年），不是有问题。

• Windows：点「更多信息 → 仍要运行」
• macOS：右键点 App →「打开」→ 再点一次「打开」，只需做这一次

First launch is gated by the OS because this build isn't code-signed. Windows: "More info → Run anyway". macOS: right-click the app → Open → Open again, once only.

---

包里带了什么 / What's in the box

以下全部不需要任何 AI 引擎，断网也能用：

• 138 节课 —— BC 省 G4–G7 数学大纲的全部知识点，中英各一份，点开秒出
• 1656 道闯关题 —— 每个知识点一套，做对升难度，通关标「扎实」
• 40 张单元测试卷 —— 每年级 5 个单元，中英各一份
• 1075 条真人语音 —— CosyVoice 预先合成，中英文都有，不是浏览器那个机械音

138 lessons covering every topic in the BC Grade 4–7 math curriculum (Chinese + English), 1656 quiz questions, 40 unit tests, and 1075 pre-synthesized natural-voice clips in both languages. All of it works offline with no AI engine.

什么需要自己装 AI 引擎 / What still needs an engine

• 自己出题：打字或拍照问一道具体的题
• FSA 模拟卷（G4 / G7）
• 家长的「完整学习报告」
• 「换个讲法再讲一遍」「再出一张新卷」

装一个引擎就解锁：Ollama 免费、离线，或者 Claude Code / Gemini CLI / Grok / Codex，也可以在 config.json 里填 API key。详见 README。
没装也不会弹报错——界面会直说哪条路现在能走。

---

已知限制 / Known limitations

• macOS 版没有在真机上验证过。 打包在 Windows 上完成，bundle 结构、可执行位、双芯片 node 都逐项检查过，但没人在真 Mac 上双击运行过。遇到问题请开 issue 告诉我。
  The macOS build has not been tested on real hardware — it was assembled on Windows. Structure, permissions and the arm64/x64 node binaries were all verified, but nobody has actually double-clicked it on a Mac. Please open an issue if it misbehaves.
• 两个包都没有代码签名（见上面的绕过办法）。
• 讲解由 AI 生成，偶尔会算错。最终答案单独醒目显示，建议家长顺手核对。
• 只含 BC 省大纲。四本 AoPS 教材的课程是本地功能，自己有书的人用 tools/books/ 生成，不随包发。

---

校验和 / Checksums (SHA-256)

2b4aa807516d5b207472e89c448740b2679a0dabd610d68fd95b2f805ab8fcb4  YuanyuanMath-1.0.0-win-x64-setup.exe
9dd92e74e5abd6dd0ad20e168069f3d7df0aff3eb2d007536de88ca12cd049f1  YuanyuanMath-1.0.0-win-x64.zip
cccfb980efbe435856505d19bbb0f2b50ff3bb25dfaf914841f54a8d9504aec5  YuanyuanMath-1.0.0-mac.tar.gz

内置 Node v22.23.2（从 nodejs.org 官方下载并核对过 SHASUMS256）。
孩子的学习数据全部留在你自己的机器上（data/kids/），不上传任何地方；卸载不会删。