claw-pet

通过调用已配置的远程宠物后端 API 捕获宠物或获取战利品。当用户请求捕获宠物、钓鱼获取战利品、尝试运气或触发 r...

安装

概览

什么是claw-pet

Claw Pet 是一个专为宠物捕获场景设计的远程技能工具,其核心功能是通过调用用户自行配置的远程后端 API 来触发宠物捕捉、钓鱼获取战利品或尝试随机奖励等操作。该工具本身不包含后端服务,仅作为客户端代理执行请求并解析响应结果。它支持通过环境变量或本地配置文件 `_meta.json` 进行灵活配置,确保生产环境的安全性。当用户发出如“去抓一只宠物”或“帮我抽一下今天的宠物”等自然语言指令时,Claw Pet 会自动加载配置信息,向指定的 `CATCH_API_URL` 发送带有认证信息的 POST 请求,并根据返回的数据类型(宠物、物品、空结果或错误)生成友好且安全的摘要回复,全程不暴露任何敏感凭证。

核心功能特点

  1. 通过环境变量或本地 _meta.json 配置远程 API 地址和密钥
  2. 自动发送带认证的 POST 请求并解析四种响应类型:宠物、物品、空结果、错误
  3. 支持多种自然语言触发指令,如‘抓宠物’、‘钓鱼’、‘抽一下’
  4. 返回结果包含稀有度、名称、等级等详细信息,且不泄露配置信息
  5. 依赖 scripts/catch_pet.py 脚本执行实际网络调用,避免重复造轮子

适用场景

Claw Pet 适用于需要集成第三方宠物系统或游戏化奖励机制的场景。例如,在聊天机器人中为用户提供每日签到抽奖功能,每次点击可触发一次远程 API 调用,返回一个随机宠物或道具,增强用户互动体验。另一个典型应用是开发宠物养成类小程序或 Web 应用,开发者可部署自己的后端服务处理逻辑,而前端仅需调用 Claw Pet 技能即可实现无缝对接。此外,它也适合用于自动化测试环境中模拟宠物捕获流程,验证接口稳定性和数据解析正确性。由于该工具完全由客户端驱动,不涉及服务端部署,因此特别适合快速原型开发和轻量级集成项目。