# qhshuati

**Repository Path**: qhgiteecode/qhshuati

## Basic Information

- **Project Name**: qhshuati
- **Description**: ~~~~~~~~~~~~~~~
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ACP 大模型考试刷题小程序

面向 ACP 大模型考试的本地刷题工具。题库 1459 道（单选 944 + 多选 515），
所有数据保存在本机 `wx.storage`，无需登录、无需联网。

## 如何运行

1. 打开微信开发者工具，新建项目 → 选择本目录
2. AppID 选「测试号」（`project.config.json` 里已经填好 `touristappid`）
3. 点编译，模拟器或真机预览都能跑

## 目录结构

```
app.js / app.json / app.wxss     全局入口和样式
project.config.json              小程序项目配置
sitemap.json                     搜索索引配置
utils/
  data.js                        题库（1459 道，CommonJS 格式）
  qbank.js                       题库服务：加载 / 组卷 / 判分
  storage.js                     本地存储封装：错题本 / 收藏 / 统计 / 考试记录
  wxs/helper.wxs                 WXML 里用的小工具
pages/
  home/        首页（快速入口 + 打卡统计）
  bank/        题库（顺序 / 随机 / 单选 / 多选）
  exam/        模考入口（开始考试 + 历次成绩）
  mine/        我的（设置 / 关于 / 清空数据）
  practice/    通用答题页（刷题 6 种模式共用）
  exam-paper/  考试答题页（倒计时 + 答题卡）
  exam-result/ 考试结果页（成绩 + 错题回顾）
  wrong/       错题本
  favorite/    收藏夹
  report/      学习报告（图表）
```

## 功能清单

### 刷题模式
- 顺序练习：从第 1 题开始，断点续做
- 随机练习：全库 Fisher-Yates 洗牌
- 只练单选 / 只练多选
- 错题重练：按最近出错时间排序，连对 2 次自动移出
- 我的收藏：自由收藏，随时练习

### 做题交互
- 单选点选即判，可设置答对自动下一题
- 多选需确认后判定
- 实时显示解析（带左侧蓝色竖线样式）
- 手势左右滑动切题
- 题干长按复制
- 答题卡抽屉，支持跳转和看题目状态

### 模拟考试
- 50 单 + 25 多，限时 60 分钟
- 单选 1 分，多选 2 分（错选漏选都不得分）
- 60 分及格
- 组卷自动避开最近 3 次考过的题
- 作答时不显示对错，交卷后统一判分
- 到时自动交卷；中途可交卷
- 成绩页展示单选得分 / 多选得分 / 用时 / 错题回顾

### 数据统计
- 累计答题数 / 总正确率 / 单选多选分开的正确率
- 连续打卡天数
- 近 7 天做题量柱状图（原生 canvas 绘制）
- 最近 10 次模考成绩折线图（带 60 分参考线）
- 薄弱题 Top 10（错 2 次以上还没消灭的）

### 其他
- 单选答对自动下一题（可在「我的」关掉）
- 一键清空所有数据

## 本地存储结构

所有数据在 `wx.storage`，key 定义在 `utils/storage.js`：

- `progress` — 顺序练习进度
- `wrongBook` — 错题本，含错次和连对次数
- `favorites` — 收藏列表
- `answerLog` — 每题历史答题记录
- `dailyStats` — 每日做题量（用于打卡和柱状图）
- `examHistory` — 模考记录
- `recentExamSeqs` — 最近 3 次模考用过的题 seq，用于去重
- `settings` — 本地设置

## 题库数据格式

```js
{
  seq: "0001",              // 题号
  type: 0 | 1,              // 0 单选 / 1 多选
  stem: "题干...",
  options: [                // 选项
    { option_label: "A", option_text: "..." },
    ...
  ],
  answer: "A,C,D",          // 正确答案（逗号分隔）
  analysis: "解析...",
  image: "data:image/png;base64,..."  // 可选，只有 1 道题带图
}
```

## 后续可加的功能

- 夜间模式
- 字号切换
- 考试结果分享海报
- 题干关键字搜索
- 每日推题（推荐 10 道题做）