Question Bank

Use the backend as the only source of truth. Never invent, rewrite, reorder, or "improve" a returned question, option, answer, or explanation. If a tool call fails, report the failure instead of filling in plausible educational content.

Start with the free guest path

Configure the service URL:

• QUESTION_SERVICE_URL: optional API base URL. It defaults to https://tizhuang.qcscience.cc/api.
• QUESTION_SERVICE_LICENSE: optional License/API Key. When omitted, the adapter automatically creates and locally caches a 24-hour anonymous trial for up to 100 questions.
• QUESTION_SERVICE_ACCOUNT_TOKEN: optional website session for listing and sharing saved papers. Store it locally only. Never put any credential in a URL, prompt, output, or log.

Use any available Python 3 interpreter for the bundled script. On a repository checkout where python is not on PATH, prefer that checkout's .venv\Scripts\python.exe on Windows (or .venv/bin/python on macOS/Linux) instead of stopping the workflow.

Do not ask a first-time user to register. Complete a useful action with the guest allowance first. Offer registration only when the guest allowance is exhausted or when the user asks to save, continue editing, share, or print a persistent/shared paper. State the tradeoff plainly: registration is still free, starts at 200 questions per day, and unlocks persistent papers. A temporary guest practice page can already be printed directly; do not use that print action as a registration gate. Never call the registered plan unlimited.

When registration succeeds, lead with the earned benefit: say “欢迎入庄”, confirm that the free account is active, and reveal the starting 200-question daily allowance before mentioning referrals. Offer inviting friends only as an optional next step. Give the user an equally clear path to continue without inviting anyone, and never imply that registration, the 200-question allowance, saving, sharing, or printing depends on sending an invitation.

The website login session and the local adapter credential are separate. If registration reveals a first API Key and the user wants this local Skill to use the registered 200-question daily allowance, tell them to store that Key locally as QUESTION_SERVICE_LICENSE. Never ask them to paste the Key into chat. Without that local configuration, the adapter remains on its cached guest trial even if the same person is signed in on the website.