WenShan · 问山搜题

叩一声,山有回应

用无障碍取词或 OCR 读到你正在做的题,在本地题库里比对,直接把答案浮在屏幕上。
不绕圈子,不装作全知。

壹

三种问法

同一套匹配逻辑,三个入口。题在屏幕上,就让手机自己看;题在手边,就念给它听。

无障碍

自动取词

开启无障碍服务后,页面稳定即读取题目节点文字,命中后浮层给出答案。

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。