AnZhiYu 主題：開源 Hexo 部落格佈景，先看清 AI 摘要兩種模式

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

安知魚主題（AnZhiYu）是一套以 Hexo 為基礎的開源部落格佈景主題。Hexo 是把 Markdown 文章編譯成靜態網站的部落格框架，主題決定成品長相；AnZhiYu 從 2023 年 3 月發展到現在，在 GitHub 上累積超過 2,500 顆星。它把中文部落格圈常用的功能一次打包：多款留言系統、彈幕、音樂館、朋友圈頁、瀑布流相簿、追番頁，還有一個掛在每篇文章開頭的「AI 摘要」框。

不過把它的原始碼翻開看，招牌的 AI 摘要分成兩種模式，而預設打開的那種，裡面沒有任何 AI。真的把文章送出去生成的模式，則是把文章內容交給一個外部付費服務，那個服務在 2025 年搬過家，主題程式碼到現在還寫著舊網址。

如果你正在挑 Hexo 主題，這篇帶你看清 AnZhiYu 的來歷、AI 摘要的實際運作、維護現況與地雷。

從 Butterfly 分支出來的中文部落格主題

AnZhiYu 的 README 開頭就寫明，它是從 hexo-theme-butterfly 修改而來的主題。Butterfly 是 Hexo 圈最主流的主題之一，超過 8,300 顆星，採 Apache-2.0 授權，2026 年 9 月下旬都還有更新。AnZhiYu 站在它上面，自己以 GPL-3.0 授權釋出，定位接近「Butterfly 的中文生態加料版」。

加的料主要針對中文部落格圈的使用習慣：留言系統內建多款選擇（Twikoo、Artalk 等）、留言彈幕、音樂館與懸浮音樂球、朋友圈頁、短動態牆、瀑布流相簿、追番頁與裝備頁。朋友圈頁是把友格的最新文章聚合在一個頁面的機制，文件有專頁教設定；短動態牆則讓格主貼非正式文章的短內容。這些功能在英文為主的主題裡通常要自己找外掛拼裝，在 AnZhiYu 是設定檔裡的開關。代價是設定檔長達 1,342 行，功能越多，要看懂的設定就越多。看過 Butterfly 設定檔的人會發現大量欄位命名與區塊結構是沿用上游的慣例，這對從 Butterfly 搬過來的人是省事，對新手則代表文件要對著兩套名詞讀。

環境需求不算高：Hexo 5.3.0 以上、Node.js 10.13 以上，安裝方式有 git clone 與 npm 兩種，裝好後記得補上 pug 與 stylus 兩個渲染器；想要文章字數統計，還要另裝 hexo-wordcount 外掛。更新方式值得照官方建議走：把主題設定複製成部落格根目錄的 _config.anzhiyu.yml，之後升級主題不會蓋掉自己的設定，這個覆蓋配置機制文件裡有一步步的說明。官方文件是完整的中文文件，常見問題從字數統計外掛沒裝到畫面顯示太大都有解法，寫得相當細。

訪客分析與站長工具的整合清單也很長：Google、百度、微軟與 Cloudflare 的分析都能開，中國的 cnzz 也在選項裡。這些是接點，不是主題自己的功能，開了就是把自己的流量資料交給對應的服務，立場與前面講的 AI 摘要一致。

還在平台選擇階段的讀者，可以先想清楚 Hexo 這類靜態框架與 WordPress 那類有後台系統的取捨（可參考我們寫過的 WordPress 與 Blogger 比較），接著再挑主題。AnZhiYu 的原始碼在 GitHub，文件與示範站分別在 docs.anheyu.com 與 hexo.anheyu.com。

Pin

招牌的 AI 摘要，預設模式裡沒有 AI

先講結論：裝好 AnZhiYu、什麼都不另外設定的話，文章開頭那個 AI 摘要框，播出來的是你自己寫的字。

原始碼是這樣運作的。AI 摘要的總開關 post_head_ai_description 預設是打開的，模式預設是 local。local 模式下，主題去讀每篇文章 front-matter 裡的 ai 欄位，把你寫在裡面的文字拿出來，配上打字機動畫逐字播出。實際使用長這樣：在文章的 front-matter 加一行 ai: 摘要文字一,摘要文字二（多段摘要用半形逗號分隔），訪客每次打開或重整頁面，主題從中隨機挑一段用打字機效果播出，看起來就像 AI 現場生成。整段流程沒有任何模型呼叫，純前端動畫。

