娜娜麻將 v0.1.67 試玩版
macOS（Apple Silicon／Intel）／單機／台灣 16 張

【開始遊玩】
1. 先將 ZIP 完整解壓縮到一個資料夾，不要直接在 ZIP 裡執行。
2. 雙擊 NanaMahjong.app。
3. 不需安裝 Godot、不需登入，也不需連網。
4. 首次選「開始新的一將」；已有存檔時選「繼續遊戲」。

【基本操作】
先抽東、南、西、北抓位，東位起莊。每局由莊家擲骰開門；電腦做莊會自動擲骰。
點手牌一次選取，再點同一張即可打出，或按「打出」。點另一張是改選。
可吃、碰、槓、胡時會出現按鈕；吃牌按鈕用牌面呈現組合，點選可預覽吃後手牌，再確認吃牌。按「過」放棄。摸牌、補花自動完成。
「出牌提示」只幫你選牌，仍由你決定是否打出。
右側顯示圈局、連莊次數、剩餘牌數、積分；吃碰槓的牌會分組顯示。
主選單會暫停牌局；按「繼續遊戲」返回，原本手動暫停的牌局仍維持暫停。
主選單「設定」或右上角按鈕可開關 BGM 與音效，設定會記住。
設定內可直接選擇 BGM1（原音樂）、BGM2 或 BGM3，選曲也會保存。

【Auto 與提示】
Auto：ON 會自動判斷並代打到本局胡牌或流局後關閉，不會自行開始下一局。
Auto 已移除倒數，依遊戲節奏直接代打。暫停或返回主選單會停止動作；關閉 Auto 改回手動。抓位仍需自行選擇。
提示：ON 會在手牌上方顯示兩行建議，不會代替你操作。第一行為建議捨牌、打後向聽數與有效進張總數；第二行列出有效牌及未見數。長文字可停留滑鼠查看全文。0 向聽代表聽牌，有效進張代表摸到後可降低向聽數的牌。
提示附上原因與聽牌未見張數；未見牌包含對手暗牌與保留牌，不等於牌牆可摸張數。AI 參考近期牌河與公開副露作風險判斷，避免拆掉聽牌，不讀取對手暗牌；低風險不保證不放槍。
重新開啟遊戲時 Auto 與提示預設關閉。

【整將進度】
東風圈 → 南風圈 → 西風圈 → 北風圈，每圈四人輪莊；無連莊時共 16 局。
莊家胡牌或流局連莊，閒家胡牌換莊。連莊 0 次是剛接莊，連莊 1 次是第一次續莊。
「下一局」保留積分與整將進度；「重頭開始」或選單開始新的一將，確認後會重設為各 1,000 分並重新抓位。
本作採固定規則，地方玩法可能不同；完整台數與排除項目請看遊戲內「玩法與計台」。
目前電腦採基礎策略，不含連線對戰。

【存檔與更新】
每次牌局操作自動存檔，重開遊戲後可繼續。存檔屬於各自的 Mac 使用者。
在 Finder 按 Command＋Shift＋G，輸入以下路徑：
~/Library/Application Support/Godot/app_userdata/青竹麻將
娜娜麻將沿用舊名存檔目錄，改名後原本進度仍可使用。round.save 是牌局；audio.cfg 是音效設定。試玩包不包含開發者的存檔。
更新前先關閉遊戲，再解壓縮新版，個人存檔會保留。

【問題回報】
請提供：版本號、圈局及連莊次數、問題發生前的操作、預期結果、實際結果，以及畫面截圖。
若是牌局或計台問題，請在重設前複製 round.save 一併提供。
若無法啟動，請提供 macOS 版本及晶片型號及錯誤訊息。

本程式使用 Godot 引擎；授權資訊請見隨附的 GODOT-LICENSE.txt 及 GODOT-COPYRIGHT.txt。

此試玩包使用 ad-hoc 簽章，尚未經 Apple 公證。若 macOS 阻擋，請確認檔案來源後到「系統設定 → 隱私權與安全性」選擇「強制打開」。

