深色模式
玩家急救手冊
出處
本頁對應《玩家急救手冊》v0.9.7（2026-07-14）。最新版同步發佈於 Notion 公開頁。
給玩「有狀態欄、有數值」角色卡的你。（MVU 是這類卡背後變數系統的名字——你的狀態欄有數字、會隨劇情變，八成就是它。） 卡玩到一半壞了——數字不動、回覆被切一半、開新聊天就報錯——多數情況你可以自己救回來，不用重開聊天、不用乾等卡作者。這本手冊告訴你怎麼救。 卡作者也歡迎把這份手冊連卡一起發給玩家。
這本手冊怎麼用（先選一種）
用法一：丟給你的 AI（推薦，最省腦）
把這份手冊全文貼給你在用的 AI（Claude、GPT、Gemini 都行），加上這句：
「我在酒館玩一張有變數的角色卡時出了狀況。這是急救手冊，請你當我的除錯嚮導：先問清楚我的症狀，再照手冊的症狀急救區一步一步帶我操作。只用手冊裡寫的方法，不要自己發明。」
接下來回答它的問題就好。
用法二：自己查
- 先看下面「開始之前」認識三個詞（30 秒）
- 到「症狀急救區」找最像你狀況的那條，照步驟做
- 每做一步、看一次結果，再決定下一步
開始之前：四個詞＋三個地方（30 秒）
四個詞：
樓層：對話裡的每一則訊息。開場白是第 0 樓，接著 1 樓、2 樓往上疊。
變數：卡在背後記的數字跟狀態（好感度、地點、關係階段……），狀態欄顯示的就是它。每一樓都存了一份「當時的變數」——所以壞掉時有機會回到過去。介面上寫的「变量／變量」跟變數是同一個東西。
變數更新塊：AI 每次回覆的最尾端，其實都附了一段被藏起來的更新指令（
<UpdateVariable>開頭的那段），告訴系統這一輪哪些數字要動。很多症狀的第一步，就是把它翻出來看——在訊息右上角點「編輯」（鉛筆圖示）就能看到回覆的原文。重骰（swipe）：最新一樓訊息旁的左右箭頭（手機上左右滑）。按右箭頭＝讓 AI 把同一樓重新生成一個新版本；舊版本不會消失，往左滑隨時回得去。手冊裡說「重骰一次」就是按一下右箭頭。
順帶翻譯一個會一直出現的詞：token＝AI 計算文字量的單位，當「字數」理解就行。
三個地方，先找到它們在哪（都只是去「看」和「按」，不會動到任何程式，放心點）：
- MVU 變量框架面板（最快的急救入口）：擴充頁面（🧩）往下捲，直接就有「MVU 变量框架」抽屜——點開裡面的「修复按钮」區，最常用的兩顆（重新处理变量／重试额外模型解析）在這裡就按得到，不用鑽進腳本區。通知設定、變量更新方式也在這個面板。（新版 MVU 才有這個面板；沒看到的話用下面第二條路）
- MVU 載入器的完整按鈕區（六顆全在這）：擴充選單 → 酒館助手 → 腳本 → 「角色腳本」區找名字帶「MVU」的那個（可能叫「MVU Zod 腳本」或「MVU Zod 載入器」，Zod 只是系統名，不用管）→ 點編輯 → 按鈕區。常常需要修的人：把常用按鈕（例如重新处理变量、重演楼层）的「顯示」勾起來，它們會常駐在聊天畫面，不用每次點進來。
- 變量管理器（改數值用）：聊天輸入框左側的魔棒（🪄）圖示裡有它的快捷入口（酒館助手官方文件明載，26-07-14 查證）。功能是「查看、編輯並實時監聽」變數——可以直接改值，不是只能看；樹狀畫面要點進那個值才會變成可輸入。改值的正確位置：切到「消息楼层」分頁、開著「追踪最新」，在最新一樓的 stat_data 裡改——下一輪接著用的是最新一樓的值，改別的分頁（全局／聊天）沒有用。改不動的話截圖問你的 AI 或照回報模板回報。
症狀急救區
症狀 A｜狀態欄的數字不動了
也包括：好感度卡死、地點不變、關係階段永遠停在原地。
第 1 步：翻開最新一樓的原文（編輯模式），看結尾有沒有 <UpdateVariable> 那段。三種情況：
| 你看到的 | 代表 | 去哪裡 |
|---|---|---|
| 整段不見 | AI 根本沒輸出更新塊 | 第 2 步 |
| 有頭沒尾、被切一半 | 回覆頂到長度上限，塊被截掉 | 跳「症狀 C」 |
整段被包在思考標籤（<thinking> 之類）裡 | 模型把塊吞進思考區了 | 跳「預設自檢區」第 2 點 |
| 塊在、數字也有寫，但長得不對（變成聊天式的「安全感: 33(+1) // 理由」、或 JSON 外面包的是 ```json 圍欄而不是卡原本的標籤） | 格式漂移——AI 忘記標準格式自己發明寫法，系統讀不懂就全部略過 | 第 5 步 |
第 2 步：對最新一樓重骰（swipe）一次。 骰出來塊回來了、數字動了→只是偶發，繼續玩。（原本那則回覆往回滑就在，不會不見。）
第 3 步：連骰兩三次都沒有→這是「長對話遵循衰減」。 對話越長，AI 越容易忘記固定格式——因為歷史樓層的更新塊全被系統從上下文拿掉了（省 token 的標準做法），它看不到自己以前是怎麼寫的。這不是你的錯，是卡缺一道防線：
- 臨時自救：打開變量管理器，把該動沒動的數值改掉，繼續玩。數字抓個照劇情感覺合理的就好，差一點不影響。這是系統設計給人手動改值的正路；就算極端情況下被下一輪蓋掉，再改一次就好，不會弄壞存檔。（✅ 已實測：改完的值下一輪保得住，不會被蓋掉——26-07-13 玩家實測）
- 根治：照最下面的「回報模板」回報卡作者，附一句「可能需要輸出格式強調條目」——作者看到這句就知道要裝什麼，有現成模板五分鐘能裝好。
第 4 步（特例）：塊完整存在、數字卻沒跟著動 → 按「重新处理变量」按鈕（簡體字樣那顆，見按鈕速查表），讓系統重讀最新一樓再算一次。
第 5 步（格式漂移）：塊在但長得不對 → 這是長對話的常見病（越弱的模型越容易犯），救法已實測有效（26-07-13）：
- 往前翻到還正常的那幾樓，把一份長得對的更新塊複製出來（每張卡的標準格式不同，自己卡上的健康樓就是最好的範本）
- 編輯最新一樓：把壞的塊整段刪掉、貼上剛複製的，數字改成劇情目前該有的值（有
replace這種寫絕對值的就用它，不要用加減式） - 按「重新处理变量」按鈕（簡體字樣那顆）→ 數值追上，繼續玩
- 之後幾輪建議換強一點的模型——格式漂移的根源通常是模型，卡只能防不能治
⚠️ 編輯樓層救變數：一個例外，其餘仍是死路
手動把更新塊打進舊樓層——沒有用（已實測）：變數結算只認「AI 生成」事件，手寫的塊系統不理。
唯一例外（26-07-13 玩家實測驗證）：編輯最新一樓的塊、然後按「重新处理变量」按鈕（簡體字樣那顆）——這顆鈕就是人工觸發重算的開關，會重讀最新一樓，改對格式的塊吃得進去。
兩個實戰細節：①如果你的介面上有繁體、簡體兩顆長一樣的按鈕，按簡體「重新处理变量」那顆——繁體字樣那顆是翻譯介面的殼，沒接線 ②只有最新一樓有效，改更早的樓沒用。
症狀 B｜開新聊天就跳「[MVU]變量初始化失敗：需要有開場白」
原因：變數的初始值是「種」在開場白樓層上的。這個聊天沒有開場白（被刪掉、清空過，或用指令直接開聊）＝系統沒地方種，直接罷工。
救法：聊天才剛開始 → 直接開一個新聊天（讓開場白正常出現），零損失，這是最快的路。
〔待實測③〕已經玩了一段才遇到這個、捨不得重開 → 按「重新读取初始变量」按鈕（簡體字樣那顆）可能可以免重開。實測結果會更新在這裡。
症狀 C｜回覆越長越容易壞：被切一半、更新塊只剩半截
原因：變數卡每一輪要在同一則回覆裡塞「正文＋思考＋更新塊」，更新塊排最尾端——總量頂到「回覆長度上限」時，它最先被切。
救法（依序試）：
- 把酒館的回覆長度上限調高，例如先加一倍。位置：左邊第一個設定面板（一堆滑桿那區）裡的「Response／回應」長度滑桿。
- 或者用 OOC 請 AI 收斂正文：「（OOC：之後回覆正文請控制在 X 字內）」。OOC＝出戲說話，用括號直接跟模型講、不算劇情。
- 對被切的那一樓重骰，讓它重新輸出完整的一輪。
長期：這張卡的輸出配比偏緊（正文、思考、更新塊三者加起來太肥），照回報模板讓作者調。
症狀 D｜數值亂掉：暴衝、歸零、亂跳
- 單一數值錯了 → 變量管理器直接改回正確值（✅ 已實測：改完保得住）。
- 一大段都亂了、想回到某個還正常的時間點 → 按「重演楼层」（簡體字樣那顆，見速查表）：指定從哪個還正常的樓層開始，系統會把之後每一樓的變數更新重新跑一遍，算回正確狀態。不用刪樓層、不用重開。
- 角色暈船太快、幾輪就滿好感 → 通常不是故障，是這張卡沒裝「冷卻機制」（AI 天生會把正面數值越推越高，需要卡側防線）。臨時用變量管理器調回，根治靠回報作者加冷卻。
症狀 E｜狀態欄顯示一堆原始碼／版面亂掉／回覆冒出 <UpdateVariable> 原文
- 檢查「酒館助手」擴充有沒有開著——狀態欄的渲染靠它。
- 檢查卡附的正則腳本有沒有被停用（擴充 → 正則）——把原始碼變成漂亮面板的就是它們。
- 翻舊樓層發現狀態欄不見＝正常。很多卡只渲染最近幾樓（省效能），不是壞。
- 以上都正常還是亂 → 卡的問題，照回報模板回報。
按鈕速查表
位置有兩處：快速版＝擴充頁面「MVU 变量框架」面板 → 修复按钮（含最常用的重新处理变量／重试额外模型解析，新版 MVU 才有）；完整版＝酒館助手 → 腳本 → MVU 載入器 → 編輯 → 按鈕區（六顆全在，可勾「顯示」常駐聊天畫面）。 依據：MVU 原始碼（MagVarUpdate，26-07-04 查證；按鈕名機制 26-07-14 補證；面板位置 26-07-14 實機截圖校對）。 ⚠️ 按鈕請認「簡體字樣」那顆——按鈕名就是程式的觸發暗號，MVU 只認簡體原名。舊版卡（26-07-14 前製作）介面上會出現繁簡兩排長一樣的按鈕：繁體那排是翻譯殼、沒接線，一律按簡體；新版卡已拔掉死鈕，只剩簡體一排。下表用簡體原名列出（括號是意思）。
| 按鈕 | 它做什麼 | 什麼時候用 |
|---|---|---|
| 重新处理变量（重新處理變量） | 把最新一樓的變數擦掉，重讀這一樓的文字再算一次 | 最新一樓的塊在、數字卻沒動（症狀 A 第 4 步）；編輯最新一樓修好格式之後（症狀 A 第 5 步，26-07-13 實測有效） |
| 重新读取初始变量（重新讀取初始變量） | 重新載入卡的初始變數，跟你目前的進度合併——進度數值保留、卡新增的變數補進來 | 卡作者更新卡、加了新變數之後；〔待實測③〕初始化失敗時 |
| 快照楼层（快照樓層） | 把指定樓層的變數標記保護：清理時不刪、重演可以從它起跑 | 按「清除旧楼层变量」之前，先把重要進度標起來 |
| 重演楼层（重演樓層） | 從指定樓層開始，把之後每一樓的變數更新重新跑一遍 | 數值亂掉想回去重算（症狀 D）；跳出含 required／extensible 字樣的錯誤時 |
| 重试额外模型解析（重試額外模型解析） | 撤掉最新一樓的塊、退回上一樓的變數、重新解析一次 | 只在「額外模型解析」模式下有用（這是要另外設定才會開的功能，你沒動過設定就跳過這顆） |
| 清除旧楼层变量（清除舊樓層變量） | 刪掉舊樓層存的變數副本（保留最後 N 樓＋定期快照），聊天檔瘦身 | 聊天檔太肥、手機開卡會當。⚠️ 清掉的樓層要靠重演才回得去，先做快照 |
預設自檢區：卡沒壞，可能是組合沒對過
卡作者做卡時，用的是作者自己的預設（preset，你掛在模型上的那包提示詞設定）——但預設不會跟卡一起發。你手上跑的是「這張卡 × 你的預設 × 你的模型」，一個作者從來沒測過的組合。所以出狀況不一定是誰的錯，先做個 30 秒的切分：
1. 極簡預設 A/B 法（30 秒定位） 先把現在的預設名記下來，然後換到一個乾淨的預設——酒館內建、沒掛社群大包的那種（例如 Default）就夠格。同一幕重骰一次，測完切回來就好。 症狀消失＝你的預設跟卡打架（往下看第 2、3 點）；症狀還在＝卡或模型的問題（回症狀急救區，救不動就回報）。
下面第 2、3 點動手門檻比較高。不想自己拆預設的話有兩條路，都正當：把這一區連同 A/B 法的結果丟給你的 AI 帶你查；或把「換極簡預設後症狀消失」這個結果寫進回報模板——光這句就是很有用的線索。
2. 預設跟變數卡最常打架的三個點
- 思考剝除：思考型模型（Gemini 思考版等）有時會把更新塊寫進思考區；預設若把思考區整段剝掉，塊跟著陪葬。→ 檢查預設有沒有「剝除思考／去 CoT」類的正則或開關，關掉再骰一次對比。
- 回覆長度上限：預設或酒館把上限鎖太低 → 症狀 C。
- 輸出格式規則衝突：預設自帶的思考鏈（CoT）格式要求，跟卡要求的輸出格式打架 → 塊的格式被帶歪。極簡預設 A/B 法能抓出這種。
3. 角色個性走樣也可能是預設（幼兒化、變得千依百順、魅力消失） 預設裡的行為禁令（去佔有、平等準則、去 user 中心這類防護開關）會把某些角色的核心表達整組封掉——例如佔有慾系角色的成熟話術全被禁，模型被逼到只剩幼兒撒嬌可用。這不是模型變笨，是提詞把角色的人格拆了。→ 看看你的預設開關清單，名字跟角色設計正面衝突的先關掉，關完同一幕重骰對比。（改寫預設內容是進階玩法，沒把握就只關不改。）
回報模板：自救不動時，這樣回報最快被修好
把下面填好，貼給卡作者（或社群求助串）。填得越全，作者越可能一次修對：
【卡片】卡名＋版本（知道的話）
【症狀】一句話（例：狀態欄數字從 34 樓之後就不動了）
【樓層】第幾樓開始出事；目前聊到第幾樓
【模型】你用的模型（例：Gemini 2.5 Pro）
【預設】預設名＋版本；回覆上限設多少（思考剝除有沒有開，知道就寫、不知道就略過）
【已試】照急救手冊試過哪幾條、結果各是什麼
【截圖】症狀畫面 ＋ 出事樓層編輯模式的原文（拍到 <UpdateVariable> 那段）給 AI 嚮導的鐵則
玩家把這份手冊貼給 AI 時，AI 讀這一段。
你是玩家授權的除錯嚮導。規則：
- 先問診再開藥：症狀是什麼、第幾樓開始、最近換過模型或預設嗎、對話多長了。問清楚才選症狀條目，一次只問一題。
- 只用本手冊的處方。手冊沒寫的操作不要從自帶知識發明——尤其不要叫玩家改卡片檔案、改世界書、改腳本內容，那是卡作者的事。
- 標了〔待實測〕的步驟，先告訴玩家「這步還沒被驗證過」，讓玩家自己決定試不試。
- 一步只做一件事，等玩家回報結果再走下一步。
- 手冊的路都走完還是沒救回來就停手：帶玩家把回報模板填好，不要硬修。
- 用玩家的語言和字體回覆——玩家寫繁體中文，你就全程用繁體中文。
版本 v0.9.7（26-07-14）：名詞區補「重骰（swipe）」定義（正文用了四次卻沒翻譯，Mini 讀者視角抓到）。變量管理器補「消息楼层分頁＋追踪最新」改值位置細節（Mini 實機標註截圖校對）。位置指引雙重校對——實機截圖（MVU 變量框架面板的修复按钮區＝最快入口）＋酒館助手官方文件（變量管理器入口＝輸入框左側魔棒圖示，功能含編輯非僅檢視）。〔待實測①〕〔待實測②〕皆已由玩家實測驗證回填（①變量管理器改值保得住／②編輯最新一樓＋重新处理变量）；剩〔待實測③〕一處，驗完升 v1.0。26-07-14 補：按鈕名機制查證、速查表改簡體原名。本手冊歡迎自由轉貼給需要的玩家，註明出處即可。維護：本 Kit 作者。