Swagger Master - AI 幫我做的第一個開源項目
最近在做項目的時候發(fā)現(xiàn)團隊內(nèi)部的 API 文檔越來越多，每個服務都有自己的 Swagger 頁面，來回切換非常麻煩。于是我花了 3 個小時，用 Cursor（眾人皆知的 AI 輔助編程工具）做了一個項目：Swagger Master。
這是什么？
一個單文件的 Swagger UI 管理器，可以在一個頁面里管理多個 OpenAPI 文檔。沒錯，就是一個 HTML 文件搞定所有事情。
圖片
看到上面這個截圖，你可能會說："這不就是個帶下拉框的 Swagger UI 嗎？"
沒錯！就是一個簡單的下拉框切吧切吧就行了，搞那么復雜干嘛。
為什么要做這個？
- 受夠了在不同的 Swagger 頁面之間切換
- 不想部署一個重量級的API管理系統(tǒng)（在 GitHub 也沒找到）
- 想要一個隨處可用，維護簡單的解決方案
怎么用？
1. 下載 index.html
2. 配置你的 API 列表：
const API_LIST = [
{
name: 'Your API Name',
url: 'https://your-api-url/openapi.json'
}
// 添加更多 API...
];3. 部署到任意靜態(tài)服務器
就這么簡單。
開發(fā)感想
本來以為要寫很多代碼，結(jié)果在 Cursor 的幫助下，整個開發(fā)過程出奇順利。中間雖然遇到了一些樣式和兼容性問題，但是在 AI 的幫助下都很快解決了。整個項目只用了一個文件就實現(xiàn)了所有功能，這讓部署和維護變得超級簡單。而且界面還挺好看的（程序員眼中的美就是那么樸實無華），不是嗎？
AI 幫我做了什么？
- 從零寫所有的代碼
- 修復調(diào)試開發(fā)過程中的所有錯誤
- 生成項目介紹，中英文
- 生成項目 Logo，用 svg 就行，別的圖片格式它干不了
- 生成代碼提交的日志
- 幫忙寫這個博客（主要是搭結(jié)構(gòu)，潤色和人類的冷笑話它不擅長）
AI 輔助開發(fā)
未來的開發(fā)模式一定會變化的，AI 不是在替代程序員，而是在幫助我們更快地實現(xiàn)想法。
用 IDE 的我們年輕的時候會羨慕用 notepad 徒手寫代碼的大神，后來我笑了，為啥大神這么喜歡用 notepad？都是裝的，如果不是裝的，就是大神已經(jīng)固化了，不愿意接受新的思維和新的工具。
你說你會凌波微步可以走路到美國，難道我有錢坐飛機去你不該反思一下自己嗎？
另外，Copilot 這樣的 AI 輔助工具相對于 Cursor 還是太弱了，因為 Copilot 只能在一個文件上輔助你，你還是需要去思考改哪個文件，改哪個位置。Cursor 才是未來 AI 輔助編程的樣子，你是老板，你下命令，它打工。但是千萬要記得，AI 和絕大數(shù)人類一樣，如果你不監(jiān)督或者你沒能力監(jiān)督，它就開始糊弄你，打鐵還是自身硬，沒能力玩火就不要玩火。
用不了多久，我們會覺得沒有 AI 輔助的編程就像現(xiàn)在寫代碼時沒有代碼補全一樣難受，信不信由你。
項目地址：https://github.com/tobyqin/swagger-master
