liyupi/ai-guide：魚皮的 AI 知識庫，一份內容型倉庫的實際邊界

這個倉庫解決的是資訊分散，不是技術缺口

AI 領域的入門困難很少來自缺少資料，而是資料太多且彼此矛盾。同一個模型有官方文件、有第三方評測、有幾十篇互相抄襲的入門文，新手分不清哪一份還有效。liyupi/ai-guide 的定位就是收斂這件事：README 開頭寫的是「完全免費開放的 AI 知識共享平台」，目標是「減少信息差」。它把內容分成幾個明確的區塊，新手入門、AI 編程、AI 工具測評、其他應用場景，每一格用表格列出主題與對應連結。

目標讀者有兩類。一類是完全沒有技術背景、想用 AI 把想法做成產品的人，README 特別強調這套 Vibe Coding 教程是為「設計師、產品運營、甚至完全不懂技術的人」準備的。另一類是有程式基礎、想快速摸清 AI 編程工具版圖的開發者，倉庫裡有 Cursor、Claude Code、MCP 服務開發、Spring AI 這類偏工程的主題。這兩類人讀同一份倉庫，但會走完全不同的路徑。

需要先講清楚的是，這個倉庫的產出物是內容，不是軟體。它沒有對外提供 API，沒有可安裝的套件，沒有版本化的介面。把它放進依賴清單是錯位的用法。

內容分層：從十分鐘上手到 MCP 服務開發

README 把教程結構列成七塊：基礎必讀、編程工具、項目實戰、經驗技巧、產品變現、編程學習、資源寶庫。這個切法透露了作者對學習順序的判斷，先做出東西，再談效率，最後才談變現。基礎必讀的承諾很具體，「10 分鐘做出第一個作品」。

編程工具那一塊的分類值得注意，它沒有把工具混在一起，而是拆成 AI 模型選擇、AI 零代碼平台、AI 智能體平台、AI 代碼編輯器、AI 命令行工具、IDE 插件六類。這個拆法對新手是有用的，因為很多人卡住的地方不是不會用 Cursor，而是根本不知道自己該用編輯器還是命令行工具。

導航表格裡的主題跨度很大。新手入門區有 DeepSeek 的入門、本地部署、API 調用、提問技巧，還有一篇「去除文章 AI 味」。AI 編程區有 Cursor 省錢方法、Claude Code 技巧、用 AI 手搓 Claude Code、MCP 服務開發、Spring AI 1.0 與 Spring AI Alibaba 1.0。測評區列了 GPT-5、Claude 4、Cursor 2.0、Gemini 3.0、OpenCode、Gemini CLI 等條目。

這裡有一個實際問題：多數條目是連到 ai.codefather.cn 的站內頁面，而不是倉庫內的 Markdown 檔案。這意味著倉庫本身更像一份目錄，內容實體在網站上。對只想 clone 下來離線看的讀者，這個結構會讓體驗打折。

Vibe Coding 教程是這個倉庫真正的重心

README 用最大篇幅介紹《Vibe Coding 零基礎入門教程》，並給了獨立入口 ai.codefather.cn/vibe。作者自述投入了「上千張圖、幾十萬字」，並結合兩年半的 AI 編程、專案開發與產品變現經驗。這些是作者自述，不是可獨立驗證的數字，讀者應該當作宣傳口徑看待。

教程的章節安排是圍繞交付而非圍繞知識點。項目實戰那一塊寫的是「從 0 到 1 做出真實可用的產品」，覆蓋個人工具、AI 應用、全棧應用、小程序。經驗技巧那一塊列出的是核心心法、對話工程、上下文管理、幻覺處理、代碼質量保障。這幾個詞比一般入門教程的「提示詞技巧」精確，上下文管理和幻覺處理是實際用 AI 寫程式時最常出問題的地方。

README 也給了兩條學習路徑。零基礎的路徑是第一天讀完基礎必讀做出第一個作品，第一到第二週學工具並做幾個簡單項目，之後按需學經驗技巧與變現。有程式基礎的路徑是第一天快速過完基礎並完成快速上手，第一週學主流工具並嘗試重構舊專案，之後重點提升對話與上下文管理。

倉庫還提供了英文與繁體中文的翻譯目錄，路徑在 translations/en 與 translations/zh-TW 底下，但目前 README 只指向《Vibe Coding 零基礎教程》這一篇的翻譯，其他章節是否同步翻譯，材料裡看不出來。

怎麼把它跑起來：VuePress 與 Markdown 的組合

倉庫的主要語言標示為 JavaScript，主題標籤裡有 vuepress，這說明文件站是以 VuePress 建置的。README 沒有提供安裝或建置指令，所以無法從材料確認具體的 npm script 名稱與目錄約定。能確定的是，內容以 Markdown 撰寫，圖片託管在 pic.yupi.icu 這個外部圖床，README 內的圖片路徑是 URL 編碼後的中文檔名，例如指向 Vibe Coding 封面與教程大綱那兩張圖。

