如何复现问题?

使用web端 message-builder 即可复现。

[
  {
    "type": "card",
    "theme": "secondary",
    "size": "lg",
    "modules": [
      {
        "type": "section",
        "text": {
          "type": "kmarkdown",
          "content": "\u003c\u0026ÿĀĀĀ\u003etest\u003c$ÿĀ\u001c\u0003\u003e"
        }
      }
    ]
  }
]

你希望的输出是什么?

正确输出解码后的unicode字符或原文。

你得到什么结果?

报错：

卡片消息格式没有通过验证或者不存在
markdown_string不存在或者你没有权限操作

功能模块

文档中约定了Channel对象，然而在频道相关api中：获取频道列表，获取频道详情，创建频道，返回的数据对象均与Channel对象不一致，这对api的开发使用造成较大困扰，尤其是对于非动态语言（目前正在开发 Rust lib）

你希望的功能描述？

尽可能统一相近api返回的对象字段

功能的主要使用产景？

如上

其它信息

如上

如何复现问题?

触发 updated_channel 事件，通过 websocket 监听事件。

你希望的输出是什么?

d.extra.body.is_category 的类型是 boolean，与文档中的样例及 Channel 类型一致

你得到什么结果?

d.extra.body.is_category 的类型是 number

文档的具体地址?

https://developer.kaiheila.cn/doc/http/message

你认为有问题的文档内容

在描述中，它被标记为 boolean 类型：

但在返回示例中却表现为了数组格式：

https://developer.kaiheila.cn/doc/webhook

配置回调地址

"s": 0, 后 // 应用需要原样返回的值 应为 // 信令类型

功能模块

客户端识别用户正在播放的音乐

你希望的功能描述？

支持识别Spotify播放的音乐

功能的主要使用产景？

可以识别用户使用Spotify播放的歌曲
并且给https://developer.kookapp.cn/doc/http/game#%E6%B7%BB%E5%8A%A0%E6%B8%B8%E6%88%8F/%E9%9F%B3%E4%B9%90%E8%AE%B0%E5%BD%95-%E5%BC%80%E5%A7%8B%E7%8E%A9/%E5%90%AC
音乐软件枚举中添加spotify

其它信息

无

Describe the bug
比如这个请求[1]。它只返回二十条消息，却要半分多钟，不适合生产使用。用其它 flag 参数的话则没有问题。

[1]: http://kaiheila.cn/api/v3/message/list?flag=around&target_id=1071036821430777&msg_id=48940efa-9295-4c7f-a159-7f97343a04ee（需要 Authorization）

来自 android 客户端的 event.d.extra :

{
        "author": {
          "avatar": "url str",
          "bot": "False",
          "id": "2184300000",
          "identify_num": "2118",
          "mobile_verified": "True",
          "nickname": "str",
          "online": "False",
          "os": "Android",
          "roles": [],
          "username": "str"
        },
        "duration": 0,
        "guild_id": "1039332615500000",
        "height": 0,
        "mention": [],
        "mention_all": "False",
        "mention_here": "False",
        "mention_roles": [],
        "size": 0,
        "type": 1,
        "width": 0
      }

来自其他客户端的 event.d.extra :

"extra": {
        "local_id": "lCJWd3XHfozeGPSEQ14MLFH8",
        "type": "1",
        "guild_id": "1039332615500000",
        "channel_name": "str",
        "mention": [],
        "mention_all": "False",
        "mention_roles": [],
        "mention_here": "False",
        "code": "",
        "author": {
          "identify_num": "4771",
          "avatar": "url str",
          "username": "str",
          "id": "3570900000",
          "nickname": "str",
          "roles": [
            59754,
            59750
          ]
        }
      }

稍微消掉了一些个人信息，两个 extra 比较关键的出入有：

• extra.type 一个是 literal string，一个是 int
• 安卓端来的 event 没有 extra.channel_name 这个 field
• 安卓端来的 event 中的 extra.author.roles 为空（正常应该有两个 roles）

其他还有一些出入，不过开发文档中目前都没有相关说明，就不列出来了

下午和 tttzzz 聊了一会儿这个问题，他也表示是安卓 APP 的 BUG

