NekoBox

基于 lagrange-python 的 Satori协议 实现，使用 satori-python

如何启动

使用稳定版(推荐)

# 安装环境
python -m pip install nekobox

# 可选依赖，用于支持非silk格式audio发送
python -m pip install pysilk-mod

# 跟随步骤生成配置文件后，使用手Q扫码即可登录
nekobox run

使用开发版

# 安装环境
git clone https://github.com/wyapx/nekobox
cd nekobox

python -m pip install .

# 可选依赖，用于支持非silk格式audio发送
python -m pip install pysilk-mod

# 跟随步骤生成配置文件后，使用手Q扫码即可登录
nekobox run

使用 PDM:

# 安装环境
git clone https://github.com/wyapx/nekobox
cd nekobox

pdm install

# 可选依赖，用于支持非silk格式audio发送
pdm sync --group audio

# 跟随步骤生成配置文件后，使用手Q扫码即可登录
pdm run nekobox run

CLI 工具

$ nekobox
usage: nekobox [-h] {run,gen,clear,default} ...

NekoBox/lagrange-python-satori Server 工具

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit

commands:
  {run,gen,list,show,clear,delete,default}
    run                 启动服务器
    gen                 生成或更新配置文件
    list                列出所有账号
    show                显示账号配置
    clear               清除数据
    delete              删除账号配置
    default             设置默认账号

生成或更新配置文件

使用 nekobox gen 生成或更新配置文件。

当未传入 uin 参数或 uin 为 ? 时，若配置文件已存在则会出现交互式选择：

$ nekobox gen
正在更新配置文件...
 - 987654
 - 123456
请选择一个账号 (987654):

启动服务器

使用 nekobox run 启动服务器。

• 若未传入 uin 参数，会使用默认账号（可由 nekobox default 指定）。
• 若 uin 为 ?，会出现交互式选择。

$ nekobox run ?
- 987654
- 123456
请选择一个账号 (987654):

• 可以使用 --debug 参数强制日志启用调试等级。

特性支持情况

1. 消息类型

   • Text
   • At, AtAll
   • Image
   • Quote
   • Audio

2. 主动操作

   • message-create
   • message-delete 部分支持：群聊
   • message-get 部分支持：群聊
   • guild-member-kick
   • guild-member-mute
   • guild-member-get
   • guild-member-list
   • guild-list
   • channel-list
   • login-get
   • user-channel-create 用于向 user 发起私聊 (前提是好友)
   • guild-member-approve
   • friend-list
   • reaction-create
   • reaction-delete
   • reaction-clear

3. 事件

   • message-created
   • message-deleted 部分支持：群聊
   • guild-member-added
   • guild-member-removed
   • guild-updated 群名更改
   • guild-member-request
   • reaction-added
   • reaction-deleted

由于大多数事件和操作没有标准参考，特性的新增可能需要一些时间.