把多家题库统一成一个 APItikuAdapter 安装与对接完整指南【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdaptertikuAdapter 是一个用 Go 写的题库接口适配器把多个网课平台的搜题 API 聚合成一个标准接口附带内置 Web 管理端。适合做自动答题脚本、网课助手或需要对接多家题库的开发者读完你能在 5 分钟内跑起服务并完成第一次搜题。核心能力速览在动手之前先明确它能替你解决什么多题库聚合已内置 icodef、buguake、万能、题库海、爱点、enncy、柠檬等题库输出统一的标准 JSON 结构你的程序只需对接一次。自定义题库零代码接入用几行 YAML 就能声明任意第三方搜题接口不必写 Go 代码。自建本地题库上传 Word 题库文件即可自动解析入库本地命中可补齐外部库的缺口。内置 Web 管理端题库增删改查、用户管理、搜索日志查看默认监听 8060 端口。搜索自动落库每次搜题的结果会记录到数据库长期运行可沉淀成你自己的私有题库。五分钟跑起来从克隆到第一次搜题获取代码git clone https://gitcode.com/gh_mirrors/ti/tikuAdapter cd tikuAdapter环境要求 Go 1.21 及以上、Node.js 18 及以上。这里有个关键点主程序通过go:embed把前端静态文件打进二进制里所以必须先构建web/前端否则直接编译失败——这是新手最常卡住的一步。构建前端并启动服务bash buildweb.sh go mod download go run ./cmd/adapter-servicebuildweb.sh会把前端产物输出到cmd/adapter-service/dist。成功的标志是控制台出现 gin 监听 0.0.0.0:8060 的日志浏览器打开 http://localhost:8060 能看到登录页默认账号 admin密码 123456。验证搜题接口curl -X POST http://localhost:8060/adapter-service/search \ -H Content-Type: application/json \ -d {question:违反安全保障义务责任属于,type:1}响应里出现answerKey、answerText字段说明题库链路已经通了。不传use参数时默认查询所有免费题库。习惯容器化部署的话仓库自带的 Dockerfile 可以直接用docker build -t tiku-adapter .构建后以docker run -d --name tiku-adapter -p 8060:8060 -v ./data:/app/data tiku-adapter启动数据库落在挂载的 data 目录里。config.yaml 里最关键的几项配置文件放在程序运行目录即可启动时自动读取无需命令行指定。下面只讲真正影响行为的几项统一按不配会怎样 / 配了能做什么来说database.pathSQLite 文件路径。不配会怎样——默认创建在程序目录下的tiku.db本地没问题容器重建就丢了配了能做什么——建议 Docker 部署时指定data/tiku.db并挂载卷数据可持久化。mysqlMySQL 连接 DSN也可用环境变量SQL_DSN指定。不配会怎样——默认用 SQLite零外部依赖配了能做什么——适合多实例共享同一份题库数据的场景。limit按 IP 限流含时间窗口duration与窗口内允许的请求数requests。不配会怎样——默认关闭个人使用足够配了能做什么——防止恶意流量打爆题库配额。api自定义外部题库。不配会怎样——只有内置题库可用配了能做什么——每个条目声明url、method、headers、body、answer五个字段body里用${question}占位符填题answer用 jsonpath 指向响应中的答案位置把enable置为 true 即接入。recordEmptyAnswer是否记录搜题未命中。不配会怎样——默认 false只存命中的题配成 true 后空答案也入库方便后期手动整理补题。最小可用配置示例database: path: data/tiku.db limit: enable: false recordEmptyAnswer: true目录速查表目录职责cmd/adapter-service/主入口加载内嵌前端并启动 gin 服务configs/示例配置与配置结构定义internal/search/各题库搜题 API 的实现新增题库在这里internal/controller/、internal/api/路由定义与接口处理逻辑internal/dao/、internal/entity/GORM 生成的数据库访问层pkg/JWT、限流、日志等通用工具web/Vue 前端管理端源码sql/表结构定义 SQL常见卡点与下一步编译报找不到 dist 目录前端没构建先执行bash buildweb.sh再编译主程序。付费题库查不到答案token 要通过 URL 查询参数传入例如?usewannengwannengToken你的token不传use只会走免费题库。某题外部库查不到把对应 Word 题库文件从 Web 端上传本地库可以兜底。想接入新题库在internal/search/里实现统一的 Search 接口参考现有实现并配测试用例验证即可。更多细节可以看仓库内的 README仍有疑问也可以去项目 issue 区向开发者提问。【免费下载链接】tikuAdapter大学生网课题库接口适配器将不同的题库整合为一个API接口。项目地址: https://gitcode.com/gh_mirrors/ti/tikuAdapter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
