JWeBot/docs/command-catalog.md

# JWeBot Command Catalog

Current baseline: `beta 1.0.1.1016`.

This catalog records the reviewed commands shipped with the built-in local
extensions. Runtime ownership is frozen at startup from the generated
descriptor inventory; plugin code delegates to reviewed service profiles.

## System

| Command | Alias | Purpose |
|---|---|---|
| `/功能列表` | `/help` | Show the command list. |
| `/状态` | `/status` | Show local runtime status. |
| `/version` | - | Show installed package versions plus the latest changelog date and summary. |
| `/debug` | - | Show privacy-safe telemetry diagnostics. |
| `/余额` | - | Show configured direct-provider balance status. |

## Context And People

| Command | Alias | Purpose |
|---|---|---|
| `/上下文 [100|200|300]` | `/context` | Summarize recent local text in the current group. |
| `/人物列表 [页码]` | `/people` | List known group-scoped people. |
| `/人物 [名称或别名]` | `/person` | Look up one configured or observed person. |
| `/记住 内容` | - | Store a local memory entry for the current person. |
| `/我的记忆` | - | Show the current person's memory entries. |
| `/人物记忆 显示名` | - | Show memory entries for a person. |
| `/忘记 关键词` | - | Remove matching local memory entries. |
| `/记忆帮助` | - | Show memory command help. |

## Group Insights

| Command | Alias | Purpose |
|---|---|---|
| `/扫码排行` | - | Show scan ranking for the current group. |
| `/复读榜` | - | Show repeat ranking for the current group. |
| `/查记录 关键词` | - | Search local group history by keyword. |

## Virtual Coins And Games

| Command | Alias | Purpose |
|---|---|---|
| `/金币` | `/wallet` | Initialize or show the current person's virtual coin account. |
| `/大富翁榜 [人数]` | `/金币排行`, `/金币排行榜`, `/richlist` | Show the group-scoped coin leaderboard. |
| `/转账 对方 金额` | `/transfer name amount` | Transfer virtual coins to an initialized group account. |
| `/贷款 [金额]` | `/loan amount`, `/借款` | Borrow up to 500 virtual coins. |
| `/还款 [金额|全部]` | `/repay [amount|all]` | Repay an active virtual coin loan. |
| `/抽奖 [金额]` | `/draw` | Play a single-player prize draw. |
| `/彩票 开始` | `/lottery start` | Open a multiplayer lottery round. |
| `/彩票 报名 数字 金额` | `/lottery join` | Join or update a lottery entry. |
| `/彩票 状态` | `/lottery status` | Show the current lottery round. |
| `/彩票 开奖` | `/lottery draw` | Host-only draw for the current lottery round. |
| `/彩票 取消` | `/lottery cancel` | Host-only cancellation with refunds. |
| `/21点 开始 [1-500]` | `/blackjack start` | Start a blackjack round with the chosen stake. |
| `/21点 要牌` | `/blackjack hit` | Draw one blackjack card. |
| `/21点 停牌` | `/blackjack stand` | Stand and settle against the dealer. |
| `/21点 状态` | `/blackjack status` | Show the current blackjack round. |
| `/21点 结束` | `/blackjack end` | End the current blackjack round. |
| `/21点 多人 启动` | - | Open a Taffy-hosted blackjack table and auto-seat the host. |
| `/21点 加入` | - | Join the current blackjack table before betting starts. |
| `/21点 多人 开始` | - | Host-only close joining and start ordered betting prompts. |
| `/21点 放金额` | - | Place the prompted table stake, 1-10000 coins. |
| `/游戏记录 [页码]` | `/gamehistory` | Show indexed personal game history. |
| `/游戏帮助` | `/games` | Show local game rules. |

## Random And Session Games

| Command | Alias | Purpose |
|---|---|---|
| `/丢骰子 [NdM]` | - | Roll dice. |
| `/丢骰子挑战` | `/骰子挑战` | Run a dice challenge. |
| `/翻硬币` | - | Flip a coin. |
| `/随机数 [范围]` | - | Draw a random number. |
| `/抽签 [内容...]` | - | Draw lots from provided options. |
| `/今日运势` | - | Show a deterministic daily fortune. |
| `/猜数字 开始 [上限]` | - | Start a group guessing game. |
| `/猜数字 数字` | - | Guess in the active guessing game. |
| `/石头剪刀布 开始` | - | Start a rock-paper-scissors session. |
| `/石头剪刀布 加入` | - | Join the active session. |
| `/石头剪刀布 出 石头|剪刀|布` | - | Submit a move. |
| `/石头剪刀布 状态` | - | Show session status. |
| `/石头剪刀布 结算` | - | Settle the session. |
| `/石头剪刀布 结束` | - | End the session. |

## Steam

| Command | Alias | Purpose |
|---|---|---|
| `/steam 在线` | - | Show configured Steam online status. |
| `/steam 游戏` | - | Show current games. |
| `/steam 全部` | - | Show full configured Steam presence. |
| `/steam 刷新` | - | Refresh cached Steam data. |
| `/steam 时长 游戏名` | `/steam时长游戏名` | Query playtime for a game. |
| `/steam时长游戏名、玩家名` | `/steam时长游戏名人=玩家名` | Query one player's game playtime. |

## CS Major Autochess

| Command | Alias | Purpose |
|---|---|---|
| `/自走棋开始` | - | Create a new IEM 盐田 Major season. |
| `/自走棋报名` | - | Register the current player. |
| `/自走棋加AI战队` | - | Add local deterministic AI teams for testing. |
| `/自走棋开赛` | - | Start the event from registration. |
| `/自走棋状态` | - | Show the current event state. |
| `/自走棋档案` | - | Show archived event information. |
| `/选1` ... `/选10` | - | Draft coaches, players, or shop cards depending on phase. |
| `/刷新` | - | Refresh the shop. |
| `/锁定` | - | Lock or unlock the shop. |
| `/阵容` | - | Show lineup, bench, coach, gold, and synergies. |
| `/赛程` | - | Show the current event schedule. |
| `/升级教练` | - | Upgrade the team's coach level when rules allow it. |
| `/上阵 备战编号 [首发位]` | - | Move a bench player into the starting lineup. |
| `/下阵 首发位` | - | Move a starting player out when rules allow it. |
| `/出售 备战编号` | - | Sell a bench player. |
| `/战术 火力|稳定|残局` | - | Set the team's tactical focus. |
| `/结束回合` | - | Mark readiness and advance when required players are ready. |

## Notes

- Commands must be sent in the configured WeChat group and normally mention the
  bot, depending on deployment configuration.
- OCR whitespace loss is tolerated for selected compact forms such as
  `/steam时长Dota2` and `/21点开始100`.
- Real profiles, Steam IDs, person context, message payloads, and secrets are
  never stored in this repository.