跳到正文

服务目录 ​

本页是仓库自研服务名称、所属系统、默认端口、启动命令、健康检查和根目录默认启动进程的 唯一文档来源。其他文档只保留场景所需的少量上下文,并链接到本页。

端口取自各模块当前 config.toml、Quasar devServer 与实际健康检查实现;启动命令取自根 package.json。部署时允许覆盖默认值,但必须同步校准调用方、反向代理和防火墙配置。

默认启动组 ​

根目录 bun run dev 通过 concurrently 启动以下 9 个进程:

  1. asr
  2. tts
  3. emotion
  4. audio-fork
  5. esl
  6. flow-api
  7. flow-web
  8. out-api
  9. out-web

阿里云和 Azure 语音网关不属于默认启动组,按需使用各自命令启动。

服务清单 ​

服务所属系统默认监听根目录启动命令健康检查 / 就绪检查
sherpa ASR (Rust 统一服务端)共享语音能力WS 10096;HTTP 10095bun run dev:asrGET http://127.0.0.1:10096/health;GET http://127.0.0.1:10095/health
FunASR ASR (Rust 统一服务端)共享语音能力WS 10099;HTTP 10094bun run dev:funasrGET http://127.0.0.1:10099/health;GET http://127.0.0.1:10094/health
sherpa TTS共享语音能力9080bun run dev:ttsGET http://127.0.0.1:9080/health
Emotion Analysis系统二 / 共享能力9090bun run dev:emotionGET http://127.0.0.1:9090/health
callflow-esl系统一底座 / 系统二执行端ESL 9911;HTTP 9912bun --filter callflow-esl devGET http://127.0.0.1:9912/health
callflow-server系统一9913bun --filter callflow-server devGET http://127.0.0.1:9913/health
callflow-webpage系统一开发服务器 19913bun --filter callflow-webpage devGET http://127.0.0.1:19913/
callout-server系统二 / AI 策略中台9920bun --filter callout-server devGET http://127.0.0.1:9920/health
callout-webpage系统二 / AI 策略前端开发服务器 19920bun --filter callout-webpage devGET http://127.0.0.1:19920/
阿里云 ASR 网关可选云语音兼容层10097bun run dev:aliyun-speechGET http://127.0.0.1:10097/health
阿里云 TTS 网关可选云语音兼容层9081bun run dev:aliyun-speechGET http://127.0.0.1:9081/health
Azure ASR 网关可选云语音兼容层10098bun run dev:azure-speechGET http://127.0.0.1:10098/health
Azure TTS 网关可选云语音兼容层9082bun run dev:azure-speechGET http://127.0.0.1:9082/health
audio_fork_server (Go 全双工网关)语音网关 / 共享能力10091bun run dev:audio-fork:airGET http://127.0.0.1:10091/health

前端根路径是可达性检查,不是独立健康 API。callflow-esl 的 outbound ESL 监听端口与 HTTP 监听端口属于同一进程,只有 HTTP 监听提供 /health。callflow-esl 的健康接口在排空或 Inbound 事件连接未就绪时返回 HTTP 503,状态字段见接口契约。

外部依赖 ​

下列依赖不由 bun run dev 启动,地址与凭据以模块配置为准:

  • FreeSWITCH:ESL 常用端口 8021,媒体和 SIP 端口由 FreeSWITCH 配置决定。
  • PostgreSQL:系统持久化数据(callflow、callout 模式)。
  • Redis:callflow 与 callout 的核心运行时依赖。
  • OpenAI 兼容后端:如 GPUStack / vLLM / Ollama,提供标准 /v1/chat/completions 接口供 callout-server(NLU / Chat / Script)调用。
  • FFmpeg:TTS MP3 流式播放链路(shout://)以及离线 ASR 服务(sherpa-asr-server、funasr-asr-server)的非 WAV 音频转码需要;普通 WAV 离线合成与标准 WAV 离线识别不依赖它。

校验来源 ​

  • 默认进程与命令:根目录 package.json(统一启动脚本与 Bun Workspaces 编排)
  • 应用端口:各模块 config.toml 和前端 quasar.config.ts
  • ONNX 端口:各服务 config.toml
  • HTTP / WebSocket 契约:对应模块 API 或协议专题

修改上述事实时,先更新代码或配置,再同步本页并运行 bun run docs:build。

文档与代码在同一仓库维护,现有 Markdown 是唯一内容源。