出單站（集中列印）

出單站是「一台固定的 Windows 電腦，負責把全店的單印到各廚房出單機」。

沒有出單站時，是誰送單、誰的裝置就負責印。這在 iPad 點餐或顧客手機掃碼點餐時會失敗——那些裝置連不到廚房印表機。開了出單站之後，這些單會先進伺服器佇列，再由這台固定電腦統一印出來。

兩種模式：先確認您的門市是哪一種

「誰去把佇列裡的單領出來印」有兩種做法，操作方式完全不同：

模式 A：瀏覽器出單站

開機後請「點一下畫面」（唯一需要您配合的動作）

這一頁載入之後，畫面上通常會蓋一層提示：「點一下畫面開始出單」。請直接用滑鼠點畫面上任何一個地方（點哪裡都可以，鍵盤按任一鍵也可以），提示就會消失、開始正常出單。

開機自動開啟、重新整理、斷電復原、按了「有新版 · 點此更新」——每一次重新載入之後都要再點一次。（少數瀏覽器會自己放行，那就不會出現這層提示，直接看下方的狀態文字確認即可。）

用模式 B 的門市，這一層提示還是會出現。點不點都不影響出單（那是常駐程式在做），但建議還是點一下——常駐程式萬一掛掉時，接手的就是這個分頁。

怎麼確認已經生效

看畫面上方那一行狀態文字：

看到紅字時的處理方式：把出單站這個分頁切到最前面（不要被其他視窗蓋住）、點一下畫面，數字就會回到 3 秒左右。

少數電腦（例如完全沒有音效裝置的主機）點了之後仍會停在橘字。這種情況請把出單站分頁保持在最前景、不要最小化，並定期看一眼上面那行紅字警告有沒有出現。

有新版時不會自己重新載入

出單站是基礎設施，不是一般後台頁面——它整天開著、沒人盯著看。所以系統有新版時，這一頁刻意不自動更新，而是在右上角出現一顆藍色按鈕：有新版 · 點此更新。

請在沒有單在等著印的空檔按它。按下去會重新載入這一頁，順便完成上面說的那「點一下」。

模式 B：常駐出單程式（不用開著分頁）

Print Bridge v1.2.0 以上可以自己把「領單 → 列印 → 回報」跑完，不再需要那個瀏覽器分頁。分頁本來就是很脆弱的東西：會被瀏覽器降速、會被自動更新重新載入、會被人不小心關掉。出單程式則是開機就自動啟動、沒有分頁那些問題。

開通步驟

1. 後台進入 餐飲 POS → 設定 → 印表機，確認「出單站集中列印」是開啟的（沒開的話下一張卡片不會出現）。
2. 在下方 常駐出單站（不用開著瀏覽器分頁） 卡片，輸入一個看得懂的電腦名稱（例：中山店櫃檯 POS），按 產生密鑰。
3. 畫面會列出四個值。密鑰只顯示這一次，關掉就再也查不回來，只能重新產生。請先抄下來或拍照。
4. 到那台接印表機的電腦上，執行 install.bat（v1.2.0 以上的安裝包），走到 [5/6] Resident print station 那一步，依序填入那四個值。
5. 安裝程式會把四個值再列一次請您確認，確認無誤按 Y。
6. 回到出單站頁面，最上面的橫幅在一分鐘內會變成灰色的「出單站（看板與備援）」，代表接手成功。

install.bat 要填的四個值

安裝程式會依這個順序問：

station.json 是什麼

按 Y 之後，安裝程式會在出單程式旁邊寫一個設定檔：

%LOCALAPPDATA%\ugomk-print-bridge\station.json

這個檔就是模式 A / B 的唯一開關：

• 有這個檔 → 出單程式自己領單列印（模式 B）
• 沒有這個檔 → 和舊版 v1.1.3 完全一樣：只等後台把單送過來（模式 A）

所以要退回模式 A，把這個檔刪掉再重開出單程式即可。重跑 install.bat 時若偵測到已存在的 station.json，會保留原檔不覆蓋（畫面會寫 Existing station.json found - keeping it.）。

備援規則：兩邊不會同時印，也不會兩邊都不印

出單程式每 20 秒向伺服器回報一次「我還活著」。伺服器據此決定誰去領單：

實測把出單程式強制關掉之後，分頁大約在 86 秒後恢復領單並印出積壓的單（60 秒的判定視窗 + 幾輪檢查的間隔）。這段期間的單不會不見，會排在佇列裡等人來領。