我转到这里记录一下供遇到相关问题的朋友参考

功能模块

使用kmarkdown+链接生成的链接只能打开网页版，不能在当前客户端加入语音频道

你希望的功能描述？

希望可以使用其他type的消息邀请玩家加入语音频道（或者增加按钮功能，使按钮可以加入语音频道）

功能的主要使用产景？

组队bot，创建房间后需要邀请玩家加入语音频道，如果是采用临时更新card message作为菜单的形式，反复发送type为1的临时消息会导致菜单被刷没，只能刷新频道消息。

其它信息

无

如何复现问题?

调用了api更新游戏接口/api/v3/game/update，代码如下

async def status_active():
    url="https://www.kookapp.cn/api/v3/game/update"
    headers={f'Authorization': f"Bot 这里填入了bot的token"}
    params = {"id":453027,"icon":"https://s1.ax1x.com/2022/07/16/j5rrwV.png"}
    async with aiohttp.ClientSession() as session:
        async with session.post(url, json=params,headers=headers) as response:
                ret =json.loads(await response.text())
                print(ret)

此代码可正常更新bot动态/删除bot动态（修改url和参数后）

你希望的输出是什么?

返回正确调用的结果

{
    "code": 0,
    "message": "操作成功",
    "data": {}
}

你得到什么结果?

使用上图所示代码，会报如下错误

{'code': 40000, 'message': 'id参数错误', 'data': {}}

如果使用khl.py的SDK，则会报如下错误（已和sdk作者联系）

khl.requester.HTTPRequester.APIRequestFailed: Requesting 'POST game/update' failed with 40000: 无法获取文件信息

id参数是int，且我可以正常使用该id进行bot游戏动态的更新操作。所以不可能是这个id游戏不存在。以下是当初创建游戏接收到的返回值👇

{'code': 0, 'message': '操作成功', 'data': {'id': 453027, 'name': '无畏契约', 'type': 0, 'options': '', 'kmhook_admin': False, 'icon': 'https://img.kookapp.cn/assets/2022-07/1NVv2eLQuf074074.png/icon', 'process_name': [], 'product_name': []}}

问题就是无法更新该id游戏的信息（我现在想更新一下icon）

bot动态同步问题

调用api进行操作之后，bot的游戏动态出现很快，但是删除游戏动态的操作需要很久才能同步！如下图，10分钟都没搞定……

已尝试刷新网页端/重启客户端，不起作用

其它信息

https://developer.kaiheila.cn/doc/reference

速度限制 Section

