技能介绍

解决什么问题

写原型、测试夹具、抽奖或数据打散时，我们常需要一段不引入额外依赖的随机逻辑。可一旦需求从“给我一个随机整数”升级为“按权重抽取”“从 N 个里抽 k 个不重复”“生成一枚安全令牌”，自己去改循环条件或调用 random 就很费时。这个技能把这类高频动作封装成一组 scripts.tools 函数，由模型负责理解意图和提取参数，代码侧只调用远端 API 并回传结构化结果。

核心能力

区间生成：random_int 在闭区间 [low, high] 内生成整数；random_float 在 [low, high] 内生成浮点，默认 0.0 到 1.0。
抽样与洗牌：random_choices 支持放回抽样，可选 weights；random_sample 做不放回抽样并要求 k 不大于总体；random_shuffle 返回打乱后的新列表。
安全输出：secure_token_hex 生成十六进制令牌，长度由 nbytes 控制；secure_random_int 生成 [0, upper_bound) 范围内的整数。

工作流程与边界

运行时先检查 scripts.config.settings.api_key，若为空则通过 AskUserQuestion 询问 XBY_APIKEY，再用 scripts.config.set_api_key(api_key) 保存；禁止在缺密钥时自行搜索或编造数据。随后从工具列表中选择函数、提取参数并按关键字传参调用。返回值是 dict，整理 result["raw"] 即可展示给用户。

需要注意，加密安全只体现在 secure_* 函数本身，不应把伪随机结果用于会话密钥、授权决定或对抗性场景；若上层依赖特定分布，应在调用前确认参数含义。