先说结论这只猫主要是给「积分只进不出」的站准备的。你站里用户天天签到、做任务，积分越攒越多，能花的地方却只有那么几处——橘喵就是那个出口；同时它还是个入口：签到、打工、发评论、下载资源、发帖，全都能在这只猫身上变成看得见的正反馈。

装好之后，页面右下角会浮出一只橘喵按钮（手机端同样在右下角，会自动避开底部安全区），点开就是一个三页签的小面板：互动 / 商店 / 荣誉。不打断用户浏览，想玩就点，不想玩也不占地方。

一、它在你的积分体系里扮演什么角色

把流程拆开看是三段：

环节	动作	作用
赚积分	签到、打工	把「每天来一趟」变成有收益的日常
花积分	喂食、玩具、扭蛋、猫粮、装扮	给积分一个真正想去的地方
养宠物	撸猫、喂食、玩具、站点行为	涨经验 / 亲密度 → 升级、进化、上榜、拿成就

关键在于第三段：宠物经验只来自互动和站点行为，永远不给积分。也就是说养成线不会再来一轮积分通胀，它只负责把「陪伴感」和「炫耀位」做起来——这两样才是让人重复回来的东西。

二、三个页签分别放什么

页签	内容
互动	宠物形象与气泡对话、饱食度 / 心情 / 亲密度 / 等级四条状态、签到、打工、喂食、玩具、撸猫、宠物经验条与今日行为任务进展
商店	橘喵扭蛋、猫粮商店、宠物装扮（含限时上新与预告档期）
荣誉	亲密度排行榜（总榜 / 周榜 / 月榜）、12 个成就、成就展示位

三、积分账本：每天的进与出

赚（产出）

动作	收益	限制
签到	+5 积分	每天一次
连签加成	+1 积分 / 天	随连签天数递增，上限 +10
打工	+10 积分 / 次	每天 3 次，冷却 120 分钟（每天最多 +30）

隐藏收益：宠物等级会反过来加成你站点自己的签到奖励——每 4 级 +1，最高 +5。所以养猫不是纯消耗，等级上去了每天签到拿得更多。这个加成写在签到接口里，不用你另外配置。

花（消耗）

动作	消耗	换到的东西
喂食	−10 积分	饱食度 +30，宠物经验 +5
玩具	−15 积分	心情 +30、亲密度 +10，宠物经验 +8
橘喵扭蛋	−5 积分 / 次	抽奖（概率与保底在后台表单里配）
猫粮商店	−5 积分 / 次	当场吃掉，回饱食 / 心情 / 亲密度，不做背包
宠物装扮	30 / 50 / 80 积分	暖暖围巾 / 叮当铃铛 / 英雄披风，买了永久有
限时装扮	66 / 88 积分	樱花簪（档期到限）、灯笼挂饰（下一期预告）
撸猫	免费	亲密度 +1、心情 +2；冷却 60 秒，每天 20 次

另外有 3 件装扮是升级免费解锁的：橘子头巾（3 级）、酷酷墨镜（8 级）、猫猫王冠（15 级）。这是给不花钱的用户留的获得感，别小看它——免费档位决定了「白嫖用户会不会也来养」。

四、养成线：为什么用户会想把它养下去

1. 等级：1 到 20 级

经验来自互动（签到 +20、打工 +10、喂食 +5、玩具 +8，签到还会顺手喂一口）和站点行为任务：发表评论 +10、下载资源 +8、发布内容 +12，行为任务每天最多计入 50 点经验（评论 5 次、下载 3 次、发帖 2 次）。全部只给经验，不给积分。

2. 形态进化：5 个阶段

奶喵 → 淘气喵 → 沉稳喵 → 威风喵 → 猫神。形态跟着等级自动进化，进化瞬间有专属提示。这是整个玩法里最直观的「我确实在变强」的反馈。

3. 亲密度排行榜：按增量排，不按存量

榜单分总榜 / 周榜 / 月榜，各取前十。周榜和月榜算的是这周 / 这个月新撸出来的亲密度，不是历史总量——所以新用户下周也能冲榜，不会被老用户的总量压死。这是让排行榜真的「活」起来的关键。

4. 成就：12 个

连签 7 天 / 30 天、升到 5 / 10 / 20 级、亲密 50、撸猫 100 次、首次中奖、十连欧皇、猫粮开箱、第一次装扮、换装达人。每个成就解锁 +15 宠物经验，可以在荣誉页挑最多 3 个放进展示位——这就是用户的炫耀位。

