Beanfun

遊戲橘子旗下科技紅利遊戲的第三方啟動器

免責聲明： 本軟體 不是 遊戲橘子旗下科技所開發的官方客戶端程式。若您的帳號使用第三方的方式登錄，請自行三思並且確認下載當前程式的來源是否安全。

• 本程式使用部份 BeanfunLogin 的代碼。
• 程式使用 Locale_Remulator 作為語言模擬元件，支援 32-bit 及 64-bit 遊戲。

---

下載與使用 (Getting Started)

系統要求 (Prerequisites)

• 作業系統： Windows 10 或以上
• 必備元件： WebView2 Runtime（Windows 11 已預裝）

使用方法 (Usage)

前往 最新發行版 (Releases) 下載：

版本	檔案	說明
免安裝版	Beanfun.exe	放至任意全英文路徑的資料夾，直接執行即可。需系統已安裝 WebView2 Runtime。
安裝版	Beanfun_x.x.x_x64-setup.exe	適用於精簡版 Windows 等未預裝 WebView2 的環境，安裝過程會自動安裝 WebView2 Runtime。

⚠ 注意事項說明：

• 啟動遊戲時程式會在執行資料夾生成 LRProc.exe、LRHookx32.dll、LRHookx64.dll 等件。
• LRProc.exe — 負責 Hook DLL 載入至程序中
• LRHookx32.dll / LRHookx64.dll — 語言模擬元件

---

技術棧 (Built With)

• Tauri v2 — 桌面殼層（WebView2）
• Rust — 後端核心
• Vue 3 + TypeScript + Vite — 前端框架
• Element Plus — UI 元件庫
• Locale_Remulator — 語言模擬元件

---

架構 (Architecture)

Beanfun/
├── src/                     # Vue 3 前端
│   ├── pages/               #   頁面元件 (Login, GameList, Settings…)
│   ├── composables/         #   組合式函式 (useAuth, useGameLauncher…)
│   ├── stores/              #   Pinia 狀態管理
│   ├── services/            #   Tauri IPC 呼叫封裝
│   ├── i18n / locales/      #   vue-i18n 多語系
│   ├── styles/              #   全域樣式
│   └── windows/             #   多視窗進入點 (In-App Browser)
├── src-tauri/               # Rust 後端 (Tauri v2)
│   ├── src/
│   │   ├── commands/        #     IPC command handlers
│   │   ├── core/            #     核心邏輯 (parser, crypto, version)
│   │   └── services/        #     服務層
│   │       ├── beanfun/     #       登入 / 帳號 / session
│   │       ├── config/      #       XML 設定檔讀寫
│   │       ├── game/        #       遊戲啟動 + LocaleRemulator
│   │       ├── process/     #       視窗操作 / PostMessage
│   │       ├── storage/     #       Users.dat 加解密 (DPAPI)
│   │       ├── registry/    #       Windows Registry
│   │       ├── updater/     #       自動更新檢查
│   │       └── system/      #       系統工具 (open URL…)
│   ├── LocaleRemulator/     #     LR 預編譯二進位檔
│   └── tests/               #     整合測試
├── tests/                   # 前端單元測試 (Vitest)
├── scripts/                 # 建置 / 轉換腳本
├── Lang/                    # WPF 時代 XAML 語系檔 → i18n 來源
└── .github/workflows/       # CI (lint, format, test, build)

---

開發 (Development)

環境需求

需求	版本
Node.js	>= 22 LTS
Rust	stable (x86_64-pc-windows-msvc)
WebView2 Runtime	Windows 11 預裝；Windows 10 需安裝
Visual Studio Build Tools	安裝 Desktop development with C++

快速開始

npm install
npm run tauri dev

常用指令

# 前端
npm run lint              # ESLint
npm run format:check      # Prettier
npm run typecheck         # TypeScript 型別檢查
npm run test              # Vitest 單元測試

# 後端 (src-tauri/)
cargo fmt --check         # Rust 格式檢查
cargo clippy -- -D warnings
cargo test

---

貢獻 (Contributing)

1. 從 code 分支出新 feature branch。
2. PR 到 code 時會跑 CI（lint / format / typecheck / test）。
3. 送 PR 前請先跑 npm run format + cargo fmt。