常见问题

先把边界讲清楚

下面这些问题,大多来自 README 的「已知边界」和真实使用反馈。

需要联网吗?断网还能用吗?

需要。识别与讲解全部走云端推理,断网时这两件事做不了。但历史数据、错题本、学情仍然可以查看。

离线时界面会明确提示,它不会用规则模板假装成模型回答。

我的数据会被上传吗?

题库、作答记录、错题本、备份都存在你自己的电脑上,没有遥测、没有埋点统计。

只有模型推理会联网:你拍的照片或输入的文字,会发给你自己配置的模型厂商。API Key 存在 macOS Keychain 里,不随备份上传。

需要自己准备 API Key 吗?大概要花多少钱?

需要。它不自带额度,你得在 DeepSeek / Kimi / MiniMax 里至少注册一家,把 Key 填进「设置 → 模型管理」。

按官方口径估算:单题约 ¥0.014(空闲时段 + 80% 缓存命中),日均 10 题一个月约 ¥4.3;高峰时段同条件约 ¥8.5。单张图片约 ¥0.0004,可忽略。设置页有成本看板,能看每一笔记账。

只配 DeepSeek 一家能跑通吗?

能。只配 DeepSeek 一家就能跑通全链路 —— 它的 deepseek-flash 同时具备文本与视觉能力,且单价最便宜。

配上第二家(Kimi / MiniMax)的价值在于交叉验证:完整讲解会换一个模型独立重解一遍。

支持哪些学段、学科和教材版本?

小学到高中,数学、物理、语文、英语四科。知识库含 542 个知识点,另附 542 条教材映射。

教材版本只影响「知识点对应哪一单元」这句话,不影响讲解内容与批改质量。语文全国统一用统编版,不用选;英语和数理需要按你所在地区选版本(人教版 / 外研版 / 译林版等)。

为什么它不直接给答案?

因为核心主张就是「不做答案机,做陪你把题做出来的学伴」。它按提示阶梯走:L0 诊断 → L1 方向 → L2 关键步骤 → L3 完整讲解 → L4 变式题。

完整讲解(L3)需要你先提交一次作答才解锁,答案闸门由主进程强制,任何输出通道都不能在解锁前泄露最终答案。当然,问答里你可以在闸门中明确选择「直接看答案」。

批改是例外:它是结果核对,本来就要给答案、指出从哪一步开始错。

模型讲错了会被发现吗?

会尽力发现。每次 L3 完整讲解都会:换一个模型独立重解一遍(交叉验证)、做本地符号校验(数学等价性,½ = 0.5、√8 = 2√2 都算相等)、做物理量纲校验(F = m·v 会被判错)。

校验不通过就撤回答案、改为引导,并进复核队列。没法比对的(比如形态不同)不会误判成「存疑」。

支持哪些 macOS 版本和芯片?

macOS 12.0(Monterey)及以上,一套代码覆盖 macOS 12 ~ 26。Apple 芯片和 Intel 都支持,分别下载 arm64 与 x64 的 DMG。

它基于 Electron 40 打包,最低系统版本就是 12.0;之前的 Electron 44 要求 13.0,macOS 12 装不了,所以特意降了下来。

为什么首次打开提示「无法验证开发者」?

因为这是私有自用软件,没有购买开发者签名,macOS 会拦一下。放行一次就好:在「应用程序」里右键 HenryEdu → 「打开」→ 再点「打开」。

也可以执行 xattr -dr com.apple.quarantine /Applications/HenryEdu.app。这不是应用有问题,只是没交签名费。

模型型号为什么会突然失效?

因为厂商下线型号很快。Kimi 的 moonshot-v1 全系、DeepSeek 的 deepseek-v4-flash-vision-exp 都已经下线过。

所以模型目录不是硬编码的,而是「种子 + 一键拉取 /models + 手动添加」。型号报错时,拉一次列表或手动补一个即可。

超纲提醒准不准?会不会误报?

它的原则是宁漏勿误。判据是「知识点标签 × 模型自报」两路交叉,任一方说超纲就算超纲。

两路都判不出时记 unknown,既不提示、也不当作「不超纲」。提醒出现时也不阻断:开题就提示,但孩子照常能拿到完整讲解。孩子升到对应年级后,横幅会撤回、不再说超纲。

交互演示里的数字和图形,一定和讲解一致吗?

不打包票,但有一道闸门:页面要把自己用到的关键量报上来,和讲解文字里已经写出来的数逐项对账,对不上就不显示,并写清哪一项不一致。

探针自检不过、生成超时也会降级为纯文字。图文一致性校验会用组件参数表核对「文字提到的几何要素」与「图里真画的」,对不上就只重画这一步。

如实说:提示词能大幅提高正确率,但不是硬保证。比如模型仍可能把「两段弧」画成整圆。

数据存在哪里?怎么做备份?

默认在 ~/Library/Application Support/HenryEdu/:主库 henryedu.db、Key 密文 credentials.enc、backups/、artifacts/。

应用内按 Cmd+B 或菜单「文件 → 立即备份」可以立即备份,保留最近 14 份。更稳妥的做法是退出应用后,把整个 HenryEdu 目录拷到移动硬盘。

也可以用 HENRYEDU_USER_DATA 指定其他目录,做便携模式或多套档案。

家长模式会限制孩子学习吗?专注模式怎么退出?

家长锁保护的是配置与数据(模型管理、成本、备份、策略、档案),不是学习流程。学习页始终不受限 —— 答案释放是教学设计,不是权限问题。

真正影响孩子怎么学的是静默生效的引导强度策略,比如「解锁完整讲解前必须提交作答」「每日完整讲解上限」。孩子端不显示这些开关。

专注模式是全屏置顶加退出拦截,逃生门是 Cmd+Opt+Esc;终端里用 HENRYEDU_NO_KIOSK=1 open -a HenryEdu 也可以跳过。

孩子说出心理危机相关的话时,它会怎么处理?

心理风险分级在输入侧先用本地规则跑一遍,不等模型生成,分 L0~L3 四级:情绪接纳、倾听引导、模板化回应加转介资源,到明确自伤意图时硬熔断,禁止自由生成。

规则会区分「累死了 / 笑死了」这类夸张用法与真实风险信号。L3 一律模板化输出,并 100% 进家长侧的复核队列。

内置了 12356 / 12355 / 110 / 120 等资源号码;上线前请自行核实,建议每季度复核。

还有其他问题?先看使用文档,隐私相关的细节见隐私说明。