前言¶
在基於 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 進程啓動，在聊天上下文中即可直接調用其提供的方法。
核心功能¶
插件主要提供兩個功能接口：
- set_xby_apikey：在聊天中設置 API 密鑰。
- roll_dice：使用標準骰子符號執行滾動操作。
使用方法¶
使用前需先完成密鑰配置，再進行骰子計算。
-
配置密鑰：
在聊天中調用set_xby_apikey，並將從小笨羊官網獲取的 API 密鑰作爲參數傳入。 -
執行滾動：
調用roll_dice函數，並傳入符合標準的骰子表達式。
常用示例：
- 2d6+3：投擲兩個六面骰（d6），並將結果加上 3。
- 1d20-2：投擲一個二十面骰（d20），並將結果減去 2。
注意事項¶
- 密鑰來源：使用該功能需要前往小笨羊官網註冊並獲取 API 密鑰。
- 持久化存儲：API 密鑰在設置後會自動持久化保存，重啓 DSH 進程後依然有效，無需重複設置。
總結¶
xby-dice 爲 DSH 生態提供了一個輕量級的骰子計算工具。對於需要引入隨機數生成或處理規則型交互的場景，通過標準符號調用該插件可以簡化開發流程。
