引言

首先欢迎大家来使用 khl.py (opens new window)！如果有兴趣的话，也非常欢迎大家来一起开发和维护khl.py

本文档基于 khl.py 0.3.16 和 python 3.10.6

您可以在 musnows/khl.py.docs/tree/main/code (opens new window) 查看本文档教程中涉及到的代码

废话就不多说了，我们先来康康入门的准备工作有哪些：

准备点米：整个机器人

巧妇难为无米之炊，所以首先要做的事儿当然是整个机器人来啦，流程也很简单，只要三部

1. 准备一个 kookapp.cn (opens new window) 的账号
2. 来 服务器：「KOOK」开发者内测 (opens new window) 申请开发者内测权限（目前已不需要申请）
3. 在 网页后台：开发者中心 - 应用 (opens new window) 创建一个「应用」，然后点开刚创建好的应用
   • 大家能在左侧的「设置」选项卡列表中看到一项「机器人」，点开它
   • 点开「机器人」选项卡后，就能看到机器人的信息以及「机器人连接模式」、「Token」两项重要选项
     • 「机器人连接模式」请设置为「websocket」，这是一种很好用的连接方式。当然，你也可以选择「webhook」。具体操作都会在初始化机器人章节讲解。
     • 「Token」是机器人的身份凭证，请不要上传到任何地方 / 告诉其他人 / 直接写进代码 / 上传到代码托管平台

准备口锅：搭个机器人的运行环境

巧妇有了，米有了，接下来就是要口锅来装米才行，而给 khl.py (opens new window) 用的「锅」也很好搭，两步即可：

1. 安装 python，版本号>=3.6.8即可
   • 为什么是 3.6.8？因为 centos7 能直接通过 epel 安装 python 3.6.8，所以 centos 选手也不需要从源码编译了，直接通过 epel 安装即可，很方便；
   • 不过，还是建议安装较新版本的 python 3.10.x，参考 CentOS安装Python3.10教程 (opens new window)；
2. 运行以下命令来安装 khl.py (opens new window)：

pip install khl.py

注意：如果你的机器上同时有多个版本的 python，要注意别装到错误版本的 python 里了

如果你的系统上安装的是 python 3.10.x，则应该用如下命令安装 khl.py

pip3.10 install khl.py

劈劈柴火：稍微了解一下 khl.py

我们下一页 文档 才会正式开始「做饭」，所以我们这里先简单地说说 khl.py (opens new window) 的特点，就当是准备点柴火和引子，方便大家之后「做起饭来」上手更快：

1. khl.py (opens new window) 是全异步的 API 框架
   • 异步是个啥？这个问题就不展开说了，大家可以百度/谷歌一下「异步 同步」，两者对照起来学比较快
   • 这篇文章里对异步和同步的描述就比较形象 -> 对python async与await的理解 (opens new window)
2. khl.py (opens new window) 使用 aiohttp (opens new window) 实现网络通信功能
   • 所以你可以直接让机器人用 aiohttp 来访问网站、获取资源，不需要再 import requests 了
   • aiohttp 也是全异步的网络框架，所以和我们的代码相性非常好
3. 有时间的话，还可以搜搜「python asyncio」，因为 khl.py (opens new window) 可以很自然地联动 asyncio，来实现一些很炫的东西

写在后面

现在巧妇有了米、有了锅、有了柴火，大家可以准备来写几段了

talk is cheap, show me the code

正式开始开发之前，您还需要阅读 kook各类ID获取办法

先从 初始化机器人 开始吧！