安裝與使用教學

1. 拿到開通信之後：下載、解壓縮

我們確認收到你的付款之後，系統會自動寄一封信到你留的 Email，主旨是 「【RPA 服務平台】您的授權已開通」。信裡有你的授權碼（一長串英數字）、 到期日，以及一個「下載安裝包」按鈕。

點「下載安裝包」會下載一個壓縮檔，檔名是 booking-chiayi.zip。

這個下載連結有兩個限制：

超過時限或用完次數，連結會失效，可以自己到「我的授權」頁重新申請一份新的。

下載回來的 zip 檔，滑鼠右鍵點它 →「解壓縮全部」，選一個你記得住的地方 （例如「文件」資料夾；不建議放桌面，避免日後不小心刪到）。 解開後會得到一個「嘉義街頭藝人登記」資料夾，之後所有步驟都在這個資料夾裡操作。

2. 載入 Chrome 擴充

只要做一次（除非之後我們通知擴充有更新）。

1. 打開 Chrome，網址列輸入：chrome://extensions
2. 右上角把「開發人員模式」打開
3. 點「載入未封裝項目」
4. 選你解壓縮出來的資料夾底下的 chrome-extension 資料夾（不是外層那個大資料夾）。
   選取時請用滑鼠單擊 chrome-extension，再用滑鼠點「選擇資料夾」按鈕——按鍵盤 Enter 不會完成選取，只會進到資料夾裡面。
   如果要在視窗上方的路徑欄直接貼上路徑，分隔符號要用反斜線「\」，用「/」會出現「資料夾名稱無效」。
5. 載入後會看到一個叫「WebOP 嘉義街頭藝人登記」的擴充

這個擴充要保持啟用狀態，不要之後手動關掉——關掉之後主程式會顯示「擴充未連線」， 登記完全跑不動（見第 10 節）。

3. 啟動主程式

雙擊 嘉義街頭藝人登記.exe。

• 會跳出一個黑色視窗，那是程式本體在背景執行，不要關掉它，可以縮到工作列。
• 幾秒鐘後瀏覽器會自動打開，網址是 http://127.0.0.1:12350/run，這就是操作台。 之後也可以自己在瀏覽器輸入這個網址回到操作台。

操作台上方有五個分頁：

畫面最上面一列有一個小圓點：灰色＝閒置，亮綠色＝執行中。

第一次啟動要做的事：填授權碼（第 4 節）、新增至少一位表演者（第 5 節）。 資料夾（照片、工作單、紀錄）不需要另外設定——就是主程式所在的那個資料夾，子資料夾會自動建立。

4. 授權碼填在哪

直接在操作台畫面上貼授權碼就好，不用碰任何檔案。只要做一次：

1. 雙擊主程式，等操作畫面自動打開
2. 畫面上方會出現紅色的「尚未啟用」區塊，裡面有一個輸入框
3. 把開通信裡的授權碼（32 碼英數字）貼進去，按「儲存並啟用」
4. 畫面立刻顯示結果：成功會出現「授權有效」與到期日，紅色區塊消失；失敗會直接寫出原因 （例如授權碼貼錯、電腦台數已用完、連不上網路）

進階做法（一般客戶用不到）：也可以自己在 runtime 資料夾建立 license_config.json， 內容為 {"license_key": "你的授權碼"}，效果相同。舊版本只能用這個方式，已經這樣設定過的不必改。

啟用之後，操作台右上角會出現一個授權狀態小標籤：

• 授權 ○○○ · 到期 2026-12-31 · api（綠底）：代表已生效
• 授權異常（紅底）：例如「授權異常：查無此授權金鑰」，請確認授權碼有沒有貼錯
• 還沒建立設定檔、或檔案裡沒有授權碼時，會顯示「尚未填入授權碼」，請照上面步驟設定

授權檢查每 4 分鐘在背景自動做一次，不用手動按什麼按鈕去「連線」。

授權沒通過的話，「開始」按鈕按下去會直接被拒絕——這是刻意的設計，不是故障。

5. 新增表演者、上傳街頭藝人證

到「表演者」分頁，按「＋ 新增表演者」。

要填的欄位：

帳號格式檢查：登入帳號沒填 09 開頭 10 碼手機格式，存檔時會跳出 「登入帳號要是 09 開頭 10 碼手機」。

密碼與身分證字號只寫不讀：每次打開編輯畫面這兩欄都是空的，留空代表不變更，不是「清空」。

證件圖上傳規則：

• 大小上限 10MB，超過會出現「證件圖超過 10MB」
• 上傳後檔名會自動改成表演者代號，之後就算改姓名，系統照樣找得到這張圖

存檔成功後，表演者清單會馬上更新。

授權可能限制表演者人數：如果你的授權有設「最多幾位表演者」的上限，新增到超過上限時會出現 「目前授權最多 N 位表演者（已建立 N 位）。要增加請聯絡供應商。」 這個限制只擋新增，不擋你編輯已經建好的資料。

刪除表演者：按「編輯」進去、下方「刪除這位」，會跳確認框 「確定刪除這位表演者的憑證？證件圖不會被刪。」——證件圖檔案不會被連帶刪除。

