dicepp-shell

What problem does it solve?

You need a fast way to verify that DicePP bot commands, dice results, and role/card workflows behave correctly before shipping or integrating changes.

Core Features & Use Cases

• Interactive session testing: Create and manage named sessions to run multi-step TRPG scenarios consistently.
• Deterministic dice control: Use a predefined dice sequence to make outcomes reproducible for acceptance testing.
• Command-level verification: Validate common flows like rolling dice, initiative,角色卡 creation, and HP updates using real chat commands.
• Debug-friendly output: Optionally request JSON output to inspect structured results during tests.

Quick Start

Start a test session and send the roll command with a fixed dice outcome: run uv run dicepp-shell start test followed by uv run dicepp-shell send test --user player1 --msg ".r 1d20 攻击" --dice 20.