Pin

先說框什麼時候出現：沒有寫 ai 欄位的文章，摘要框根本不會渲染。所以「開啟 AI 摘要」的真實意思是，每篇文章多一個要自己動手寫的欄位。再說框裡的自我介紹：AI 助手的自介是寫死的範本文字，內容自稱基於 GPT-4 的生成式 AI，這段文字在 local 模式下照樣顯示。換句話說，訪客看到的說明，與實際情況（你自己打的字）不一致。

Pin

摘要框下面還有一排按鈕：介紹自己、生成本文簡介、推薦相關文章、前往主頁。在 local 模式下，按「生成本文簡介」只是再隨機抽一段你預先寫好的字；「推薦相關文章」列的是主題自己算出來的站內相關文章，同樣沒有模型介入。整個框裡唯一像 AI 的部分，是打字速度與游標動畫。

兩個名字也可以自己換：AI 助手的顯示名（預設 AnZhiYu GPT）有設定欄位，想掛自己站名可以改；官方示範站另外開了模式切換鈕，讓訪客在 local 與 tianli 兩種模式之間手動切換，這也是設定選項，預設關閉。

對格主來說，這個設計其實是用 AI 的外殼做摘要的排程。好處是摘要完全可控、零成本；代價是它掛著 AI 的名字，而每一個字都要自己生。文章量不大的人，手寫摘要反而比等機器生成可靠；文章量大的人，這個功能沒有替你省下任何自動化。

真要 AI 生成，文章前兩千字會送到哪裡

把模式換成 tianli，就會動真格：瀏覽器把文章標題加上正文開頭約一千到兩千字（送出長度由 basicWordCount 控制，預設一千，設定檔註解標明上限一千九百九十九字；內容還會先被過濾到只留中文字元，英文與數字在送出前就被剃掉），連同設定檔裡的金鑰與頁面網址，POST 到外部服務 summary.tianli0.top，拿到服務算好的摘要再播出動畫。朗讀功能也是跟同一個服務要音檔。

這個服務叫 TianliGPT，獨立於主題之外，金鑰在贊助平台愛發電（afdian.net）販售，主題摘要框裡還內建一個連到購買頁的按鈕。現行服務的主控台在 ai.zhheo.com，服務本身已經搬遷過一次：2025 年 6 月有使用者開 issue 反映主題內建的摘要功能失效，原因出在服務升級後 API 變了。當時在 issue 裡留下解法的服務開發者承認舊的 CDN 已關閉，給的做法是手動替換主題裡的 js 檔。主題開發分支（2026 年 5 月之後就沒有新進度）的程式碼，到 2026 年 9 月下旬仍寫死舊網址，那個網域現在以 301 轉址指向新服務網域，能不能沿用取決於服務端的相容性。

金鑰的安全性也有紀錄可查：金鑰是明文寫進每個頁面的 HTML 的，任何訪客打開原始碼就看得到，官方示範站自己的頁面原始碼裡就放著一組完整金鑰。設計上服務用 Referer 綁定網域來降低盜用，主題程式碼對 403 的處理訊息也寫明，金鑰與 Referer 對不上會被服務拒絕，等於金鑰跟網域綁在一起，站搬家要重新對應。這件事曾被使用者開 issue 反映過，問題登記後沒有改變設計。

想在主題裡接自有的 AI 端點（例如自行申請的模型 API）這件事，2024 年 7 月就有人提出功能請求，到現在沒有得到維護者答覆。真要接自己的模型，現階段得改主題的 js。

功能清單越長，外部依賴越多

1,342 行的設定檔代表大量第三方接點：留言、統計、圖床、音樂，每個接點各有各的壽命。

最具體的例子是音樂館。AnZhiYu 的音樂播放器建立在 MetingJS 上，這是一支把網易雲等平台的歌單轉成網頁播放器格式的開源程式庫，靠公共 API 端點運作，而公共端點是會死的。2026 年 4 月起有使用者反映音樂館掛掉：預設依賴的 API 端點失效，歌單整個載入不出來。issue 裡是社群使用者互相幫忙，找到另一個社群維護的 API 端點，教大家改主題的 CDN 設定換過去，到 2026 年 9 月底還有人踩到同樣的問題，維護者沒有出面。

