Search an illustration for a Chinese or English request.

Args: query: free-form request, e.g. "初音未来 泳装 竖图"; tags/count/orientation are parsed. count: number of images, 1-10. size: "compressed" for a smaller preview, "original" for the full-size file. orientation: optional "landscape", "portrait" or "square" filter. extra_tags: additional canonical booru tags to include. negative: tags to exclude, sent to the board as "-tag".

Map a character name, nickname, four-digit uid or six-digit id to an arena id.

Args: query: what the player said — "布丁", "克总", "猫拳", "1001", "100101". limit: how many candidates to return, 1-10.

Identify which characters are in cropped portrait images.

Args: images: one entry per portrait — a file path, raw bytes as base64, or a data URI. top_k: candidates per portrait, 1-10. min_score: similarity floor below which the portrait counts as unknown, 0-1.

Look up defence teams for a lineup via the local arena browser service.

Args: defense: the lineup by name — "布丁", "克总", "真琴" … (names, aliases or ids). def_ids: the same thing as six-digit ids, if you already have them. region: arena region id, 1 = mainland, 2 = overseas, 0 = no filtering. limit: how many teams to summarise, 1-6 (display cap, not a game rule). exclude: names to drop before searching ("先排除一个再查"). replace: in-place swaps such as ["宫子->真琴"]; positions are preserved.

Search the assistant's local memory store (read-only).

Args: query: keywords or a sentence to look for. limit: maximum hits, 1-20. scope: "all", "session" or "global".

Report row counts and database size of the local memory store.

Probe the local services of the assistant stack and report their status.

Rank characters by how close their names are to a query.

Use this when a lookup fails because the name is not in the table: the score and matched_on say whether the candidate is trustworthy, so the host can ask the user instead of guessing.

Args: query: a name in any form, e.g. "宫紫", "ミヤコ", "miyako". top_k: how many candidates to return, 1-20. threshold: minimum score, 0-1; below it nothing is returned.

Add a character or extend its aliases in the local overlay file.

New characters are usually published in Japan first and arrive with a Japanese name before any Chinese alias exists; pass jp so lookups by the Japanese name work immediately. The packaged table is never modified.

Args: char_id: six-digit arena id, e.g. 100701. name: Chinese name; required when creating a character that is not known. aliases: extra names to accept, e.g. ["布丁新皮", "miyako"]. jp: Japanese name, e.g. "ミヤコ". servers: servers the character exists on, e.g. ["jp", "cn"]. remove_aliases: aliases to drop (a wrong alias is worse than a missing one).

Teach the table that term refers to a character.

This is the manual fix for a wrong match: the term is stored as an alias of the chosen character and the correction is logged with a timestamp.

Args: term: what the user actually typed, e.g. "宫紫". char_id: the character it should resolve to (id or any known name). note: optional free text kept with the correction.