cqbot

基本的事件、API都实现了，没有花里胡哨的设计，开发者可以自由发挥

比如我现在在这里复制链接，https://docs.go-cqhttp.org/api/#%E6%A0%87%E8%AE%B0%E6%B6%88%E6%81%AF%E5%B7%B2%E8%AF%BB
或者是 https://docs.go-cqhttp.org/api/#标记消息已读

然后打开新标签页，访问刚刚复制的链接，都会跳转去基础通信。如果在已经打开的文档页面就可以正确跳转到锚点。

对频道消息进行撤回操作

据报错消息类型显示是notice.guild_channel_recall，然而文档中没有相关事件的说明。

复现方法

在频道发送消息后撤回。

API 部分的 get_forward_msg, 要求的参数是一个 string 的 message_id, 这个和其他 action, post 中的 message_id 不同

尝试使用http请求发送消息，不知道Access Token该以什么字段放在何处，
尝试过在Header上配置各种组合均无效，经过搜索在 Mrs4s/go-cqhttp#489 这条issues上得知配在url params上以access_token的形式。
文档内没有地方标明此种调用方式的参数配置

对撤回的消息进行全员删除操作时go-cqhttp本身报错

[2023-06-23 08:09:36] [ERROR]: 处理频道撤回事件时出现错误: 获取操作者资料时出现错误 fetch roles error: decode packet error: oidb result unsuccessful: 58002 msg: users not in guild

复现方法

在频道撤回消息后，将撤回的消息通知进行全员删除操作。该操作可能需要频道管理权限。

感觉更加规范？
同时方便后面写 API 自动化更新（虽然好像更新频率也蛮低的）

apiVersion: generator/v1
metadata:
  apiVersion: v1
  commitId: 987daad785839a9cb0425a27edc90a0a695f5c84
  creationTimestamp: '2022-03-04T04:49:41Z'
spec:
  CQSendGroupMessage:
    metadata:
      type: group
      availableVersion: v1
      annotations:
    spec:
      name:
        metadata:
          autotype: true
        spec: 发送群消息
      endpoint: /send_group_msg
      description: |-
       发送群消息
      payload:
        metadata:
          annotations:
        spec:
          - name: group_id
            type:
              metadata:
                autotype: true
                link: none
              spec: int64
            default: none
            description: none
      response:
        metadata:
            annotations:
        spec:

随手搓的一个示例，不是定稿
现有格式都会被考虑在内

主要目的是生成风格统一的 API 详情页面，不用考虑排版问题。需要考虑时只需要修改一个地方然后用生成器生成就可以了

感觉咋样（

• 为全部API添加请求与返回例子

现有的gocq API文档是建立在用户充分了解OneBot协议之上的，对新接触机器人的用户来说并不友好。何况现在的API文档仅描述了HTTP的通信方式，对WS和RWS的实现方法没有提及。综上，我认为有必要在/api下添加一个绪论，描述OneBot API基本通信原理，并附上OneBot的链接。

cmd不打印最新消息,url也无法收到发送的消息,摁下ctrl + c 才会弹出最新消息并发送

看标题

Todo

• 分版本构建文档
• 使用 vuepress-plugin-versioning 处理
• 使用自定义主题，从而在侧边栏加入文档版本选择下拉
• 可以使用 NoneBot 文档已经做好的主题直接加入适配，或者做一个 gocq 版本的？ (Request for Comments)

原 issue 为 #29

目前看来简介和主仓库是一样的，感觉复制一份到文档有点多余（
https://docs.go-cqhttp.org/guide/#go-cqhttp

https://docs.go-cqhttp.org/api/ 下的 item 太多了

如果考虑按类型区别，比如群相关 API、好友相关 API 分门别类放置可能会更利于阅读

想问问大家意见

是int32, 还是 int64 呢, 保证不出问题, 这需要与 go-cqhttp 内部的数据类型保持一致