壹
三种问法
同一套匹配逻辑,三个入口。题在屏幕上,就让手机自己看;题在手边,就念给它听。
无障碍
自动取词
开启无障碍服务后,页面稳定即读取题目节点文字,命中后浮层给出答案。
OCR
拍照 / 截屏
拍下题目,或用录屏截图,ML Kit 中文识别成文字再匹配。识别不准会直说没找到,不硬凑。
输入
文字搜题
手打题干与选项,走同一套比对。适合题源在纸上、或在另一台设备上。
贰
试一次
下面是官网直连的接口,输入题干(可带选项),它会在内置题库里找最像的一道,并给出把握有多大。
题目越完整越准;只给半句时,会返回候选与匹配度。
叁
接口
这一页的问答就是它算出来的。接口对公众开放,无需密钥;请克制调用,别把山问塌了。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/health | 健康检查,含题库与题量 |
| GET | /api/v1/banks | 题库列表(题量、大小、校验和、下载地址) |
| GET | /api/v1/banks/{id} | 题库题目,分页 ?limit=50&offset=0 |
| GET | /api/v1/banks/{id}/download | 整份题库 JSON 下载(带 ETag) |
| POST | /api/v1/ask | 输入题干与选项,返回答案与候选 |
| POST | /api/v1/debug | 上报调试信息(崩溃、识别失败等) |
| POST | /api/v1/auth/sms/send | 发送登录验证码 |
| POST | /api/v1/auth/sms/login | 验证码登录 |
| POST | /api/v1/auth/password/login | 密码登录 |
| GET | /api/v1/me | 当前账号(需 Authorization: Bearer) |
问一题:
curl -s https://question.buzhoushan.studio/api/v1/ask \
-H 'Content-Type: application/json' \
-d '{"title":"女性一生中,哪个生理阶段时间最长()","options":["儿童期","青春期","性成熟期","围绝经期","老年期"]}'
{
"ok": true,
"matched": true,
"best": {
"id": "1000:41", "bankId": 1000, "bankName": "医务人员“三基”训练指南(临床分册·下册)",
"title": "女性一生中,哪个生理阶段时间最长()",
"options": ["儿童期", "青春期", "性成熟期", "围绝经期", "老年期"],
"answer": "C", "answerTexts": ["性成熟期"], "score": 1.0
},
"candidates": [ ... ]
}
上报一条调试信息:
curl -s https://question.buzhoushan.studio/api/v1/debug \
-H 'Content-Type: application/json' \
-d '{"device":"Pixel 7","version":"1.1.8","level":"warn","kind":"ocr_fail","message":"未识别到题干"}'
登录(不周山工坊账号,与巡山、映山同一套):
curl -s https://question.buzhoushan.studio/api/v1/auth/sms/send \
-H 'Content-Type: application/json' -d '{"phone":"13800000000"}'
curl -s https://question.buzhoushan.studio/api/v1/auth/sms/login \
-H 'Content-Type: application/json' -d '{"phone":"13800000000","code":"123456"}'
肆
题库
与 App 内置题库同源,可整份下载。格式是一组题目对象,字段:type、title、options、answer、analysis、chapter_id。
正在读题库…
伍
如实边界
只在题库里找
题库里没有的题,它就说没有。候选与匹配度一起给你,由你判断信不信。
不替你答题
它是查题工具,不是学习替身。答案给你,怎么用是你的事。
调试信息由你决定
只有在你主动上报时,才会把那段文字发上来;不上报就没有记录。
官网与接口都不保存你问过什么;调试上报的内容按天落在服务器上,仅用于修 bug。