chub ai 避坑實錄：那些讓我重裝三次才搞懂的 Lorebook 雷區

chub ai 是什麼

chub ai官網 推出的這款 Android 端 AI 角色聊天工具，核心玩法是玩家自建或下載角色卡，接入各家 LLM API 之後跟虛擬角色對話。它最特別的功能是 Lorebook——一套「關鍵詞 → 對應世界觀條目」的觸發機制，聊天歷史裡只要出現你設的關鍵詞，對應的背景設定就會自動注入 Prompt。這解決了角色卡長度有限的問題：你不用把所有世界觀硬塞進 Personality 和 Scenario，能拆成幾十個 Lorebook Entry 按需觸發。

適合誰？喜歡自訂角色細節、追求世界觀一致性的玩家——如果你覺得 AI 老是「忘記」之前聊過的設定，或者角色說的話前後矛盾，Lorebook 就是為你準備的。但這東西參數多、邏輯細，看著不難實際踩坑的地方不少。

安裝

chub ai下載 目前只有 Android APK 一個版本，安裝包 8.44M，體積很小，下載完直接點安裝就行。這裡說兩個容易忽略的點：

一是包名叫 ai.chub，個別國產 ROM 的安全中心會攔截未在應用商店認證的 APK，彈窗提示「風險應用」，需要在彈窗裡手動勾「允許此來源」繼續安裝——不是包有毒，是應用商店白名單的問題。

二是首次打開之後不能直接用。進入主介面先跳 Secrets 面板，要自己貼 LLM 的 API Key 進去——這款軟體不附帶任何免費額度，API 鑰匙得自己申請。沒配好鑰匙的話聊天頁會一直卡在「等待模型響應」，還以為是軟體壞了。

坑一：Scan Depth 兩極化——調太小沒反應，調太大舊記憶復活

這是我踩的第一個坑，也是最直觀的一個。Scan Depth 顧名思義就是 Chub 往回掃描多少條聊天歷史來匹配 Lorebook 關鍵詞。數值小（1~2）只看最近一兩輪，數值大（5~10）回看更多消息。

症狀：第一次寫了個 Lorebook Entry，關鍵詞設了「學院」，角色在聊天裡確實說了「我來自皇家學院」——但 Lorebook 沒觸發。我以為是關鍵詞匹配規則沒設對，來回改了半小時，後來才發現 Scan Depth 預設是 2，而「學院」這個詞出現在三輪之前，掃描範圍根本沒覆蓋到。

解法：調 Scan Depth 到 4~5 試一次。但別貪心——我後來氣得直接拉到 10，結果幾十輪前聊到的「古老預言」這個舊關鍵詞又被掃了出來，AI 突然開始扯完全不相干的世界觀，像是記憶混亂了一樣。掃描太深會讓舊條目反覆「復活」，消耗 token 還擾亂當前對話。

建議值：2~5 之間，先從 2 開始，發現漏觸發再加，一次只動一個數。

坑二：Token Budget 的隱形擠壓——明明匹配到關鍵詞卻不注入

這個坑比第一個陰暗，症狀很迷惑。你看聊天面板裡 Lorebook 條目是亮的（說明關鍵詞確實匹配到了），但 AI 回覆裡完全沒體現那條世界觀——像是條目被「吞了」一樣。

原因：Token Budget 超額了。這個參數決定 Lorebook 條目最多占多少 token，當多個條目同時觸發、總 token 數超過預算時，Priority（優先級）最高——注意是數值最大——的條目會被擠掉。我一開始以為 Priority 數字越小越優先，把最重要的世界觀設了 Priority=80，不重要的設了 20，結果反而是最重要的先被擠掉了。

解法：兩種方式。要嘛調大 Token Budget（從預設 512 提到 768 或 1024），讓更多條目同時容納；要嘛反過來調 Priority——重要的條目給低值（比如 10~30），不重要的給高值（70~90）。另外每個 Entry 的 Content 控制在 50~200 token 之間，太長也會加速預算耗盡。

坑三：關鍵詞選錯地方——玩家不會說的術語永遠觸發不了

這個坑是思維死角。寫 Lorebook Entry 的時候，我很自然地把「Characterbook」、「Scan Depth」、「Reverse Proxy」這些術語當成了關鍵詞——畢竟我自己知道這些概念。但問題是，玩家跟 AI 聊天的時候絕對不會說「哎你開啟 Scan Depth 了嗎」，他們只會說「這個角色的背景是什麼」、「你之前說的那個學院」。

症狀：Lorebook 掛上去半小時，一個條目都沒觸發。翻匹配日誌顯示零命中。

解法：關鍵詞選「玩家可能主動說出來的詞」，不要選 AI 內部術語或只有你自己才懂的標籤。比如你要觸發「玩家提到角色出身」，關鍵詞應該是「出身」、「哪裡來的」、「故鄉」，而不是「character-backstory-tag」。這點 chub ai文檔 裡也特別提醒了。

另外同一個主題拆成多個短 Entry 比一個大 Entry 效果好——每個 Entry 只管一個小概念，關鍵詞更精準，匹配率自然上去。

坑四：Recursive Scanning 開啟就炸——條目互相觸發的連鎖反應

Recursive Scanning 是個很酷但很危險的功能：A 條目激活後，它注入的內容裡如果出現了 B 的關鍵詞，B 也會跟著激活。理論上可以實現複雜世界觀聯動，實際上很容易變成連鎖反應。

症狀：點了勾開啟 Recursive Scanning，聊了幾句之後 AI 突然開始輸出一大堆亂七八糟的世界觀設定，像是把所有 Lorebook 條目同時灌了進去。Token 瞬間爆表，聊天直接崩掉。

原因：你的 Lorebook 條目之間有隱含的關鍵詞重疊。比如 Entry A 注入「洞穴裡有怪物」，而 Entry B 的關鍵詞剛好是「怪物」——A 激活 → 注入內容裡出現「怪物」→ B 也激活 → B 的內容裡又有「黑暗」→ Entry C 關鍵詞是「黑暗」也跟著激活……指數級膨脹，幾輪之後整個 Prompt 被 Lorebook 占滿，聊天歷史被擠沒了。

解法：大多數場景直接關掉 Recursive Scanning 就行。真的需要聯動的話，要仔細檢查每個 Entry 的 Content 裡有沒有其他 Entry 的關鍵詞，確保沒有隱含的交叉觸發。

最後的速查表

踩完這些坑，我總結了四條檢查清單，下次寫 Lorebook 之前對照一下：

• Scan Depth 從 2 起步，漏觸發再加，到 5 封頂——太深會讓舊條目反覆復活
• Priority 低值優先，重要的條目給 10~30，不重要的給 70~90——數值越大越先被擠掉
• 關鍵詞寫玩家的語言，不要寫術語標籤——選聊天中真的會被提到的詞
• Recursive Scanning 默認關閉——除非你確定條目之間沒有關鍵詞重疊

避開這些雷區之後，chub ai 的 Lorebook 其實是個很強的世界觀保持工具——把角色卡的定義拆成幾十個小條目，讓每條都在對的時機出現，AI 的角色一致性會提升一個量級。

本文为个人基于网络公开资料整理编写，非官方内容，仅供学习交流参考；软件版权归原作者所有，请支持正版；使用过程中遇到问题请查阅官方渠道，本文不承担任何责任。