1.0.9 • Published 9 months ago

nekoneko v1.0.9

Weekly downloads
-
License
ISC
Repository
github
Last release
9 months ago

nekoneko - 基于 tencent 官方的 qq 群聊机器人框架

nekoneko 框架只做群聊,不做频道,因此有些许注意事项

基础文档

机器人框架文档:

https://bot.q.qq.com/wiki/develop/api-v2/ 消息发送 markdown 按钮

腾讯开放平台:

https://q.qq.com/

接入流程:

https://bot.q.qq.com/wiki/#%E6%8E%A5%E5%85%A5%E6%B5%81%E7%A8%8B

关于注册

  1. 为获得群聊能力,群聊机器人必须使用企业主体才能注册

  2. 注册请看接入流程

  3. 接入完毕后进入机器人后台,查看你的 appId 和 appSecret,用于框架消费

安装

npm install nekeneko

基础使用

async function main() {
  const bot = await createBot({
    appId: "xxx", //请从机器人后台获得
    clientSecret: "xxxx", //请从机器人后台获得
    callback: {
      handleAt: async (context, event) => {
        console.log("context", context);
      },
      handleWatchMessage: (msg) => {
        console.log(msg);
      },
    },
  });
  //发送单聊文本
  bot?.sendUserPlain(openId, "你好");
  //发送单聊图片
  bot?.sendUserImage(openId, "你好", path.join(__dirname, "./image.png"));
  //发送群聊文本
  bot?.sendGroupPlain(openId, "你好!");
  //发送群聊图片
  bot?.sendGroupImage(openId, "你好!", path.join(__dirname, "./image.png"));
}
main();

注意事项

接口 & SDK

腾讯制定了一系列匪夷所思的规则,笔者挑选了几个具有代表性的罄竹难书:

  1. URL 域名必须备案且经过认证(认证方式是在域名的某个路径放置一个文件)

  2. 服务器必须有公网 IP(最近突然发公告说 Bot 必须绑定 IP,被骂的挺惨的,腾讯说会考虑取消这个限制 只是套话 应该不会改)

  3. 不能获取用户信息(无法获取用户 QQ 号,昵称,头像等,取而代之的是一长串 openid,即使是同一用户在不同群也会有不同的 ID,腾讯半年前说会更新)

  4. qq 群聊机器人腾讯目前仅支持回复 AT 事件,且主动发送消息每月限制4条,被动(回复别人的艾特消息)无限条

生成内容尺度

关于文本

腾讯对文本审核尺度把握非常迷惑严格,列举几个一般人觉得没问题但腾讯不允许出现的词汇:

上瘾,生病,胸,腿(等身体部位),美国(或任何国家),迪士尼系列的所有名词,,警察,药

上面的词汇仅限中文,用英文可以过审

能否过审主要取决于审核的心情,每个审核的 G 点不一样

关于图片

几乎没有标准

封号

几个可能导致封号的行为:

复读用户发过的消息或发送用户的 ID。

复读用户的表情包/图片或处理后发送用户的头像。

在某些日子发送或回复某些词汇,强烈建议了解以避免踩雷。坦克,蛋炒饭等

被举报包含 AI 回复的功能,AI 必须有对应资质。

github

https://github.com/moushicheng/qqgroup-bot

1.0.9

9 months ago

1.0.8

10 months ago

1.0.7

10 months ago

1.0.6

10 months ago

1.0.5

10 months ago

1.0.4

10 months ago

1.0.3

11 months ago

1.0.2

11 months ago

1.0.1

11 months ago

1.0.0

11 months ago