有关速度限制的问题，请参阅速率限制一节 (https://developer.kaiheila.cn/docs/rate-limit)

https://developer.kaiheila.cn/docs/rate-limit (404)
->
https://developer.kaiheila.cn/doc/rate-limit

功能模块

消息相关文档

你希望的功能描述？

在 频道消息相关接口文档 中，是有针对于 消息详情参数 的说明的，但是在 用户私聊消息接口文档 则没有对消息内容进行说明。那么私聊消息的数据字段是与频道消息数据字段一致吗？如果是，建议增加一个备注说明，或者为 消息 字段提供一个单独的概述页之类的

语音对讲技术实现，你好，请问你们语音对讲是用什么编码的？我最近也在研究语音对讲，技术上遇到点难题，
vue作为技术框架，websocket作为通信方式，实时语音读取，pcm格式文件，打算编码未opus格式
希望能帮忙解答下，语音采集多久时间发送到服务器最好，pcm编码opus如何变码，麻烦解答下，谢谢

如何复现问题?

调用 /user/me api

你希望的输出是什么?

根据文档，invited_count 字段返回类型为 int

具有 mobile_verify: bool 字段

你得到什么结果?

实际收到类型为 String

缺失 mobile_verify 字段

其它信息

开黑啦官方的吐槽中心链接 好像过期了 有没有新的链接啊
想弄一下bot玩玩 但是好像需要先申请
谢谢了

/guild/view这个接口，返回值的channels列表的channel数据里，似乎跟“标准对象格式”里提供的channel数据字段相比，缺少了几个字段：user_id guild_id topic slow_mode

相关数据返回值 (channels内)：

[
        {
			"id": "7566099004366572",
			"master_id": "886154643",
			"parent_id": "3457936871358649",
			"name": "文字频道",
			"type": 1,
			"level": 100,
			"limit_amount": 0,
			"is_category": false,
			"permission_sync": 0,
			"permission_overwrites": [{
				"role_id": 0,
				"allow": 0,
				"deny": 0
			}],
			"permission_users": []
		}
]

相关异常提示：

kotlinx.serialization.MissingFieldException: Fields [user_id, guild_id, topic, slow_mode] are required for type with serial name 'CHANNEL_I', but they were missing

功能模块

WIN端，开发者模式

你希望的功能描述？

希望新增复制角色ID的能力

功能的主要使用产景？

点击按钮或添加回应自动赋予角色，在角色被（其他管理）重建或者新增更多需要自动授予的角色时，需要方便的获取角色ID。（否则需要使用调试工具调用接口获取服务器角色列表再一个个寻找）

其它信息

顺便，新版本更新没有推送给0.0.37.4，我是手动去官网下载的。

文档的具体地址?

https://developer.kaiheila.cn/doc/http/user-chat#%E8%8E%B7%E5%8F%96%E7%A7%81%E4%BF%A1%E8%81%8A%E5%A4%A9%E4%BC%9A%E8%AF%9D%E5%88%97%E8%A1%A8

https://developer.kaiheila.cn/doc/http/user-chat#%E8%8E%B7%E5%8F%96%E7%A7%81%E4%BF%A1%E8%81%8A%E5%A4%A9%E4%BC%9A%E8%AF%9D%E8%AF%A6%E6%83%85

你认为有问题的文档内容

在List中，存在 target_info - online 字段，但是在View中则没有：

那么这两个中的targetInfo是不同的吗（就是是存在online字段的差异的吗）

(emj)服务器表情名(emj)[服务器id]
服务器表情无法显示

To Reproduce

1. 使用 Webhook 监听 added_reaction 事件
2. 当事件发生时使用事件的 msg_id 请求 /api/v3/message/reaction-list

Expected behavior
API 返回所有该消息的回应。

Actual behavior
API 返回的回应中不包含 added_reaction 事件所指的回应。十次中大概发生一次。

文档的具体地址?

https://developer.kaiheila.cn/doc/http/channel#%E6%9B%B4%E6%96%B0%E9%A2%91%E9%81%93%E8%A7%92%E8%89%B2%E6%9D%83%E9%99%90

你认为有问题的文档内容

应该是用户ID 或 角色ID吧，怎么会是频道ID

你期望的结果?

应该是用户ID 或 角色ID吧，怎么会是频道ID

如何复现问题?

api/message/update接口，提供temp_target_id时，如果消息类型为10，消息本身时长超过一个月，且更新的消息中含有按钮，会导致按钮不可用（消息不存在或你没有权限操作）

你希望的输出是什么?

正常更新

你得到什么结果?

消息不存在或你没有权限操作

其它信息

无

文档的具体地址?

无

你认为有问题的文档内容

无

你期望的结果?

添加对于 "动作消息" 的消息事件的格式描述

如何复现问题?

请给出api接口，并给出相应的调用步骤
https://www.kookapp.cn/api/v3/channel/create
传入参数is_category=1来创建分组

你希望的输出是什么?

正常创建分组

你得到什么结果?

如果机器人创建分组的时候用户在服务器里，用户的客户端会崩溃
如果进入机器人创建过分组的服务器，会加载不出来左边的频道列表

其它信息

不论是客户端还是浏览器都会出现该问题

如何复现问题?

/api/v3/channel/update
channel_id = 4121189805803798
name = test

你希望的输出是什么?

正确修改频道名字

你得到什么结果?

客户端打开频道无限崩溃

其它信息

文档的具体地址?

https://developer.kookapp.cn/doc/http/user

你认为有问题的文档内容

获取目标用户信息的返回参数说明中出现了两个mobile_verified

引用较长的Markdown消息的时候会出现UI位置错误的情况

文档的具体地址?

事件结构/格式说明：https://developer.kaiheila.cn/doc/event/event-introduction
消息相关事件列表：https://developer.kaiheila.cn/doc/event/message

你认为有问题的文档内容

在 事件结构/格式说明 中的 extra 说明中提到，extra字段分为两种可能：一个是 type == 255 的 系统消息，其格式是千变万化的，一个是其他可能，就是 “消息事件”，从文档中来看，消息事件的 extra 似乎并没有可变的点，也没有提到是否所有事件都一致

然后到 消息相关事件列表 文档中，可以看到，实际上 type != 255 的事件的 extra 字段数据之间依然有很大差距，例如 文件消息 中，出现了 attachments 字段，且该字段下的数据格式不明确（只能从示例json中看到一些字段，但是无法确定这些字段是必然存在的、还是可能出现变化的）；并且 文件消息 的字段示例中还少了很多 事件结构/格式说明 中提到的字段（例如 channel_name）

然后，再看到下面的 KMarkdown消息 和 Card消息 中，extra 数据中又出现了新的字段 kmarkdown 以及一些未标注含义的字段（例如 nav_channels）

然后我发现 事件结构/格式说明 中说明的 extra 字段元素似乎并非是所有事件之间的 最小范围 的通用元素，且不同事件存在 增加 / 减少 字段内容的可能。

你期望的结果?

希望能够明确事件的通用内容（例如那些字段必然是每个事件都有的），以及对于事件中出现的额外内容（例如 文件消息 中的附件字段 attachments ）进行较为细致的说明（包括每个字段的类型、是否必然存在等等）

因为没有 template 所以简单写一下：

开启 compress 时，challenge 使用 deflate 方式压缩， 但 events 使用 zlib 方式压缩

下午和 tttzzz 沟通过了，如果已经 fix 的话直接 close 该 issue 即可，谢谢！

To Reproduce
用 Webhook 接受任意带有文字消息的事件 （https://developer.kaiheila.cn/doc/event/message）

Expected behavior
nickname 属性是用户的服务器昵称。

Actual behavior
nickname 属性是用户名，和 username 一样。

C# Decrypt示例

public static class Encrypt
{
    public static async Task<string> Decrypt(string content, string encryptKey)
    {
        string eData = Encoding.UTF8.GetString(Convert.FromBase64String(content));

        byte[] iv = Encoding.UTF8.GetBytes(eData.Substring(0, 16));
        eData = eData.Substring(16);

        byte[] key = Encoding.UTF8.GetBytes(encryptKey +
                                            new string('\0', 32 - encryptKey.Length));

        try
        {
            using var rijndaelManaged =
                new RijndaelManaged { Key = key, IV = iv, Mode = CipherMode.CBC };
            await using var memoryStream =
                new MemoryStream(Convert.FromBase64String(eData));
            await using var cryptoStream =
                new CryptoStream(memoryStream,
                    rijndaelManaged.CreateDecryptor(key, iv),
                    CryptoStreamMode.Read);

            return await new StreamReader(cryptoStream).ReadToEndAsync();
        }
        catch (CryptographicException e)
        {
            throw;
        }
        catch (Exception e)
        {
            throw;
        }
    }
}

已经通过了测试并且已经用在了 SDK 上

正在修正一些问题

你认为有问题的文档内容

以 websocket 下的 文字消息 为例，在文档中显示，字段中有 mention_all 等字段，但是在私聊消息事件中，这些字段实际上并不存在。

你期望的结果?

希望能对这些 可能 不存在的字段进行标注说明。如果可能，最好为每个字段都标记其存在性（比如必然存在 / 可能不存在）

麻烦做下Github Issues模板，在仓库设置里有模板设置
设置传送门

功能模块

文档搜索

你希望的功能描述？

比如用vuepress生成的页面会自带搜索功能

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

文档的具体地址?

/

你认为有问题的文档内容

全部

你期望的结果?

希望区分 Int32（Integer） 和 Int64（Long）

功能模块

文档中与 时间(戳) 相关内容

你希望的功能描述？

针对于文档中一些与时间相关的描述（例如 获取私信聊天会话列表 中的 last_read_time、latest_msg_time 等 ）进行一个描述，表述他的时间格式是秒还是毫秒，或者在一个统一的地方对时间格式进行概述，比如在 资源 - 参考 中追加一个对全局时间格式的描述。

https://razedev.is-inside.me/OwDmVTDH.png
Image is above ^

如何复现问题?

使用错误的，或不使用 Authorization Header 请求 Gateway。

你得到什么结果?

返回的 code 为 Integer 类型

其它信息

文档的具体地址?

卡片消息 - 卡片 - card | https://developer.kaiheila.cn/doc/cardmessage#%E5%8D%A1%E7%89%87

你认为有问题的文档内容

card

作用说明： 标题模块只能支持展示标准文本（text），突出标题样式。

你期望的结果?

将其修改为正确的描述

我的机器人需要对用户的消息回应做出反应，并且获得该用户的名称。有没有 API 能够通过用户 id 获取用户名？

现在的做法是收取 Webhook 的 added_reaction 事件，然后通过事件的 msg_id 查询该消息下所有回应，包括事件所指的回应及用户名，但会遇到问题 #53。

我个人认为应当将issue作为主要的bug反馈区而不是那个 问题反馈 的频道。
站在我个人的角度，希望能为issue提供更清晰的模板，而不是github给的默认模板，并将反馈上报的重心转移到这边儿，因为在这里，能够更好的追踪问题进度、查询问题历史记录、讨论、问题之间的关联与分类等

以上是我个人建议🐱

如何复现问题?

请给出api接口，并给出相应的调用步骤
https://www.kaiheila.cn/api/v3/guild/user-list

Python3 使用requests.get()调用

你希望的输出是什么?

指定服务器的全部成员

你得到什么结果?

少个人

其它信息

Describe the bug
我做的机器人需要读取和编辑自己发过的消息。现有的 /api/v3/message/list 无法直接查询某条消息，用 flag=around 的话又会遇上其它问题：#46

如何复现问题?

请给出api接口，并给出相应的调用步骤
/api/v3/channel-role/update
传入以下数据
type = role_id
value = "0"

你希望的输出是什么?

应该是正常修改@everyone的权限

你得到什么结果?

40000, '服务器角色不存在或者你没有权限操作

其它信息

如何复现问题?

请给出api接口，并给出相应的调用步骤
调用/api/oauth2/token
获得了code
利用code根据文档参数调用/api/oauth2/token
发送请求之后给出的结果是

{
"code": 400,
"message": "Authorization code doesn't exist or is invalid for the client",
"data": {
"name": "Bad Request",
"status": 400
}
}

你希望的输出是什么?

我希望输出正确的access_token

你得到什么结果?

我希望输出正确的access_token

其它信息

文档的具体地址?

https://developer.kaiheila.cn/doc/http/message

你认为有问题的文档内容

在消息详情数据中， attachments、quote 这两个字段的格式并没有进行描述，且在示例数据中也都是以 [] 和 null 略过了。

如何复现问题?

请给出api接口，并给出相应的调用步骤
针对一个只含文件的消息使用
/api/v3/message/view

你希望的输出是什么?

{ ...,
    data: {
        "type": 4,
        "attachments": {...},
        ...
    }
}

你得到什么结果?

{ ...,
    data: {
        "type": 10,
        "attachments": null,
        ...
    }
}

其它信息

如何复现问题?

• 接口地址 /api/v3/channel-user/get-joined-channel
• 文档地址 接口文档
• 问题描述：
  如果从服务器A的语音频道a离开后，第一次进入服务器B的任意语音频道b后，该接口不能正确返回频道b的id，返回为空
• 复现方法：
  先进入另外一个服务器A的语音频道，再进入测试用服务器B的任意语音频道b1，此时调用接口即可复现，如果离开b1重新进入b1，则接口可以正常返回；如果离开b1，进入任意一个服务器B的其他语音频道b2，该接口亦可以正常返回；问题仅发生在第一次切换服务器的语音频道时

其他信息

• 语言 Python
• 操作系统 macos12.4 arm64(apple/m1)

文档的具体地址?

https://developer.kaiheila.cn/doc/http/user#%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%94%A8%E6%88%B7%E4%BF%A1%E6%81%AF

你认为有问题的文档内容

文档的字段说明中说存在一个 system 字段：

但是似乎实际上并没有这个字段。

你期望的结果?