zhenxun-org/zhenxun_bot
Zhenxun Bot
This project is a cross-platform bot manager and development framework built on Nonebot2. It enables the creation and deployment of automated assistants that function across multiple chat services using a unified codebase and a shared communication protocol.
The system distinguishes itself with an integrated virtual economy plugin for tracking currencies and user rankings, alongside a dedicated administration web interface for monitoring system health and configuring plugin permissions. It utilizes an asynchronous event-driven architecture and an adapter-based abstraction layer to maintain consistent bot behavior across different messaging platforms.
The framework covers a broad range of capabilities, including role-based access control for command security, automated group administration for member onboarding, and comprehensive observability tools for performance visualization and user interaction analysis. It also provides a plugin management system and data persistence options using relational databases and Redis caching.
The project supports containerized deployment to ensure consistency across different hosting environments.
Features
- Cross-Platform - Enables the creation of bots that function across multiple messaging platforms using a unified codebase.
- Cross-Platform Bot Frameworks - Acts as a comprehensive framework for creating and deploying automated assistants across multiple chat services.
- Relational State Management - Implements state management by persisting user information and system data in relational databases.
- Multi-Channel Connectivity Adapters - Uses connectivity adapters to normalize communication between a common schema and various external messaging platforms.
- Cross-Platform Bot Protocols - Implements a shared communication protocol to ensure consistent behavior across different messaging services.
- Cross-Platform Bot Managers - Provides a unified system for deploying and controlling automated assistants across diverse chat services.
- Messaging Bot Frameworks - Offers a modular development framework for building cross-platform messaging bots.
- Messaging Platform Integrations - Provides adapters and interfaces to connect the bot framework to external social messaging services.
- Access Control Managers - Provides granular permission and group-based access policies for bot command execution.
- Administrative Access Control - Implements systems to restrict sensitive administrative commands to authorized superusers.
- User Profile Management - Maintains user-specific data including nicknames and virtual economy check-in streaks.
- Plugin Access Permissions - Implements a granular access control system for restricting bot commands via whitelists, blacklists, and roles.
- Chat Platform Adapters - Abstracts different chat platform APIs behind a common interface to enable multi-platform bot connectivity.
- Plugin Development Frameworks - Provides a modular framework for building interactive plugins using an asynchronous event-driven architecture.
- Plugin-Based Extensibility - Employs a plugin-based architecture that allows adding new bot capabilities at runtime without modifying the core engine.
- Multi-Platform Codebases - Enables the development of bots that communicate across multiple messaging platforms using a single unified codebase.
- User Identity Tracking - Tracks unique user identifiers and profile data across multiple chat environments.
- Gamified Economy Plugins - Includes an integrated virtual economy plugin for tracking currencies, check-ins, and user rankings.
- Redis-Backed State Stores - Uses Redis as a high-frequency state store to track temporary session data and interactions.
- Game Economy Managers - Includes a virtual economy system for tracking currencies, managing a bot shop, and user rankings.
- Relational Database Persistence - Persists user profiles and system state in relational databases to maintain consistency across restarts.
- Development Accelerators - Provides pre-implemented methods and internal interfaces to accelerate the development of bot plugins.
- Bot Management Interfaces - Ships a graphical user interface and API for configuring bot settings and monitoring system health.
- Chat Community Engagement Tools - Implements virtual currencies, daily check-ins, and gamified rankings to drive community engagement.
- Group Chat Administration - Provides tools for managing group memberships, onboarding workflows, and automated moderation policies.
- Role-Based Access Control - Implements a permission system to restrict sensitive commands to authorized users and groups based on defined roles.
- Event-Driven Architectures - Utilizes a non-blocking event loop and asynchronous processing to dispatch incoming messages to handlers.
- Administrative APIs - Provides a web-based administrative API for remote management of system controls and performance metrics.
- Bot Management Interfaces - Provides a dedicated web interface and API for managing bot settings and plugin permissions.
- Group Access Controls - Manages chat group member permissions, ban lists, and join/leave request workflows.
- System Health Monitoring - Monitors system stability through status checks, data inspection via SQL, and live configuration reloading.
- Plugin Management Systems - Provides a system to install, update, and configure modular plugins via a central library.
- Infrastructure Health Monitoring - Tracks system health, resource usage, and interaction metrics through dashboards and web interfaces.
- Web-Based Server Administration Panels - Provides a centralized web panel for managing remote bot configurations and monitoring system status.
