最近在做项目的时候发现团队内部的 API 文档越来越多,每个服务都有自己的 Swagger 页面,来回切换非常麻烦。于是我花了 3 个小时,用 Cursor(众人皆知的 AI 辅助编程工具)做了一个项目:Swagger Master。
这是什么?
一个单文件的 Swagger UI 管理器,可以在一个页面里管理多个 OpenAPI 文档。没错,就是一个 HTML 文件搞定所有事情。
图片
看到上面这个截图,你可能会说:"这不就是个带下拉框的 Swagger UI 吗?"
没错!就是一个简单的下拉框切吧切吧就行了,搞那么复杂干嘛。
为什么要做这个?
- 受够了在不同的 Swagger 页面之间切换
- 不想部署一个重量级的API管理系统(在 GitHub 也没找到)
- 想要一个随处可用,维护简单的解决方案
怎么用?
1. 下载 index.html
2. 配置你的 API 列表:
3. 部署到任意静态服务器
就这么简单。
开发感想
本来以为要写很多代码,结果在 Cursor 的帮助下,整个开发过程出奇顺利。中间虽然遇到了一些样式和兼容性问题,但是在 AI 的帮助下都很快解决了。整个项目只用了一个文件就实现了所有功能,这让部署和维护变得超级简单。而且界面还挺好看的(程序员眼中的美就是那么朴实无华),不是吗?
AI 帮我做了什么?
- 从零写所有的代码
- 修复调试开发过程中的所有错误
- 生成项目介绍,中英文
- 生成项目 Logo,用 svg 就行,别的图片格式它干不了
- 生成代码提交的日志
- 帮忙写这个博客(主要是搭结构,润色和人类的冷笑话它不擅长)
AI 辅助开发
未来的开发模式一定会变化的,AI 不是在替代程序员,而是在帮助我们更快地实现想法。
用 IDE 的我们年轻的时候会羡慕用 notepad 徒手写代码的大神,后来我笑了,为啥大神这么喜欢用 notepad?都是装的,如果不是装的,就是大神已经固化了,不愿意接受新的思维和新的工具。
你说你会凌波微步可以走路到美国,难道我有钱坐飞机去你不该反思一下自己吗?
另外,Copilot 这样的 AI 辅助工具相对于 Cursor 还是太弱了,因为 Copilot 只能在一个文件上辅助你,你还是需要去思考改哪个文件,改哪个位置。Cursor 才是未来 AI 辅助编程的样子,你是老板,你下命令,它打工。但是千万要记得,AI 和绝大数人类一样,如果你不监督或者你没能力监督,它就开始糊弄你,打铁还是自身硬,没能力玩火就不要玩火。
用不了多久,我们会觉得没有 AI 辅助的编程就像现在写代码时没有代码补全一样难受,信不信由你。
项目地址:https://github.com/tobyqin/swagger-master