Giter VIP home page Giter VIP logo

landsol-distrust's Introduction

Landsol Distrust 兰德索尔失信人员名单

  • 此为 Lancercmd / Yuni 的功能 Landsol Distrust 的公开版本,但主要功能完全一致。

前言

  • 本文档并非面向一般用户,但若对 Python 或 nonebot 稍有兴趣,配合搜索引擎您一定能解决阅读和部署中遇到的问题。
  • 本文档尝试为对于 Python 或基于 Python 的机器人有所了解,但未曾接触或对 nonebot 略知一二,且有一定的自定义经验的用户提供部署和使用上的帮助。
  • 该插件试图对公主连结Re:Dive的行会系统在筛选成员的过程中带来的特定困难或部分困难提供解决方案。
  • 本人不为由于用户所在的或考虑加入的公主连结Re:Dive的行会,在插件使用过程中给用户造成游戏体验的下降负责。
  • 该版本在 nonebot 1.6.0 环境下测试通过,代码比较粗糙,欢迎优化版本的 Pull requests 。

如果你曾接触过 PCR 机器人

  • 该插件理论上支持导入 richardchien / nonebot 的较新版本并正常使用。
  • 该插件理论上支持导入基于 richardchien / nonebot 编写的 Ice-Cirno / HoshinoBot 的较新版本并正常使用。
  • 该插件理论上支持导入基于 richardchien / nonebot 编写的 Joenothing-lst / kkl-Android-2.0 ,但可能会遇到依赖版本的兼容性问题。
  • 该插件未测试在 yuudi / yobot 下的使用,可能会遇到依赖版本的兼容性问题,或其他无法预见的问题。
  • 该插件未测试在 mamoe / mirai 及其关联项目下的使用,可能会遇到无法预见的问题。
  • 该插件支持输出图片,您可能需要为此购买 酷Q Pro 的授权。

这是什么?

  • __init__.py : Landsol Distrust 插件本体
  • distruct.json : Landsol Distrust 插件的示例配置文件之兰德索尔失信人员名单,保存了供测试用的信息
  • image : Landsol Distrust 插件的配置文件内保存的供测试用信息所使用的酷Q图片缓存目录

部署方法

  • 对于插件本体,您可以将 __init__.py 置于独立目录,并由上级 __init__.py 导入。
  • 对于插件本体,您也可以简单地将其作为 nonebot 的插件,重命名后导入。
  • 对于示例配置文件,在未对插件本体进行修改的情况下,您应将其与 __init__.py 放在同一目录下。
  • 对于示例配置文件所使用的酷Q图片缓存目录,您应将其放在 \酷Q Pro\data 目录中,该目录为酷Q图片缓存目录,也是酷Q接收图片时默认的保存位置,一般情况下您将其于原 image 文件夹合并。
  • 您可以通过查看 nonebot 控制台日志来确认插件是否完全导入成功,您可能会需要更新本地的 nonebot 至 1.5.0 或更高版本。
  • 插件在导入时会优先使用 ujson 依赖,当无法导入 ujson 时会自动使用默认库,您可以忽略无 ujson 时的警告。(ujson 是一个在处理大量数据时性能更强的 json 库)
  • 接下来您可以参考使用说明来进行插件的测试。

使用说明

  • 该使用说明的说明对象,以该使用说明上传时的插件版本为准。

  • /ld -f jp 3058632117
  • 我们使用查询指令作为测试指令,该指令用于查询 日服 ID 为 305863117 是否存在不良记录,期望的输出结果如下图所示。
  • 查询指令输出结果
  • 若结果与上图一致,您已经非常接近成功了。
  • 如果什么都没有,甚至控制台出现了错误,您不应进行下一个测试,而应转到前文的部署方法,配合搜索引擎进行错误排查。
  • 如果有文本但没有图片,您可能将示例配置文件所使用的图片放错了位置,又或许遇到了无法预见的问题,但您依然可以进行下一个测试。

  • /ld -a cn 1234567890 此处应有100字图文丢人事迹
  • 这是一个添加指令,在未对插件本体进行修改的情况下,该指令仅限群聊内使用,您可以完全复制并使用这行指令,期望的输出结果如下图所示。
  • 添加指令群聊输出结果
  • 同时作为主人,您应在私聊中收到来自机器人的消息,期望的输出结果如下图所示。
  • 添加指令私聊输出结果
  • 若结果与上图一致,恭喜您已经成功部署了该插件。
  • 若结果与上图不一致,或许遇到了无法预见的问题,您可以将其提交到 Issues ,共同解决潜在的问题,以减少他人部署时遇到问题的机会。

