Swagger Master - AI 幫我做的第一個開源項目
最近在做項目的時候發現團隊內部的 API 文檔越來越多,每個服務都有自己的 Swagger 頁面,來回切換非常麻煩。于是我花了 3 個小時,用 Cursor(眾人皆知的 AI 輔助編程工具)做了一個項目:Swagger Master。
這是什么?
一個單文件的 Swagger UI 管理器,可以在一個頁面里管理多個 OpenAPI 文檔。沒錯,就是一個 HTML 文件搞定所有事情。
圖片
看到上面這個截圖,你可能會說:"這不就是個帶下拉框的 Swagger UI 嗎?"
沒錯!就是一個簡單的下拉框切吧切吧就行了,搞那么復雜干嘛。
為什么要做這個?
- 受夠了在不同的 Swagger 頁面之間切換
- 不想部署一個重量級的API管理系統(在 GitHub 也沒找到)
- 想要一個隨處可用,維護簡單的解決方案
怎么用?
1. 下載 index.html
2. 配置你的 API 列表:
const API_LIST = [
{
name: 'Your API Name',
url: 'https://your-api-url/openapi.json'
}
// 添加更多 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