README.md

zhukebot

烛客：我的社交媒体机器人

简介

• python技术栈：nonebot
• JavaScript技术栈：koishi

Nonebot

运行环境

• OS：Debian Stable(12 "bookwarm")，with Python3(3.11.2)
• APT INSTALLED：nvidia-driver 525.105.17.1、nvidia-cuda-toolkit 11.8
• PIP INSTALLED：PyTorch 2.0、nb-cli

由于 fastapi需要 watchfiles 而该模块暂不兼容 Python3.11，因此 nb-cli 实际运行的环境是 Python3.8-3.10，或是需要 Rust 编译。

开发工具

• 包管理器：PDM、UV
• 编程检查：ruff（black、flake8）、pyright、pylint
• 编辑环境：VS Code

工作环境

• 应用场景：QQ
• 协议：onebot
• 协议前端：NTQQ+签名服务器
• 服务后端：nonebot

插件清单

• SDwebui，精简自 nonebot-plugin-novelai，
• ChatGLM，为清华开源的 chatGLM-6B 提供 nonebot 插件。
• ChatRWKV 支持插件，还在调试
• 缝合nonebot-plugin-hitokoto和nonebot-plugin-everyday-en

基于 Termux 的方案

通过 API 分离 AIGC，减轻机器人服务器压力

安装

本体：android 系统手机，安装 termux，python、pip、nb-cli 等

1. 在 Android 手机上，从 termux 下载安装termuxAPP。
2. 打开termuxAPP，使用termux-change-repo进入图形化界面更换软件源（空格是选择，Enter 是确认），中国国内建议用清华源（北外源）、南大源、中科大源等。
3. 更新termux的软件源（更换后一般会自动更新），然后用apt upgrade命令升级（也可以用apt list --upgradable查看可升级列表），其中需要确认配置的，一律选择缺省设置（defualt，即输入n）。
4. 进入 Debian stable 环境
   1. 安装发行版工具：apt install proot-distro
   2. 安装Debian，proot-distro install debian
   3. 登录Debian，proot-distro login debian
   4. 更新 debian apt 源，可参考清华开源镜像的 说明
5. 安装 Python 环境
   1. python、pip、等。输入apt install python3 python3-pip -y
   2. 更换 pip 源，中国国内建议用清华源（北外源）、南大源、中科大源等，pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple，并升级pip install -U pip setuptools wheel。
   3. 用 pip 安装 pipx 工具，python3 -m pip install --user pipx和python3 -m pipx ensurepath
6. 安装nb-cli，pipx install nb-cli
7. 初始化 nonebot 环境，nb init。之后的可参考 nonebot 官方文档

常见错误及解决

• 定时插件报错，时区设置问题：修改时区 date，tzselect，export TZ="Asia/Shanghai"

用以下代码检查时区是否正确

from tzlocal import get_localzone
get_localzone()

插件

核心功能插件

适配器

服务器状态：nonebot-plugin-status，

撤回

定时任务：nonebot-plugin-apscheduler，

AIGC 功能插件

Chat 功能提供：笔记本（8G 显存），使用 nonebot-plugin-ChatGLM6B

Draw 功能提供：台式（8G 显存），使用 nonebot-plugin-novelai

License