# Xunzhi Media Domain

> AI-Meeting 媒体与实时通信知识 Skill。用于处理实时语音转写、WebSocket 推送、心跳、错误通知、长文本 TTS 和消息协议；当需求命中 `/api/xunzhi/v1/xunfei/**`、`/api/xunzhi/v1/websocket/**` 或 `@ServerEndpoint` 实时链路时使用。

- Skill: `lishuangqiang/xunzhi-media-domain` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add lishuangqiang/xunzhi-media-domain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lishuangqiang/xunzhi-media-domain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: lishuangqiang (https://skillmd.com/u/lishuangqiang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lishuangqiang/xunzhi-media-domain

---


# xunzhi-media-domain

## 使用顺序

- 再看 `references/object-dictionary.md`，确认连接对象、转写对象、TTS 对象的真相源。
- 先看 `references/api-map.md`，确认是 WebSocket、转写还是 TTS。
- 再看 `references/realtime-asr.md`，理解实时转写会话与消息协议。
- 再看 `references/websocket-notification.md`，理解服务器推送的消息类型。
- 最后看 `references/tts.md` 和 `references/gotchas.md`。

## 关键入口

- `admin/src/main/java/com/hewei/hzyjy/xunzhi/media/api/WebSocketController.java`
- `admin/src/main/java/com/hewei/hzyjy/xunzhi/media/api/XunfeiTtsController.java`
- `admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/websocket/AudioTranscriptionWebSocketHandler.java`
- `admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/integration/XunfeiAudioService.java`
- `admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/integration/XunfeiLongTextTtsService.java`

## 必守约束

- WebSocket 连接 session 和业务 `sessionId` 不是一回事，不能混写。
- WebSocket 转写必须先鉴权，再进入转写会话。
- 同一个 session 不能无限叠加多个转写上下文。
- 心跳、开始、停止、状态查询的协议字段必须前后端一致。
- 长文本 TTS 的任务创建和查询是两条不同的生命周期。

## 参考资料

- `references/object-dictionary.md`
- `references/api-map.md`
- `references/realtime-asr.md`
- `references/websocket-notification.md`
- `references/tts.md`
- `references/gotchas.md`