常駐程式沒有回報時

出單站頁面最上方會出現紅色警告：「常駐出單程式沒有回報，目前由本頁負責出單」，並寫出最後一次回報的時間。

看到這一格代表：

• 現在是這個分頁在出單——此時關掉分頁會停印
• 有一台電腦上的出單程式該被去看一眼

請依序確認那台電腦：開機了嗎 → 出單程式在跑嗎（工作管理員找 print-bridge.exe）→ 網路通嗎 → 後台這一站是不是被停用或刪掉了。

這一格和琥珀色那一格不是同一件事。琥珀色是「這家店本來就沒有常駐出單程式，分頁本來就該開著」；紅色是「本來該有卻沒有」——後者需要有人去處理，前者不用。

後台看得到什麼

餐飲 POS → 設定 → 印表機 → 常駐出單站 每 20 秒刷新一次，每一站顯示：

還會顯示版本、最後回報 / 最後領單時間，以及那台電腦回報的印表機錯誤（例如某台 IP 連不上）。

能力宣告（2026-09-01 起）

每一站底下多一行 能力宣告，顯示那台出單程式自己回報說它會做哪些事（例如 usb_print）。

這一行是拿來回答「為什麼這台領不到單」的。在這之前，這個值系統裡任何地方都查不到，只能從症狀往回猜。

USB 出單機與常駐出單程式的關係（很重要）

USB 出單機（用 USB 線直接接在電腦上的那種，見「出單機設定」）與網路印表機在出單站這裡有一個關鍵差別：

USB 印表機的單，只有「常駐出單程式」領得到；出單站分頁永遠領不到。

原因是 USB 列印必須由那台實體電腦上的程式執行，而瀏覽器分頁做不到 —— 它既沒有出單站身分，也不會回報自己支援 usb_print。

停用 / 換電腦 / 重新產生密鑰

出單站頁面上的資訊（兩種模式共用）

以下這些在兩種模式下都看得到。用模式 B 時，這一頁的角色是看板 + 備援——數字照樣是全店的，只是領單列印的人換成了出單程式。

畫面上的四個數字

四個數字都只統計最近 24 小時內產生的列印任務，不是開店以來的總數。

用這四個數字判斷問題出在哪

店家反映「等很久才出單」時，先看這四個數字：

待印任務去向與清除待印

2026-09-01 起提供。

四個數字只說得出「有幾張卡住」，說不出「卡在哪一台」。待印任務去向 這一塊就是回答後者的。

只有在待印大於 0 時才會出現（正常營業時待印接近 0，常駐一塊空面板只會變成背景雜訊）。出現時，每一台目標印表機各一列：位址、幾筆，以及一個狀態標籤。

三種狀態，處置方式完全不同

清除待印

面板右上角有一顆 清除待印（N）。按下去會先跳出確認視窗，列出目前每一台的去向與筆數，確認後才清。

清除待印不會補印。 這些單不會被印出來，需要的話請到訂單頁補印。列印紀錄仍然保留，事後查得到。

正在「列印中」的單不受影響，也不會被清掉 —— 那些已經被認領、可能紙都吐出來了。所以確認視窗上會寫明「列印中的 N 筆不在此列」。

已連接出單機

四個數字下方是本店所有啟用中出單機的清單，每一台一列：名稱、IP、連線狀態、紙張、最後出單、上次檢查。

右上角的 重新檢查 可以立刻重問一次全部。

連線狀態

紙張狀態

最後出單

顯示這台最近一次成功印出的時間，以及今日張數。

哪些單會進出單站

開了出單站模式之後，這些動作產生的單一律進佇列，由出單站那台電腦印：

同一張單重複加點一樣的菜，兩張廚房單都會印

客人先點一份「椒鹽鴨架骨」，過一會兒又加點同一道，兩次都會各出一張廚房單（2026-08-11 修正）。

在此之前，第二次那張會被系統誤判成「同一張單重送」而丟掉，廚房只收到一張 —— 影響的是一菜一張、單上不含金額的廚房工作單（單子內容完全一樣，系統分不出是網路重試還是客人真的又點一份）。現已可正確區分：

• 客人真的加點第二份 → 兩張都印
• 網路不穩導致同一次加點被送出兩次 → 仍然只印一張（防雙印不變）

失敗清單

送不出去的單會留在這裡，顯示送單時間（不是失敗當下的時間）、錯誤訊息、已嘗試次數，最新的排在最上面，最多顯示 50 筆。

