nonebot-plugin-group-market 0.3.0__tar.gz

nonebot_plugin_group_market-0.3.0/LICENSE

@@ -0,0 +1,43 @@
+木兰宽松许可证，第2版
+
+木兰宽松许可证，第2版
+
+2025 https://github.com/TonyLiangP2010405/nonebot-plugin-slave-market
+
+您对“软件”的复制、使用、修改及分发受木兰宽松许可证，第2版（“本许可证”）的如下条款的约束：
+
+0. 定义
+
+“软件”是指由“贡献”构成的许可在“本许可证”下的程序和相关文档的集合。
+
+“贡献”是指由任一“贡献者”许可在“本许可证”下的受版权法保护的作品。
+
+“贡献者”是指将受版权法保护的作品许可在“本许可证”下的自然人或“法人实体”。
+
+“法人实体”是指提交贡献的机构以及由该机构控制、受该机构控制或与之共同控制的机构，此定义中的“控制”是指：(i) 通过合同或其他方式，直接或间接地指导或管理该实体的权力，或 (ii) 拥有该实体百分之五十（50%）或以上已发行股份的权力，或 (iii) 拥有该实体的实益所有权。
+
+“对应源代码”是指生成、安装和（对于可执行作品）运行目标代码的所有源代码，包括修改该软件所需的脚本，但不包括该软件作为单独作品分发的任何源代码或库、该软件作为编译环境的一部分使用的任何源代码或库，或该软件使用的操作系统或虚拟机。
+
+1. 授予版权许可
+
+每个贡献者根据本许可证的条款，授予您永久性的、全球性的、免费的、非独占的、不可撤销的版权许可，以复制、使用、修改、分发其贡献，无论是修改或未修改的，无论是源代码形式还是目标代码形式。
+
+2. 授予专利许可
+
+每个贡献者根据本许可证的条款，授予您永久性的、全球性的、免费的、非独占的、不可撤销的（根据本条规定撤销除外）专利许可，以制作、让其制作、使用、销售、许诺销售、进口和以其他方式转移其贡献，该许可仅适用于该贡献者可授权的那些专利权利要求，且仅因该贡献者单独或联合其贡献而导致该贡献者或其贡献被许可的软件被指控侵权。如果您对任何实体提起专利诉讼（包括诉讼中的交叉索赔或反诉），主张该软件本身（不包括您可能添加的任何代码）侵犯了专利，则本许可证授予您的与该软件相关的任何专利许可自您提起该诉讼之日起终止。
+
+3. 无商标许可
+
+本许可证不授予您使用任何贡献者的商品名称、商标、服务标记或产品名称的权利，但您在使用该贡献者的贡献时必须遵守适用法律关于归属的要求。
+
+4. 免责声明
+
+在适用法律允许的最大范围内，本软件按“原样”提供，无任何明示或暗示的保证，包括但不限于对适销性、特定用途适用性或不侵权的保证。在任何情况下，任何贡献者或版权持有者均不对因使用本软件而产生的任何索赔、损害或其他责任负责，无论是在合同诉讼、侵权诉讼或其他诉讼中。
+
+5. 分发
+
+您可以在不同的条款下分发本软件的副本，无论是修改还是未修改的，只要您满足本许可证的所有条款。
+
+6. 贡献提交
+
+除非您明确声明，否则您提交给贡献者的任何贡献均视为在本许可证下许可，不附加任何额外条款或条件。但是，如果您向贡献者提交了贡献，且您明确声明了与该贡献相关的许可证，则该许可证适用于您的贡献。

