打造激励生态：Xiuno 积分体系与勋章成就系统设计与实现全攻略

52JinY 助手

最近花了将近两个月时间，把自己手上一个基于 Xiuno BBS 的社区积分体系和勋章成就系统从零捋了一遍，踩了不少坑，也摸出了一些门道，在这里分享给同样在折腾的朋友们。

先说积分体系。Xiuno 本身的积分字段是现成的，用户表里有 credit 和 point 两个字段，很多人搞不清楚这两个有什么区别，其实可以这么理解——credit 更适合做不可消费的"荣誉值"，而 point 才是可以用于兑换、消费的实体积分。我一开始把两个混用，搞得逻辑一团糟，后来重新设计，把发帖、回帖、被点赞、签到等行为统一归入 point 体系，credit 只做累计展示用，这样前端展示和后端逻辑都清晰很多。

积分触发这块，我没有用定时任务去跑，而是选择在对应的钩子里直接写入。Xiuno 的钩子机制虽然文档少得可怜，但翻源码其实能找到不少有用的 hook，比如 thread_insert_after、reply_insert_after 这类，直接在插件里监听，用户完成对应操作之后立即更新积分，体验上比异步任务要即时得多，用户也更有正反馈。不过要注意防刷，我加了个操作冷却表，同一用户同一行为在一定时间窗口内只计一次积分，否则有人疯狂水帖刷积分，整个体系就崩了。

勋章系统相对麻烦一点，因为 Xiuno 本身没有这个模块，需要自己建表。我的做法是建了两张表，一张是 medal_define，存勋章定义，包括名称、图标路径、触发条件类型、触发阈值；另一张是 user_medal，存用户已获得的勋章记录。触发条件我设计成了枚举类型，比如 post_count（发帖数量）、register_days（注册天数）、point_total（累计积分）这几种，每种对应一个检测函数，每次用户有相关行为发生时就跑一遍检测，符合条件就写入 user_medal 并推送一条系统消息给用户。

前端展示是最花时间的地方，主要是个人主页的改造。我在用户资料页下面加了一个勋章展示区，用 CSS 做了一个小徽章样式，悬停会显示勋章名称和获得原因。有几个用户反馈说看到自己解锁新勋章很有成就感，这让我觉得这块的开发是值得的，社区氛围肉眼可见地活跃了一些。

有几个经验教训值得特别说一下。第一，积分数值的设计要慎重，初期我把发帖奖励设得太高，导致一些老用户积分已经高到没有意义，后来只能做数据修正，很麻烦。第二，勋章不要一开始就设计太多，我最开始做了三十几个，结果维护起来特别累，而且用户看到一大堆自己没有的勋章反而有挫败感，后来精简到十几个核心勋章，效果反而更好。第三，一定要做好积分变动日志，方便排查问题，我建了一张 point_log 表，每次积分变动都记一条，出问题的时候查起来清楚多了。

整体来看，Xiuno 作为二次开发基础还是够用的，代码结构不算复杂，稍微熟悉一下就能上手。积分和勋章这类功能做好了对社区留存真的有帮助，有在做类似项目的朋友欢迎交流，我在评论区等你们。