HydroRoll下載 - HydroRoll源代碼下載

下載

release_img CodeQL

跨平台、多模態、高度自定義的骰系開發框架

歡迎來到HydroRoll [水系]，一個依據科學原理架構並由多模態模型賦能，使用Rust與Python編寫的高性能、跨平台、去中心化骰系開發框架。

? 此框架主要用於解決“如何更好的為冷門規則書做適配”與“如何更好的實現人機交互”兩個問題。如果你是世界主、規則書作者、人工智能（自然語言處理方向）愛好者，那麼水系或許是你的不二之選。

? 核心由Rust編寫，性能優異、速度驚人。
? Python編寫的頂層業務邏輯，方便使用、更快入門。
基於規則書的架構，名副其實的骰系（製造）工場。
⚡ 僅需三條指令即可快速安裝運行已有的規則包，或開發自己的骰系。
靈活的配置，高度自定義，就像搭積木與拼拼圖一樣簡單高效。
? 可選的拓展模塊，兼容shiki的lua模塊、兼容青果onedice標準的骰子表達式解析模塊等...
? 跨平台，對接onebot協議、 kook平台、 dingtalk軟件、 telegram 、 discord 、 minecraft ...與自研IM平台。
? 兼容的插件設計，可編寫lua 、 python 、 javascript腳本，為附加功能賦能， Blockly 傻瓜式在線可視化編寫水系腳本插件。
? Meta級別的擲骰表達式解析庫，可自定義任何解析規則，或可用於一條指令執行多個操作~>學習oneroll。
? 內嵌AI工具——水系模型工作流， webui管理各個單一任務模型的輸入輸出與嵌套關係，低成本實現媲美大模型的多任務功能。
? 漸進式學習框架，從編寫簡單的nivis reply腳本，到編寫滿足小需求的lua 、 python腳本，再到成為世界主編寫自己的規則包模塊，甚至訓練水系模型，層層遞進，輕鬆學習。
? 更多特性等你發掘！

在安裝3.9+版本的Python之後，請先全局安裝pdm依賴，接著全局安裝hydro-roll包。

pip install hydro-roll
# pip install hydro-roll[all] 安装所有组件
# pip install hydro-roll[basemodel] 安装基础模型
# pip install hydro-roll[dev] 安装开发包

接著使用atien命令搭建機器人模板並運行。

atien new -b coc-example " HydroRollBot "
cd HydroRollBot
atien run

更多詳細的使用方法請參考官方文檔。

你可以選擇從框架端開始開發水系骰子。

pip install iamai
iamai new " HydroRollDevBot "

iamai install hydro-roll --dist HydroRollDevBot
# cd HydroRollDevBot
# iamai install hydro-roll

接著你需要自行修改config.toml中的相關適配器與hydro-roll插件的配置。

最後你可能需要一個啟動錨點—— main.py 。

 from iamai import Bot

bot = Bot ( hot_reload = True )

if __name__ == '__main__' :
    bot . run ()

python main.py

HydroRoll[水系] 不僅僅是一個骰系開發框架，更是一個不斷壯大的用戶和框架開發者社區。

我們已經在水系的文檔主頁上列出了主要的社區交流渠道。與核心框架開發人員取得聯繫的最佳方式是加入HydroRoll[水系] 社區論壇Github Discussions。

如果你想要開始為HydroRoll-Team 組織下的任何項目做貢獻，請參閱貢獻指南，這本指南還包括了提交Issue 與PullRequest 的規範。

世界主:	規則書作者。水系基於通用規則包（規則書的對應語言實現）標準架構，可以為你一鍵生成規則書的pdf版本與一個在線規則書瀏覽站點，同時允許你在規則包內自定義高優先級的骰系內建指令。一個規則包，便是一個骰系。
插件愛好者:	下游插件開發者。水系插件可用lua 、 python 、 javascript編寫，同時，支持在線將其他骰系的插件文件（如shiki的lua腳本，青果的python插件，海豹的js插件等）轉換為水係對應語言的插件腳本實現，另有使用Blockly 搭建的可視化編程站點，輕鬆編寫插件腳本。
ML/AI 愛好者:	水系繼承自多模態機器學習框架iamai ，能夠同時訓練與推理多個模型，試想你的骰子擁有自己的獨特人格...
kp與pl :	水系豐富的規則包生態以及骰系生態允許渴望遊玩冷門規則的他們在各種遵循水系GRPS標準的骰系中安裝遊玩同一個規則包文件。