Math ATI 加油站

本包提供本地运行的数学 ATI 学习闭环：章节知识点覆盖、易错题修复、能力评估、纸质试卷打印、PDF 批改和掌握状态回写。

安装与初始化

npm install -g @zhouchangui/math-ati
mkdir my-math-ati
cd my-math-ati
math-ati init

初始化会创建本地 data/ 和 .env.local。编辑 .env.local，填入 LLM 推理地址、模型和 API Key。

math-ati start --open

默认启动地址是 http://127.0.0.1:4173。

常用命令

math-ati init [workspace]
math-ati start [workspace] --open --port 4173
math-ati doctor [workspace]

开发运行目录

开发模式下运行 npm run dev 时，默认使用 $HOME/math-ati-workspace 作为本地工作目录。也可以用一个变量指定其它目录：

MATH_AGENT_WORK_DIR=$HOME/my-math-ati npm run dev

• 数据、试卷、上传文件和生成缓存写入 $HOME/math-ati-workspace/data
• LLM 配置读取和写入 $HOME/math-ati-workspace/.env.local

数据边界

data/ 是本地孩子档案、练习、批改和掌握状态，不会随 npm 包发布。包内只包含干净的初始化模板、服务端、前端构建产物和提示词。

教材原始图片与完整课程资源应通过独立资源包安装到本地 workspace，再由 MATH_AGENT_IMAGE_ROOT 指向资源目录。