本文档提供了nkuwiki项目的部署说明,包括运行项目、部署MySQL和Qdrant服务等内容。
# 启动智能问答服务
cd nkuwiki & python3 app.py
# 启动爬虫任务 (示例)
# 确保已安装 playwright install chromium
cd nkuwiki & python3 ./etl/crawler/wechat.py
sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker
# 添加当前用户到docker组(免sudo运行docker)
sudo usermod -aG docker $USER
# 重新登录以使权限生效
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable docker
sudo systemctl start docker
# 添加当前用户到docker组(免sudo运行docker)
sudo usermod -aG docker $USER
# 重新登录以使权限生效
docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=your_password -v path\to\your\data\mysql:/var/lib/mysql mysql:latest
# 示例
# docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -v d:\code\nkuwiki\etl\data\mysql:/var/lib/mysql mysql:latest
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 \
-v path\to\your\data\qdrant:/qdrant/storage \
qdrant/qdrant:latest
# 示例
# docker run -d --name qdrant -p 6333:6333 -p 6334:6334 -v d:\code\nkuwiki\etl\data\qdrant:/qdrant/storage qdrant/qdrant:latest
sudo apt update
sudo apt install mysql-server
sudo systemctl enable mysql
sudo systemctl start mysql
# 设置root密码
sudo mysql_secure_installation
sudo yum install mysql-server
sudo systemctl enable mysqld
sudo systemctl start mysqld
# 获取临时root密码
sudo grep 'temporary password' /var/log/mysqld.log
# 设置新密码
mysql -uroot -p
ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_new_password';
brew install mysql
brew services start mysql
# 设置root密码
mysql_secure_installation
curl -L https://github.com/qdrant/qdrant/releases/latest/download/qdrant-x86_64-unknown-linux-gnu.tar.gz -o qdrant.tar.gz
tar -xvf qdrant.tar.gz
cd qdrant
# 启动qdrant服务
./qdrant
curl -L https://github.com/qdrant/qdrant/releases/latest/download/qdrant-x86_64-apple-darwin.tar.gz -o qdrant.tar.gz
tar -xvf qdrant.tar.gz
cd qdrant
# 启动qdrant服务
./qdrant
# mysql配置(根据需要修改)
# linux/macos
sudo mysql
CREATE USER 'your_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;
etl/crawler
目录创建新的爬虫类,继承BaseCrawler
self.platform
, self.base_url
, self.content_type
等配置login_for_cookies
方法(如果需要登录), scrape
和download
方法services
目录创建新的通道类services/channel_factory.py
中注册新通道core/agent/
目录下添加新的AI提供商目录Agent
类的自定义智能体agent_factory.py
中注册您的智能体services/terminal
模块进行命令行调试,配置channel_type = terminal
logs/
目录下的日志文件排查问题更详细的开发文档请参考docs目录。