Skip to content

gongchen618/bug-carrot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bug-carrot

项目进度

  • dice 占卜
  • food 吃什么
  • goodmorning 早安 & goodnight 晚安
  • homework 作业
  • repeat 复读
  • weather 天气
  • codeforces 未来比赛列表
  • schedule 任务清单
  • keyword 召唤(关键字)
  • family 通讯录
  • muster 名单
  • ballot 投票 & 收集表

如何参与项目的 Q&A

以下说明均以 /src 作为根目录

Q0: 完全不懂要做什么诶...

  • 省流:回忆一下 cqhttp 是啥,bug-carrot 又是啥;然后看看 /plugin/default.go,里面写了一些注释,或许能够帮你找到灵感!
  • 不省流:介绍一下项目结构好啦!
    • /config 用来读取 ../../config 目录里的配置文件,插件不需要配置文件的话不需要看
    • /constant 放了一些静态变量,比如 bot 的语言部分,写好插件之前不需要看
    • /controller 是项目核心逻辑的目录,绝大多数情况下不需要看
    • /model 是数据库,插件没有用数据库的需求的话不需要看
    • /param 是结构体仓库,写好插件之前不需要看
    • /plugin 是插件主体目录,里面的 default.go 好好看,它写了函数注释,你也可以通过这个目录下多个插件文件的对比来速通 golang!
    • /router 是路由注册部分,绝对不需要看
    • /util 是工具部分,其中 qq.go 里放了一些常用的可以给 cqhttp 通信的函数,写了注释可以看看,word.go 不需要看

Q0.5: 还是云里雾里?

  • 戳戳 GC,她可以手把手教你写 plugin!

Q1: 如果我想写一个新的 plugin,需要在项目的哪些部分动手呢?

  • /plugin 目录下仿照其他 plugin 的结构新建一个文件写逻辑代码
  • 注意你应该至少需要阅读两个 plugin 并对比其差异(其中 food 和 homework 用到了数据库,所以会显得有些复杂哦)
  • main.gopluginRegister() 中调用你 plugin 的注册函数

Q2: 我可以通过哪些方法把我的 plugin 写的更加...格式化?

  • 把 bot 的语言部分统一写在 /constant/index.go
  • 把某些配置写在 ../../config/default.yml 里,并对应修改 config/config.goPlugin{} 的结构,让它可以被你的插件读取
  • 对于上一个选择,记得相应的去更新 prod.ymldefault-example.yml
  • 把新增的结构体写到 /param 目录里

Q3: 我需要调用数据库?

  • 首先,请再次确认你的 plugin 是否真的有数据库的需求,是否可以简单的被 map/slice 等程序内部结构所替代,前者在程序重启时依然能保留数据,而后者不能
  • 你需要在本地环境下安装 MongoDB,运行它,它会默认开放 127.0.0.1:27017 的端口。然后,你需要新建一个名为 carrot 的数据库,在其中创建用户 carrot,密码为 123,此处参考配置文件
  • 在配置文件中有一个 database-use 的选项,设置它为 true
  • /model 目录下仿照 homework.gofood.go 的结构写你需要的逻辑,再于同目录下 init.goModel{} 中增加你的 Interface

Q4: 我应该如何在本地测试我的 plugin?

  • pull 这个 repo,按照上面的指引写好 plugin,复制 ../../config/default-example.yml 并重命名为 default.yml ,修改 default.yml 中 qqbot-qq 为你自己的 QQ 号,然后在本地跑起来!
  • https://docs.go-cqhttp.org/ 安装 cqhttp,修改 config.yml 的 uin 为自己的 QQ 号,修改 http 通信设置为
  - http:
      host: 0.0.0.0 # 服务端监听地址,这里是本地
      port: 5701      # 服务端监听端口,也就是 bug-carrot 给 cqhttp 发信的端口
      post:           # 反向 HTTP POST 地址列表,这是 bug-carrot 的 API
        - url: 'http://127.0.0.1:3456/api/reverse'
  • 把 cqhttp 也跑起来,然后愉快的测试吧!

Q5, 我应该如何向 cqhttp 通信?

  • 项目在 /util/qq.go 里已经写好了许多可以直接调用的函数
  • 如果需要更多操作,可以阅读 https://docs.go-cqhttp.org/api 的说明,并在 /util/qq_test.go 里进行测试

Q6, 我想发戳一戳 / 音乐分享 / 图片等特殊消息格式?

Q7, 我想监听除了群消息以外的更多事件?比如检测加好友请求?

Q8. /util/word.go 是干什么的?

  • 它调用了 gojieba 的库,实现了对一条消息的简单分词,分词的具体信息可以参阅 https://github.com/fxsjy/jieba
  • 这使得我们可以调用 param.GroupMessage.WordsMap.ExistWord("n", []string{"晚安"}) 来检查 msg 里有没有名词“晚安”
  • 这在后续或许可以开发出有意思的功能(x

Q9. 很好奇项目处理 time / private / group / listen 等多种需求的逻辑是什么?

  • 参考 /controller/message.go/controller/plugin.go,前者接受 cqhttp 消息并处理,后者处理插件

Q10. 你的 param.GroupMessage{} 怎么没有我想要的信息啊?

  • 阅读 https://docs.go-cqhttp.org/event 的说明
  • 阅读 /controller/message.gogroupMessageHandler() 函数,看看它做了什么,然后修改 param.GroupMessage{}

Q11. CD 啥时候能用上啊?

  • 问就是马上!

Q12. 我发现了项目bug特性!

  • 速速发 issue!

Q13. 我应该如何给 bot 写一个新的 plugin 呢?

  • fork 这个仓库并进行你想要的修改,完成后提交 pull request,等待管理员把它 merge 到这里就好啦!

Q14. ???

  • 提提 issue 吧!

About

a cute qqbot frame

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published