圖床是同一個故事。主題預設的素材圖放在中國一個遊戲論壇的圖床（upload-bbs.miyoushe.com）：預設的「隨便逛逛」區塊那張圖，現在打開是被圖床換過的破圖佔位；示範站首頁部分文章卡片的封面圖，載入失敗時會變成寫著「僅對中國大陸地區提供服務」的錯誤畫面，同一批圖檔的原始網址在不同時間測試，時好時壞。連官方示範站的圖都顧不穩，拿論壇圖床當預設素材，載入狀況就是掌握在別人手裡。

這不是 AnZhiYu 獨有的問題，功能大雜燴主題都一樣：你搬進來的不只是一套主題，還有一整排別人免費維護的服務。挑這類主題的時候，先看清楚每個功能背後靠的是誰，再決定要不要整包搬進自己的站。

專案還在，但作者的重心已經搬家

AnZhiYu 不是棄坑專案，但節奏明顯放慢。GitHub 上的預設分支 dev 最近一次更新落在 2026 年 5 月 31 日，main 分支停在 2026 年 1 月，最新正式版 1.7.1 發布於 2025 年 12 月，npm 上的套件版本還停在 1.7.0（近一週約 478 次下載，仍有人在裝，只是裝到的版本落在最新進度之後）。未關閉的 issue 與合併請求共 43 個，一部分有社群互助，一部分沒有下文。

更有信號意義的是 README 裡的一段話。主題作者自己寫著，如果想要一套類似 WordPress、有後台可以編輯的系統，可以看看他的新專案 anheyu-app。這個新專案 2025 年 8 月開張，2026 年 9 月下旬都還在持續推送。原本被當作主題預覽網址的 blog.anheyu.com，現在就是這個新專案的站：用 Next.js 蓋的，首頁標題也已經換掉。想看主題實際長相，現在的官方示範站是 hexo.anheyu.com，別走錯。

對採用決策的意義：上游的 Butterfly 還在活躍維護，AnZhiYu 的獨特價值（中文生態整合）與它的風險（更新放緩、關鍵功能依賴外部服務）其實來自同一個源頭，它本質上是一個人的中文圈專案。用它可以，但把它當成「需要的時候自己接手也看得懂」的底子來用，會比較踏實。

繁中使用者會碰到的小落差

繁體中文支援是真實存在的：語言檔 zh-TW.yml 與簡中版完全對齊（26 個分組、165 條字串），用語也是台灣習慣（複製成功、文章總覽、標籤、分類、歸檔），在部落格的 site 設定把 language 指到 zh-TW 就能整套換上。不過對得再齊也有縫：語言檔裡仍有一條漏翻的簡體字串。

不過語言檔只換得到框架文字。AI 摘要框上的按鈕文案直接寫死在模板裡，是簡體中文，語言檔換不掉，要自己改模板檔。文件全站是簡體中文，README 另有英文版。對台灣格主來說這些都是小工程，不是阻礙，但要有心理準備。

四種需求對照：裝 AnZhiYu 前先看這張表

適合的人：已經用 Hexo、想要中文部落格圈那套完整功能（留言彈幕、音樂、朋友圈、相簿），而且願意自己顧第三方接點的格主。它省下的拼裝時間是真的，GPL-3.0 對個人部落格的使用也沒有額外義務。

該想清楚的人：想要開箱即用 AI 摘要的。在 AnZhiYu 上，AI 摘要要嘛每篇自己手寫（掛著 AI 的名字），要嘛付費訂外部服務、把文章內容送出站、金鑰攤在頁面原始碼裡，還要自己留意服務搬家。兩條路都不是裝了就有。也要留意日後換掉它的成本：ai 欄位是 AnZhiYu 自訂的 front-matter，哪天換到不支援 ai 欄位的主題（上游 Butterfly 就不認得它），這些內容就沒有人讀，搬遷前要先想好摘要要不要跟著走。

如果還在「要不要自己架站」的階段，也可以看看自架微型部落格的輕量路線，或用免費平台搭配自有網域的做法，先把定位想清楚，再挑工具不遲。

AnZhiYu 值得裝的前提，是你把它當「功能很多的中文主題」，而不是「有 AI 的主題」。摘要願意自己寫的人會用得很順；期待 AI 代勞的人，先去 ai.zhheo.com 看看服務現況再決定。