下面提供从 0 到 1 的完整流程，包含豆包 API 申请、MiGPT 部署、配置与使用，确保你能顺利让小爱音箱 Pro 用上豆包的强大能力。

一、准备工作（必做）

二、申请豆包 API 密钥（关键步骤）

豆包 API 需通过火山引擎方舟平台申请，以下是详细步骤：

1. 注册与实名认证

1. 访问火山引擎官网：https://www.volcengine.com/
2. 注册账号并完成实名认证（个人 / 企业均可）
3. 登录后进入方舟大模型平台

2. 创建 API 密钥与推理接入点

1. 进入控制台 → API 密钥管理 → 点击 "创建密钥"，保存Access Key ID和Secret Access Key
2. 进入在线推理 → 创建推理接入点：
   • 名称：自定义（如 "小爱音箱豆包"）
   • 模型选择：豆包系列（推荐 Doubao-seed-1.6-flash，响应快）
   • 地域：选择cn-beijing（国内延迟低）
3. 等待状态变为 "运行中"，记录接入点 ID（格式：ep-xxxxxxxxxxxxxx）

三、部署 MiGPT（推荐 Docker 方式，零门槛）

1. 安装 Docker

• Windows/macOS：下载Docker Desktop并安装
• Linux：执行sudo apt-get install docker.io（Ubuntu）

2. 创建配置文件

在电脑上新建migpt文件夹，创建以下两个文件：

（1）.migpt.js（小爱音箱配置）

module.exports = {
  speaker: {
    userId: "你的小米账号",       // 必须修改
    password: "你的小米密码",     // 必须修改
    did: "小爱音箱Pro",          // 必须与米家App设备名称一致
    ttsCommand: [5, 1],          // 小爱音箱Pro专用参数，不可改
    wakeUpCommand: [5, 3],       // 小爱音箱Pro专用参数，不可改
    monitorCommand: [3, 1, 1],   // 小爱音箱Pro专用参数，不可改
    callAIKeywords: ["豆包", "请", "你"] // 触发豆包AI的关键词
  }
}

（2）.env（豆包 API 配置）

# 豆包配置
DOUBAO_API_KEY=你的Access Key ID:Secret Access Key  # 格式如AK:SK
DOUBAO_MODEL=接入点ID  # 如ep-xxxxxxxxxxxxxx
DOUBAO_BASE_URL=https://ark.cn-beijing.volces.com/api/v3  # 固定值
DOUBAO_REGION=cn-beijing  # 与接入点地域一致

# 其他设置（可选）
BOT_NAME=豆包  # 回答时的称呼
TTS_TYPE=xiaomi  # 使用小爱原生TTS，也可改为doubao使用豆包音色

3. 启动 MiGPT 服务

打开终端 / 命令提示符，执行以下命令（替换本地路径）：

docker run -d \
  -v /本地migpt文件夹路径:/app/config \
  -p 3000:3000 \
  --name mi-gpt \
  idootop/mi-gpt:latest

4. 验证部署

• 访问http://localhost:3000，看到 MiGPT 界面即部署成功
• 检查日志：docker logs mi-gpt，无报错即可使用

---

四、使用豆包 AI 功能（超简单）

1. 基础使用

1. 对小爱音箱说：" 小爱同学，豆包，什么是人工智能？"（关键词触发）
2. 或：" 小爱同学，请帮我写一首关于春天的诗 "
3. MiGPT 会自动拦截问题，调用豆包生成回答，通过音箱播报

2. 高级玩法

功能	语音指令示例
连续对话	"小爱同学，豆包，开启连续对话"，之后可直接提问
角色设定	"小爱同学，豆包，你现在是小学数学老师，帮我辅导孩子作业"
内容生成	"小爱同学，豆包，写一篇关于超级跑车的作文"（适合孩子兴趣）
知识问答	"小爱同学，豆包，解释一下相对论"

---

五、常见问题与解决方案（避坑指南）

问题	原因	解决方法
MiGPT 无法连接音箱	小米账号两步验证开启 / 密码错误	关闭两步验证；确认账号密码正确；设备名称与米家 App 一致
豆包回答延迟高	网络差 / 模型选择不当	切换国内模型（如 Doubao-seed-1.6-flash）；优化网络
语音播报异常	TTS 参数错误	确认 ttsCommand 为 [5,1]（小爱音箱 Pro 专用）
API 调用失败	密钥错误 / 接入点未运行	检查 API 密钥与接入点 ID；确认接入点状态为 "运行中"
部分问题不触发豆包	关键词未匹配	修改.callAIKeywords，添加常用触发词（如 "帮我"、"解释"）

---

六、两种接入方式对比（官方 vs 豆包）

对比项	官方内置大模型	豆包 AI（MiGPT）
功能	基础问答、内容生成	全功能豆包，支持连续对话、角色设定、多轮记忆
响应速度	快（本地模型）	中（网络调用，国内模型约 1-3 秒）
定制化	有限	高度自定义（角色、回答风格、关键词）
适合场景	普通用户、便捷使用	技术爱好者、有孩子家庭（可定制教育角色）