一次不可能的 Hugo 升級:當 AI 助理 Manus 接管戰場
「這不可能。」
當我看到 hugo server 命令噴出滿屏的錯誤時,腦海裡只剩下這四個字。我的博客停留在 Hugo 0.133.0 版本已經很久了,最近想升級到最新的 0.157.0,結果發現這簡直是一場災難。
版本跳躍太大,跨越了幾十個版本,API 變更、主題不兼容、SCSS 編譯器從內置變為外部依賴……每一個問題都像一座大山,橫亙在我面前。我花了一個下午,嘗試修復了幾個錯誤,但新的錯誤又不斷湧現,彷彿永無止境。我意識到,這可能需要我花上好幾天,甚至一周的時間,才能勉強完成。
就在我準備放棄,打算回退到舊版本時,我突然想起了我的 AI 助理——Manus。
把戰場交給 AI
我抱著試一試的心態,把需求告訴了 Manus:「我有一個用 Hugo 0.133.0 做的博客網站,你能幫我遷移到最新的 Hugo 0.157.0 版本嗎?」
接下來發生的事情,徹底顛覆了我的認知。

Manus 並沒有立刻開始寫代碼,而是先像一個經驗豐富的開發者一樣,向我了解項目的基本情況:倉庫地址、使用的主題、有沒有遇到特定的錯誤。在拿到我的 GitHub 倉庫連結後,它制定了一個清晰的作戰計劃:
- 克隆倉庫並分析項目結構:了解我的配置、主題和文章結構。
- 研究 Hugo 0.133.0 到 0.157.0 的破壞性變更:這一步讓我大為震撼。Manus 竟然主動去瀏覽 Hugo 的官方 Release Notes,把幾十個版本之間的關鍵變更全部整理出來,並記錄在案。
- 安裝新版本並嘗試構建,記錄錯誤:這是最關鍵的一步,也是我之前卡住的地方。
- 逐一修復遷移問題:針對構建時出現的錯誤,逐個擊破。
- 驗證構建結果與文章完整性:確保所有文章、鏈接和樣式都完美保留。
- 提交變更到新分支並交付結果:所有工作在一個獨立的分支上進行,絕不污染我的主分支。
整個過程,Manus 就像一個真正的同事,有條不紊,思路清晰。它不再是一個只會回答問題的聊天機器人,而是一個能夠獨立思考、制定計劃、並解決複雜問題的開發夥伴。
攻克「不可能的任務」
遷移過程中,Manus 遇到了和我一樣的攔路虎:
- 主題不兼容:我使用的 LoveIt 主題早已停止更新,大量使用了在新版 Hugo 中已被廢棄的 API。
- SCSS 編譯器變更:Hugo 0.153.0 之後不再內置 libsass,需要外部的 Dart Sass 支持,而主題的代碼並沒有適配。
我本以為 Manus 會在這裡卡住,但它給出了幾個解決方案讓我選擇:修改舊主題、切換到維護中的分支、或者更換一個現代主題。在我們決定切換到 DoIt 主題(LoveIt 的一個活躍分支)後,Manus 發現 DoIt 同樣存在 SCSS 編譯問題。
接下來的操作堪稱經典:
- 覆蓋模板:它沒有直接修改主題文件,而是在我的項目中創建了
layouts覆蓋文件,只修改必要的模板(plugin/style.html),將 SCSS 編譯方式從toCSS改為css.Sass,並指定使用dartsass。 - 修復 Vercel 部署環境:當我們發現 Vercel 構建失敗時,Manus 立刻意識到是 Vercel 的構建環境中缺少 Dart Sass。它編寫了一個
build.sh腳本,在部署時自動安裝 Hugo 和 Dart Sass,從根本上解決了 CI/CD 的問題。 - 處理 Git 子模塊陷阱:當我自己在本地修改文章,不小心把 DoIt 主題的 Git 子模塊指向恢復到舊版本時,Manus 在排查 Vercel 構建錯誤時發現了這個問題,並指導我如何在本地正確地更新和提交子模塊。
- 像素級的樣式修復:遷移完成後,我發現新舊版本之間存在一些細微的樣式差異。我把問題列表發給 Manus,它像一個前端工程師一樣,通過 CSS 覆蓋,逐一修復了 Logo 大小、圖片居中、文字顏色、行距等 6 個樣式問題,達到了像素級的還原度。
從開始到結束,包括中間的溝通和排查,整個過程只花了幾個小時。那個我以為需要耗費數天、甚至讓我一度想要放棄的「不可能的任務」,在 AI 的幫助下,竟然如此輕鬆地完成了。

AI 時代,我們何去何從?
這次經歷讓我深刻地感受到,AI 已經不再是遙遠的未來,而是真真切切地融入了我們的生活和工作。
我們正處在一個技術爆炸的時代。曾經需要專業技能和大量時間才能完成的工作,現在可以借助 AI 大大提高效率。這並不意味著人類會被取代,而是我們的角色正在發生轉變——從一個執行者,變為一個指揮者、一個決策者。
我們需要學會的,是如何更好地與 AI 協作,如何提出正確的問題,如何利用 AI 的能力來放大我們自身的價值。當我們把那些重複、繁瑣、耗時的工作交給 AI,我們就能解放出更多的時間和精力,去從事更有創造性、更具戰略性的工作。
善用 AI,不僅僅是為了跟上時代的潮流,更是為了讓我們自己的生活和工作,變得更加輕鬆和高效。
就像這次 Hugo 升級,如果沒有 Manus,我可能還在為滿屏的錯誤而頭疼。但現在,我的博客已經順利運行在最新的版本上,而我,則有時間在這裡寫下這篇文章,與你分享這個激動人心的經歷。
歡迎來到 AI 的時代。