🧸 智能毛绒玩具本地伴侣 Node.js 服务端运行指南

这是一个为您的智能玩具提供“智脑”的纯 Node.js 服务。整个服务设计为“无头模式（Headless）”，不需要任何浏览器页面，笔记本盖子合上放在房间角落即可运行。

---

🛒 1. 硬件采购清单与避坑指南 (免焊接版)

为了让您体验“乐高式”的拼装乐趣，避免焊接，请按照以下指南去淘宝采购配件（总成本约 15~20 元人民币）：

配件名称	推荐淘宝搜索词	预估价格	💡 购买避坑要点（重点）
1. 蓝牙通话主板	蓝牙音频通话模块 带功放 PH2.0	5 ~ 8 元	① 必须有**“通话”或“麦克风/MIC”字样。不要买只能放音的纯接收板。 ② 必须带有 PH2.0 插座（用来插喇叭和电池）。 ③ 最好是“板载麦克风”**（主板上自带一个金属小圆片收音，免去接麦克风线）。
2. 带开关电池	3.7v锂电池带开关带插头 或 18650带开关电池盒 PH2.0	5 ~ 8 元	① 必须选 PH2.0 双线插头。 ② 强烈建议购买带有“滑动开关”的锂电池（或者带开关的电池盒），这可以作为小熊的物理电源开关，一键开机/休眠。
3. 小喇叭	腔体喇叭 8欧 2W 带线 PH2.0	3 ~ 5 元	① 必须买带有 PH2.0 2pin 插头的导线。 ② 推荐买带塑料外壳的“腔体喇叭”（音质较浑厚，不刺耳），不要买光秃秃的圆片纸盆喇叭。
4. 充电线	家里闲置的 Type-C 或 Micro-USB 线	0 元	主板上一般都自带充电接口，插上普通手机充电线就能给玩具里的电池充电。

🧩 硬件组装方法（只需 3 步）：

1. 把带有 PH2.0 插头的喇叭，插在主板标有 SPK 或喇叭图标的插座上。
2. 把带有 PH2.0 插头且带滑动开关的电池，插在主板标有 BAT 或电池图标的插座上。
3. 拨动电池盒上的开关至 ON，主板指示灯闪烁，开启您的 Mac 蓝牙搜索配对，硬件组装即宣告完成！

---

💻 2. 笔记本电脑前置要求 (以 Mac OS 为例)

1. 系统录音组件 (sox): 主程序的录音引擎依赖底层的 rec 命令。请先在您的终端中运行以下命令安装：

   brew install sox

2. 默认音频设备设置:

   • 将毛绒玩具内的蓝牙音频主板开机，并在 Mac 的蓝牙设置中将其连接。
   • 在 Mac 的 系统声音设置 中：
     • 将 输入 (Input) 设备设为：毛绒玩具的蓝牙麦克风
     • 将 输出 (Output) 设备设为：毛绒玩具的蓝牙喇叭

---

⚙️ 2. 本地服务配置

① 声音克隆 (GPT-SoVITS) 配置

本服务调用本地 http://127.0.0.1:9880 端口的声音克隆服务。

• 在您的闲置笔记本上先开启已训练好您声音的 GPT-SoVITS API 推理接口。
• 确保能够通过 GET http://127.0.0.1:9880/?text=你好&text_language=zh 获取合成的音频。

② 环境变量配置 (.env)

项目根目录下的 .env 文件保存了核心的 API 配置，请根据您的实际密钥进行填写：

# 大模型 API 配置 (DeepSeek 或 豆包)
LLM_API_KEY=您的_API_KEY
LLM_BASE_URL=https://api.deepseek.com/v1
LLM_MODEL=deepseek-chat

③ 记忆配置 (src/user_profile.json)

在该 JSON 文件中填写您孩子的真实信息，大模型会自动记忆并在日常对话中适时提起：

{
  "userName": "天天",
  "favoriteToy": "霸王龙",
  "pet": "小猫咪咪",
  "birthday": "10月20日"
}

---

🚀 3. 运行玩具进程

在项目根目录下，直接执行守护启动脚本：

./scripts/start-toy.sh

该脚本会自动进入死循环守护状态，如果服务因蓝牙信号断开、网络异常意外退出，将会在 3 秒后自动拉起重启，确保玩具 24 小时在线。