【建置版本辨識】
畫面顯示版本與短提交；星號代表建置時包含未提交修改。回報問題時可附上 ZIP 內的 build-info.json，內含完整來源提交、來源雜湊、平台與建置時間。

【雙候選提示】
輪到你出牌且提示 ON 時，推薦／備選會列出向聽、有效進張未見數與相對風險。點候選只選牌，再點已選手牌或按打出才出牌。滑鼠停留可看有效牌清單；Auto 仍使用主要推薦。

【牌桌動畫】
摸牌、出牌、吃碰槓胡會播放短動畫；Auto 加速播放。
主選單 → 設定 → 牌桌動畫，可開關並記住選擇。
動畫期間暫時鎖定操作，完成後即可繼續出牌。

【語音與主題】
主選單 → 設定：語音可選關閉／國語／台語／日文，BGM、音效、語音各有獨立音量。
國語與日文使用內建語音，不需要安裝系統文字轉語音。國語可選男聲／女聲1／女聲2，日文可選男聲／女聲；從下拉選單直接選擇並試聽。
台語待補錄音；存檔目錄的 voices/nan/ 放入 chi.wav、pong.wav、kong.wav、win.wav、self_win.wav 五句 PCM WAV 即可。
牌桌可選經典綠／午夜藍／暖紫，牌背可選翡翠／靛藍／櫻紅；設定自動保存。

【授權】
本遊戲免費供個人非商業遊玩，可下載、安裝、備份或自行建置。歡迎分享官方下載連結；未經許可不得重新散布、改名重發、發布修改版本、販售或用於其他商業產品。完整範圍與例外見隨附 LICENSE.txt。Godot 與其他第三方元件依各自授權。
官方下載：https://github.com/twsam/qingzhu-mahjong/releases

【過水】
過水中仍可自摸（包含補牌自摸），但不能胡別人的捨牌或搶加槓。狀態列顯示「過水中（可自摸）」。打出、暗槓或加槓非進入過水時所聽的牌可解除限制；只摸牌或吃碰不解除。

【宣告聽牌】
選牌後按「宣告聽牌 +1台」，確認會打出該牌並鎖牌。胡牌另加 1 台；此後只能摸什麼打什麼，不能吃碰槓，可胡牌、自摸及正常補花。不宣告仍可正常遊玩。過水中仍可自摸，胡別人的牌須依過水規則解除限制。AI 與 Auto 也會選擇是否宣告。
存檔格式更新為 v5，舊存檔可升級並保留備份，舊版遊戲無法讀取新版存檔。

宣告聽牌時會播放約 0.8 秒的「聽！」動畫，標示宣告者並搭配提示音效；Auto 縮短為約 0.28 秒。關閉牌桌動畫仍保留「已聽」狀態，音效可獨立關閉。

【發牌動畫】
開局發牌動畫約 2.7 秒：四家依莊家順序每次取四張，共四輪，莊家多取一張後依序展示補花。可按「跳過發牌動畫」，Auto 約 1.4 秒；關閉牌桌動畫時直接完成。動畫只呈現發牌結果，不影響牌序與存檔；對手手牌始終以牌背顯示。

【鍵盤操作】
←／→ 選牌；Enter、數字鍵盤 Enter 或空白鍵打出已選牌，長按不會連續執行。
吃／碰／槓／胡／過可用 ←／→ 切換，空白鍵或 Enter 確認；自摸／暗槓／加槓可從最後一張手牌按 → 選到。Tab／Shift+Tab 也可切換按鈕；空白鍵執行框選的吃／碰／槓／胡等動作，吃牌預覽仍須確認。開局空白鍵可擲骰、取牌，平時自動摸牌。
Esc 關閉對話框／吃牌預覽；牌桌上開啟主選單，選單內返回上一層。
暫停、Auto、動畫與對手回合不接受鍵盤出牌；宣告聽牌後只可打出新摸牌。
