Koishi 学习小组管理插件

一个功能完整的 Koishi 插件，用于帮助用户创建、加入和管理学习小组，促进协作学习。

功能特性

• ✅ 创建学习小组 - 用户可以创建学习小组并自动成为组长
• ✅ 加入/离开小组 - 用户可以加入感兴趣的小组或离开已加入的小组
• ✅ 小组列表查看 - 分页查看所有活跃的学习小组
• ✅ 小组详情查看 - 查看小组的详细信息、成员列表和状态
• ✅ 小组搜索功能 - 根据关键词搜索学习小组
• ✅ 个人小组管理 - 查看自己加入的所有小组
• ✅ 小组解散功能 - 组长可以解散自己创建的小组
• ✅ 小组信息修改 - 组长可以修改小组描述信息
• ✅ 权限控制 - 完善的权限检查和成员数量限制

安装

在 Koishi 项目目录中运行以下命令：

npm install koishi-plugin-study-group-manager

配置

在 koishi.yml 中添加以下配置：

plugins:
  study-group-manager:
    defaultMaxMembers: 10        # 默认小组最大成员数
    allowUserCreateGroup: true   # 是否允许用户创建小组
    maxGroupsPerUser: 3          # 每个用户最多加入的小组数

使用说明

创建学习小组

创建学习小组 <小组名称> <科目> [描述]
study-group.create <name> <subject> [description]

示例：

创建学习小组 数学互助小组 数学 一起学习高等数学

加入学习小组

加入小组 <小组ID>
study-group.join <groupId>

示例：

加入小组 1

查看小组列表

查看小组列表 [页码]
study-group.list [page]

示例：

查看小组列表
查看小组列表 2

查看小组详情

小组详情 <小组ID>
study-group.info <groupId>

示例：

小组详情 1

搜索学习小组

搜索小组 <关键词>
study-group.search <keyword>

示例：

搜索小组 数学

查看我的小组

我的小组
study-group.my

离开学习小组

离开小组 <小组ID>
study-group.leave <groupId>

示例：

离开小组 1

解散学习小组（仅组长）

解散小组 <小组ID>
study-group.disband <groupId>

示例：

解散小组 1

修改小组信息（仅组长）

修改小组 <小组ID> [新描述]
study-group.edit <groupId> [description]

示例：

修改小组 1 新的小组描述信息

数据库结构

学习小组表 (study_groups)

• id - 小组ID（自增）
• name - 小组名称
• description - 小组描述
• creatorId - 创建者ID
• subject - 学习科目
• maxMembers - 最大成员数
• createdAt - 创建时间
• isActive - 是否活跃

小组成员表 (study_group_members)

• id - 成员记录ID（自增）
• groupId - 小组ID
• userId - 用户ID
• joinedAt - 加入时间
• role - 角色（leader/member）

开发

构建项目

npm run build

开发模式

npm run dev

许可证

MIT License

作者

aynuzbh

问题反馈

如果在使用过程中遇到任何问题，请通过以下方式联系：

• GitHub Issues

更新日志

v1.0.0

• 初始版本发布
• 实现基本的小组管理功能
• 支持创建、加入、查看、搜索等操作