10 分钟跑起来tikuAdapter 题库接口适配器从零到可用的完整指南【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdapter如果你手里有几个不同的题库 API一个免费、一个付费、还有一个自己搞的但你的脚本或系统只认一种返回格式tikuAdapter 就是干这个的——一个题库接口适配器把市面上多家题库源整合成一个统一标准格式的搜题 API你只需对接它一次换题库源时改个参数即可不用重新写解析代码。它解决什么问题适合谁 市面上的搜题接口各回各家请求参数不一样、返回的 JSON 结构也不一样你每接一家题库就得写一套适配代码。tikuAdapter 把这些源icodef、不挂科等免费源以及万能、言溪 enncy、柠檬等付费源统一收敛成一个search接口你 POST 一个题干和选项它返回带答案、答案索引、答案文本的标准结构。写自动答题脚本的同学脚本只对接这一个地址换题库源只需改 URL 参数代码零改动。做教育类工具/小程序的开发省掉对多家题库的重复适配还能用它的管理页面维护自己的本地题库。额外红利所有查过的题会自动沉淀到本地数据库查得越多本地库越全支持把 Word 文档解析导入成自己的题库。跑起来准备与最短启动路径前置条件二选一装了 Go 1.21源码启动或只装了 Docker推荐不用碰 Go 环境。服务固定监听 8060 端口无必配环境变量开箱即用。克隆仓库git clone https://gitcode.com/gh_mirrors/ti/tikuAdapter源码方式进入仓库目录后执行go mod download go run ./cmd/adapter-service或 Docker 方式在仓库目录内先构建镜像再运行docker run -d --name tiku-adapter -p 8060:8060 -v ./data:/app/data tiku-adapter启动后浏览器打开http://localhost:8060即管理后台默认账号admin密码123456搜题接口为 POSThttp://localhost:8060/adapter-service/search请求体传question题干、options选项数组、type1 单选 / 2 填空 / 3 判断 / 4 问答发个请求收到带answerKey的 JSON 就算跑通了。配置关键点讲解⚙️ 配置文件是config.yaml必须放在程序运行的根目录即你执行命令时所在的目录仓库里的 configs/ 目录只是参数模板放在那里不会生效。真正影响运行的项就下面几个配置项作用不填 / 填错的后果limit.enable/duration/requests按 IP 对搜题接口限流默认关闭个人使用别开公网部署不启用可能被供应商接口打爆database.pathSQLite 数据库文件位置留空默认tiku.dbDocker 部署不改成data/tiku.db且不挂载目录容器一删题库数据全丢mysql填连接串后从 SQLite 切换到 MySQL留空则用 SQLite正常连接串写错服务直接起不来api列表接入自定义题库url地址、headers请求头、body用${question}占位、answer用 jsonpath 指明答案在返回体里的位置enable控制开关样例默认enable: falseContent-Type或answer路径写错会请求通但永远解析不到答案recordEmptyAnswer是否把没查到答案的题也记进本地库方便事后手动补题保持默认 false 即可开了会积累一批待整理的空答案记录⏩ 还有一组运行时参数不走配置文件搜题接口的 URL 上加useicodef,wanneng指定用哪些题库不填默认只用免费源付费源再带上对应xxxToken如enncyTokenToken 在各自题库站点购买后获取详见 configs/ 内模板的注释。避坑与常见问题配置文件改了不生效九成是放错了地方——它必须在进程启动目录运行根目录下而不是仓库的configs/里Docker 部署时要用-v ./config.yaml:/app/config.yaml挂进去。8060 端口被占用该端口是写死在 cmd/adapter-service/ 入口代码里的本地源码跑起来前换个进程或停掉占用者Docker 部署可把宿主机侧映射换掉比如把-p改成9000:8060用 9000 访问即可。依赖没拉全go run 报缺包先执行go mod download再启动别直接go run指望它现下。配了付费题库却查不到光写usewanneng不给对应 Token 是不行的每个付费源要带各自的 Token 参数不想付费就只用免费源icodef、buguake。容器重建后本地题库没了SQLite 默认落在容器内根目录务必设database.path: data/tiku.db并挂载./data持久化细节见 deploy/ 文档。下一步去哪看想深入定制按需求找对应目录就行给 tikuAdapter 新增一家题库源参考 internal/search/ 下现有实现比如wanneng.go照着写同目录有测试用例模板。想改管理后台的题库增删改查、日志、用户界面前端代码在 web/。要接微信或对接自有系统的接口清单路由定义在 internal/api/router.go请求/响应模型在 pkg/model/。要改表结构或看懂数据存了啥建表脚本在 sql/tiku.sql。【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdapter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考