This commit is contained in:
JWeBot Contributors
@@ -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.
|
||||
@@ -1,7 +1,7 @@
|
||||
# Command Registration And Execution Paths
|
||||
|
||||
Status: authoritative local registration and routing contract for
|
||||
`alpha 0.6.x`.
|
||||
`beta 1.0.x`.
|
||||
|
||||
## Three Execution Paths
|
||||
|
||||
@@ -46,7 +46,7 @@ because each bubble position still produces its own `IncomingMessage`.
|
||||
Changed pixels force fresh OCR. The cache is bounded and periodically
|
||||
revalidated.
|
||||
|
||||
For the three local plugins added in `alpha 0.6.1.1015`, including bilingual
|
||||
For the local plugins introduced during the 0.6.x line, including bilingual
|
||||
commands, person identity limitations and atomic single-player game settlement,
|
||||
see [local plugin rules](local-plugins-0.6.1.md).
|
||||
|
||||
@@ -146,7 +146,8 @@ descriptors unless they are strictly Kernel-only. The current official
|
||||
operational commands are:
|
||||
|
||||
- `/状态` and `/status`: server, Edge, OCR, and queue status.
|
||||
- `/version`: installed JWeBot package versions.
|
||||
- `/version`: installed JWeBot package versions plus the latest changelog date
|
||||
and summary.
|
||||
- `/debug`: recent privacy-safe telemetry p50/p95/max summary.
|
||||
|
||||
These commands delegate to Kernel-owned service profiles through generated
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Plugin Contract
|
||||
|
||||
Status: authoritative for the `alpha 0.6.x` extension API.
|
||||
Status: authoritative for the `beta 1.0.x` extension API.
|
||||
|
||||
## Scope
|
||||
|
||||
|
||||
@@ -6,9 +6,11 @@ exception.
|
||||
|
||||
## Release Discipline
|
||||
|
||||
- Version format is `alpha X.Y.Z.MMDD`.
|
||||
- Patch changes increment `Z`; minor version changes require explicit user
|
||||
approval.
|
||||
- Version format is `beta X.Y.Z.MMDD` for current beta releases.
|
||||
- Python package versions use the matching PEP 440 beta form, such as
|
||||
`X.Y.Zb1+MMDD`.
|
||||
- Patch changes increment `Z`; minor, major, or stable-release changes require
|
||||
explicit user approval.
|
||||
- A release change must update:
|
||||
- `VERSION`;
|
||||
- root `pyproject.toml`;
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# Runtime Telemetry And ACK Semantics
|
||||
|
||||
Status: local instrumentation contract for `alpha 0.6.x`.
|
||||
Status: local instrumentation contract for `beta 1.0.x`.
|
||||
|
||||
## What ACK Means
|
||||
|
||||
|
||||
+10
-6
@@ -1,20 +1,24 @@
|
||||
# Versioning
|
||||
|
||||
JWeBot uses an alpha version string:
|
||||
JWeBot uses a human-readable product version string:
|
||||
|
||||
```text
|
||||
alpha X.Y.Z.MMDD
|
||||
beta X.Y.Z.MMDD
|
||||
```
|
||||
|
||||
Rules:
|
||||
|
||||
- `alpha` means the public API and deployment process may still change.
|
||||
- `beta` means the project has passed the local, staging, privacy, and
|
||||
production-safety gates expected for wider testing, while still allowing
|
||||
controlled breaking changes before a stable release.
|
||||
- `X.Y.Z` is the project version.
|
||||
- `MMDD` is the delivery date.
|
||||
- Python package versions use PEP 440 pre-release form. For beta builds,
|
||||
`beta 1.0.0.1016` maps to `1.0.0b1+1016`.
|
||||
- Normal small updates increment only the patch version, for example
|
||||
`alpha 0.0.1.1014` to `alpha 0.0.2.1014`.
|
||||
- Minor versions such as `0.1.x` require explicit user review and milestone
|
||||
approval.
|
||||
`beta 1.0.0.1016` to `beta 1.0.1.1016`.
|
||||
- Minor, major, or stable-release changes require explicit user review and
|
||||
milestone approval.
|
||||
- Local repository migration does not imply a production deployment.
|
||||
- Production services must not be changed unless the operator explicitly asks
|
||||
for deployment or runtime verification.
|
||||
|
||||
Reference in New Issue
Block a user