尧图网站建设 
游戏公会招募时经常能看到类似“50级以上就行等级接近的我会带”这样的公告。门槛设得不高、老玩家愿意带新人确实是公会快速拉活的好办法。但真正负责登记的管理员往往最头疼今天刚记录一个 48 级的新人明天对方升到 52 级又要改表过几天还要统计多少人达到了主力团门槛、谁该进培养名单。如果全靠 Excel 手工维护数据一多就会乱。这篇文章就从公会管理的真实场景出发用 Python SQLite 从零搭建一个“游戏公会成员等级管理系统”把成员录入、等级筛选、升级追踪和数据统计这几件事自动化。不需要安装额外的数据库服务代码开箱即用适合后端入门、Python 练手也适合真的拿去做公会管理工具。1. 背景与需求分析1.1 游戏公会管理的核心痛点很多游戏公会在早期都是靠“群公告 在线表格”来管理成员的。成员少的时候问题不大人一旦超过几十个麻烦就接踵而至信息分散成员的等级、职业、入会时间散落在多个表格和聊天记录里想查一个数据要翻半天。门槛筛选靠人工公会制定“50 级可进主力团”的规则后每次招募都要人工核对所有申请者的等级效率低还容易漏。升级记录不完整成员今天 48 级、明天 55 级管理员往往靠群消息里的截图追踪时间一长根本对不上。缺少整体视角公会到底有多少活跃成员、等级分布如何、哪些人已经连续很久没升级这些问题缺少数据支撑管理决策只能靠感觉。这些问题本质上都是“数据管理”问题。游戏内的公会面板通常只提供简单的在线成员列表无法灵活支持自定义等级门槛、升级历史追踪和统计报表。所以一个面向公会管理场景的轻量级工具就有了落地空间。1.2 “50 级以上就行”背后的业务逻辑“50 级以上就行”这句话看似简单背后其实是公会的分层管理思路等级门槛用来快速过滤活跃度和基础实力防止公会被大量低等级小号占满。等级接近的我会带这是一种“带练”运营策略说明公会管理层愿意投入精力培养潜力玩家而不是只招满级号。持续追踪培养一个人不能只靠口头承诺管理员需要记录每个人入会时的等级、每次升级的时间和当前段位才能判断培养效果。如果把这些业务规则转换成技术需求就是我们下面要实现的功能成员资料建档、按等级门槛筛选、升级历史记录、等级分布统计。2. 系统设计与技术选型2.1 功能模块划分为了让代码结构清晰、方便后续扩展我把系统拆成下面几个功能模块模块功能说明成员信息管理新增成员、查看成员列表记录昵称、职业、等级、推荐人等招募筛选按等级门槛自动过滤出符合要求的成员升级追踪更新成员等级同时写入升级历史方便回溯成长轨迹数据统计统计公会在册人数和等级分布每个模块对应一个独立的函数入口采用简单的命令行交互菜单。这样既便于新手理解也方便后续改造成 Web 服务或机器人接口。2.2 技术选型技术选型上我选择的是 Python 标准库加 SQLite理由如下Python 3语法简洁几乎所有开发环境都自带学习成本低。SQLitePython 内置 sqlite3 模块即可操作不需要单独安装 MySQL、PostgreSQL 等数据库服务单文件存储非常适合公会这种轻量级数据场景。命令行交互省去前端页面开发把核心逻辑先跑通后续再套 Flask/Django 或对接聊天机器人。选择 SQLite 还有一个好处整个数据库就是一个 .db 文件备份时直接复制文件即可对普通公会管理场景来说足够了。如果以后成员规模大到上万再迁移到 MySQL 也不难因为 SQL 语法大部分是通用的。3. 环境准备与项目结构3.1 环境要求本文示例的代码基于以下环境版本可以根据你的实际环境调整Python 3.6 及以上无需安装第三方依赖只用标准库 sqlite3、datetime操作系统Windows / macOS / Linux 均可可以先用下面命令检查 Python 版本python --version如果 Python 版本过低建议升级到 3.8 以上避免个别语法不兼容。3.2 项目结构为了便于管理建议新建一个名为guild_manager的文件夹项目结构如下guild_manager/ ├── guild_manager.py # 主程序 └── guild_manager.db # SQLite 数据库文件首次运行自动生成主程序只需要一个 Python 文件即可运行数据库文件会在程序启动时自动创建不需要手动建表。4. 数据库设计4.1 成员表 members成员表用于保存公会成员的基础信息。这里需要重点关注的是referrer字段它对应“等级接近的我会带”这个场景——记录是谁把新人带入公会的方便后续追踪带练关系。字段名类型说明idINTEGER 主键自增成员唯一编号nicknameTEXT成员昵称jobTEXT游戏职业levelINTEGER当前等级referrerTEXT推荐人/带练人statusTEXT状态默认 ACTIVEcreated_atTEXT入会时间默认当前时间4.2 升级历史表 level_history升级历史表用于记录每一次等级变化方便查看成员成长轨迹。字段名类型说明idINTEGER 主键自增历史记录编号member_idINTEGER关联 members 表old_levelINTEGER原等级new_levelINTEGER新等级upgraded_atTEXT升级时间默认当前时间设计上把升级历史单独拆成一张表是因为等级会被多次更新如果只覆盖 members 表中的 level 字段就无法追溯“谁在什么时候从多少级升到多少级”。有了历史表统计长期培养效果就方便很多。4.3 初始化脚本初始化脚本负责创建数据表保证程序第一次运行时数据库结构是正确的。def init_db(): conn get_conn() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS members ( id INTEGER PRIMARY KEY AUTOINCREMENT, nickname TEXT NOT NULL, job TEXT DEFAULT , level INTEGER NOT NULL DEFAULT 1, referrer TEXT DEFAULT , status TEXT DEFAULT ACTIVE, created_at TEXT DEFAULT (datetime(now, localtime)) ) ) cursor.execute( CREATE TABLE IF NOT EXISTS level_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, member_id INTEGER NOT NULL, old_level INTEGER, new_level INTEGER, upgraded_at TEXT DEFAULT (datetime(now, localtime)), FOREIGN KEY (member_id) REFERENCES members(id) ) ) conn.commit() conn.close()这里使用了CREATE TABLE IF NOT EXISTS所以即使重复运行程序也不会因为表已存在而报错。5. 核心功能实现5.1 数据库连接与公共方法每个功能函数都需要连接数据库。为了复用代码我单独封装了一个get_conn()方法import sqlite3 DB_NAME guild_manager.db def get_conn(): conn sqlite3.connect(DB_NAME) conn.row_factory sqlite3.Row return conn设置row_factory sqlite3.Row之后查询结果就可以通过字段名访问例如row[nickname]代码可读性会好很多。5.2 添加成员添加成员是管理系统最常用的操作。函数接收昵称、职业、等级和推荐人四个参数插入成功后打印成员 ID方便后续操作。def add_member(nickname, job, level1, referrer): conn get_conn() cursor conn.cursor() cursor.execute( INSERT INTO members (nickname, job, level, referrer) VALUES (?, ?, ?, ?), (nickname, job, level, referrer) ) conn.commit() member_id cursor.lastrowid conn.close() print(f[OK] 成员 {nickname} 已加入公会当前等级 {level}推荐人 {referrer or 无}ID{member_id})这里使用了参数化查询?占位符而不是直接拼接字符串主要原因有两个避免 SQL 注入风险虽然本地工具风险低但好习惯要养成。自动处理字符串中的特殊字符比如昵称里包含单引号时不会产生语法错误。5.3 查看成员列表查看成员列表时默认只显示状态为 ACTIVE 的成员并按等级从高到低排序方便管理员快速了解公会当前的高战力和新人。def list_members(show_allFalse): conn get_conn() cursor conn.cursor() sql SELECT * FROM members if not show_all: sql WHERE status ACTIVE sql ORDER BY level DESC cursor.execute(sql) rows cursor.fetchall() conn.close() if not rows: print(当前没有成员记录。) return print(\n 公会成员列表 ) print(f{ID:5}{昵称:20}{职业:10}{等级:8}{推荐人:15}{状态:10}) print(- * 70) for row in rows: print(f{row[id]:5}{row[nickname]:20}{row[job]:10}{row[level]:8}{row[referrer] or 无:15}{row[status]:10})在输出格式上用:20这样的格式控制符实现左对齐保证数据显示出来是整齐的表格效果。5.4 招募筛选招募筛选对应标题中的“50 级以上就行”场景。函数接收最低等级参数默认值为 50可以筛选出所有达到门槛的活跃成员。def recruit_filter(min_level50): conn get_conn() cursor conn.cursor() cursor.execute( SELECT * FROM members WHERE status ACTIVE AND level ? ORDER BY level DESC, (min_level,) ) rows cursor.fetchall() conn.close() print(f\n 招募筛选结果等级 {min_level} 的成员 ) if not rows: print(暂无人达到门槛。) return for row in rows: print(f- {row[nickname]} | 职业 {row[job] or 未知} | 等级 {row[level]})这个函数的参数是动态传入的所以未来公会把门槛从 50 级调整到 60 级不需要改代码只需要在菜单里重新输入一个数字。5.5 更新成员等级更新等级是最容易出错的环节需要做好两个校验成员 ID 必须存在。新等级必须高于当前等级否则说明数据录入有误。def update_level(member_id, new_level): conn get_conn() cursor conn.cursor() cursor.execute(SELECT * FROM members WHERE id ?, (member_id,)) row cursor.fetchone() if not row: print(f[ERROR] 找不到 ID 为 {member_id} 的成员。) conn.close() return old_level row[level] if new_level old_level: print(f[WARN] 新等级 {new_level} 不高于当前等级 {old_level}未执行更新。) conn.close() return cursor.execute(UPDATE members SET level ? WHERE id ?, (new_level, member_id)) cursor.execute( INSERT INTO level_history (member_id, old_level, new_level) VALUES (?, ?, ?), (member_id, old_level, new_level) ) conn.commit() conn.close() print(f[OK] {row[nickname]} 等级 {old_level} - {new_level}升级成功)这里的关键操作是“双写”先更新成员表里的当前等级再往历史表插入一条升级记录。只有两个操作都成功才提交事务。如果中途失败SQLite 默认会回滚不会出现“等级改了但没留记录”的情况。5.6 等级分布统计统计模块用来生成公会整体的等级分布帮助管理员了解当前人员结构。def level_stats(): conn get_conn() cursor conn.cursor() cursor.execute(SELECT level, COUNT(*) AS cnt FROM members WHERE status ACTIVE GROUP BY level ORDER BY level) rows cursor.fetchall() conn.close() print(\n 公会等级分布 ) total 0 for row in rows: total row[cnt] print(f等级 {row[level]}: {row[cnt]} 人) print(f公会在册人数: {total} 人)5.7 升级历史查询升级历史查询用来查看最近谁升了级方便管理员在群里点名鼓励或者掌握带练效果。def show_level_history(): conn get_conn() cursor conn.cursor() cursor.execute( SELECT h.id, m.nickname, h.old_level, h.new_level, h.upgraded_at FROM level_history h JOIN members m ON h.member_id m.id ORDER BY h.upgraded_at DESC LIMIT 20 ) rows cursor.fetchall() conn.close() print(\n 最近升级记录 ) if not rows: print(暂无升级记录。) return for row in rows: print(f{row[nickname]}: {row[old_level]} 级 - {row[new_level]} 级{row[upgraded_at]})这里使用JOIN把两张表关联起来查出昵称和升级信息比单独查历史表更直观。6. 完整代码与运行演示6.1 完整源码把上面的所有功能整合到一个文件里加上菜单交互逻辑就是完整的公会成员等级管理系统。直接复制以下代码保存为guild_manager.py即可运行import sqlite3 DB_NAME guild_manager.db def get_conn(): conn sqlite3.connect(DB_NAME) conn.row_factory sqlite3.Row return conn def init_db(): conn get_conn() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS members ( id INTEGER PRIMARY KEY AUTOINCREMENT, nickname TEXT NOT NULL, job TEXT DEFAULT , level INTEGER NOT NULL DEFAULT 1, referrer TEXT DEFAULT , status TEXT DEFAULT ACTIVE, created_at TEXT DEFAULT (datetime(now, localtime)) ) ) cursor.execute( CREATE TABLE IF NOT EXISTS level_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, member_id INTEGER NOT NULL, old_level INTEGER, new_level INTEGER, upgraded_at TEXT DEFAULT (datetime(now, localtime)), FOREIGN KEY (member_id) REFERENCES members(id) ) ) conn.commit() conn.close() def add_member(nickname, job, level1, referrer): conn get_conn() cursor conn.cursor() cursor.execute( INSERT INTO members (nickname, job, level, referrer) VALUES (?, ?, ?, ?), (nickname, job, level, referrer) ) conn.commit() member_id cursor.lastrowid conn.close() print(f[OK] 成员 {nickname} 已加入公会当前等级 {level}推荐人 {referrer or 无}ID{member_id}) def list_members(show_allFalse): conn get_conn() cursor conn.cursor() sql SELECT * FROM members if not show_all: sql WHERE status ACTIVE sql ORDER BY level DESC cursor.execute(sql) rows cursor.fetchall() conn.close() if not rows: print(当前没有成员记录。) return print(\n 公会成员列表 ) print(f{ID:5}{昵称:20}{职业:10}{等级:8}{推荐人:15}{状态:10}) print(- * 70) for row in rows: print(f{row[id]:5}{row[nickname]:20}{row[job]:10}{row[level]:8}{row[referrer] or 无:15}{row[status]:10}) def recruit_filter(min_level50): conn get_conn() cursor conn.cursor() cursor.execute( SELECT * FROM members WHERE status ACTIVE AND level ? ORDER BY level DESC, (min_level,) ) rows cursor.fetchall() conn.close() print(f\n 招募筛选结果等级 {min_level} 的成员 ) if not rows: print(暂无人达到门槛。) return for row in rows: print(f- {row[nickname]} | 职业 {row[job] or 未知} | 等级 {row[level]}) def update_level(member_id, new_level): conn get_conn() cursor conn.cursor() cursor.execute(SELECT * FROM members WHERE id ?, (member_id,)) row cursor.fetchone() if not row: print(f[ERROR] 找不到 ID 为 {member_id} 的成员。) conn.close() return old_level row[level] if new_level old_level: print(f[WARN] 新等级 {new_level} 不高于当前等级 {old_level}未执行更新。) conn.close() return cursor.execute(UPDATE members SET level ? WHERE id ?, (new_level, member_id)) cursor.execute( INSERT INTO level_history (member_id, old_level, new_level) VALUES (?, ?, ?), (member_id, old_level, new_level) ) conn.commit() conn.close() print(f[OK] {row[nickname]} 等级 {old_level} - {new_level}升级成功) def level_stats(): conn get_conn() cursor conn.cursor() cursor.execute(SELECT level, COUNT(*) AS cnt FROM members WHERE status ACTIVE GROUP BY level ORDER BY level) rows cursor.fetchall() conn.close() print(\n 公会等级分布 ) total 0 for row in rows: total row[cnt] print(f等级 {row[level]}: {row[cnt]} 人) print(f公会在册人数: {total} 人) def show_level_history(): conn get_conn() cursor conn.cursor() cursor.execute( SELECT h.id, m.nickname, h.old_level, h.new_level, h.upgraded_at FROM level_history h JOIN members m ON h.member_id m.id ORDER BY h.upgraded_at DESC LIMIT 20 ) rows cursor.fetchall() conn.close() print(\n 最近升级记录 ) if not rows: print(暂无升级记录。) return for row in rows: print(f{row[nickname]}: {row[old_level]} 级 - {row[new_level]} 级{row[upgraded_at]}) def show_menu(): print(\n 公会成员管理系统 ) print(1. 添加成员) print(2. 查看成员列表) print(3. 招募筛选等级门槛) print(4. 更新成员等级) print(5. 等级分布统计) print(6. 查看升级记录) print(7. 退出系统) print() def main(): init_db() while True: show_menu() choice input(请输入操作编号: ).strip() if choice 1: nickname input(成员昵称: ).strip() job input(职业: ).strip() level int(input(当前等级: ).strip()) referrer input(推荐人可留空: ).strip() add_member(nickname, job, level, referrer) elif choice 2: list_members() elif choice 3: min_level int(input(请输入等级门槛默认50: ).strip() or 50) recruit_filter(min_level) elif choice 4: member_id int(input(成员ID: ).strip()) new_level int(input(新等级: ).strip()) update_level(member_id, new_level) elif choice 5: level_stats() elif choice 6: show_level_history() elif choice 7: print(已退出系统。) break else: print(无效的操作编号请重新输入。) if __name__ __main__: main()6.2 运行演示在命令行进入guild_manager.py所在目录执行python guild_manager.py程序启动后会显示菜单。假设我们要录入一个 48 级的新人选择 1依次输入昵称、职业、等级、推荐人 公会成员管理系统 1. 添加成员 2. 查看成员列表 3. 招募筛选等级门槛 4. 更新成员等级 5. 等级分布统计 6. 查看升级记录 7. 退出系统 请输入操作编号: 1 成员昵称: 阿伟 职业: 战士 当前等级: 48 推荐人可留空: 会长 [OK] 成员 阿伟 已加入公会当前等级 48推荐人 会长ID1过几天阿伟升到了 53 级管理员选择 4 操作请输入操作编号: 4 成员ID: 1 新等级: 53 [OK] 阿伟 等级 48 - 53升级成功此时执行招募筛选输入门槛 50系统就会自动列出阿伟请输入操作编号: 3 请输入等级门槛默认50: 50 招募筛选结果等级 50 的成员 - 阿伟 | 职业 战士 | 等级 53如果阿伟等级还是 48还没有达到门槛筛选结果会提示“暂无人达到门槛”。可以看到系统把原来需要人工翻表格的操作变成了输入一个数字查询效率和准确率都提高了。7. 常见问题与排查思路在实际运行过程中新手可能会遇到一些常见问题。这里整理了一份排查思路问题现象常见原因解决思路中文昵称显示乱码终端编码不是 UTF-8Windows 命令行先执行chcp 65001再运行程序输入等级时程序报错崩溃输入了非数字字符在int(input(...))外层增加 try-except捕获 ValueError成员 ID 填写错误记不住成员的唯一 ID先执行“查看成员列表”根据列表中的 ID 操作升级后查看记录为空新等级低于或等于当前等级更新未生效程序有防误操作逻辑检查old_level是否正确重复执行程序后数据还在SQLite 数据持久化存储这是正常现象数据都保存在 .db 文件中数据库文件被占用打不开程序未正常退出或另一个终端还在运行关闭旧终端或复制 .db 文件前先退出程序再强调一点如果未来要手动修改数据库建议先备份.db文件再进行任何更新或删除操作。数据库操作不是“撤销”那么容易在生产环境或正式公会数据中尤其要小心。8. 最佳实践与扩展建议8.1 数据安全与备份SQLite 的数据库就是一个文件备份非常方便。建议每天或每周把guild_manager.db复制到网盘或本地备份目录防止文件损坏或误操作导致数据丢失。如果公会成员数据比较多可以写一个定时脚本用 Python 的shutil库自动拷贝数据库文件。8.2 日志与操作记录现在的程序只记录了升级历史但“谁在什么时候添加了成员”“谁删除了成员”这类操作没有记录。后期可以增加一张操作日志表operate_log把每次增删改操作都记录下来方便追溯问题。8.3 输入校验与异常处理目前代码中直接把输入字符串转换为int如果用户输入abc程序会直接崩溃。在真实使用场景中建议对输入做一层异常处理。比如try: level int(input(当前等级: ).strip()) except ValueError: print(等级必须是数字已取消本次操作。) continue8.4 扩展为 Web 管理后台当公会成员规模变大命令行工具就不够方便了。可以考虑用 Flask 做一套简单的 Web 管理页面成员和管理员通过浏览器访问。由于数据库和核心函数已经写好只需把函数调用改为路由处理函数即可改造成本很低。8.5 对接聊天机器人很多公会管理依赖微信、QQ 或 Discord 群。如果能让管理员在群里发一条“筛选 50 级”就自动返回结果那就更实用了。可以把核心函数封装成一个服务接口然后对接机器人框架实现群里自助查询。8.6 数据库迁移到 MySQL当公会数据量增大或者有多个管理员同时操作时SQLite 的并发写入能力会略显不足。此时可以在保留现有代码结构的前提下把 sqlite3 替换为 pymysql将 SQL 语法稍作调整即可迁移到 MySQL。注意 SQLite 和 MySQL 在时间函数、自增主键写法上有差异需要测试验证。整体来看这个公号成员管理工具虽然代码量不大但覆盖了数据库设计、CRUD 操作、联表查询、命令行交互等 Python 核心知识点。你可以先把代码跑起来录入一批测试数据体验一下招募筛选和升级追踪的实际效果。再往后无论是扩展成 Web 系统还是接入聊天机器人核心的数据模型和函数逻辑都可以继续复用。 Python+SQLite实现游戏公会成员等级管理系统
游戏公会招募时经常能看到类似“50级以上就行等级接近的我会带”这样的公告。门槛设得不高、老玩家愿意带新人确实是公会快速拉活的好办法。但真正负责登记的管理员往往最头疼今天刚记录一个 48 级的新人明天对方升到 52 级又要改表过几天还要统计多少人达到了主力团门槛、谁该进培养名单。如果全靠 Excel 手工维护数据一多就会乱。这篇文章就从公会管理的真实场景出发用 Python SQLite 从零搭建一个“游戏公会成员等级管理系统”把成员录入、等级筛选、升级追踪和数据统计这几件事自动化。不需要安装额外的数据库服务代码开箱即用适合后端入门、Python 练手也适合真的拿去做公会管理工具。1. 背景与需求分析1.1 游戏公会管理的核心痛点很多游戏公会在早期都是靠“群公告 在线表格”来管理成员的。成员少的时候问题不大人一旦超过几十个麻烦就接踵而至信息分散成员的等级、职业、入会时间散落在多个表格和聊天记录里想查一个数据要翻半天。门槛筛选靠人工公会制定“50 级可进主力团”的规则后每次招募都要人工核对所有申请者的等级效率低还容易漏。升级记录不完整成员今天 48 级、明天 55 级管理员往往靠群消息里的截图追踪时间一长根本对不上。缺少整体视角公会到底有多少活跃成员、等级分布如何、哪些人已经连续很久没升级这些问题缺少数据支撑管理决策只能靠感觉。这些问题本质上都是“数据管理”问题。游戏内的公会面板通常只提供简单的在线成员列表无法灵活支持自定义等级门槛、升级历史追踪和统计报表。所以一个面向公会管理场景的轻量级工具就有了落地空间。1.2 “50 级以上就行”背后的业务逻辑“50 级以上就行”这句话看似简单背后其实是公会的分层管理思路等级门槛用来快速过滤活跃度和基础实力防止公会被大量低等级小号占满。等级接近的我会带这是一种“带练”运营策略说明公会管理层愿意投入精力培养潜力玩家而不是只招满级号。持续追踪培养一个人不能只靠口头承诺管理员需要记录每个人入会时的等级、每次升级的时间和当前段位才能判断培养效果。如果把这些业务规则转换成技术需求就是我们下面要实现的功能成员资料建档、按等级门槛筛选、升级历史记录、等级分布统计。2. 系统设计与技术选型2.1 功能模块划分为了让代码结构清晰、方便后续扩展我把系统拆成下面几个功能模块模块功能说明成员信息管理新增成员、查看成员列表记录昵称、职业、等级、推荐人等招募筛选按等级门槛自动过滤出符合要求的成员升级追踪更新成员等级同时写入升级历史方便回溯成长轨迹数据统计统计公会在册人数和等级分布每个模块对应一个独立的函数入口采用简单的命令行交互菜单。这样既便于新手理解也方便后续改造成 Web 服务或机器人接口。2.2 技术选型技术选型上我选择的是 Python 标准库加 SQLite理由如下Python 3语法简洁几乎所有开发环境都自带学习成本低。SQLitePython 内置 sqlite3 模块即可操作不需要单独安装 MySQL、PostgreSQL 等数据库服务单文件存储非常适合公会这种轻量级数据场景。命令行交互省去前端页面开发把核心逻辑先跑通后续再套 Flask/Django 或对接聊天机器人。选择 SQLite 还有一个好处整个数据库就是一个 .db 文件备份时直接复制文件即可对普通公会管理场景来说足够了。如果以后成员规模大到上万再迁移到 MySQL 也不难因为 SQL 语法大部分是通用的。3. 环境准备与项目结构3.1 环境要求本文示例的代码基于以下环境版本可以根据你的实际环境调整Python 3.6 及以上无需安装第三方依赖只用标准库 sqlite3、datetime操作系统Windows / macOS / Linux 均可可以先用下面命令检查 Python 版本python --version如果 Python 版本过低建议升级到 3.8 以上避免个别语法不兼容。3.2 项目结构为了便于管理建议新建一个名为guild_manager的文件夹项目结构如下guild_manager/ ├── guild_manager.py # 主程序 └── guild_manager.db # SQLite 数据库文件首次运行自动生成主程序只需要一个 Python 文件即可运行数据库文件会在程序启动时自动创建不需要手动建表。4. 数据库设计4.1 成员表 members成员表用于保存公会成员的基础信息。这里需要重点关注的是referrer字段它对应“等级接近的我会带”这个场景——记录是谁把新人带入公会的方便后续追踪带练关系。字段名类型说明idINTEGER 主键自增成员唯一编号nicknameTEXT成员昵称jobTEXT游戏职业levelINTEGER当前等级referrerTEXT推荐人/带练人statusTEXT状态默认 ACTIVEcreated_atTEXT入会时间默认当前时间4.2 升级历史表 level_history升级历史表用于记录每一次等级变化方便查看成员成长轨迹。字段名类型说明idINTEGER 主键自增历史记录编号member_idINTEGER关联 members 表old_levelINTEGER原等级new_levelINTEGER新等级upgraded_atTEXT升级时间默认当前时间设计上把升级历史单独拆成一张表是因为等级会被多次更新如果只覆盖 members 表中的 level 字段就无法追溯“谁在什么时候从多少级升到多少级”。有了历史表统计长期培养效果就方便很多。4.3 初始化脚本初始化脚本负责创建数据表保证程序第一次运行时数据库结构是正确的。def init_db(): conn get_conn() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS members ( id INTEGER PRIMARY KEY AUTOINCREMENT, nickname TEXT NOT NULL, job TEXT DEFAULT , level INTEGER NOT NULL DEFAULT 1, referrer TEXT DEFAULT , status TEXT DEFAULT ACTIVE, created_at TEXT DEFAULT (datetime(now, localtime)) ) ) cursor.execute( CREATE TABLE IF NOT EXISTS level_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, member_id INTEGER NOT NULL, old_level INTEGER, new_level INTEGER, upgraded_at TEXT DEFAULT (datetime(now, localtime)), FOREIGN KEY (member_id) REFERENCES members(id) ) ) conn.commit() conn.close()这里使用了CREATE TABLE IF NOT EXISTS所以即使重复运行程序也不会因为表已存在而报错。5. 核心功能实现5.1 数据库连接与公共方法每个功能函数都需要连接数据库。为了复用代码我单独封装了一个get_conn()方法import sqlite3 DB_NAME guild_manager.db def get_conn(): conn sqlite3.connect(DB_NAME) conn.row_factory sqlite3.Row return conn设置row_factory sqlite3.Row之后查询结果就可以通过字段名访问例如row[nickname]代码可读性会好很多。5.2 添加成员添加成员是管理系统最常用的操作。函数接收昵称、职业、等级和推荐人四个参数插入成功后打印成员 ID方便后续操作。def add_member(nickname, job, level1, referrer): conn get_conn() cursor conn.cursor() cursor.execute( INSERT INTO members (nickname, job, level, referrer) VALUES (?, ?, ?, ?), (nickname, job, level, referrer) ) conn.commit() member_id cursor.lastrowid conn.close() print(f[OK] 成员 {nickname} 已加入公会当前等级 {level}推荐人 {referrer or 无}ID{member_id})这里使用了参数化查询?占位符而不是直接拼接字符串主要原因有两个避免 SQL 注入风险虽然本地工具风险低但好习惯要养成。自动处理字符串中的特殊字符比如昵称里包含单引号时不会产生语法错误。5.3 查看成员列表查看成员列表时默认只显示状态为 ACTIVE 的成员并按等级从高到低排序方便管理员快速了解公会当前的高战力和新人。def list_members(show_allFalse): conn get_conn() cursor conn.cursor() sql SELECT * FROM members if not show_all: sql WHERE status ACTIVE sql ORDER BY level DESC cursor.execute(sql) rows cursor.fetchall() conn.close() if not rows: print(当前没有成员记录。) return print(\n 公会成员列表 ) print(f{ID:5}{昵称:20}{职业:10}{等级:8}{推荐人:15}{状态:10}) print(- * 70) for row in rows: print(f{row[id]:5}{row[nickname]:20}{row[job]:10}{row[level]:8}{row[referrer] or 无:15}{row[status]:10})在输出格式上用:20这样的格式控制符实现左对齐保证数据显示出来是整齐的表格效果。5.4 招募筛选招募筛选对应标题中的“50 级以上就行”场景。函数接收最低等级参数默认值为 50可以筛选出所有达到门槛的活跃成员。def recruit_filter(min_level50): conn get_conn() cursor conn.cursor() cursor.execute( SELECT * FROM members WHERE status ACTIVE AND level ? ORDER BY level DESC, (min_level,) ) rows cursor.fetchall() conn.close() print(f\n 招募筛选结果等级 {min_level} 的成员 ) if not rows: print(暂无人达到门槛。) return for row in rows: print(f- {row[nickname]} | 职业 {row[job] or 未知} | 等级 {row[level]})这个函数的参数是动态传入的所以未来公会把门槛从 50 级调整到 60 级不需要改代码只需要在菜单里重新输入一个数字。5.5 更新成员等级更新等级是最容易出错的环节需要做好两个校验成员 ID 必须存在。新等级必须高于当前等级否则说明数据录入有误。def update_level(member_id, new_level): conn get_conn() cursor conn.cursor() cursor.execute(SELECT * FROM members WHERE id ?, (member_id,)) row cursor.fetchone() if not row: print(f[ERROR] 找不到 ID 为 {member_id} 的成员。) conn.close() return old_level row[level] if new_level old_level: print(f[WARN] 新等级 {new_level} 不高于当前等级 {old_level}未执行更新。) conn.close() return cursor.execute(UPDATE members SET level ? WHERE id ?, (new_level, member_id)) cursor.execute( INSERT INTO level_history (member_id, old_level, new_level) VALUES (?, ?, ?), (member_id, old_level, new_level) ) conn.commit() conn.close() print(f[OK] {row[nickname]} 等级 {old_level} - {new_level}升级成功)这里的关键操作是“双写”先更新成员表里的当前等级再往历史表插入一条升级记录。只有两个操作都成功才提交事务。如果中途失败SQLite 默认会回滚不会出现“等级改了但没留记录”的情况。5.6 等级分布统计统计模块用来生成公会整体的等级分布帮助管理员了解当前人员结构。def level_stats(): conn get_conn() cursor conn.cursor() cursor.execute(SELECT level, COUNT(*) AS cnt FROM members WHERE status ACTIVE GROUP BY level ORDER BY level) rows cursor.fetchall() conn.close() print(\n 公会等级分布 ) total 0 for row in rows: total row[cnt] print(f等级 {row[level]}: {row[cnt]} 人) print(f公会在册人数: {total} 人)5.7 升级历史查询升级历史查询用来查看最近谁升了级方便管理员在群里点名鼓励或者掌握带练效果。def show_level_history(): conn get_conn() cursor conn.cursor() cursor.execute( SELECT h.id, m.nickname, h.old_level, h.new_level, h.upgraded_at FROM level_history h JOIN members m ON h.member_id m.id ORDER BY h.upgraded_at DESC LIMIT 20 ) rows cursor.fetchall() conn.close() print(\n 最近升级记录 ) if not rows: print(暂无升级记录。) return for row in rows: print(f{row[nickname]}: {row[old_level]} 级 - {row[new_level]} 级{row[upgraded_at]})这里使用JOIN把两张表关联起来查出昵称和升级信息比单独查历史表更直观。6. 完整代码与运行演示6.1 完整源码把上面的所有功能整合到一个文件里加上菜单交互逻辑就是完整的公会成员等级管理系统。直接复制以下代码保存为guild_manager.py即可运行import sqlite3 DB_NAME guild_manager.db def get_conn(): conn sqlite3.connect(DB_NAME) conn.row_factory sqlite3.Row return conn def init_db(): conn get_conn() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS members ( id INTEGER PRIMARY KEY AUTOINCREMENT, nickname TEXT NOT NULL, job TEXT DEFAULT , level INTEGER NOT NULL DEFAULT 1, referrer TEXT DEFAULT , status TEXT DEFAULT ACTIVE, created_at TEXT DEFAULT (datetime(now, localtime)) ) ) cursor.execute( CREATE TABLE IF NOT EXISTS level_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, member_id INTEGER NOT NULL, old_level INTEGER, new_level INTEGER, upgraded_at TEXT DEFAULT (datetime(now, localtime)), FOREIGN KEY (member_id) REFERENCES members(id) ) ) conn.commit() conn.close() def add_member(nickname, job, level1, referrer): conn get_conn() cursor conn.cursor() cursor.execute( INSERT INTO members (nickname, job, level, referrer) VALUES (?, ?, ?, ?), (nickname, job, level, referrer) ) conn.commit() member_id cursor.lastrowid conn.close() print(f[OK] 成员 {nickname} 已加入公会当前等级 {level}推荐人 {referrer or 无}ID{member_id}) def list_members(show_allFalse): conn get_conn() cursor conn.cursor() sql SELECT * FROM members if not show_all: sql WHERE status ACTIVE sql ORDER BY level DESC cursor.execute(sql) rows cursor.fetchall() conn.close() if not rows: print(当前没有成员记录。) return print(\n 公会成员列表 ) print(f{ID:5}{昵称:20}{职业:10}{等级:8}{推荐人:15}{状态:10}) print(- * 70) for row in rows: print(f{row[id]:5}{row[nickname]:20}{row[job]:10}{row[level]:8}{row[referrer] or 无:15}{row[status]:10}) def recruit_filter(min_level50): conn get_conn() cursor conn.cursor() cursor.execute( SELECT * FROM members WHERE status ACTIVE AND level ? ORDER BY level DESC, (min_level,) ) rows cursor.fetchall() conn.close() print(f\n 招募筛选结果等级 {min_level} 的成员 ) if not rows: print(暂无人达到门槛。) return for row in rows: print(f- {row[nickname]} | 职业 {row[job] or 未知} | 等级 {row[level]}) def update_level(member_id, new_level): conn get_conn() cursor conn.cursor() cursor.execute(SELECT * FROM members WHERE id ?, (member_id,)) row cursor.fetchone() if not row: print(f[ERROR] 找不到 ID 为 {member_id} 的成员。) conn.close() return old_level row[level] if new_level old_level: print(f[WARN] 新等级 {new_level} 不高于当前等级 {old_level}未执行更新。) conn.close() return cursor.execute(UPDATE members SET level ? WHERE id ?, (new_level, member_id)) cursor.execute( INSERT INTO level_history (member_id, old_level, new_level) VALUES (?, ?, ?), (member_id, old_level, new_level) ) conn.commit() conn.close() print(f[OK] {row[nickname]} 等级 {old_level} - {new_level}升级成功) def level_stats(): conn get_conn() cursor conn.cursor() cursor.execute(SELECT level, COUNT(*) AS cnt FROM members WHERE status ACTIVE GROUP BY level ORDER BY level) rows cursor.fetchall() conn.close() print(\n 公会等级分布 ) total 0 for row in rows: total row[cnt] print(f等级 {row[level]}: {row[cnt]} 人) print(f公会在册人数: {total} 人) def show_level_history(): conn get_conn() cursor conn.cursor() cursor.execute( SELECT h.id, m.nickname, h.old_level, h.new_level, h.upgraded_at FROM level_history h JOIN members m ON h.member_id m.id ORDER BY h.upgraded_at DESC LIMIT 20 ) rows cursor.fetchall() conn.close() print(\n 最近升级记录 ) if not rows: print(暂无升级记录。) return for row in rows: print(f{row[nickname]}: {row[old_level]} 级 - {row[new_level]} 级{row[upgraded_at]}) def show_menu(): print(\n 公会成员管理系统 ) print(1. 添加成员) print(2. 查看成员列表) print(3. 招募筛选等级门槛) print(4. 更新成员等级) print(5. 等级分布统计) print(6. 查看升级记录) print(7. 退出系统) print() def main(): init_db() while True: show_menu() choice input(请输入操作编号: ).strip() if choice 1: nickname input(成员昵称: ).strip() job input(职业: ).strip() level int(input(当前等级: ).strip()) referrer input(推荐人可留空: ).strip() add_member(nickname, job, level, referrer) elif choice 2: list_members() elif choice 3: min_level int(input(请输入等级门槛默认50: ).strip() or 50) recruit_filter(min_level) elif choice 4: member_id int(input(成员ID: ).strip()) new_level int(input(新等级: ).strip()) update_level(member_id, new_level) elif choice 5: level_stats() elif choice 6: show_level_history() elif choice 7: print(已退出系统。) break else: print(无效的操作编号请重新输入。) if __name__ __main__: main()6.2 运行演示在命令行进入guild_manager.py所在目录执行python guild_manager.py程序启动后会显示菜单。假设我们要录入一个 48 级的新人选择 1依次输入昵称、职业、等级、推荐人 公会成员管理系统 1. 添加成员 2. 查看成员列表 3. 招募筛选等级门槛 4. 更新成员等级 5. 等级分布统计 6. 查看升级记录 7. 退出系统 请输入操作编号: 1 成员昵称: 阿伟 职业: 战士 当前等级: 48 推荐人可留空: 会长 [OK] 成员 阿伟 已加入公会当前等级 48推荐人 会长ID1过几天阿伟升到了 53 级管理员选择 4 操作请输入操作编号: 4 成员ID: 1 新等级: 53 [OK] 阿伟 等级 48 - 53升级成功此时执行招募筛选输入门槛 50系统就会自动列出阿伟请输入操作编号: 3 请输入等级门槛默认50: 50 招募筛选结果等级 50 的成员 - 阿伟 | 职业 战士 | 等级 53如果阿伟等级还是 48还没有达到门槛筛选结果会提示“暂无人达到门槛”。可以看到系统把原来需要人工翻表格的操作变成了输入一个数字查询效率和准确率都提高了。7. 常见问题与排查思路在实际运行过程中新手可能会遇到一些常见问题。这里整理了一份排查思路问题现象常见原因解决思路中文昵称显示乱码终端编码不是 UTF-8Windows 命令行先执行chcp 65001再运行程序输入等级时程序报错崩溃输入了非数字字符在int(input(...))外层增加 try-except捕获 ValueError成员 ID 填写错误记不住成员的唯一 ID先执行“查看成员列表”根据列表中的 ID 操作升级后查看记录为空新等级低于或等于当前等级更新未生效程序有防误操作逻辑检查old_level是否正确重复执行程序后数据还在SQLite 数据持久化存储这是正常现象数据都保存在 .db 文件中数据库文件被占用打不开程序未正常退出或另一个终端还在运行关闭旧终端或复制 .db 文件前先退出程序再强调一点如果未来要手动修改数据库建议先备份.db文件再进行任何更新或删除操作。数据库操作不是“撤销”那么容易在生产环境或正式公会数据中尤其要小心。8. 最佳实践与扩展建议8.1 数据安全与备份SQLite 的数据库就是一个文件备份非常方便。建议每天或每周把guild_manager.db复制到网盘或本地备份目录防止文件损坏或误操作导致数据丢失。如果公会成员数据比较多可以写一个定时脚本用 Python 的shutil库自动拷贝数据库文件。8.2 日志与操作记录现在的程序只记录了升级历史但“谁在什么时候添加了成员”“谁删除了成员”这类操作没有记录。后期可以增加一张操作日志表operate_log把每次增删改操作都记录下来方便追溯问题。8.3 输入校验与异常处理目前代码中直接把输入字符串转换为int如果用户输入abc程序会直接崩溃。在真实使用场景中建议对输入做一层异常处理。比如try: level int(input(当前等级: ).strip()) except ValueError: print(等级必须是数字已取消本次操作。) continue8.4 扩展为 Web 管理后台当公会成员规模变大命令行工具就不够方便了。可以考虑用 Flask 做一套简单的 Web 管理页面成员和管理员通过浏览器访问。由于数据库和核心函数已经写好只需把函数调用改为路由处理函数即可改造成本很低。8.5 对接聊天机器人很多公会管理依赖微信、QQ 或 Discord 群。如果能让管理员在群里发一条“筛选 50 级”就自动返回结果那就更实用了。可以把核心函数封装成一个服务接口然后对接机器人框架实现群里自助查询。8.6 数据库迁移到 MySQL当公会数据量增大或者有多个管理员同时操作时SQLite 的并发写入能力会略显不足。此时可以在保留现有代码结构的前提下把 sqlite3 替换为 pymysql将 SQL 语法稍作调整即可迁移到 MySQL。注意 SQLite 和 MySQL 在时间函数、自增主键写法上有差异需要测试验证。整体来看这个公号成员管理工具虽然代码量不大但覆盖了数据库设计、CRUD 操作、联表查询、命令行交互等 Python 核心知识点。你可以先把代码跑起来录入一批测试数据体验一下招募筛选和升级追踪的实际效果。再往后无论是扩展成 Web 系统还是接入聊天机器人核心的数据模型和函数逻辑都可以继续复用。