# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Commands

```bash
# Install dependencies
pip install -r requirements.txt

# Run the CLI
python giftcenter.py login              # account info (gift center)
python giftcenter.py redeem <gift_code> # redeem a gift code
python giftcenter.py profile            # full profile: power/level/alliance
python giftcenter.py news               # game announcements (no UID needed)
python giftcenter.py info               # region / latest APK url (no UID needed)

# Override UID without editing .env (on login/redeem/profile)
python giftcenter.py --uid <uid> profile
```

## Configuration

UID is read from the `UID` environment variable, typically set in `.env`. The `--uid` flag on any subcommand overrides it.

## Architecture

Single-file Python CLI (`giftcenter.py`) using `argparse` subcommands across two backends:

`giftcenter.last-z.com` (helper: inline `requests` calls):
- `login` → `cmd_login()` — GET `/getcodeuser.php?uid=...`, displays account info
- `redeem <code>` → `cmd_redeem()` — GET `/code.php` with `Usertoken` header and `uid`/`code` params

`store.last-z.com` (`STORE_URL`):
- `profile` → `cmd_profile()` — `store_auth("getuserhome.php", uid)`, prints fields from `PROFILE_FIELDS`
- `news` → `cmd_news()` — `store_post("getsite_new.php")` (public, no auth)
- `info` → `cmd_info()` — `store_post("getindex.php")` (public, no auth)

Two store helpers: `store_post(endpoint)` for public endpoints (empty POST body), and
`store_auth(endpoint, uid)` for private ones. **Store "auth" is just the UID** — sent as both the
`Usertoken` header and the `{uid}` POST body; there is no password. (`getuser.php` is the exception —
it needs a recaptcha `loginToken` + AES `signature`, so `profile` uses `getuserhome.php` instead.)
Adding more store reads (`getmail.php`, `getuseritem.php`, `gettask_new.php`) is a one-liner via `store_auth`.

API responses use numeric error codes (`code` field) for login and string error codes (`errorCode`
field, value `"ok"` on success) for redemption. Error mappings are in `LOGIN_ERRORS` and
`REDEEM_ERRORS` constants. UI text is in Traditional Chinese.