---
title: ai-mistake-doctor
canonical_url: "https://www.modelscope.cn/studios/qingyuanspace/ai-mistake-doctor"
md_url: "https://www.modelscope.cn/studios/qingyuanspace/ai-mistake-doctor.md"
repository: qingyuanspace/ai-mistake-doctor
chinese_name: "AI错题诊疗室"
last_updated: 2026-10-06
sdk_type: streamlit
sdk_version: 6.17.3
downloads: 0
stars: 1
---

# ai-mistake-doctor

> ai-mistake-doctor - qingyuanspace 在 ModelScope 创建的在线 Demo。面向中学生的AI错题诊疗应用：拍照上传错题，AI即时诊断考点/错因/知识点，自动建档并生成学情统计（错因分布、知识点雷达图）。2026 JDXplorers 未来青少年AI探索者计划参赛作品（主题一·AI原点）。

qingyuanspace/ai-mistake-doctor 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 streamlit 6.17.3 构建，中文名为「AI错题诊疗室」。

- **Repository**: qingyuanspace/ai-mistake-doctor
- **SDK**: streamlit
- **SDK version**: 6.17.3
- **Downloads**: 0
- **Stars**: 1
- **Last updated**: 2026-10-06

Source: https://www.modelscope.cn/studios/qingyuanspace/ai-mistake-doctor

---

# AI错题诊疗室 · 云端部署说明（v10.3 · 病历卡对齐）

> 本目录是**可直接部署**的作品副本（展示版，无需联网、无需 API Key 也能看完整演示效果）。
> 把本目录内容发布到云端平台，其他人就能通过网址访问使用。


## 在线体验地址

**https://qingyuanspace-ai-mistake-doctor.ms.show**

（ModelScope 创空间，免费、免安装；手机 / 电脑浏览器直接打开，或扫分享卡上的二维码。）

## 版本特性

- **v10.3（本次）·「病历卡」就诊疗程全记录**：每道错题新增「就诊日期 / 题目 / 考点 / 知识点 / 主错因 / 次错因 / 处方 / 变式题得分 / 掌握状态」结构化病历卡，学习疗程可追踪、可复诊；诊断新增「❓ 为什么错」，「💡 怎么改」升级为「💊 处方」，分步讲解升级为启发式引导；
- **v10.1 · 现场诊断支持文档上传**：PDF / Word / TXT 多方式上传题目；
- **v10 · 新增「🎯 练习处方」栏目（第六个栏目）**：三档难度分级引擎（基础 / 中等 / 挑战）+ 判定理由 + 每日 3 题处方 +「已掌握」自动标记，错题本汇总表与详情卡同步带上推荐难度徽章。

六栏目：🏠 首页演示 · 🔍 现场诊断 · 📚 错题本 · 🎯 练习处方 · 🎮 闯关学习 · 📖 知识宝典。

部署方式不变：把本目录内容覆盖上传到 Streamlit Cloud / ModelScope 创空间即可（只传 app.py 也行，其余文件与线上相同）。本地验证：`pip install -r requirements.txt` 后执行 `streamlit run app.py`，浏览器打开即可零 Key 看完整演示。

## 目录内容

```
repo_live2/（线上部署副本）
├── app.py                    # 主应用（v10.3：六栏目 + 病历卡 + 现场诊断拍照/文档上传 + 三档练习处方）
├── geo_figs.py               # 数形结合 SVG 示意图模块（柱状图 / 雷达图）
├── mistake_book_demo.json    # 演示错题本（真实 AI 诊断结果，离线可看）
├── 错题演示_1~4_*.jpg         # 4 张示例错题素材（首页演示与上传测试用）
├── 学情_知识点雷达.png         # 学情统计图
├── 学情_错因分布.png
├── requirements.txt          # 依赖清单
└── .streamlit/               # 服务配置 + API Key 配置模板
```

---

## 方式一：Streamlit Community Cloud（推荐，免费）

官网：https://streamlit.io/cloud

1. **准备 GitHub 账号**：把本目录内容上传到一个 GitHub 仓库（Public 或 Private 均可）；
2. **登录 Streamlit Cloud**：用 GitHub 账号登录 https://share.streamlit.io 或 https://streamlit.io/cloud；
3. **创建 App**：点「New app」→ 选择刚才的仓库 → 主文件填 `app.py`；
4. **配置 Key（可选）**：如果想让评委能**现场诊断**新错题，在 App 的 Settings → Secrets 里填：
   ```
   ARK_API_KEY = "你的豆包APIKey"
   ```
   不填也没关系——展示页本身不需要 Key 就能完整展示作品效果；
5. **Deploy**：等 1–2 分钟构建完成，就能得到一个公开网址，发给谁都能访问。

---

## 方式二：ModelScope 创空间（国内访问更快）

官网：https://modelscope.cn （阿里系平台，需手机号注册）

1. 注册登录后，进入「创空间」→「创建创空间」；
2. 应用类型选 **Streamlit**，把本目录代码上传/推送到创空间仓库；
3. 在「设置 → 环境变量」里配置 `ARK_API_KEY`（可选，同方式一）；
4. 发布后生成 `https://modelscope.cn/studios/你的账号/xxx` 链接。

---

## 想部署"完整诊断版"（评委可现场用）？

展示版是**零依赖、最稳定**的选择。如果希望访问者能直接上传错题得到 AI 诊断：

1. 从项目主仓库取 `w3_diagnose_save.py`（完整诊断版入口脚本），放进本目录；
2. 在云端 Secrets / 环境变量配置 `ARK_API_KEY`（豆包 API Key）；
3. 把入口改成 `w3_diagnose_save.py`，或新建 `app.py` 做一个"展示 + 诊断"双入口导航。

> ⚠️ 任何情况下都**不要把真实 API Key 写进代码**，只用云端 Secrets / 环境变量。