五、安装（按顺序做）

拿到安装包：guaqi-pet-mewmew-1.15.1.zip（79 KB）。

1. 上传：进 WordPress 后台的瓜奇插件管理页上传 ZIP。首次上传只安装，不自动启用。
2. 开开关：在插件列表里，把「橘喵桌面宠物」在你要用的那个前端网站上启用（按前端网站独立启停）。
3. 挂到页面上：进 builder，把「橘喵桌面宠物」以表单形式加到页面上。它是表单型插件，加完之后右下角就会出现那只猫。
4. 点发布：这一步务必别漏——builder 里改完必须点「发布」，前台才会生效。
5. 验收：见第七节。

六、两个可选玩法（扭蛋 & 猫粮）

这两个走的是平台官方的「积分兑换」引擎——扣分、概率、保底、库存、幂等、失败自动退款全在官方引擎里，插件只负责发起和给宠物侧反馈。所以积分出问题的风险很低。

玩法	承载方式	没配置时
橘喵扭蛋	官方「积分兑换与抽奖」表单，绑定在插件常量里	商店里整块不渲染，不报错
猫粮商店	官方 exchange 的 direct 模式表单（直接兑换，不抽奖）	同上，不渲染

也就是说这两个不开也能用，插件会自动把对应区块藏起来，不会出现空白或报错。开的时候按你自己的经济模型在后台表单里定价格、概率、保底和库存；本站示例配置是扭蛋 5 分 / 次、中奖率 70%、保底 10 抽、库存 500 份，猫粮 5 分 / 次——你可以直接照这个改数。

合规提醒：抽奖类玩法建议在页面上公示中奖概率，并且积分只能靠站内行为获得、不可变现、不可兑换现金。概率透明 + 没有提现口，这两条能挡掉绝大多数麻烦。

七、装完怎么验收

用带密钥的调试接口一次看完全部体检信息（宠物状态、扭蛋表单连通性、猫粮表单连通性、榜单数据）：

mutation {
  gqPetDebug(input: { key: "gqpet-diag-7f3a91c4e8b2" }) {
    result
  }
}

返回里会分段给出 gacha（扭蛋）、snack（猫粮商店）、board（排行榜）三块的配置状态。哪一块没通，这里会直接告诉你原因——比如表单没绑定、表单类型不对，不用去翻日志。

八、常见问题

Q：装了但右下角没有猫？
先确认插件在你这个前端网站上是启用状态，再确认 builder 里把它加到页面上了，最后确认点了「发布」。三步缺一步都不显示。

Q：点了没反应 / 数据加载失败？
如果你的前端域名和源站不是同一个域，需要在 nginx 上把 /graphql 反代到源站。这是本站踩过的坑，写在这里省你一轮排查。

Q：游客点「去登录」没反应？
1.15.1 版本已经修好了这个（之前是调用路径不对，点了只会闪一句提示）。现在点「去登录」会真的拉起站点自己的登录弹窗。装 1.15.1 或更高版本即可。

Q：积分被刷怎么办？
几个防刷口子都是现成的：打工有每日 3 次 + 120 分钟冷却、撸猫有 60 秒冷却 + 每日 20 次、行为任务经验有每日 50 上限 + 同类行为 20 秒去抖（防止下载键连点）、扭蛋同一用户 3 秒内连点会复用同一请求（不会重复扣分）。宠物经验不影响积分，所以就算刷经验也伤不到你的积分账。

Q：面板会不会挡住页面内容？
面板宽度 320px，高度封顶在视口内、内容再多也只在面板里滚动；手机端会自动收窄到屏幕宽减 28px，按钮缩到 56px。想藏起来点掉就行，它不会常驻展开。

九、给站长的两句实话

第一，先看你的积分是不是「只进不出」。如果用户积分本来就紧张、没什么可花的地方，先别急着加消耗品——那只会让人觉得你的站处处要钱。橘喵的顺序是：先给产出（签到、打工），再给消耗（喂食、扭蛋），最后才是炫耀（榜单、装扮）。

第二，定价别定太狠。喂食 10 分、玩具 15 分、撸猫免费——这个比例是刻意设计的：免费动作保证「不花钱也能玩」，付费动作提供效率，扭蛋提供惊喜。日常刚需如果贵到用户算不过来，他们会直接关掉面板，再也不会点开第二次。