cially 的安装和配置教程

项目基础介绍

cially 是一个强大的开源仪表板，专为 Discord 服务器提供深入洞察、实时分析和详细的统计数据。它能够监控成员活动、跟踪参与度趋势，并轻松做出基于数据的决策。cially 适用于社区经理、版主和服务器管理员，帮助他们优化 Discord 社区。

该项目主要使用 JavaScript 编程语言，并基于 Node.js 运行。

项目使用的关键技术和框架

• Discord.js: 用于与 Discord API 交互的 Node.js 库。
• Next.js: 一个基于 React 的框架，用于构建服务器渲染的 Web 应用程序。
• Pocketbase: 一个开源的后端即服务 (BaaS) 平台，用于快速开发应用程序。
• Docker: 用于容器化应用程序，简化部署和扩展。

项目安装和配置的准备工作

在开始安装 cially 之前，请确保您的系统已安装以下软件：

• Node.js (推荐版本 LTS)
• Docker (可选，但推荐用于简化部署)
• Discord Developer Portal 账户

详细安装步骤

步骤 1: Discord 机器人设置

1. 访问 Discord Developer Portal 并创建一个新的应用程序。
2. 进入 "Bot" 部分，启用所有 "Privileged Gateway Intents"。
3. 邀请机器人到您的 Discord 服务器，并授予它查看频道和查看消息历史的权限。如果需要跟踪服务器虚荣网址使用情况，还可以授予 "管理服务器" 权限。

步骤 2: 克隆项目仓库

使用 Git 克隆项目仓库到本地计算机：

git clone https://github.com/skellgreco/cially.git
cd cially

步骤 3: 配置 Pocketbase

1. 下载并运行 Pocketbase：

docker pull pocketbase/pocketbase
docker run -p 8090:8090 -d pocketbase/pocketbase

2. 在浏览器中打开 Pocketbase UI (http://localhost:8090) 并创建一个管理账户。
3. 导航到 "设置" -> "导入"，使用项目目录中的 pb_schema.json 文件导入数据模型。

步骤 4: 配置 Discord 机器人

1. 在 ./cially-bot 目录中，将 .env.example 文件重命名为 .env 并填写相关配置。
2. 在项目目录中运行：

npm install
npm start

步骤 5: 配置 Web 应用程序

1. 在 ./cially-web 目录中，将 .env.example 文件重命名为 .env 并填写相关配置。
2. 构建并运行 Web 应用程序：

npm run build
npm start

步骤 6: 完成设置

1. 确保机器人已经在 Discord 服务器上运行并且已经开始记录数据。
2. 打开 Web 应用程序，在仪表板上粘贴您的服务器 ID，然后查看显示的数据。

请注意，只有机器人运行期间发生的事件才会被跟踪和显示在仪表板上。机器人离线期间的事件将不会被记录。

以上就是 cially 的安装和配置教程。祝您使用愉快！