tikuAdapter 快速上手教程:3 步跑通一个统一的题库 API
tikuAdapter 快速上手教程3 步跑通一个统一的题库 API【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdaptertikuAdapter 是一个题库接口适配器把各家题库 API 整合成一个标准 API。读完本文你能在自己的机器上完成题库接口适配器的安装把服务跑起来并准确知道配置里要改哪几个字段。为什么需要题库接口适配器市面上万能、icodef、不挂科等题库接口各有各的请求方式和返回结构题库 API 对接的麻烦在于你的答题脚本想用几家题库就得为每家单独写一遍适配代码。tikuAdapter 就是中间的翻译官你按标准格式发一次请求它同时查多家题库再统一返回答案含 answerKey、bestAnswer 等字段客户端只对接这一种格式即可。顺带还内置本地题库搜题记录可以存进数据库Word 等文件也能解析后批量导入。最快启动路径3 步把服务跑起来 第一步拿到代码git clone https://gitcode.com/gh_mirrors/ti/tikuAdapter第二步构建并运行。有 Docker 的话在仓库根目录执行两条命令即可docker build -t tiku-adapter .docker run -d --name tiku-adapter -p 8060:8060 tiku-adapter不想用 Docker也可以直接去项目 Release 页面下载对应系统的可执行文件解压后运行。第三步验证。浏览器访问http://localhost:8060打开网页管理界面默认账号admin、密码123456。能登录就说明服务已经跑通。读懂目录每个文件夹负责什么打开仓库根目录先认这几个文件夹文件夹一句话职责cmd/启动入口adapter-service就是主服务程序configs/配置模板config.yaml与完整参数说明internal/核心逻辑API 路由、控制器、题库管理、答案采集internal/search/各家题库的适配器实现一个题库一个文件pkg/通用工具日志、限流、JWT、错误码web/Vue 前端源码构建网页管理界面sql/数据库建表脚本deploy/部署文档后续想深入看代码从 cmd/ 和 configs/ 入手就能看懂大半。配置只改这几处⚙️ 在可执行文件同目录放一份config.yaml程序会自动读取没有也会以默认配置启动所以可以先不动配置直接跑。tikuAdapter 配置真正要动的其实只有几个字段limit.enable搜题接口限流开关个人使用保持false部署到公网建议开启并调整duration、requestsdatabase.pathSQLite 数据库文件路径。Docker 部署时设成data/tiku.db并挂载./data目录避免容器重建丢数据database: path: data/tiku.dbapi想接自己的第三方题库时在这里写url、method、body、answer并把enable改为true即生效recordEmptyAnswer没搜到答案的记录是否也入库方便后期手动整理题库时打开下一步从跑通到用上✅ 服务起来后建议按这个顺序试一遍向POST /adapter-service/search发一道题请求体带question、options、type0 单选 / 1 多选 / 2 填空 / 3 判断 / 4 问答URL 上加?usewanneng,icodef指定要用的题库再拼上对应题库的 Token 参数即可启用付费源手里有 Word 题库文件传到/adapter-service/parser解析入库本地搜题命中更快想自己新增一个题库源参考 internal/search/ 里任意一个文件实现search.go中的接口即可常见问题启动失败或行为异常先检查config.yaml的 YAML 语法缩进、引号Docker 容器重建后题库数据没了确认挂载了./data且设置了database.path某题库总返回空答案在 URL 参数里补上该题库的 Token或打开recordEmptyAnswer留记录排查还是解决不了到项目的 Issues 页面搜索或提一个附上你的配置片段和报错日志【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdapter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考