dev.md

一、开发准备

本节介绍如何搭建基础的开发环境。

1.获取项目源码及初始化

1. 命令行执行：https://github.com/project-yui/Yui.git
2. 进入项目：cd Yui
3. 安装npm包：pnpm install

2 安装环境

2.1 使用脚本安装

1. 执行 pnpm run install-ntqq
2. pnpm run dev
3. pnpm run nodestart

2.2 手动安装

参考此处

二、开发介绍

1. 运行

1. 执行命令 pnpm run dev，开始编译ts文件
2. 生成的文件在 program/resources/app/app_launcher/index.js
3. 启动无UI界面的Yui，执行pnpm nodestart
4. 启动有UI界面的Yui，执行pnpm start
5. 启动有UI界面保存Log的Yui，执行pnpm start-log-file (分析接口行为使用)

2. 关于后续开发

1. 修改ts代码会自动编译
2. 要应用更新需要关闭QQ，重新启动
3. 有时代码错误导致QQ崩溃，需要在任务管理器中杀掉进程

三、开发

此处以获取好友列表为例

1. 找出功能的流程

1. 打开QQ界面

2. 点击 联系人 -> 好友管理器

3. 使用好友名称搜索日志

4. 观察日志：

   

5. 可以发现，它先注册一个onBuddyListChange的订阅；

   然后，发送getBuddyList触发这个订阅；

   最后，产生了一条不带callbackid的推送。

2. 实现功能流程

相关代码在：getFriendList

1. 通过 sendEvent 先订阅 onBuddyListChange 事件
2. 再通过 registerEventListener 注册一次性的好友列表变更事件 onBuddyListChange，用来接收推送
3. 最后，通过 sendEvent 发送 getBuddyList 操作触发好友列表变更事件

3. 注册Onebot的动作处理

相关代码在：initFriend

在这个函数中，通过 registerActionHandle 来注册动作调用函数。