最近在做項(xiàng)目的時(shí)候發(fā)現(xiàn)團(tuán)隊(duì)內(nèi)部的 API 文檔越來越多，每個(gè)服務(wù)都有自己的 Swagger 頁面，來回切換非常麻煩。于是我花了 3 個(gè)小時(shí)，用 Cursor（眾人皆知的 AI 輔助編程工具）做了一個(gè)項(xiàng)目：Swagger Master。

這是什么？

一個(gè)單文件的 Swagger UI 管理器，可以在一個(gè)頁面里管理多個(gè) OpenAPI 文檔。沒錯(cuò)，就是一個(gè) HTML 文件搞定所有事情。

圖片

看到上面這個(gè)截圖，你可能會說："這不就是個(gè)帶下拉框的 Swagger UI 嗎？"

沒錯(cuò)！就是一個(gè)簡單的下拉框切吧切吧就行了，搞那么復(fù)雜干嘛。

為什么要做這個(gè)？

• 受夠了在不同的 Swagger 頁面之間切換
• 不想部署一個(gè)重量級的API管理系統(tǒng)（在 GitHub 也沒找到）
• 想要一個(gè)隨處可用，維護(hù)簡單的解決方案

怎么用？

1. 下載 index.html

2. 配置你的 API 列表：

const API_LIST = [
    {
        name: 'Your API Name',
        url: 'https://your-api-url/openapi.json'
    }
    // 添加更多 API...
];

3. 部署到任意靜態(tài)服務(wù)器

就這么簡單。

開發(fā)感想

本來以為要寫很多代碼，結(jié)果在 Cursor 的幫助下，整個(gè)開發(fā)過程出奇順利。中間雖然遇到了一些樣式和兼容性問題，但是在 AI 的幫助下都很快解決了。整個(gè)項(xiàng)目只用了一個(gè)文件就實(shí)現(xiàn)了所有功能，這讓部署和維護(hù)變得超級簡單。而且界面還挺好看的（程序員眼中的美就是那么樸實(shí)無華），不是嗎？

AI 幫我做了什么？

1. 從零寫所有的代碼
2. 修復(fù)調(diào)試開發(fā)過程中的所有錯(cuò)誤
3. 生成項(xiàng)目介紹，中英文
4. 生成項(xiàng)目 Logo，用 svg 就行，別的圖片格式它干不了
5. 生成代碼提交的日志
6. 幫忙寫這個(gè)博客（主要是搭結(jié)構(gòu)，潤色和人類的冷笑話它不擅長）

AI 輔助開發(fā)

未來的開發(fā)模式一定會變化的，AI 不是在替代程序員，而是在幫助我們更快地實(shí)現(xiàn)想法。

用 IDE 的我們年輕的時(shí)候會羨慕用 notepad 徒手寫代碼的大神，后來我笑了，為啥大神這么喜歡用 notepad？都是裝的，如果不是裝的，就是大神已經(jīng)固化了，不愿意接受新的思維和新的工具。

你說你會凌波微步可以走路到美國，難道我有錢坐飛機(jī)去你不該反思一下自己嗎？

另外，Copilot 這樣的 AI 輔助工具相對于 Cursor 還是太弱了，因?yàn)?Copilot 只能在一個(gè)文件上輔助你，你還是需要去思考改哪個(gè)文件，改哪個(gè)位置。Cursor 才是未來 AI 輔助編程的樣子，你是老板，你下命令，它打工。但是千萬要記得，AI 和絕大數(shù)人類一樣，如果你不監(jiān)督或者你沒能力監(jiān)督，它就開始糊弄你，打鐵還是自身硬，沒能力玩火就不要玩火。

用不了多久，我們會覺得沒有 AI 輔助的編程就像現(xiàn)在寫代碼時(shí)沒有代碼補(bǔ)全一樣難受，信不信由你。

項(xiàng)目地址：https://github.com/tobyqin/swagger-master