zhenxun_bot/zhenxun/plugins/bym_ai/README.md
2025-07-01 16:56:34 +08:00

2.1 KiB
Raw Blame History

BYM AI 插件使用指南

本插件支持所有符合 OpenAi 接口格式的 AI 服务,以下以 Gemini 为例进行说明。 你也通过 其他文档 查看配置

获取 API KEY

  1. 进入 Gemini API Key 生成 API KEY。
  2. 如果无法访问,请尝试更换代理。

配置设置

首次加载插件后,在 data/config.yaml 文件中进行以下配置(请勿复制括号内的内容):

bym_ai:
  # BYM_AI 配置
  BYM_AI_CHAT_URL: https://generativelanguage.googleapis.com/v1beta/chat/completions  # Gemini 官方 API更推荐找反代
  BYM_AI_CHAT_TOKEN:
    - 你刚刚获取的 API KEY可以有多个进行轮询
  BYM_AI_CHAT_MODEL: gemini-2.0-flash-thinking-exp-01-21  # 推荐使用的聊天模型(免费)
  BYM_AI_TOOL_MODEL: gemini-2.0-flash-exp  # 推荐使用的工具调用模型(免费,需开启 BYM_AI_CHAT_SMART
  BYM_AI_CHAT: true  # 是否开启伪人回复
  BYM_AI_CHAT_RATE: 0.001  # 伪人回复概率0-1
  BYM_AI_TTS_URL:  # TTS 接口地址
  BYM_AI_TTS_TOKEN:  # TTS 接口密钥
  BYM_AI_TTS_VOICE:  # TTS 接口音色
  BYM_AI_CHAT_SMART: true  # 是否开启智能模式(必须填写 BYM_AI_TOOL_MODEL
  ENABLE_IMPRESSION: true  # 使用签到数据作为基础好感度
  CACHE_SIZE: 40  # 缓存聊天记录数据大小(每位用户)
  ENABLE_GROUP_CHAT: true  # 在群组中时共用缓存

人设设置

data/bym_ai/prompt.txt中设置你的基础人设

礼物开发

与商品注册类型,在bym_ai/bym_gift/gift_reg.py中查看写法。

例如:

@gift_register(
    name="可爱的钱包",
    icon="wallet.png",
    description=f"这是{BotConfig.self_nickname}的小钱包,里面装了一些金币。",
)
async def _(user_id: str):
    rand = random.randint(100, 500)
    await UserConsole.add_gold(user_id, rand, "BYM_AI")
    return f"钱包里装了{BotConfig.self_nickname}送给你的枚{rand}金币哦~"