xby-dice：DeepSeek Harness 骰子滚动服务

前言¶

在基于 DeepSeek Harness (DSH) 构建的智能体应用中，有时需要引入随机性或处理基于规则的游戏逻辑。如果直接在代码中实现骰子算法，会增加开发维护成本。xby-dice 插件通过封装 MCP 服务器，为模型提供了一个直接调用骰子服务的入口，使其能够使用标准的数学符号进行计算。

插件概览¶

xby-dice 是由 xby-skill 维护的 DSH 插件，专注于骰子模拟功能。它允许智能体通过标准的骰子符号（如 1d20）进行调用，并返回单个结果及其总和。该插件遵循 MIT 许可证，源码托管在 GitHub 上。

安装与启用¶

使用 DSH 的命令行工具即可完成安装。该插件支持从 GitHub 仓库直接拉取安装。

dsh plugin --profile web add github:xby_skill/xby-dice

安装后，插件将随 DSH 进程启动，在聊天上下文中即可直接调用其提供的方法。

核心功能¶

插件主要提供两个功能接口：

1. set_xby_apikey：在聊天中设置 API 密钥。
2. roll_dice：使用标准骰子符号执行滚动操作。

使用方法¶

使用前需先完成密钥配置，再进行骰子计算。

1. 配置密钥：
   在聊天中调用 set_xby_apikey，并将从小笨羊官网获取的 API 密钥作为参数传入。

2. 执行滚动：
   调用 roll_dice 函数，并传入符合标准的骰子表达式。

常用示例：
- 2d6+3：投掷两个六面骰（d6），并将结果加上 3。
- 1d20-2：投掷一个二十面骰（d20），并将结果减去 2。

注意事项¶

• 密钥来源：使用该功能需要前往小笨羊官网注册并获取 API 密钥。
• 持久化存储：API 密钥在设置后会自动持久化保存，重启 DSH 进程后依然有效，无需重复设置。

总结¶

xby-dice 为 DSH 生态提供了一个轻量级的骰子计算工具。对于需要引入随机数生成或处理规则型交互的场景，通过标准符号调用该插件可以简化开发流程。