roll-dice

name	roll-dice
description	掷骰子与检定计算技能。用于 RPG、概率演示、课堂示例。支持 NdM、修正值(+/-K)、优势/劣势(adv/dis)、固定随机种子复现结果。触发词: roll dice, 掷骰子, d20, 骰子检定。
argument-hint	输入示例: 1d20+5, 4d6, 2d20kh1, adv 1d20+3, dis 1d20, seed=42 3d8-1
user-invocable	true

Roll Dice

这个技能产出什么

• 根据用户输入执行一次或多次骰子掷点，并给出总和、分项明细与简短解释。
• 当输入含糊时，先补齐默认值再执行（默认 1d20）。
• 当用户需要可复现结果时，支持固定种子 seed=<int>。

何时使用

• 需要快速做 RPG 检定（如 1d20+5）。
• 需要课堂/演示中展示随机抽样结果与明细。
• 需要批量掷点（如能力值 4d6kh3）。

输入约定

• 标准表达式：NdM，例如 2d6、1d20。
• 修正值：NdM+K 或 NdM-K。
• 保留规则（可选）：khX（保留最高 X 个），klX（保留最低 X 个）。
• 优势/劣势（d20 场景）：adv 或 dis，等价于 2d20kh1 / 2d20kl1。
• 随机种子（可选）：seed=42。

处理流程

1. 解析用户输入。
2. 标准化表达式：把 adv/dis 映射为 2d20kh1/2d20kl1。
3. 校验参数合法性：

• N >= 1。
• M >= 2。
• kh/kl 的数量 X 必须满足 1 <= X <= N。

4. 生成随机结果并计算：

• 原始掷点数组。
• 根据 kh/kl 选中的子集。
• 子集求和并加上修正值。

5. 输出统一格式：

• 规范化表达式。
• 每次掷点明细。
• 最终结果。
• 若使用种子，附上 seed 以便复现。

输出格式（建议）

• Expression: <normalized>
• Rolls: <list>
• Kept: <list or same as Rolls>
• Modifier: <+K/-K/0>
• Total: <number>

质量检查

• 同一 seed + 同一表达式应得到相同结果。
• 错误输入返回清晰提示与示例，不要静默纠正。
• 对潜在滥用输入加限制：建议 N <= 200、M <= 1000。

参考实现

• Python 参考脚本：scripts/roll_dice.py