Blume 2.0
Hayden Bleasel · 寫作 · 程式設計
Blume 2.0 是開源文件框架，把一個 Markdown 資料夾變成快速的 Astro 文件網站，內建本地搜尋、API 參考與給程式代理用的 MCP 伺服器。
關於 Blume 2.0
About
Blume 2.0 是什麼
Blume 2.0 是架在 Astro 與 Vite 上的文件框架。你把 Markdown 或 MDX 檔丟進 docs/ 資料夾，跑一行指令，就得到一個已經接好導覽、搜尋、語法高亮與 Open Graph 圖片的網站。沒有應用程式碼要顧，也沒有後台要每天登入。
第二個大版本動的主要是設定。搜尋、部署、內容來源、API 參考、分析與助理後端，全部改成從 blume/* 子路徑匯入的轉接器，在 blume.config.ts 裡呼叫。給機器讀的設定從 ai 搬到新的 agents 鍵。頁面本身不用改，所以升級是設定工作，不是重寫。
Blume 跟其他靜態文件產生器的差別在第二種讀者。每個網站都會輸出 llms.txt、每頁的 Markdown 鏡像、唯讀的 JSON 文件 API，還能開啟 MCP 伺服器，讓程式代理讀到跟人一樣的內容。這一整組東西，才讓一個 Markdown 文件網站變成適合 AI 讀取的文件。代價也寫得很清楚：它是開發者工具，期待有託管編輯器與所見即所得面板的人，會看到一個 Git 儲存庫。
開始使用
- 在空資料夾執行
npx blume init。CLI 會安裝相依套件，並在package.json補上dev與build指令。 - 打開
blume.config.ts，填好網站名稱、網址，以及搜尋、部署或分析需要的轉接器。 - 把 Markdown 檔放進
docs/。資料夾結構會變成網址路徑，頁面順序則來自檔名或旁邊的meta.ts。 - 執行
npm run dev在本機預覽，再用npm run build產出靜態檔案。 - 選用：
npx blume migrate <來源> --codex會把 Mintlify、Docusaurus、GitBook 或 MkDocs 的舊站交給程式代理轉換。
產品資訊
快速了解 Blume 2.0 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 為自家產品寫文件的開發者：直接在原本的儲存庫寫 Markdown，文件上線只是多一個 CI 步驟，不必再維護一套要同步的內容系統。
- 平台與 API 團隊：OpenAPI、AsyncAPI 與 GraphQL 參考都由規格檔產生，參考頁面不會再跟它所描述的結構脫節。
- 開源專案維護者：MIT 授權加上不按人數收費，任何人開 pull request 就能改文件，不需要誰先去買方案。
任務
- 從 Markdown 發布技術文件：標題、表格、提示框、程式碼群組、分頁與步驟都能直接呈現，不用額外元件或匯入。
- 讓程式代理讀得懂文件：`llms.txt`、逐頁 Markdown 鏡像與 MCP 伺服器，給代理一套穩定的搜尋與引用方式。
- 從其他平台搬家：migrate 指令會讀取 Mintlify、Docusaurus、GitBook、MkDocs 或 ReadMe 專案，再把轉換工作交給 Codex 或 Claude Code。
情境
- 新創團隊的 README 不夠用了：文件獨立成一個儲存庫，補上搜尋與版本切換，流量不大時放 Cloudflare 或 Vercel 幾乎不花錢。
- 產品要出多語版本：語言資料夾會產生對應路由、導覽與翻譯介面，給代理的介面也照同一套結構走。
- 客服每週回答同樣的問題：頁面上的助理直接從文件內容作答，網站主人只要付模型供應商的費用。
主要功能
Markdown 頁面與自動推導的導覽
資料夾變成路由，檔名變成 slug，新增頁面就是新增檔案。側邊欄先從目錄樹長出來，再接受 frontmatter 或頁面旁 meta.ts 的調整。你可以重排群組、換圖示、隱藏某一頁，都不必動設定檔，麵包屑與右側大綱也跟著同一套結構。
給代理的介面：llms.txt 與 MCP
每個 Blume 網站都會輸出 llms.txt，以及每條路由的 .md 鏡像，代理因此能直接抓頁面原始內容，不必去爬渲染後的 HTML。選用的 MCP 伺服器把搜尋與讀頁變成工具，網站另外提供一份由 OpenAPI 3.1 描述的 JSON 文件 API。/.well-known/ai-catalog.json 清單則讓代理註冊表找到這個站。
從規格產生 API 參考
Blume 可以當 API 參考文件產生器，吃 OpenAPI、AsyncAPI 或 GraphQL 結構，本機或遠端都行。設定指向規格檔之後，概觀、每個操作一頁、參數、請求內容與回應表格都出來了。程式範例支援 18 種語言，從 cURL、Python 到 Go、Ruby 與 C#。參考在建置時產生，規格一改，下次部署就反映。
本地搜尋與頁內助理
搜尋靠本地索引，不用 API 金鑰，中文、日文、韓文與泰文這種不靠空格斷詞的內容也找得到。站變大之後，可以換成 Algolia、Typesense、Orama Cloud、Mixedbread 或 Pagefind 轉接器。助理面板用網站自己的頁面回答，後端可接 Vercel AI Gateway、OpenRouter、LLM Gateway、Inkeep 或任何相容 OpenAI 的端點。
多語翻譯與版本化文件
語言資料夾會產生帶前綴的路由、分語系導覽與翻譯好的介面文字，blume translate 則補上缺的語言。版本功能替每個發行凍結一份快照資料夾，加上版本切換器，搜尋也限定在選定版本。兩項功能同樣套用到代理介面，代理看到的就會跟讀者一樣。
檢查、稽核與退出成 Astro
blume validate 在上線前檢查連結、錨點與 frontmatter。blume audit 讀建置後的 HTML，指出 SEO 問題並附上來源檔與行號。blume eval 派一個讀者代理與一個評審代理去測文件，看答案到底找不找得到。哪天框架不夠用，blume eject 會把藏起來的專案變成你自己擁有的 Astro 應用程式。
優缺點
優點
- MIT 授權不限編輯人數、頁數與流量，成本只剩主機費用和你自己選的模型額度。
- 零設定就能起步：`npx blume init` 在寫任何 config 之前，就已經給你搜尋、導覽與 OG 圖片。
- 代理介面是內建的，不是後來補上去的，省掉現在幾乎每組文件團隊都要做的 `llms.txt` 與 MCP 工程。
- 轉接器把麻煩的選擇都包好了，從 Algolia、Typesense 到 Vercel、Netlify、Cloudflare、PostHog 與 Plausible。
- CLI 檢查與 `eject` 留了退路，選這個框架不算把自己鎖死。
缺點
- Blume 2.0 是破壞性設定更新。原本設定了搜尋、部署、來源或助理的專案，必須把那些區塊改寫成轉接器呼叫，設定一大包就要花掉一個下午。
- 沒有託管編輯器與後台。不熟 Git 的寫手得靠開發者或 CMS 來源，對行銷團隊是真實成本。
- 需要 Node.js 22.19 以上，舊的 CI 映像要等人升級執行環境才能跑。
- AI 功能直接向模型供應商計費。框架免費，但助理用量大或要產生語音導覽，就會多出一筆變動的月費。
常見問題
Blume 2.0 是這套 Astro 開源文件框架的第二個大版本。它用 Markdown 或 MDX 檔產生網站，再加上搜尋、API 參考、多語翻譯、版本切換，以及代理讀得懂的介面。
相關內容
探索與 Blume 2.0 相關的工具、技能與文章。
Blume 2.0 替代方案
Google EmbeddingGemma 2
Google DeepMind · 寫作 · 圖片 · 程式設計Google EmbeddingGemma 2 是 7.4 億參數的開源模型，能把文字、程式碼、圖片、音訊與影片畫面轉成同一個 768 維空間裡的向量，在手機與筆電上就能執行。
MePersona
MePersona, Inc. · 寫作 · 生產力 · 行銷MePersona 是為創作者設計的 AI 統一收件匣。它學習你的說話方式，在 12 個平台上草擬粉絲訊息回覆，只送出你核准的內容。
Fluence
Yay Software (Yannick Huchard) · 寫作 · 語音與語言 · 生產力Fluence 是 Android 上的文件閱讀器，能朗讀 PDF、EPUB、Word 檔與網路文章，逐句跟著語音標示，並在手機上直接回答你對內容的提問。