在 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
