在 DeepSeek Harness (DSH) 的智能体开发中，让 Agent 生成随机内容或模拟数据是常见需求。面对这些场景，直接在代码中调用底层库可能不够灵活，或者难以集成到 DSH 的上下文管理中。xby-random-number 是 DSH 的一个插件，由 xby-skill 维护，旨在提供伪随机和加密安全的随机数生成能力。
核心功能¶
插件提供了两类随机数生成能力，以及基础的集合操作：
- 普通随机数：支持生成指定范围内的整数和浮点数。
- 安全随机数：提供加密安全的令牌和整数生成。
- 集合操作：支持列表的洗牌、无放回抽样以及加权随机选择。
- 环境配置：提供
set_xby_apikey方法，用于设置密钥并自动持久化。
安装与启用¶
使用 DSH 的命令行工具安装此插件。安装后，插件会自动持久化，重启进程依然有效。
dsh plugin --profile web add github:xby_skill/xby-random-number
典型用法¶
插件通过 DSH 的上下文暴露方法。以下是各功能的具体逻辑：
- 随机整数：
random_int接受low和high参数（包含边界），返回范围内的整数。 - 随机浮点数：
random_float接受low和high参数（默认为 0.0 和 1.0），返回浮点数。 - 加权选择：
random_choices从population中选取k个元素，支持weights参数进行加权。 - 列表洗牌：
random_shuffle接收一个列表，返回打乱顺序的新列表。 - 无放回抽样：
random_sample从population中选取k个不重复的元素。 - 安全令牌：
secure_token_hex默认生成 32 字节的随机字节，返回十六进制字符串。 - 安全整数：
secure_random_int生成小于upper_bound的安全随机整数。
配置与注意事项¶
- API 密钥：使用前需前往小笨羊官网注册并获取 API 密钥。
- 环境：插件类型为
module，依赖文件包括dist和cordis.patch.yml。 - 权限：插件以当前 DSH 进程的权限运行。在安装前，建议检查源码以确保符合安全策略。
总结¶
xby-random-number 为 DSH 提供了基础的随机数生成能力，涵盖从普通的数学随机到加密安全的令牌生成。对于需要动态生成数据或模拟场景的开发者，这是一个轻量级的解决方案。
- 源码地址：https://github.com/xby-skill/xby-random-number
- 目录页：https://www.skillhub.cn/plugins/xby-skill/xby-random-number
