Inicio Explorar Ayuda
Iniciar sesión
18307996893
/
QIWEI-skill
1
0
Fork 0
Archivos Incidencias 0 Pull Requests 0 Wiki
Rama: master
Ramas Etiquetas
QIWEI-skill
/
NEXT-STEPS.md

NEXT-STEPS.md 5.8 KB
Permalink Histórico Raw

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

✅ 已完成项目

  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：立即分发（推荐）

# 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：继续开发/测试

# 修改代码后重新打包
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

🔧 常用命令速查

# 打包
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 为空模板
  • 用户填写后提醒不要共享

数据清理

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

席位管理

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

🐛 故障排查

端口被占用

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 → 通知用户下载