文档导航总览

本页是 ai-voice-platform 的跨项目文档入口。根 docs/ 只维护项目认知、服务目录、开发测试、 部署、演示、排障、发布升级和文档规范；模块配置、HTTP / WebSocket 契约与业务示例留在对应 模块目录，与代码共同演进。

仓库内置 docs-site/ VitePress 文档站，直接读取现有 Markdown，不复制正文：

bun run docs:dev
bun run docs:build

项目认知

• 识别链路：FreeSWITCH mod_audio_fork 将 16kHz 单声道 PCM16 推送到流式 ASR， callflow-esl 接收识别事件并驱动业务。
• 播报链路：callflow-esl 调用 TTS，FreeSWITCH 通过 WAV、audio_fork:// PCM 流或 shout:// MP3 流播放。
• 系统一：通话底座与管理面，包含 callflow-esl、ASR / TTS / NLU、管理 API 和管理前端。
• 系统二：智能外呼与协同，包含外呼调度、流程脚本、坐席、转人工、质检、情绪分析与结果闭环。

快速入口

• 项目总览
• 服务目录：服务名称、归属、默认监听、启动命令、健康检查与默认启动组。
• 演示环境
• 开发测试（Windows 11）
• 部署与运行
• 部署网络拓扑与配置：跨主机调用链、地址规划、防火墙、 FreeSWITCH / WebRTC / FRP / 多 cell 配置与验收。
• 生产部署与落地
• WebRTC 音视频排障与避坑指南：WebRTC / Verto 音视频秒断、超时排查与前端视频防黑屏渲染规范。
• 故障排查
• 发布与升级
• 源码仓库访问与授权：GitCode 私有仓库访问、版本基线、Git LFS、权限撤销及许可与资产边界。
• 文档规范
• 发布说明
• 部署资产边界
  • FreeSWITCH 容器化部署包：通用基线镜像包与五篇专题 （网络与 NAT、 SIP Profiles 与外呼网关、 核心模块与 AI 语音集成、 模块配置详解、 业务集成与拨号计划）。
  • 阿里云公网节点部署
  • WSL 计算集群部署
  • 浏览器软电话 ICE / TURN 指南

模块文档入口

系统一

• callflow-esl
  • 配置参考
  • HTTP 与运行时接口
  • 会议生命周期与对账自愈体系
  • 业务、组件与场景导航
• callflow-server
• callflow-webpage

系统二

• callout-server (外呼调度、坐席协同与 AI 策略中台)
  • 配置参考
  • 运行与后台任务
  • 三栏一体化 AI 话术策略工作台
  • LLM 推理引擎架构与多模型协同
  • 浏览器软电话与坐席 SIP 接入
  • API、生命周期、流程脚本、软电话与转人工导航
• callout-webpage (外呼管理与「AI 策略中心」前端)

本地与云端语音能力

• ONNX 平台总览
• FunASR ASR 服务 (Rust 统一服务端)
• Sherpa ASR 服务 (Rust 统一服务端)
• Sherpa TTS 语音合成服务 (Rust 统一服务端)
• 情绪分析服务 (Rust 统一服务端)
• sherpa demo
• 云语音网关总览
• audio-fork-server (Go 全双工音频网关)
• 阿里云语音网关
• Azure 语音网关

建议查找顺序

1. 首次接入：项目总览 → 服务目录 → 开发测试或部署手册。
2. 配置变更：模块 README → 模块配置专题 → 实际 config.toml。
3. 接口联调：模块 API / 协议专题 → 模块集成专题。
4. 运行异常：故障排查 → 受影响模块的运行专题。
5. 发布升级：发布与升级 → 发布说明 → 源码仓库访问与授权。

文档事实归属和提交检查见文档规范。