TixCraft 購票助理 (TixCraftAutoSystem)

一款專為 TixCraft 設計的桌面版購票輔助工具，透過直覺的圖形化介面、驗證碼辨識輔助與排程提醒，協助你在繁瑣的購票流程中更從容地完成每一個步驟。 支援 macOS 與 Windows。

⚠️ 本工具僅作為個人購票流程的輔助使用，並供學術研究參考。使用前請詳閱並遵守 TixCraft 服務條款與各活動規範，並尊重其他購票者的權益。

---

✨ 功能特色

• 🎯 設定一次，重複使用：把活動 ID、場次與票區關鍵字儲存起來，下次直接套用
• 🕒 排程提醒：在開賣前自動開啟流程，不用守著時鐘
• 🧠 驗證碼辨識輔助：自動嘗試辨識，若信心不足會主動請你確認
• 🙋 人工補登後援：登入、付款等敏感步驟一律由你親自操作
• 📧 完成後 email 通知：購票結果可寄到你的 Gmail
• 🔔 版本更新提示：有新版時會在側邊欄提醒，到「關於」頁一鍵下載

---

📦 下載

到 Releases 下載對應系統的版本：

系統	檔案
macOS (Apple Silicon, M1/M2/M3)	TixCraft-mac-arm64.zip
macOS (Intel)	TixCraft-mac-x64.zip
Windows 10/11 (x64)	TixCraft-win-x64.zip

macOS 安裝

1. 解壓縮後，把 TixCraft.app 拖到 /Applications/
2. 第一次開啟：右鍵 → 開啟 → 開啟（因為未簽章，Gatekeeper 會擋下雙擊）
3. 如果跳 Operation not permitted：到 系統設定 → 隱私權與安全性 點「強制開啟」

Windows 安裝

1. 解壓縮整個 TixCraft\ 資料夾到任意位置（建議桌面或 C:\Tools\）
2. 雙擊 TixCraft.exe 啟動
3. SmartScreen 警告：點「其他資訊 → 仍要執行」

先決條件

• 系統已安裝 Google Chrome（最新穩定版），助理會自動配對對應的 chromedriver
• 首次執行需要網路下載 chromedriver（約 15MB）

---

🖥️ 使用流程

1. 打開 App，到「設定」頁填寫購票偏好：
   • 活動 ID（網址 https://tixcraft.com/activity/game/<id> 中的 <id>）
   • 演出時間關鍵字、票價/區域關鍵字、票數
   • 想預先準備的話，勾選「依排程時間開始購票」並指定時間
   • （選填）填入 Gmail 帳號與 App password，完成後可收到 email 通知
2. 按下「儲存設定」
3. 切換到「執行」頁，按「啟動瀏覽器登入」
4. 在跳出的 Chrome 視窗中親自登入 TixCraft 帳號
5. 回到 App，按下「開始購票」，助理會依照你設定的偏好協助開啟對應頁面、填入資訊
6. 驗證碼若辨識信心不足，App 會跳出對話框，由你親自確認後再繼續
7. 結帳與付款步驟請自行於瀏覽器中完成，確保交易由本人授權

---

🔄 版本更新

App 啟動時會背景查詢 GitHub Releases 最新版本。有新版時，側邊欄會出現「✦ 有新版本」提示，到「關於」頁可直接點「下載更新」開啟對應檔案。

---

🛠️ 從原始碼開發 / 自行打包

需求

• Python 3.10+（建議 3.10 或 3.12）
• Google Chrome

安裝

python3 -m venv .venv
source .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements-dev.txt

啟動 GUI

python gui.py

啟動 CLI（命令列流程）

python main.py

打包成 .app / .exe

# macOS
./build/build_mac.sh
# Windows
build\build_win.bat

產物在 dist/。

設定檔位置

• 開發模式：專案根目錄的 config.json / .env
• 打包後：
  • macOS：~/Library/Application Support/TixCraftAutoSystem/
  • Windows：%APPDATA%\TixCraftAutoSystem\

config.json 欄位

詳見 docs/config.md。

---

📦 發佈新版本

# 1. 改 version.json 的 version
# 2. 提交、打 tag、推上去
git tag v0.2.1
git push origin v0.2.1

推 tag 後，GitHub Actions 會自動：

• 在 macOS Apple Silicon、macOS Intel、Windows x64 三平台打包
• 把 zip 上傳到 Release
• 使用者打開 App 後即會收到更新提示

---

🐞 問題回報

到 Issues 開單，附上：

• 作業系統 + App 版本（在「關於」頁可看到）
• log 輸出（「執行」頁右下角可複製）
• 重現步驟