6. 建立工作單

到「工作單」分頁。

新增一筆：選姓名、填日期（格式一定要是 2026/10/14 這種四碼年／二碼月／二碼日， 斜線分隔）、填次數，按「新增」。

「次數」的意思要弄清楚：工作單上的次數是「這個日期總共要跑滿幾筆」的目標， 不是你按一次「開始」就會自動跑那麼多。「執行」分頁上也有這段提示：

工作單表格每一列會即時顯示：已完成 / 剩餘 / 進度條 / 預估還要多久。

修改次數後，畫面上會出現「有未儲存的變更」標籤，一定要按「儲存」才會真的寫進去； 按「放棄變更」可以取消。 執行中的時候，工作單整頁鎖住不能改（見第 8 節）。

工作單的存放位置可以在「設定」分頁看到。

7. 執行登記

到「執行」分頁。

1. 上方「作用中的表演者」下拉選單選人，按「切換」——這套軟體一次只跑一位表演者， 要換人一定要在這裡切換（提示文字：「一次只跑這一位。要換人請在上面選好再按切換。」）。 如果你的授權有開通多人模式，可以勾選「多人一起排」，同時勾選多位表演者， 用同一組日期／次數一起登記；沒開通的話這個選項會是灰色不能點。
2. 選「工作單」下拉（會列出這位表演者的每一筆目標），或直接填「日期」與「這次要跑幾筆」。
3. 按「帶入剩餘」可以把選定日期「還沒跑完的次數」自動帶進「這次要跑幾筆」欄位—— 如果已經跑滿了，會提醒你「這筆已經跑滿了」，並把筆數先帶成 1。
4. 「單筆失敗重試」：預設 1 次，代表單筆卡住失敗時自動再試幾次。
5. 想先看看會跑什麼、不想真的送出，勾選「試算：只列出要跑什麼，不開瀏覽器、不送件」。
6. 按「開始」。

按「開始」之前系統會先做這些檢查，任何一項沒過都會直接跳出訊息、不會開始跑：

• 授權是否有效
• 是否已經有另一批在跑
• 是否有其他分頁也開著操作台（多開分頁會鎖住不能按開始）
• Chrome 擴充是否已連線（試算模式不受此限）
• 是否選了作用中的表演者、有沒有上傳證件圖
• 授權的「每日登記上限」是否會被超過

以上任何一項擋下時看到的實際文字，見第 10 節。

8. 怎麼看進度、預估還要多久

「執行」分頁上方四張卡片：

下方「這位的工作單」表格顯示這位表演者每個日期的已完成／總數／進度條／剩餘／預估還要。

預估時間怎麼算：用「單筆耗時的中位數」乘以「剩餘筆數」，不是用平均——因為單筆耗時 從 30 秒到 2 分鐘都有可能，平均會被極端值拉歪，中位數比較穩。 樣本優先用「這位表演者、這個日期」自己的紀錄，不足 3 筆才用最近 30 筆的整體中位數； 完全沒有樣本時會顯示「—」，不會硬編一個數字給你看。

點開「即時日誌（點擊展開）」可以看逐行的執行紀錄，來源可切換「批次」或「單筆細節」。

執行中，整個畫面會進入「唯讀」狀態：工作單、表演者、切換人員全部鎖住不能改， 畫面上會出現一條橘色提示「批次執行中 —— 工作單、表演者、切換人員都暫時鎖住了， 這時候只能看進度與日誌。要改東西請先按「中止」。」就算是別的畫面（例如你重開了程式）啟動的那一批， 一樣會被偵測到、一樣鎖住，訊息會多一句「這批不是從目前這個畫面開始的」。

9. 怎麼中止

「執行」分頁按「中止」。

• 已經跑完的筆數不會被撤銷，紀錄都留著。
• 中止後可以馬上再按「開始」重新排，不會重複跑已經成功的那幾筆 （工作單的「已完成」數字是照全部歷史紀錄算的，不是只看這一批）。

10. 常見錯誤訊息怎麼判讀

下面每一句都是畫面上實際會出現的訊息。

「執行」分頁按不下去 / 按了跳出訊息

授權訊息（右上角小標籤，或「開始」被擋時顯示）

「開始登記」之後，單筆失敗時，「歷史」分頁「案號 / 原因」欄常見內容

這些訊息的完整版在紀錄檔裡（見第 11 節），「歷史」分頁只顯示前 300 字。

11. 出問題要回報時，該給我們什麼

所有紀錄都在主程式資料夾底下的 logs 資料夾：

回報問題時請寄到 shawn@aaservice.cc，並提供：

1. 出問題那個時間點附近、最新的那幾個 batch_*.log、batch_*.jsonl、 chiayi_apply_*.log（照檔名時間戳找）
2. 「歷史」分頁上那一筆的畫面截圖（或「案號 / 原因」欄的文字）
3. 大概發生的時間、當時做了什麼操作
4. 你的授權碼或訂單編號

不用整包 logs 資料夾都傳，抓最相關的幾個檔案就好——檔名裡的時間戳會告訴我們哪幾份 是同一次執行留下的。

常見問題 → ／ 回產品介紹 →