Release beta 1.0.0 baseline

docs/command-catalog.md

@@ -0,0 +1,122 @@
+# JWeBot Command Catalog
+
+Current baseline: `beta 1.0.0.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. |
+| `/游戏记录 [页码]` | `/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.