Tiếng Việt | English
Tool tự động hoá công việc hằng ngày (daily) cho Stella Sora (bản EN) trên giả lập Android. Kiến trúc lấy cảm hứng từ AzurLaneAutoScript (ALAS): điều khiển qua ADB, nhận diện màn hình bằng template matching (OpenCV), scheduler tự hẹn giờ từng task.
⚠️ Đây là dự án cá nhân, phi thương mại, phục vụ học tập. Vui lòng đọc kỹ phần Tuyên bố & Điều khoản sử dụng trước khi dùng.
Dành cho người dùng cuối — không cần cài đặt gì ngoài giả lập:
- Vào trang Releases → tải file
StellaSoraTool-vX.Y.Z-win64.zipmới nhất. - Giải nén cả thư mục ra ổ đĩa — giữ nguyên
app.exe,_internal/vàassets/cạnh nhau (đừng tách rời). - Mở giả lập Android (khuyến nghị MuMu Player), bật ADB, đăng nhập Stella Sora (EN) về màn hình Home.
- Chạy
app.exe. Lần đầu: vào Cấu hình nhập Serial ADB (vd127.0.0.1:16384) và đường dẫn adb.exe. - Bật các task muốn chạy → bấm Start.
config/vàlog/sẽ tự tạo cạnhapp.exekhi chạy lần đầu. Không cần cài Python.
🧩 Nếu
app.exebáo lỗi "Failed to resolve Python.Runtime…" (giao diện desktop dùng WebView2/.NET):
- Cách nhanh nhất: khi báo lỗi, bấm Yes để mở bằng giao diện WEB (trình duyệt) — không cần .NET, chạy mọi máy. Hoặc chạy thẳng
app.exe --web.- Muốn dùng bản desktop thì thử: (1) giải nén tool vào đường dẫn KHÔNG dấu (vd
C:\StellaSoraTool, tránh thư mục có tên tiếng Việt có dấu); (2) chuột phải file.zip→ Properties → Unblock → giải nén lại; (3) máy Windows cũ thì cài .NET Framework 4.8
⚠️ Screenshot adb PHẢI ra đúng1280 × 720(rộng × cao — game chạy ngang/landscape). Đây chính là con số mà panel "Android Device" của MuMu hiển thị (1280 × 720 | 240 DPI). Tool nhận diện bằng ảnh mẫu ở đúng kích thước này và không tự co giãn; đặt sang độ phân giải khác (1080×1920, 1600×900, custom…) sẽ khiến tool báo lỗi và dừng. Ngược lại, kéo to/thu nhỏ hay zoom CỬA SỔ MuMu trên desktop thì vô hại (adb chụp framebuffer Android, độc lập với cửa sổ hiển thị) — cứ zoom thoải mái để nhìn.
📖 Chi tiết từng task & tuỳ chọn cấu hình: CHANGELOG_VN.md.
Tool kết nối thuần bằng ADB (không dùng API riêng của MuMu), nên chạy được với mọi giả lập Android có ADB. Đổi giả lập chỉ cần chỉnh 2 ô trong Cấu hình cho khớp:
- Bật ADB trong cài đặt giả lập (mỗi hãng một chỗ — xem cột cuối bảng).
- Đặt độ phân giải
1280 × 720(rộng × cao, game chạy ngang) — bắt buộc; sai số này tool báo lỗi và dừng ngay (tool nhận diện bằng ảnh mẫu đúng kích thước, không tự co giãn). - Mở cửa sổ dòng lệnh, chạy
adb devicesđể lấy đúng Serial (vd127.0.0.1:5555). - Vào Cấu hình nhập Serial + đường dẫn adb.exe → Lưu.
| Giả lập | Serial (cổng ADB) thường gặp | adb.exe kèm theo (ví dụ) | Bật ADB ở đâu |
|---|---|---|---|
| MuMu Player (mặc định) | 127.0.0.1:16384 |
…\MuMuPlayerGlobal\nx_device\12.0\shell\adb.exe |
Bật sẵn |
| LDPlayer | 127.0.0.1:5555 |
…\LDPlayer9\adb.exe |
Settings → Other settings → ADB debugging: Open local connection |
| BlueStacks 5 | 127.0.0.1:5555 |
…\BlueStacks_nxt\HD-Adb.exe |
Settings → Advanced → Android Debug Bridge |
| Nox | 127.0.0.1:62001 |
…\Nox\bin\nox_adb.exe |
Bật sẵn |
| MEmu | 127.0.0.1:21503 |
…\Microvirt\MEmu\adb.exe |
Bật sẵn |
💡 Cổng ADB có thể khác theo phiên bản hoặc khi mở nhiều instance — cứ chạy
adb devicesđể lấy đúng serial. Nếu không muốn dùng adb.exe kèm giả lập, gõadbở ô đường dẫn (khi máy đã cài adb và có trong PATH). Mặc định của tool đang tinh chỉnh cho MuMu; giả lập khác chỉ cần đổi 2 ô này.
Login · Mail · Dispatch (Commission) · Shop · BountyTrial · Ascension · EventDaily ·
EventFirstClear · Grant · DailyReward · Cleanup
Nhóm Event (trong sidebar app) gồm 2 task: Event Daily (Quick Battle sweep stage đã master, tiêu Vigor) và Event First Clear (tự đánh Deploy + Auto-Battle các stage còn sao xám để lấy quà First Clear).
Xem mô tả đầy đủ trong CHANGELOG_VN.md.
Bản PC (client Windows) của Stella Sora chống tự-động-hoá: game lọc bỏ mọi thao tác click "nhân tạo" (injected), nên tool điều khiển được màn hình nhưng không bấm được nút. Đã khảo sát & dựng thử backend PC (chụp màn hình bằng WGC chạy rất tốt) nhưng phải dừng vì rào cản này. SST vì thế chỉ chạy trên giả lập Android qua ADB — nơi input được bơm ở tầng hệ điều hành, ngoài tầm chặn của game (giống ALAS / StarRailCopilot / MaaStellaSora).
📄 Chi tiết kỹ thuật + cách xem lại code đã khảo sát: docs/pc-backend-rejected.md.
python -m venv venv
venv\Scripts\pip install -r requirements.txtYêu cầu: giả lập Android chạy game ở 1280x720 (đã test MuMu Player Global), adb.exe kèm giả lập.
| Lệnh | Chế độ |
|---|---|
python app.py |
App desktop kiểu Alas (cửa sổ WebView2, khuyến nghị) |
python gui.py |
Web UI tại http://localhost:22270 |
python sst.py |
CLI — vòng lặp scheduler 24/7 |
python sst.py <Task> |
CLI — chạy 1 task rồi thoát |
Lần chạy đầu tự tạo config/stella.json — sửa serial và đường dẫn adb.exe theo giả lập của máy.
venv\Scripts\pyinstaller.exe --noconfirm app.specKết quả: dist\app\app.exe + _internal\ + assets\. assets/ phải nằm cạnh exe;
config/ và log/ tự tạo cạnh exe khi chạy.
Tạo GitHub Release bằng 1 lệnh (cần GitHub CLI đã đăng nhập: gh auth login):
# 1) Thêm mục "## vX.Y.Z" vào CHANGELOG_EN.md (script lấy notes từ đây)
# 2) Chạy:
.\dev_tools\release.ps1 -Version 0.1.1 -PreReleaseScript tự động: build exe → đóng gói StellaSoraTool-vX.Y.Z-win64.zip → trích notes từ CHANGELOG →
tạo tag + release + upload zip. Thêm -DryRun để chạy thử (không đụng GitHub), -SkipBuild để dùng
lại bản build sẵn.
Đọc kỹ trước khi tải hoặc sử dụng. Bằng việc tải/sử dụng tool, bạn đồng ý với toàn bộ điều khoản dưới đây.
- Dự án cá nhân, phi thương mại. Được phát triển với mục đích học tập, nghiên cứu về tự động hoá. Không phải sản phẩm thương mại.
- Không liên kết với nhà phát hành. Dự án không được tài trợ, xác nhận hay liên kết với YoStar hoặc nhà phát hành Stella Sora dưới bất kỳ hình thức nào. "Stella Sora" cùng mọi thương hiệu, logo, tài sản liên quan thuộc quyền sở hữu của chủ sở hữu tương ứng.
- Miễn phí — NGHIÊM CẤM thương mại hoá & sử dụng phạm pháp. Cụ thể cấm:
- Bán, cho thuê, thu phí phân phối hoặc đóng gói lại tool này để kiếm lời.
- Dùng tool để vận hành dịch vụ cày thuê, buôn bán tài khoản/tài nguyên game trái phép.
- Dùng vào bất kỳ mục đích vi phạm pháp luật nào (gian lận, lừa đảo, rửa tiền, phá hoại...).
- Rủi ro tài khoản. Tự động hoá có thể vi phạm Điều khoản dịch vụ (ToS/EULA) của game và dẫn tới khoá tài khoản. Bạn tự chịu hoàn toàn rủi ro khi sử dụng.
- Miễn trừ trách nhiệm. Phần mềm cung cấp "nguyên trạng" (AS IS), không kèm bất kỳ bảo hành nào. Tác giả không chịu trách nhiệm cho mọi thiệt hại, mất mát tài khoản/tài sản ảo, hay hậu quả pháp lý phát sinh từ việc sử dụng hoặc lạm dụng tool.
- Quyền riêng tư. Tool không thu thập hay gửi thông tin tài khoản đi bất kỳ đâu; mọi cấu hình (serial/adb) do bạn tự nhập và chỉ lưu cục bộ trên máy.
- Gỡ bỏ theo yêu cầu. Nếu nhà phát hành/chủ sở hữu quyền hợp pháp yêu cầu, dự án sẽ ngừng phân phối.
Phát hành theo PolyForm Noncommercial License 1.0.0 — được phép dùng, sửa và chia sẻ cho mục đích phi thương mại; mọi hình thức sử dụng thương mại đều bị cấm.
- 📖 docs/huong-dan-su-dung.md — Hướng dẫn sử dụng đầy đủ (cài đặt → cấu hình → từng chức năng, có ảnh minh hoạ). Bản English · 日本語.
- CHANGELOG_VN.md / CHANGELOG_EN.md — chi tiết bản phát hành.
docs/game-map.md— bản đồ màn hình / điều hướng trong game.- docs/pc-backend-rejected.md — vì sao không hỗ trợ bản PC.