这是什么？

这是一个题库适配器，可以将各种的题库接口转换为统一的标准格式，同时这将会是 题库接口的一个规范

市面上有很多题库接口，比如您想要在 【万能】全平台自动答题脚本 使用言溪enncy题库您就可以通过此题库适配器轻松实现。

功能

1.支持多种题库接口输入源

排名顺序为免费优先于付费。

• icodef：icodef 题库
• buguake：不挂科 题库
• wanneng：万能题库
• Tikuhai：题库海题库
• aidian：爱点题库
• enncy：enncy 言溪题库
• lemon：柠檬题库
• 自定义题库

2.支持多种文件自动解析到题库

• Word题库将您的word文档自动解析到本地数据库，方便您的搜索。

3. 支持多种输出源：

• tikuAdapter标准格式 强烈推荐 您为您的软件适配标准格式
• 微信公众号 微信开发者后台填写tikuAdapter的url即可

4.个性化配置

• 自定义请求参数 个性化禁用题库或者配置题库Token
• 搜题接口的限流措施(个人使用一般不需要开启) 配置限流
• 自定义数据库路径：支持在 config.yaml 中配置 SQLite 数据库路径，默认为 tiku.db（Docker 部署建议设置为 data/tiku.db）

  database:
    path: "data/tiku.db"  # 自定义数据库文件路径（Docker部署推荐）

如何部署使用

方式一：下载可执行文件

从 GitHub Releases 下载对应的版本，解压后运行即可

方式二：Docker 部署

构建镜像

docker build -t tiku-adapter .

运行容器

docker run -d \
  --name tiku-adapter \
  -p 8060:8060 \
  -v ./data:/app/data \
  tiku-adapter

推荐方式：使用配置文件

# 在 config.yaml 中设置 database.path: "data/tiku.db"
docker run -d \
  --name tiku-adapter \
  -p 8060:8060 \
  -v ./data:/app/data \
  -v ./config.yaml:/app/config.yaml \
  tiku-adapter

更多 Docker 部署细节请参考 部署文档

使用网页版

直接访问 http://localhost:8060 可以看到网页版，可以实现题库的增删改查，日志记录等功能。

默认账号为 admin 密码123456

使用API接口

POST http://localhost:8060/adapter-service/search

请求体

{
  "question": "违反安全保障义务责任属于（）",
  "options": [
    "公平责任",
    "特殊侵权责任",
    "过错推定责任",
    "连带责任"
  ],
  "type": 1 // 单选0多选1填空2判断3问答4
}

URL 请求参数

参数	描述	是否必须	示例值	Token获取方式
use	你想要使用哪些题库,不填写默认使用所有免费题库	否	local,icodef,buguake,wanneng
wannengToken	万能付费题库的Token值(10位)	否	E196FD8B49	https://lyck6.cn/pay
icodefToken	Icodef 题库Token值	否	UafYcHViJMGzSVNh	关注微信公众号"一之哥哥"发送"token"获取
enncyToken	enncy 题库Token值	否	a21ae2403b414b94b512736c30c69940	https://tk.enncy.cn
aidianYToken	爱点题库(亿级题库API)Token值	否	cvor7f3HxZ7nF2M3ljmA	https://www.51aidian.com
lemonToken	柠檬题库 Token值	否	8a3debe92e2ba83d6786e186bef2a424	https://www.lemtk.xyz
tikuhaiToken	题库海题库 Token值	否	Cardabcde1MdljoZk4l4E47NaAK	https://shop.tikuhai.com/links/2C63E8E8

例如您想使用万能题库和icodef题库，您的url应为http://localhost:8060/adapter-service/search?use=wanneng,icodef&icodefToken=UafYcHViJMGzSVNh

响应示例

{
  "plat": 0,
  "question": "违反安全保障义务责任属于（）",
  "options": [
    "公平责任",
    "特殊侵权责任",
    "过错推定责任",
    "连带责任"
  ],
  "type": 1,
  "answer": {
    "answerKey": [
      "B",
      "C"
    ],
    "answerKeyText": "BC",
    "answerIndex": [
      1,
      2
    ],
    "answerText": "特殊侵权责任#过错推定责任",
    "bestAnswer": [
      "特殊侵权责任",
      "过错推定责任"
    ],
    "allAnswer": [
      [
        "特殊侵权责任",
        "过错推定责任"
      ],
      [
        "A特殊侵权责任",
        "B过错推定责任"
      ]
    ]
  }
}

如何贡献

提出您的issue

将您的题库接口提issue我们为您增加上去。

提出您的pr

您可以参与开发，提交pr。

• 您可以参考 internal/search/wanneng.go 来实现 internal/search/search.go接口
• 编写 internal/search/search_test.go 来测试您的接口

贡献者

谢谢以下开源贡献者～