兰德索尔失信人员名单的唯一性

  • 作为开源项目,本人无法保证该项目被用户合理的或不合理的使用,故无法保证用户所持有的兰德索尔失信人员名单的审核是否公平公正。
  • 将该开源项目用于任何项目时,都应始终保证对所持有的兰德索尔失信人员名单的审核的公平公正。
  • 为使该项目发挥最大作用,您可以选择提交您的兰德索尔失信人员名单条目(或副本)。
  • 本人不为第三方使用其持有的兰德索尔失信人员名单所造成的任何问题负责。
  • 本人不为第三方对其持有的兰德索尔失信人员名单进行修改,并造成的任何问题负责。
  • 在个人或团体项目中使用该开源项目的内容时,请自觉遵守 GPL v3.0 协议,并将该项目名及地址置于显眼位置。

父项目

  • Lancercmd / Yuni 是实现了全功能的模块化,同时保证兼容性和独立性,和维护便利程度的机器人。
  • 基于 richardchien / nonebot https://github.com/richardchien/nonebot

特别感谢

(以下为首字母排序)

landsol-distrust's People

Contributors

lancercmd avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

landsol-distrust's Issues

您可能想问的问题

为什么会编写这个插件?

  • 该插件编写并开源的起因是客户群的需求,同时也为了向公众推送用机器人查失信人员的概念。
  • 插件本身是开源的,需要用到的行会战警察也可以部署到自己的机器人上。

如何保证上报信息的真实有效?

  • 上报事由支持图文混编, 只要QQ能够发出来,能写多长写多长,越详细的上报事由自然能让他人知道该 ID / QQ 究竟发生了什么。
  • 上报事由中的图片本就可以长期被保存在酷Q图片缓存中,只要未被外部清理就能长期加载。
  • 在插件本体未经修改的情况下,机器人主人可以收到来自机器人的私聊推送,机器人主人可以使用其他的寄存方式保存用户的上报信息。
  • 机器人主人应长期保存用户的上报信息,以及时发现潜在的恶意上报者。

如何确保审核的相对公正?

  • 从代码本身而言,该插件的开源版本是取 Lancercmd / Yuni 所用的闭源版本剔除次要功能而来。
  • 在自行部署插件时,您可以对插件进行修改,如通过用户组的区分,以限制上报者的身份方式来实现审核的相对公平公正。
  • 行会和行会之间可以在机器人主人的协助下建立共同的兰德索尔失信人员名单,以及兰德索尔失信人员名单审核组(后文简称审核组)
  • 对于非功能测试期间利用该功能进行恶意上报者,应毫不犹豫地将其加入兰德索尔失信人员名单。
  • 如同 README 里所说的,作为开源项目,本人无法保证该项目被用户合理的或不合理的使用,故无法保证用户所持有的兰德索尔失信人员名单的审核是否公平公正,但机器人主人及审核组应始终保证对所持有的兰德索尔失信人员名单的审核的公平公正。

被上报者如何进行申诉?

  • 被上报者应通过机器人主人所提供的申诉渠道,并准备申诉资料进行申诉。
  • 机器人主人及审核组理应认真对待并长期维护所持有的兰德索尔失信人员名单。
  • 机器人主人及审核组应热情且合理地要求被通报者在申诉时提供资料与通报者对弈。
  • 机器人主人及审核组也应向上报者进一步确认被通报者的失信严重性,并进一步审核,确保信息的真实有效。
  • 对于存在质疑的上报应尽快返回审核阶段,以维护被上报者的正当权益,避免其声誉受到影响。
  • 对于错误的上报应毫不犹豫地撤销,并将恶意上报者加入兰德索尔失信人员名单,并对错误上报公开广播及致歉,以保护被恶意上报者并为其挽回声誉。

为什么会提交这个 Issue ?

  • 该项目被开源后,在有限的传播范围内,得到了多数行会长及行会战警察的支持。
  • 该项目在开发过程中进行交换意见的开发者,以及项目被开源后对该项目关心的潜在用户对于功能的可实现性表示担忧。
  • 该 Issue 旨在为希望使用该插件,但对该插件的使用场景存在不确定的用户群提供一个使用指导。

上面都不是我想问的!

  • 您可以在此 Issue 下方 Comment 您的问题,不仅是本人,任何能提供帮助的人都能为您解答。

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.