• 重試：把該筆放回待印佇列，下一輪會再印一次
• 清除全部：一次清掉整份清單

失敗自動重印（每 5 秒）

失敗清單標題下方有一個勾選框 失敗自動重印（每 5 秒，持續重試到送單後 30 分鐘為止）。勾起來之後就不必守著畫面一筆一筆按重試，系統每 5 秒自己把失敗的單放回佇列再印一次。

這個開關是每間分店一份（不是每台電腦一份），預設開啟。關掉之後立刻停止自動重印。

開關有兩個入口，改哪一邊都一樣：

• POS 出單站頁面：失敗清單標題下方的勾選框
• 後台 餐飲 POS → 設定 → 出單機設定 → 失敗自動重印

為什麼有些單不會被自動重印

列印失敗分成兩種，畫面上會直接告訴您目前是哪一種狀況：

勾選後，勾選框下方會顯示目前這台電腦的狀態：

• 顯示「本機出單程式已支援防重複（v1.1.2+）」→ 兩種狀況都會自動重試，逾時的單重印也不會出現兩張。
• 顯示「本機出單程式版本較舊、無防重複功能」→ 只會自動重印「確定沒印出來」的那些；不確定的會告訴您還有幾筆，需要您自己判斷後按「重試」。把出單程式升級到 v1.1.2 以上，這些也能自動處理（請聯繫客服取得新版）。

這個保守做法是刻意的：「沒有在時限內回應」不等於「沒印出來」，若一律重送，那些其實已經印好的單會變成重複出紙。人工按重試時店員會自己判斷，自動化沒有這個判斷，只好交給出單程式的防重複機制把關。

印表機停用了會怎樣

在「印表機設定」把某台印表機停用之後：

• 新的單不會再送給它
• 停用之前還卡在「待印」的單，會在下次出單站運作時自動清掉（大約幾秒內），不會一直卡在那裡拖慢其他印表機

自動清掉的細節：

• 只清「待印」的單。已經進失敗清單的不會自動消失（那是查帳用的紀錄，要清請按「清除全部」）。
• 被清掉的單不會補印（那些單早就過去了，補印只會印出一疊廢紙），但列印紀錄仍保留、事後查得到。
• 把印表機重新啟用後，新的單照常送給它。
• 例外：若同一個 IP／連接埠上還有另一台仍啟用的印表機設定，這些單會被視為還有機器可印，不會被清掉。

一台印表機壞掉不會影響其他台

出單站會依印表機分組同時處理：A 廚房的機器故障時，B 廚房、櫃台的單照常印出，不會被卡住。

一台印表機一旦確定連不上，這一輪要送給它的其他單也會一起進失敗清單（不會每張各等一次逾時），所以壞掉那台的單會很快出現在失敗清單。修好之後按 重試 即可補印。

有單卡住：指派的出單站沒有上線

2026-09-04 新增。只有真的有單卡住時才會出現，平常看不到這塊。

出單機可以在後台指派專屬出單站（餐飲 POS → 設定 → 出單機設定 → 該台 編輯 → 指定出單站，見「指定出單站」）。指派之後，只有那一台電腦認領得到那台印表機的單。

那台電腦沒上線時，單不會失敗、不會進失敗清單、也不會自己消失，而是一直停在「待印」。畫面上看起來是：出單站頁面開著、一切正常、待印數字往上跳，就是不印。

所以 出單機設定頁最上方會出現一塊紅色警告：

有 N 張單卡住：指派的出單站沒有上線

裡面逐台列出是哪一台站、屬於哪一家分店、卡了幾張、最久那張等了多久，以及該怎麼處理：

判定門檻：常駐程式正常時每 3 秒認領一次；連續 90 秒沒有來認領才會被列出來（一次網路抖動或防毒掃描不會讓它亂叫）。被停用與已刪除的站不等時間，立刻列出 —— 那兩種等再久也不會自己好。

專屬出單站綁定（瀏覽器分頁專用）

這一節與上面的「指定出單站」是兩套不同的機制：這裡綁的是瀏覽器分頁，上面指派的是常駐出單程式。

可以指定「只有某一台電腦」能認領本店的列印任務，避免別台電腦誤搶單導致印到別的地方。

在該台電腦上按 設為本店出單站 即可。要換電腦時，在新電腦上按同一個按鈕（會覆蓋舊綁定）；不想限制了就按 解除綁定。