咸鱼 AI 对话插件使用教程

欢迎体验咸鱼 AI 对话插件！这份指南将帮助你快速掌握插件的安装、配置与使用方法。

📝 一、插件授权获取

1.1 访问授权购买页面

• 官网地址: xyfaka.xianyuw.cn
• 核心操作: 点击 “咸鱼 AI 对话授权” 按钮进行购买

1.2 填写购买信息（必填项标注）

• ★ 联系方式: 填写你的主 QQ 号
• ★ 绑定 QQ: 输入机器人小号 QQ
• ★ 主人 QQ: 再次输入你的主 QQ（与联系方式一致）
• ★ 授权密码: 自定义设置（首次激活框架时需要输入）
• 确认操作: 检查信息无误后完成购买

🛠️ 二、框架与插件部署

2.1 框架准备

• 前置要求: 自行准备并登录机器人框架（基础环境）

2.2 插件安装

• 下载路径: 咸鱼网络菜单 → 下载 “咸鱼 AI 对话插件”

2.3 插件启用与授权

1. 启用插件: 右键插件 → 选择 “启用”
2. 进入设置: 右键插件 → 选择 “设置”
3. 首次激活: 输入购买时设置的授权码完成激活
4. 授权失败排查:
   • 检查机器人 QQ 是否被正确识别
   • 未识别则手动选择后重新授权
   • 授权完成后重新打开插件菜单

⚙️ 三、插件核心配置

3.1 字体文件安装（必做）

⚠️ 未安装字体将导致菜单图片字体显示异常

1. 下载字体: 从群文件下载指定的 4 个字体文件
2. 安装步骤: 双击每个字体文件 → 点击 “安装” → 确保4个字体全部安装完成

3.2 AI 基础设置

• 设置位置: 插件菜单 → AI 基本信息与默认人设配置
• 人设来源:
  • 推荐: 人设网站（直接复制）
  • 自定义: 自行编写专属人设

3.3 模型设置（核心功能）

3.3.1 API Key 获取

3.3.2 接口填写规范

第三方中转接口: 按下图格式填写完整信息 官方 Key（OpenAI/Gemini）: 仅填写模型名 + Key，接口字段留空

3.3.3 默认模型设置

• 操作步骤: 点击标记位置 → 选择全局默认模型
• 启用对话: 群聊发送 “开启 AI 对话” 即可使用

3.4 触发开关

• 功能说明: 勾选后，支持两种触发方式
  • @机器人 + 问题
  • 发送“机器人名字 + 问题”

3.5 系统设置

• MD 开关: 启用 Markdown 语法渲染（仅部分框架支持）
• 自定义菜单指令: 默认 “咸鱼 AI 对话”，可自定义修改
• 其他配置: 自定义接口、人设列表可按需配置

🚀 四、拓展功能配置

4.1 语音回复功能

1. 下载转码库: 从群文件下载语音转码库文件
2. 安装步骤:
   • 解压下载的压缩包
   • 将所有文件复制到框架的 main 文件夹（无则新建）

4.2 用户组设置（权限管理）

⚠️ 切换人设/模型需先启用用户组功能

• 权限配置: 设置不同用户组可使用的模型和点数
• 格式要求: 可用模型用 # 分隔，最后一个模型后也需加 #
• 默认用户组: 从已创建用户组中选择基础用户组
• 修改指令: 发送 更改用户组 [QQ号]#[用户组名]（例: 更改用户组 123456789#xiyou）
• 启用开关: 勾选右下角用户组开关

4.3 模型管理

• 核心功能: 设置每个模型的点数消耗规则

4.4 伪人模式（特色功能）

• 功能说明: 机器人随机在群内冒泡，模拟真人发言
• 启用指令: 发送 “开启伪人”
• 详细配置:
  1. 消息条数: 建议设置固定条数触发
  2. 语音功能: 需先按语音回复教程配置转码文件
  3. 表情包: 将图片放入指定文件夹并启用
  4. 模式选择:
     • 普通模式: @/叫名字触发AI对话，伪人独立触发
     • 半隐藏模式: @/叫名字触发伪人，AI对话用系统指令
     • 隐藏模式: 仅触发伪人，屏蔽其他插件指令

4.5 伪人分群配置

1. 路径: 咸鱼ai对话\alternate\分群配置
2. 操作: 复制 0.ini 内容 → 粘贴到 群号.ini 文件
3. 启用: 将配置内 分群=假 改为 分群=真

4.6 伪人自定义模型

⚠️ 模型名需先在系统设置中配置

1. 路径: 咸鱼ai对话\alternate\分群配置（未分群则编辑 0.ini）
2. 操作: 在 [基本] 节点下添加 对话模型=模型名

📋 五、常用指令速查