如果你打算自己建一份站，典型流程是先 clone 倉庫，再依 VuePress 專案的慣例安裝依賴並啟動本機預覽。但因為 README 沒有給出 package.json 的 script 名稱，我不會在這裡寫出一個可能不存在的指令。要確認的話，直接打開倉庫根目錄的 package.json 看 scripts 欄位，比照著任何一篇教學猜測可靠。

配置層面能從材料推斷的只有兩件事：一是文件站與 ai.codefather.cn 這個線上站是兩套入口，首頁徽章同時指向兩者；二是圖片全部走外部圖床，如果圖床失效，倉庫內的 Markdown 會出現大面積破圖，而圖片本身不在版本控制內。這是採用這份內容做二次整理時要先評估的風險。

內容型倉庫的失效模式：時效與同步

AI 工具測評這類內容有明確的半衰期。倉庫測評區的標題帶有「GPT-5 炸裂登場」、「Claude 4 炸裂發布」、「Cursor 2.0 炸裂發布」、「Gemini 3.0 發布」這種寫法，這類標題在發布當下有效，半年後讀者需要的是版本差異而不是發布情緒。倉庫最後一次推送時間是 2026 年 9 月，說明仍在維護，但這不能保證每一篇舊文的結論都還成立。

第二個問題是同步。內容主體在網站上，倉庫是索引。當網站更新而倉庫沒有同步，clone 下來的人看到的是舊版；反過來也一樣。README 沒有說明哪一邊是唯一真實來源，也沒有說明更新流程。對需要引用具體段落的人來說，這是一個必須自己驗證的環節。

第三個問題是作者自述與可驗證事實的界線。README 裡「吊打 90% 的付費 Vibe Coding 內容」是行銷語言，不構成評估依據。真正能判斷品質的只有實際翻幾篇教程，看它的項目實戰是否給出可重現的步驟。這一點材料無法代替你完成。

替代選項：官方文件與社群問答的差別

同類需求有兩條完全不同的路。一條是直接讀工具官方文件，例如 Cursor、Claude Code 各自的官方站與 release notes。官方文件的優勢是版本對應準確，改版當天就更新，缺點是不會告訴你「新手該先學哪一個」，也不會比較不同工具的取捨。

另一條是社群問答與討論區，例如各家工具的 issue 區與開發者論壇。這條路的優勢是能拿到真實的踩坑紀錄，缺點是品質參差，同一個問題會有三種互相矛盾的答案，而且沒有結構。

liyupi/ai-guide 的位置在中間。它做的是挑選與排序，把散落的材料按學習順序排好，並用中文寫成連續的教程。這個價值的來源是編輯判斷，不是技術深度。所以它無法取代官方文件，當你要查某個參數或某個 API 的準確行為時，仍然要回到官方來源。它的用途是在你還沒有能力判斷該查什麼之前，先給你一張地圖。

授權與維護成本：採用前必須自己確認的兩件事

倉庫的 License 欄位顯示為 NOASSERTION。這表示 GitHub 的授權識別機制無法從倉庫內容判斷出標準的開源授權條款，常見原因是專案用了自訂條款，或根本沒有放 LICENSE 檔案。這對想轉載、翻譯或商用其中內容的人是直接相關的：在沒有明確授權的情況下，預設的著作權狀態是保留所有權利。我不會在這裡給法律意見，實際條款要打開倉庫根目錄確認。

維護成本方面，這個倉庫的成本不在於升級依賴，而在於內容的追蹤。AI 工具大約每幾個月就有一次大版本，測評與技巧類文章需要重寫而不是修補。README 提到倉庫已「升級為魚皮 AI 導航網站」，這暗示內容重心可能逐步轉向網站，倉庫作為鏡像或索引的角色會更明顯。

如果你只是想拿它當個人學習清單，這些都不是問題，clone 或直接看網站都可以。如果你打算把裡面的內容放進自己的產品或課程，授權確認就必須先做完，而不是先寫完再補。

編輯結論

如果你是要找一份中文 AI 學習入口、想知道 Vibe Coding 該從哪個工具開始、或者需要一份提示詞與概念的整理，這個倉庫可以當作起點，先讀 README 的學習路徑再看對應章節。如果你是工程團隊，想找一個可以直接引入專案、有明確版本與 API 契約的依賴，這個倉庫不是那類東西，它的主語言標示為 JavaScript 是因為文件站以 VuePress 建置，不代表它提供可呼叫的程式庫。採用前務必確認兩件事：一是倉庫的 License 欄位顯示為 NOASSERTION，GitHub 未能識別出標準授權條款，你要自行到倉庫內確認實際條款再決定能否轉載或商用；二是內容主體託管在 ai.codefather.cn，倉庫內的 Markdown 與線上網站是否同步、更新以哪一邊為準，README 並沒有說明。

官方來源

1. Issues
2. liyupi/ai-guide on GitHub
3. Project website
4. README