koishi-plugin-active-tasks

Koishi 活跃任务插件 一个功能丰富的 Koishi 插件，为群成员提供每日任务、积分系统和商店兑换功能。

功能特色 🎯 任务系统 多种任务类型：诗词接龙、数学计算、知识问答、词语接龙、自定义任务等

每日刷新：每天随机生成新的任务

智能验证：支持答案验证、尝试次数限制、冷却时间

难度分级：简单、中等、困难三个难度级别

自定义配置：完全可配置的任务库和参数

💰 积分系统 任务奖励：完成任务获得积分

每日签到：连续签到获得额外奖励

积分上限：可配置的每日积分上限

排行榜：查看积分排名

🛒 商店系统 物品兑换：使用积分兑换各种物品

库存管理：有限库存和无限库存支持

限购功能：每人限购数量控制

购买记录：完整的交易历史记录

📊 数据持久化 用户数据：积分、任务完成情况、购买历史

签到记录：连续签到天数和总签到次数

物品库存：用户个人物品栏

每日任务：每天的任务状态和尝试记录

安装 在 Koishi 市场安装 bash

在 Koishi 控制台搜索 "active-tasks" 并安装

手动安装 bash npm install koishi-plugin-active-tasks 配置 在 koishi.yml 或 Koishi 控制台中配置插件：

yaml plugins: active-tasks: # 基础设置 dailyTaskCount: 5 maxPointsPerDay: 200 enableSignIn: true signInReward: 10 consecutiveBonus: [5, 10, 15, 20, 30] enableLeaderboard: true leaderboardSize: 10 taskCooldown: 5

# 任务配置
tasks:
  - id: 'poetry_1'
    name: '诗词接龙'
    description: '接下一句诗'
    type: 'poetry'
    difficulty: 'medium'
    reward: 15
    enabled: true
    
  - id: 'math_1'
    name: '数学题'
    description: '简单的数学计算'
    type: 'math'
    difficulty: 'easy'
    reward: 10
    enabled: true
    
  - id: 'custom_1'
    name: '脑筋急转弯'
    description: '什么车寸步难行？'
    type: 'custom'
    difficulty: 'hard'
    reward: 20
    answer: '风车'
    hint: '不是真正的交通工具'
    enabled: true

# 商店物品
shopItems:
  - id: 'badge_1'
    name: '初级徽章'
    description: '新手荣誉徽章'
    cost: 50
    stock: -1
    maxPerUser: 1
    enabled: true
    effect: '身份象征'
    
  - id: 'double_1'
    name: '双倍积分卡'
    description: '下次任务双倍积分'
    cost: 80
    stock: 50
    maxPerUser: 5
    enabled: true
    effect: '一次性使用'

# 诗词数据库
poetryDatabase:
  "床前明月光，疑是地上霜。": "举头望明月，低头思故乡。"
  "春眠不觉晓，处处闻啼鸟。": "夜来风雨声，花落知多少。"

# 知识问答库
triviaQuestions:
  - question: "中国的首都是？"
    answer: "北京"
  - question: "太阳从哪边升起？"
    answer: "东边"

# 词语接龙词库
wordTasks:
  - "苹果"
  - "香蕉"
  - "电脑"
  - "手机"

使用方法 基础命令 命令 别名 说明 任务 tasks 查看今日任务和积分 完成任务 <编号> <答案> complete 完成任务 我的积分 points 查看当前积分 积分商店 shop 查看商店物品 兑换 <编号> exchange 兑换物品 我的物品 inventory 查看已拥有的物品 签到 signin 每日签到获取积分 排行榜 leaderboard 查看积分排行榜 任务帮助 taskhelp 查看详细帮助 使用示例 查看今日任务

text

任务 📊 当前积分：150（总计：520）

📋 今日任务：

• 诗词接龙 - 请接下一句诗："床前明月光，疑是地上霜。" 奖励: 15积分 (0/3次尝试) [❌ 未完成]
• 数学题 - 计算：25 + 38 = ? 奖励: 10积分 (0/3次尝试) [❌ 未完成] 完成任务

text

完成任务 1 举头望明月，低头思故乡。 🎉 任务完成！获得 15 积分 兑换物品

text

积分商店 🛒 积分商店：

• 初级徽章 - 新手荣誉徽章 [身份象征] 价格: 50积分 [库存: 无限]

兑换 1 🎉 成功兑换 初级徽章！消耗 50 积分，剩余积分：100 每日签到

text

签到 ✅ 签到成功！获得 15 积分 📅 已连续签到 5 天 🎁 连续签到奖励 +10 积分 任务类型说明

• 诗词接龙 随机显示一句古诗的上半句

用户需要接出下半句

支持自定义诗词库

• 数学计算 随机生成数学计算题

支持加减乘除运算

自动验证计算结果

• 知识问答 常识性问题问答

支持自定义问题库

自动答案验证

• 词语接龙 给出词语的最后一个字

用户需要说出以该字开头的词语

支持自定义词库

• 自定义任务 完全自定义的任务内容

支持预设答案和提示

灵活的验证机制

高级配置 任务配置选项 yaml tasks:

• id: 'unique_id' # 唯一标识 name: '任务名称' # 显示名称 description: '任务描述' # 详细描述 type: 'poetry' # 任务类型 difficulty: 'medium' # 难度级别 reward: 15 # 奖励积分 answer: '答案' # 正确答案（可选） options: [] # 选项列表（可选） hint: '提示信息' # 提示信息（可选） cooldown: 5 # 冷却时间（分钟，可选） maxAttempts: 3 # 最大尝试次数（可选） enabled: true # 是否启用 商店物品配置 yaml shopItems:
• id: 'unique_id' # 唯一标识 name: '物品名称' # 显示名称 description: '物品描述' # 详细描述 cost: 50 # 兑换所需积分 stock: -1 # 库存（-1表示无限） maxPerUser: 1 # 每人限购数量（-1表示无限） enabled: true # 是否启用 effect: '效果描述' # 物品效果说明（可选） 数据管理 插件会自动创建以下数据表：

active_tasks_user - 用户积分和任务数据

active_tasks_daily - 每日任务状态

active_tasks_inventory - 用户物品库存

active_tasks_signin - 签到记录

所有数据都支持持久化存储，确保服务器重启后数据不丢失。

开发说明 构建插件 bash npm run build 开发模式 bash npm run dev 项目结构 text koishi-plugin-active-tasks/ ├── index.ts # 主插件文件 ├── package.json # 项目配置 ├── tsconfig.json # TypeScript配置 └── lib/ # 编译输出目录 常见问题 Q: 任务没有正确验证答案？ A: 检查任务配置中的 answer 字段，确保答案格式正确。支持多个正确答案，可以用数组格式。

Q: 用户积分异常？ A: 检查每日积分上限配置，确保没有超过限制。可以查看用户数据表进行调试。

Q: 商店物品库存不更新？ A: 确保物品配置中的 stock 字段设置正确，-1 表示无限库存，大于0表示有限库存。

Q: 如何重置用户数据？ A: 可以通过数据库操作工具直接修改对应的数据表，或者等待每日自动刷新。

更新日志 v1.0.0 ✅ 基础任务系统

✅ 积分商店

✅ 每日签到

✅ 排行榜功能

✅ 数据持久化

技术支持 如果遇到问题或有功能建议，请通过以下方式联系：

在 GitHub 仓库提交 Issue

在 Koishi 官方社区发帖

联系插件作者

许可证 MIT License

享受使用 Koishi 活跃任务插件！🎉