nonebot_plugin_group_market-0.3.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-group-market
+Version: 0.3.0
+Summary: 适用于 QQ 群聊的群友市场经济小游戏，包含打工、购买群友、训练、决斗、银行、排行榜、每日任务、等级、成就、防刷屏等玩法。
+Author: Tony
+License: Mulan PSL v2
+Project-URL: Homepage, https://github.com/TonyLiangP2010405/nonebot-plugin-group-market
+Project-URL: Repository, https://github.com/TonyLiangP2010405/nonebot-plugin-group-market
+Keywords: nonebot,nonebot2,plugin,group-game,market,qq-group
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Mulan Permissive Software License v2 (MulanPSL-2.0)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nonebot2>=2.2.0
+Requires-Dist: nonebot-adapter-onebot>=2.0.0
+Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
+Requires-Dist: nonebot-plugin-localstore>=0.7.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: license-file
+
+<div align="center">
+
+# ✨ 群友市场 ✨
+
+<a href="https://v2.nonebot.dev/store">
+  <img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/NoneBotPlugin.svg" width="300" height="120" alt="NoneBotPluginText">
+</a>
+
+[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-group-market.svg)](https://pypi.python.org/pypi/nonebot-plugin-group-market)
+[![python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
+[![license](https://img.shields.io/badge/license-MulanPSL--2.0-green.svg)](./LICENSE)
+
+</div>
+
+适用于 **QQ 群聊** 的 NoneBot2 群友市场经济小游戏，包含打工、购买群友、训练、决斗、银行、排行榜、每日任务、等级、成就、防刷屏等玩法。
+
+> 从 Yunzai-Bot V3 插件 [Slave-Market](https://gitee.com/Tloml-Starry/Slave-Market) 移植并大幅扩展而来。
+
+---
+
+## 📦 安装
+
+### 使用 nb-cli 安装（推荐）
+
+在 nonebot2 项目的根目录下打开命令行，输入：
+
+```bash
+nb plugin install nonebot-plugin-group-market
+```
+
+### 使用包管理器安装
+
+```bash
+pip install nonebot-plugin-group-market
+```
+
+然后在 `pyproject.toml` 的 `[tool.nonebot]` 部分追加：
+
+```toml
+plugins = ["nonebot_plugin_group_market"]
+```
+
+---
+
+## 🎮 功能
+
+### 核心玩法
+- 💰 **打工** — 赚取金币
+- 🧑‍🌾 **购买群友** — 将群友收为"奴隶"（游戏内称呼，可自定义）
+- ⚔️ **训练** — 提升奴隶身价
+- ⚔️ **决斗** — 奴隶之间决斗
+- 🏆 **排位赛** — 段位系统（青铜→钻石）
+- 🏦 **银行** — 存款/取款/升级/利息/转账
+- 📊 **排行榜** — 金币榜/身价榜
+
+### 扩展玩法 (v0.2.0+)
+- ✅ **签到系统** — 连续签到奖励，7/30天里程碑
+- ⭐ **等级经验** — 50级上限，打工/训练/决斗获经验
+- 🏅 **成就系统** — 20+ 成就可解锁
+- 📋 **每日任务** — 每天3个随机任务
+- 📊 **个人信息面板** — 综合数据一览
+- 🛒 **道具商店** — 6种道具可购买/使用/赠送
+- 📢 **随机事件** — 每天一个群事件影响玩法
+- 👑 **称号系统** — 8个称号，部分带属性加成
+- 🎯 **悬赏系统** — 发布/领取/取消悬赏
+- 🏆 **赛季系统** — 周/月赛季排名与奖励
+
+### 防刷屏保护 (v0.3.0+)
+- ⏳ **多层冷却** — 用户级+群全局冷却
+- 🛡️ **洪水保护** — 60秒内命令过多自动锁定
+- 🔇 **安静模式** — 冷却期间重复触发静默处理
+- 📉 **查询限流** — 排行榜/信息面板等也有冷却
+
+---
+
+## 📝 使用说明
+
+在群聊中发送以下指令（默认以 `#` 为前缀）：
+
+### 经济玩法
+
+| 指令 | 说明 |
+|------|------|
+| `#打工` | 赚取金币（冷却20分钟） |
+| `#购买群友 @用户` | 购买群友（冷却30分钟） |
+| `#我的奴隶` | 查看自己的奴隶 |
+| `#放生奴隶 @用户` | 放生奴隶 |
+| `#训练 @用户` | 训练奴隶（冷却45分钟） |
+| `#决斗 @用户1 @用户2` | 奴隶决斗（冷却30分钟） |
+| `#排位赛` | 查看排位信息 |
+| `#参加排位赛 @用户` | 参加排位（冷却30分钟） |
+
+### 银行系统
+
+| 指令 | 说明 |
+|------|------|
+| `#存款 数量` | 银行存款 |
+| `#取款 数量` | 银行取款 |
+| `#升级信用` | 升级银行等级 |
+| `#银行信息` | 查看银行详情 |
+| `#领取利息` | 领取银行利息 |
+| `#转账 数量 @用户` | 向他人转账 |
+
+### 扩展玩法
+
+| 指令 | 说明 |
+|------|------|
+| `#签到` / `#打卡` | 每日签到 |
+| `#我的等级` | 查看等级经验 |
+| `#我的成就` | 查看成就 |
+| `#每日任务` | 查看今日任务 |
+| `#领取任务奖励` | 领取任务奖励 |
+| `#我的信息` | 个人信息面板 |
+| `#商店` | 道具商店 |
+| `#购买道具 道具名` | 购买道具 |
+| `#今日事件` | 查看今日群事件 |
+| `#我的称号` | 查看称号 |
+| `#悬赏列表` | 查看悬赏 |
+| `#赛季信息` | 赛季信息 |
+| `#赛季排行` | 赛季排名 |
+
+### 管理命令
+
+| 指令 | 权限 | 说明 |
+|------|------|------|
+| `#游戏冷却状态` | 任何人 | 查看当前群防刷屏状态 |
+| `#开启安静模式` | 管理员 | 冷却重复触发静默 |
+| `#关闭安静模式` | 管理员 | 恢复提示 |
+| `#开启防刷屏` | 管理员 | 启用防刷屏 |
+| `#关闭防刷屏` | 管理员 | 禁用防刷屏 |
+
+> 完整命令列表请发送 `#奴隶帮助` 或 `#群友市场帮助` 查看。
+
+---
+
+## ⚙️ 配置
+
+在 `.env` 文件中添加：
+
+```env
+# 打工冷却（秒）
+slavemarket__work__cooldown=1200
+
+# 购买冷却（秒）
+slavemarket__purchase__cooldown=1800
+
+# 银行初始限额
+slavemarket__bank__initialLimit=1000
+
+# 每周重置开关
+slavemarket__weeklyReset__enabled=true
+
+# 防刷屏总开关
+slavemarket__antiSpam__enabled=true
+
+# 安静模式开关
+slavemarket__antiSpam__quietMode__enabled=true
+
+# 洪水保护：统计窗口（秒）
+slavemarket__antiSpam__groupFloodProtection__windowSeconds=60
+
+# 洪水保护：窗口内最大命令数
+slavemarket__antiSpam__groupFloodProtection__maxCommands=20
+
+# 洪水保护：锁定持续时间（秒）
+slavemarket__antiSpam__groupFloodProtection__lockSeconds=300
+```
+
+> 所有配置均有默认值，零配置即可运行。详细配置项见源码 `config.py`。
+
+---
+
+## 📋 更新日志
+
+见 [CHANGELOG.md](./CHANGELOG.md)
+
+---
+
+## 📄 许可证
+
+本项目使用 [木兰宽松许可证，第2版](./LICENSE) 开源。
+
+---
+
+*若从旧版 `nonebot-plugin-slave-market` 迁移，旧数据完全兼容，详见 [PORTING_NOTES.md](./PORTING_NOTES.md)。*

nonebot_plugin_group_market-0.3.0/README.md

@@ -0,0 +1,185 @@
+<div align="center">
+
+# ✨ 群友市场 ✨
+
+<a href="https://v2.nonebot.dev/store">
+  <img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/NoneBotPlugin.svg" width="300" height="120" alt="NoneBotPluginText">
+</a>
+
+[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-group-market.svg)](https://pypi.python.org/pypi/nonebot-plugin-group-market)
+[![python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
+[![license](https://img.shields.io/badge/license-MulanPSL--2.0-green.svg)](./LICENSE)
+
+</div>
+
+适用于 **QQ 群聊** 的 NoneBot2 群友市场经济小游戏，包含打工、购买群友、训练、决斗、银行、排行榜、每日任务、等级、成就、防刷屏等玩法。
+
+> 从 Yunzai-Bot V3 插件 [Slave-Market](https://gitee.com/Tloml-Starry/Slave-Market) 移植并大幅扩展而来。
+
+---
+
+## 📦 安装
+
+### 使用 nb-cli 安装（推荐）
+
+在 nonebot2 项目的根目录下打开命令行，输入：
+
+```bash
+nb plugin install nonebot-plugin-group-market
+```
+
+### 使用包管理器安装
+
+```bash
+pip install nonebot-plugin-group-market
+```
+
+然后在 `pyproject.toml` 的 `[tool.nonebot]` 部分追加：
+
+```toml
+plugins = ["nonebot_plugin_group_market"]
+```
+
+---
+
+## 🎮 功能
+
+### 核心玩法
+- 💰 **打工** — 赚取金币
+- 🧑‍🌾 **购买群友** — 将群友收为"奴隶"（游戏内称呼，可自定义）
+- ⚔️ **训练** — 提升奴隶身价
+- ⚔️ **决斗** — 奴隶之间决斗
+- 🏆 **排位赛** — 段位系统（青铜→钻石）
+- 🏦 **银行** — 存款/取款/升级/利息/转账
+- 📊 **排行榜** — 金币榜/身价榜
+
+### 扩展玩法 (v0.2.0+)
+- ✅ **签到系统** — 连续签到奖励，7/30天里程碑
+- ⭐ **等级经验** — 50级上限，打工/训练/决斗获经验
+- 🏅 **成就系统** — 20+ 成就可解锁
+- 📋 **每日任务** — 每天3个随机任务
+- 📊 **个人信息面板** — 综合数据一览
+- 🛒 **道具商店** — 6种道具可购买/使用/赠送
+- 📢 **随机事件** — 每天一个群事件影响玩法
+- 👑 **称号系统** — 8个称号，部分带属性加成
+- 🎯 **悬赏系统** — 发布/领取/取消悬赏
+- 🏆 **赛季系统** — 周/月赛季排名与奖励
+
+### 防刷屏保护 (v0.3.0+)
+- ⏳ **多层冷却** — 用户级+群全局冷却
+- 🛡️ **洪水保护** — 60秒内命令过多自动锁定
+- 🔇 **安静模式** — 冷却期间重复触发静默处理
+- 📉 **查询限流** — 排行榜/信息面板等也有冷却
+
+---
+
+## 📝 使用说明
+
+在群聊中发送以下指令（默认以 `#` 为前缀）：
+
+### 经济玩法
+
+| 指令 | 说明 |
+|------|------|
+| `#打工` | 赚取金币（冷却20分钟） |
+| `#购买群友 @用户` | 购买群友（冷却30分钟） |
+| `#我的奴隶` | 查看自己的奴隶 |
+| `#放生奴隶 @用户` | 放生奴隶 |
+| `#训练 @用户` | 训练奴隶（冷却45分钟） |
+| `#决斗 @用户1 @用户2` | 奴隶决斗（冷却30分钟） |
+| `#排位赛` | 查看排位信息 |
+| `#参加排位赛 @用户` | 参加排位（冷却30分钟） |
+
+### 银行系统
+
+| 指令 | 说明 |
+|------|------|
+| `#存款 数量` | 银行存款 |
+| `#取款 数量` | 银行取款 |
+| `#升级信用` | 升级银行等级 |
+| `#银行信息` | 查看银行详情 |
+| `#领取利息` | 领取银行利息 |
+| `#转账 数量 @用户` | 向他人转账 |
+
+### 扩展玩法
+
+| 指令 | 说明 |
+|------|------|
+| `#签到` / `#打卡` | 每日签到 |
+| `#我的等级` | 查看等级经验 |
+| `#我的成就` | 查看成就 |
+| `#每日任务` | 查看今日任务 |
+| `#领取任务奖励` | 领取任务奖励 |
+| `#我的信息` | 个人信息面板 |
+| `#商店` | 道具商店 |
+| `#购买道具 道具名` | 购买道具 |
+| `#今日事件` | 查看今日群事件 |
+| `#我的称号` | 查看称号 |
+| `#悬赏列表` | 查看悬赏 |
+| `#赛季信息` | 赛季信息 |
+| `#赛季排行` | 赛季排名 |
+
+### 管理命令
+
+| 指令 | 权限 | 说明 |
+|------|------|------|
+| `#游戏冷却状态` | 任何人 | 查看当前群防刷屏状态 |
+| `#开启安静模式` | 管理员 | 冷却重复触发静默 |
+| `#关闭安静模式` | 管理员 | 恢复提示 |
+| `#开启防刷屏` | 管理员 | 启用防刷屏 |
+| `#关闭防刷屏` | 管理员 | 禁用防刷屏 |
+
+> 完整命令列表请发送 `#奴隶帮助` 或 `#群友市场帮助` 查看。
+
+---
+
+## ⚙️ 配置
+
+在 `.env` 文件中添加：
+
+```env
+# 打工冷却（秒）
+slavemarket__work__cooldown=1200
+
+# 购买冷却（秒）
+slavemarket__purchase__cooldown=1800
+
+# 银行初始限额
+slavemarket__bank__initialLimit=1000
+
+# 每周重置开关
+slavemarket__weeklyReset__enabled=true
+
+# 防刷屏总开关
+slavemarket__antiSpam__enabled=true
+
+# 安静模式开关
+slavemarket__antiSpam__quietMode__enabled=true
+
+# 洪水保护：统计窗口（秒）
+slavemarket__antiSpam__groupFloodProtection__windowSeconds=60
+
+# 洪水保护：窗口内最大命令数
+slavemarket__antiSpam__groupFloodProtection__maxCommands=20
+
+# 洪水保护：锁定持续时间（秒）
+slavemarket__antiSpam__groupFloodProtection__lockSeconds=300
+```
+
+> 所有配置均有默认值，零配置即可运行。详细配置项见源码 `config.py`。
+
+---
+
+## 📋 更新日志
+
+见 [CHANGELOG.md](./CHANGELOG.md)
+
+---
+
+## 📄 许可证
+
+本项目使用 [木兰宽松许可证，第2版](./LICENSE) 开源。
+
+---
+
+*若从旧版 `nonebot-plugin-slave-market` 迁移，旧数据完全兼容，详见 [PORTING_NOTES.md](./PORTING_NOTES.md)。*

nonebot_plugin_group_market-0.3.0/nonebot_plugin_group_market/__init__.py

@@ -0,0 +1,43 @@
+"""
+NoneBot2 群友市场插件
+License: Mulan PSL v2
+"""
+from nonebot import require, logger, get_driver
+from nonebot.plugin import PluginMetadata
+
+require("nonebot_plugin_apscheduler")
+
+from .config import plugin_config, Config
+from .storage import init_storage
+from .weekly_reset_task import start_weekly_reset_scheduler
+
+__plugin_meta__ = PluginMetadata(
+    name="群友市场",
+    description="适用于 QQ 群聊的群友市场经济小游戏，包含打工、购买群友、训练、决斗、银行、排行榜、每日任务、等级、成就、防刷屏等玩法。",
+    usage=(
+        "发送 #群友市场帮助 或 #奴隶帮助 查看完整玩法说明。\n"
+        "核心命令: #打工 #购买群友 #训练 #决斗 #排位赛 #银行 #签到 #每日任务 #商店"
+    ),
+    type="application",
+    homepage="https://github.com/TonyLiangP2010405/nonebot-plugin-group-market",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+# 导入扩展配置（确保先加载）
+from . import extension
+
+# 导入所有指令模块（触发注册）
+from . import commands
+
+driver = get_driver()
+
+@driver.on_bot_connect
+async def on_bot_connect():
+    logger.info("[GroupMarket] 群友市场插件加载中...")
+    await init_storage()
+    # 确保扩展群数据目录存在
+    from .extension.group_storage import _ensure_dir
+    _ensure_dir()
+    start_weekly_reset_scheduler()
+    logger.info("[GroupMarket] 插件已就绪！")

nonebot_plugin_group_market-0.3.0/nonebot_plugin_group_market/commands.py

@@ -0,0 +1,39 @@
+"""指令入口 - 导入所有子模块触发注册"""
+from nonebot import on_command, logger
+from nonebot.adapters.onebot.v11 import Bot, Message, MessageEvent, GroupMessageEvent, MessageSegment
+from nonebot.params import CommandArg
+from nonebot.permission import SUPERUSER
+
+# 基础帮助
+from .commands_help import help_cmd
+from .commands_work import work_cmd
+from .commands_purchase import purchase_cmd
+from .commands_slave import myslave_cmd, release_cmd
+from .commands_buyback import buyback_cmd
+from .commands_rob import rob_cmd
+from .commands_train import train_cmd
+from .commands_arena import arena_cmd
+from .commands_ranking import ranking_info_cmd, ranking_join_cmd
+from .commands_bank import deposit_cmd, withdraw_cmd, upgrade_cmd, bank_info_cmd, interest_cmd, transfer_cmd
+from .commands_rankings import rankings_cmd
+from .commands_weekly import reset_status_cmd, manual_reset_cmd, reset_help_cmd, last_week_cmd
+from .commands_update import update_cmd
+from .exit_handler import exit_notice
+
+# 扩展玩法模块
+from .commands_signin import signin_cmd, signin_rank_cmd
+from .commands_level import level_cmd, level_rank_cmd
+from .commands_achievement import achievement_cmd, achievement_rank_cmd
+from .commands_dailytask import daily_task_cmd, claim_task_reward_cmd, refresh_task_cmd
+from .commands_profile import profile_cmd, view_profile_cmd
+from .commands_shop import shop_cmd, buy_item_cmd, my_items_cmd, use_item_cmd, gift_item_cmd
+from .commands_randomevent import today_event_cmd
+from .commands_title import title_cmd, equip_title_cmd
+from .commands_bounty import bounty_post_cmd, bounty_list_cmd, bounty_claim_cmd, bounty_cancel_cmd
+from .commands_season import season_info_cmd, season_rank_cmd, season_reward_cmd, season_history_cmd
+from .commands_admin import (
+    admin_cooldown_status, admin_enable_quiet, admin_disable_quiet,
+    admin_enable_spam, admin_disable_spam, admin_set_work_cd, admin_set_group_cd
+)
+
+logger.info("[SlaveMarket] 指令模块已注册")

nonebot_plugin_group_market-0.3.0/nonebot_plugin_group_market/commands_achievement.py

@@ -0,0 +1,137 @@
+"""成就系统"""
+from nonebot import on_command
+from nonebot.adapters.onebot.v11 import Bot, GroupMessageEvent
+
+from .storage import ensure_player, load_player, save_player, list_group_players
+from .utils import get_member_nickname
+from .extension.config import ext_config
+from .extension.utils import check_achievement_unlock, apply_achievement_rewards
+from .extension.anti_spam import check_cooldown
+
+achievement_cmd = on_command("我的成就", aliases={"成就", "成就列表"}, priority=5, block=True)
+achievement_rank_cmd = on_command("成就排行", priority=5, block=True)
+
+# 成就定义
+ACHIEVEMENTS_DEF = {
+    "first_work": {"name": "初次打工", "desc": "第一次打工", "check": lambda d: d.get("workCount", 0) >= 1},
+    "work_10": {"name": "勤劳小蜜蜂", "desc": "累计打工10次", "check": lambda d: d.get("workCount", 0) >= 10},
+    "work_50": {"name": "打工皇帝", "desc": "累计打工50次", "check": lambda d: d.get("workCount", 0) >= 50},
+    "work_100": {"name": "永动机", "desc": "累计打工100次", "check": lambda d: d.get("workCount", 0) >= 100},
+    "first_purchase": {"name": "初次购买", "desc": "第一次购买群友", "check": lambda d: d.get("purchaseCount", 0) >= 1},
+    "purchase_10": {"name": "收藏家", "desc": "累计购买10次", "check": lambda d: d.get("purchaseCount", 0) >= 10},
+    "first_master": {"name": "成为主人", "desc": "第一次拥有奴隶", "check": lambda d: len(d.get("slave", [])) >= 1},
+    "first_bought": {"name": "被买下", "desc": "第一次被购买", "check": lambda d: bool(d.get("master", ""))},
+    "train_10": {"name": "训练大师", "desc": "累计训练成功10次", "check": lambda d: d.get("trainSuccessCount", 0) >= 10},
+    "arena_win_10": {"name": "决斗王者", "desc": "累计决斗胜利10次", "check": lambda d: d.get("duelStats", {}).get("wins", 0) >= 10},
+    "bank_10000": {"name": "理财达人", "desc": "银行存款达到10000", "check": lambda d: d.get("bank", {}).get("balance", 0) >= 10000},
+    "value_1000": {"name": "身价过千", "desc": "身价达到1000", "check": lambda d: d.get("value", 100) >= 1000},
+    "value_5000": {"name": "身价过万", "desc": "身价达到5000", "check": lambda d: d.get("value", 100) >= 5000},
+    "signin_7": {"name": "早起鸟儿", "desc": "连续签到7天", "check": lambda d: d.get("continuousSignInDays", 0) >= 7},
+    "signin_30": {"name": "持之以恒", "desc": "连续签到30天", "check": lambda d: d.get("continuousSignInDays", 0) >= 30},
+    "level_10": {"name": "初露锋芒", "desc": "等级达到10级", "check": lambda d: d.get("level", 1) >= 10},
+    "level_20": {"name": "一代宗师", "desc": "等级达到20级", "check": lambda d: d.get("level", 1) >= 20},
+    "level_50": {"name": "传说", "desc": "等级达到50级", "check": lambda d: d.get("level", 1) >= 50},
+    "slave_5": {"name": "奴隶收藏家", "desc": "同时拥有5名奴隶", "check": lambda d: len(d.get("slave", [])) >= 5},
+    "task_50": {"name": "任务达人", "desc": "累计完成50个每日任务", "check": lambda d: d.get("totalTasksCompleted", 0) >= 50},
+}
+
+
+def check_all_achievements(data: dict) -> list:
+    """检查所有成就，返回新解锁的成就ID列表"""
+    newly = []
+    for ach_id, ach_def in ACHIEVEMENTS_DEF.items():
+        if check_achievement_unlock(data, ach_id, ach_def["check"]):
+            newly.append(ach_id)
+    return newly
+
+
+@achievement_cmd.handle()
+async def _(bot: Bot, event: GroupMessageEvent):
+    if not isinstance(event, GroupMessageEvent):
+        await achievement_cmd.finish("该指令仅群聊可用")
+
+    allowed, msg = check_cooldown(event, "achievement")
+    if not allowed:
+        if msg:
+            await achievement_cmd.finish(msg)
+        return
+
+    if not ext_config.achievement.enabled:
+        await achievement_cmd.finish("成就系统已关闭")
+
+    group_id = event.group_id
+    user_id = event.user_id
+    nickname = await get_member_nickname(bot, group_id, user_id)
+    data = await ensure_player(group_id, user_id, nickname)
+
+    # 检查新成就
+    newly = check_all_achievements(data)
+    if newly:
+        apply_achievement_rewards(data)
+        await save_player(group_id, user_id, data)
+
+    achieved = set(data.get("achievements", []))
+
+    lines = [f"🏅 {nickname} 的成就"]
+    if newly:
+        lines.append(f"🎉 新解锁 {len(newly)} 个成就！")
+
+    unlocked = []
+    locked = []
+    for ach_id, ach_def in ACHIEVEMENTS_DEF.items():
+        status = "✅" if ach_id in achieved else "❌"
+        line = f"{status} {ach_def['name']} - {ach_def['desc']}"
+        if ach_id in achieved:
+            unlocked.append(line)
+        else:
+            locked.append(line)
+
+    lines.append(f"\n已解锁 ({len(unlocked)}/{len(ACHIEVEMENTS_DEF)}):")
+    lines.extend(unlocked[:10])
+    if len(unlocked) > 10:
+        lines.append(f"... 还有 {len(unlocked) - 10} 个")
+
+    if locked:
+        lines.append(f"\n未解锁:")
+        lines.extend(locked[:5])
+
+    await achievement_cmd.finish("\n".join(lines))
+
+
+@achievement_rank_cmd.handle()
+async def _(bot: Bot, event: GroupMessageEvent):
+    if not isinstance(event, GroupMessageEvent):
+        await achievement_rank_cmd.finish("该指令仅群聊可用")
+
+    allowed, msg = check_cooldown(event, "achievement_rank")
+    if not allowed:
+        if msg:
+            await achievement_rank_cmd.finish(msg)
+        return
+
+    if not ext_config.achievement.enabled:
+        await achievement_rank_cmd.finish("成就系统已关闭")
+
+    group_id = event.group_id
+    players = await list_group_players(group_id)
+
+    items = []
+    for pid in players:
+        pdata = await load_player(group_id, pid)
+        if pdata:
+            count = len(pdata.get("achievements", []))
+            items.append({
+                "name": await get_member_nickname(bot, group_id, pid),
+                "count": count,
+            })
+
+    if not items:
+        await achievement_rank_cmd.finish("暂无成就数据")
+
+    items.sort(key=lambda x: x["count"], reverse=True)
+
+    lines = ["🏅 成就排行榜"]
+    for i, item in enumerate(items[:15], 1):
+        lines.append(f"{i}. {item['name']} - {item['count']} 个成就")
+
+    await achievement_rank_cmd.finish("\n".join(lines))