# 📋 企微培训包 - 下一步操作清单

## ✅ 已完成项目

1. ✅ 从业务仓同步通用客服能力到开发仓
2. ✅ 剔除看房经纪人特定场景
3. ✅ 打包为 Bun 单文件可执行程序
4. ✅ 完整验证启动、配置、监听流程
5. ✅ 编写完整的部署和交付文档
6. ✅ 创建快速验证和测试脚本
7. ✅ **集成语音克隆能力**（方案 A - 完整打包）
   - 完整打包 ffmpeg/wx-voice 依赖（exe 96MB）
   - 调用 Fmode 后端语音合成服务
   - 本地 SILK 编码与企微发送
   - 文档与验证脚本齐全
8. ✅ **真实测试验证**（2026-08-20）
   - 25 项自动化测试全部通过（100%）
   - exe 启动正常，参数解析正确
   - 所有依赖可正常加载和访问
   - Token 配置验证通过
   - 生成完整测试报告

## 🎯 你现在可以做的事

### 选项 1：立即分发（推荐）

```bash
# 1. 打包为 ZIP
cd D:\
zip -r qiwei-training-v1.0.zip qiwei-training\

# 或使用 PowerShell
Compress-Archive -Path D:\qiwei-training -DestinationPath D:\qiwei-training-v1.0.zip

# 2. 上传到你的 CDN/对象存储
# （这一步根据你的实际平台操作）

# 3. 分享下载链接给用户
```

**产物内容**：

- qiwei-workbench.exe (**约 96 MB，含语音克隆能力**)
- 完整资源文件（web/, knowledge/, .env.local 等）
- README.md 用户手册（含语音使用说明）

**用户操作**：

1. 下载解压
2. 双击 exe
3. 按页面提示配置（Token → 订阅 → 扫码 → 监听）

### 选项 2：继续开发/测试

```bash
# 修改代码后重新打包
cd E:\workspace\QIWEI-skill
node scripts/rebuild-and-verify.mjs --target D:\qiwei-training

# 或单独打包
node scripts/build-training-package.mjs --outdir D:\qiwei-training

# 快速验证
powershell -ExecutionPolicy Bypass -File scripts\quick-verify-training-package.ps1 D:\qiwei-training
```

### 选项 3：现场培训准备

**培训前清单**：

- [ ] 确认培训机已安装 **Claude Code**
- [ ] 确认飞马账号余额充足（500元/席位）
- [ ] 释放已占用的企微席位
- [ ] 准备测试白名单客户（企微联系人）
- [ ] 打印或发送用户手册（README.md）
- [ ] **语音克隆准备**：准备 5-30 秒参考录音（清晰、无噪音）

**现场演示流程**：

1. 解压培训包 → 双击启动
2. 在工作台页面粘贴凭据（或预先写入包目录 `.env.local`）
3. 开通席位（演示扣费流程）
4. 扫码登录企微
5. 添加白名单客户
6. 测试客户发送消息
7. 展示智能回复草稿
8. 人工审核并发送
9. **语音克隆演示**：录制 → 合成 → 发送语音消息

## 📁 关键文档位置

### 用户文档

- **用户手册**: `D:\qiwei-training\README.md`
- **交付说明**: `E:\workspace\QIWEI-skill\docs\DELIVERY.md`

### 技术文档

- **部署指南**: `E:\workspace\QIWEI-skill\docs\training-package-deployment-guide.md`
- **验证报告**: `E:\workspace\QIWEI-skill\docs\training-package-verification-report.md`
- **项目总结**: `E:\workspace\QIWEI-skill\docs\PROJECT-SUMMARY.md`
- **语音集成完成报告**: `E:\workspace\QIWEI-skill\docs\voice-integration-completion-report.md`
- **语音部署指南**: `E:\workspace\QIWEI-skill\docs\voice-enabled-training-package.md`
- **语音集成测试报告**: `E:\workspace\QIWEI-skill\docs\voice-integration-test-report.md`

### 开发脚本

- **打包**: `scripts/build-training-package.mjs`
- **重打包**: `scripts/rebuild-and-verify.mjs`
- **验证**: `scripts/quick-verify-training-package.ps1`
- **语音验证**: `scripts/verify-voice-in-training-package.js`
- **语音冒烟测试**: `scripts/voice-training-smoke-test.js`
- **语音模拟测试**: `scripts/test-voice-synthesis-mock.js`
- **完整集成测试**: `scripts/full-voice-integration-test.js`

## 🔧 常用命令速查

```bash
# 打包
node scripts/build-training-package.mjs --outdir D:\qiwei-training

# 重打包（保留凭据和数据）
node scripts/rebuild-and-verify.mjs --target D:\qiwei-training

# 验证
powershell -ExecutionPolicy Bypass -File scripts\quick-verify-training-package.ps1 D:\qiwei-training

# 启动工作台
D:\qiwei-training\qiwei-workbench.exe

# 查看监听状态
D:\qiwei-training\qiwei-workbench.exe runtime status

# 停止监听
D:\qiwei-training\qiwei-workbench.exe runtime stop
```

## ⚠️ 重要提醒

### Token 安全

- `.env.local` 包含敏感 token，**切勿外传**
- 分发前确保 `.env.local` 为空模板
- 用户填写后提醒不要共享

### 数据清理

```bash
# 培训结束后建议清理
del D:\qiwei-training\.env.local
rmdir /s D:\qiwei-training\outputs
```

### 席位管理

- 1 个席位 = 1 个企微账号 = 500元/月
- 同一账号只能 1 个设备登录
- 培训前确认席位可用

## 🐛 故障排查

### 端口被占用

```bash
netstat -ano | findstr 4320
taskkill /PID <进程ID> /F
# 或使用其他端口
qiwei-workbench.exe --port 4321
```

### Token 检测失败

- 检查 `~/.fmode/config.json` 是否存在
- 或在页面手动粘贴 token
- 或预先填写 `.env.local`

### 席位已满

- 联系管理员释放席位
- 或购买更多席位

### 智能回复不生效

- 确认本机已安装 Claude Code
- 确认客户在白名单内
- 确认监听已启动

## 📞 技术支持

### 后端 API 仓库

```
E:\workspace\server\future-server\fmode-server\modules\fmode-qiwei-api
```

### 日志位置

- 工作台日志: 控制台输出
- Runtime 状态: `outputs/runtime/qiwei-runtime.json`
- 会话数据: `outputs/workbench.db` (SQLite)
- 消息归档: `outputs/messages/`

## 🎉 恭喜完成

培训包已经打好，在 **D:\qiwei-training**，可以直接：

1. 双击 `qiwei-workbench.exe` 测试
2. 打包为 ZIP 分发
3. 上传到 CDN 供用户下载

所有功能已验证通过，文档齐全，可以放心交付！

---

**下一步建议**: 打包为 ZIP → 上传 CDN → 通知用户下载