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

這是什么？

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

圖片

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

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

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

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

怎么用？

1. 下載 index.html

2. 配置你的 API 列表：

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

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

就這么簡(jiǎn)單。

開(kāi)發(fā)感想

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

AI 幫我做了什么？

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

AI 輔助開(kāi)發(fā)

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

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

你說(shuō)你會(huì)凌波微步可以走路到美國(guó)，難道我有錢坐飛機(jī)去你不該反思一下自己?jiǎn)幔?/p>

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

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

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