• 技术交流 拓展文件
  • 【技术文档/文件托管】我想做一个方便大家直接下载功能模块mod的地址页,或者,不止mod地址...

ssJSKFJDJ

LicenseNetlify Status

for script or mod.

类似pip…
类似luarocks…

可供访问的网页地址:

Background - 背景

在Dice!624版本以后更新了.mod get命令来远程下载功能模块,考虑到整合需要,因此搭建了这样一个库(已经实现自动化部署),可供功能模块作者pr需要收录的功能模块下载json,审核通过后便可以通过.mod get [已收录功能模块]下载。

tips:还有一个前提是source.list必须存在https://ss.jyunko.cn/Module/

其一般步骤如下:

  1. fork main-pages库。一切都是从这里开始的。
  2. 提交你的包含"pkg"字段的功能模块下载json:
    比如listen2me库提供的json是这样的:
       {
         "mod":"listen2me",
         "author":"简律纯",
         "ver":"1.1.8",
         "dice_build":612,
         "brief":"使用mml作曲",
         "pkg":"https://github.com/HsiangNianian/listen2me/releases/download/v1.1.8/listen2me_v1.1.8.zip",
         "comment":"",
         "helpdoc":{
             "listen2me":"【listen2me[Windows]】\n使用mml语言进行作曲\nhttps://github.com/HsiangNianian/listen2me"
         }
       }
    你可以直接访问来查看该json所在位置。
    这里我们只需要填写"pkg"字段即可,"repo"字段如有请删除。

Contribute - 贡献

功能模块的收集没有任何像plugin或PublickDeck那样的专门的库,这里只选择功能模块作者在main-pages的master分支的Module文件夹下提交功能模块远程下载json的方式来收录Module。在收到PR以及审核通过后,审核人员会将你的功能模块库fork到ssJSKFJDJ。

功能模块作者仅需要上传自己的mod下载json并pr即可,通过后Dice版本624+的在DiceQQ/conf/mod/source.list里添加新的一行并输入https://ss.jyunko.cn/Module/(注意最后也需要一个斜杠/,这是必须的),即可直接发送指令.mod get|update [已收录的功能模块]来远程下载或更新功能模块。

这里有一个发帖指引模板:

# I. install
- Dice版本2.6.5beta12(624+)以上安装方法:
1.`./DiceQQ/conf/mod/source.list`文件内(没有mod文件夹和这文件就新建)输
入 `https://ss.jyunko.cn/Module/`2. 使用 `.system load`命令重载bot,这样做的目的是为了让步骤1里的远程地址生效。
3. 对bot发送 `.mod get [功能模块名]`命令,等待安装。
4. 回到第二步,这样做的目的是为了让mod被加载。
5. Enjoy Your Self!
- Dice版本2.6.4b(612+)以上安装方法:
1. 浏览器访问 `https://github.com/ssJSKFJDJ/功能模块库`并点击绿色按钮 `Code`下
的 `Download Zip`按钮下载仓库压缩包。
2. 解压压缩包,将里面的文件和文件夹全部丢进 `./DiceQQ/mod/`文件夹内。
3. 使用 `.system load`命令重载。
4. Enjoy Your Self!

关于这点大家可以很明显的在我的另外两个论坛功能模块帖子里发现:

  1. thesaurus - 词典匹配回复
  2. listen2me - 使用mml语法作曲

More - 不止

除了收录功能模块外,脚本作者、牌堆作者也可以提交pr,方便用户下载,但其二者更重要的功能不在这里(当然这也是功能模块作者可以进行的步骤)。

mkdocs - 文档

功能模块作者可以提交用于介绍(比如功能模块信息、更新日志、功能模块bug、功能模块实现原理或功能模块To-Do List等)自己的功能模块的md文件,审核通过后也一样会生成一篇独立的网页供访问。

License - 协议

关于协议,信息完全是公开的,同时采用MIT.协议,也鼓励大家做好版权或其他申明事宜。

At last - 最后

最后希望大家都能积极热心的参与到这个项目里(我想捞人),若有什么疑问欢迎大家在帖子下面评论回复,也欢迎大家加入ssJSKFJDJ的群聊。

说点什么吧...