feat(ws): split ws-server config and resolve voicebot by device

Author: LiusCraft

README.md

@@ -90,6 +90,24 @@ cp voicebot.example.json data/voicebot.json
 go run cmd/voicebot/main.go
 ```
 
+### 运行 ws-server（独立配置）
+
+```bash
+cp ws-server.example.json data/ws-server.json
+go run cmd/ws-server/main.go -config data/ws-server.json
+```
+
+`ws-server` 配置与本地 `voicebot` 配置分离：
+
+- `data/voicebot.json`：`cmd/voicebot` / `cmd/agent`
+- `data/ws-server.json`：`cmd/ws-server`
+
+`ws-server` 会按 `device-id` 解析会话级 `voicebot` 配置：
+
+- 先查 `voicebot.local_bindings`
+- 未命中则用 `voicebot.default`
+- 若 `voicebot.default` 设为 `null`，未绑定设备会被拒绝（需先绑定）
+
 ## 配置说明
 
 ```json

cmd/ws-server/main.go

@@ -19,18 +19,14 @@ import (
 )
 
 func main() {
-	configPath := flag.String("config", config.DefaultPath, "config file path")
+	configPath := flag.String("config", config.DefaultWSServerPath, "config file path")
 	flag.Parse()
 
-	appConfig, err := config.Load(*configPath)
+	appConfig, err := config.LoadWSServer(*configPath)
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Failed to load config: %v\n", err)
 		os.Exit(1)
 	}
-	if err := appConfig.ValidateKeys(true, true, true); err != nil {
-		fmt.Fprintf(os.Stderr, "Invalid config: %v\n", err)
-		os.Exit(1)
-	}
 
 	if err := logging.Init(logging.Config{
 		Level:  appConfig.Logging.Level,

docs/config.md

@@ -13,6 +13,8 @@
 - 通过 `-config` 参数覆盖默认路径
 - 示例配置: `voicebot.example.json`
 
+> `cmd/ws-server` 使用独立配置：默认路径 `data/ws-server.json`，示例 `ws-server.example.json`。
+
 ## 加载顺序
 
 1. 代码默认值（由各模块 `Default*Config` 提供）
@@ -124,3 +126,27 @@
 - **MCP 工具**：使用完整前缀名称配置（如 `mcp.demo.get_device_status`）。
 - 未配置的工具类型默认为 `query`。
 - Metrics 默认独立端口暴露 `/metrics`，可通过 `bearer_token` 简单鉴权。
+
+## ws-server 独立配置
+
+`cmd/ws-server` 不再直接复用 `voicebot.json`，而是使用独立配置模型：
+
+- `logging` / `server` / `metrics`：服务端运行级配置
+- `voicebot`：会话级配置池（ASR/TTS/LLM/Audio/Tools/Memory）
+
+核心字段：
+
+- `voicebot.default`：默认会话配置（可选）
+- `voicebot.profiles`：按 profile id 管理多个 voicebot 配置
+- `voicebot.local_bindings`：`device-id -> profile-id` 本地绑定
+
+解析规则（当前实现）：
+
+1. 命中 `voicebot.local_bindings[device-id]`，使用对应 profile
+2. 未命中时，若 `voicebot.default` 存在则使用 default
+3. 若 `voicebot.default` 为 `null`（关闭默认配置），则该设备视为未开通，需要绑定后才能接入
+
+说明：
+
+- `voicebot.default` 设置为 `null` 时，服务端不会兜底，未绑定设备会被拒绝。
+- manager 服务（设备与 voicebot 关联管理）尚未实现，当前以本地绑定为准。

docs/voicebot-todo.md

@@ -172,6 +172,10 @@
 - [ ] 实现HTTP API
 - [ ] 客户端SDK
 
+### 16.1 配置与设备管理服务 (优先级: 中)
+- [ ] 设计并实现 manager 服务（管理设备与 voicebot 配置绑定关系）
+- [ ] ws-server 接入 manager 查询（device-id -> voicebot），并支持超时降级策略
+
 ## 优先级说明
 
 - **高**: 核心功能，必须先实现

docs/ws-server-design.md

@@ -37,13 +37,27 @@ S -> C: hello (确认后的 audio_params)
 ## Session 生命周期
 
 1. 建立连接并完成 hello 交换
-2. 初始化音频管线（Mixer + WebSocketSink + AudioOutPipe）
+2. 基于 `device-id` 解析会话级 `voicebot` 配置
+3. 初始化音频管线（Mixer + WebSocketSink + AudioOutPipe）
 3. 监听 JSON / 二进制消息
 4. 断开连接后释放：
    - Orchestrator.Stop()
    - AudioInPipe.Stop()
    - Mixer.Stop()
 
+## 配置分层
+
+- 服务端配置（`server`/`metrics`/`logging`）只负责 WS 服务运行。
+- 会话配置放在 `voicebot` 下，包含 ASR/TTS/LLM/Audio/Tools/Memory。
+
+会话配置解析规则：
+
+1. 先查 `voicebot.local_bindings[device-id]`
+2. 未命中则尝试 `voicebot.default`
+3. 若 `voicebot.default = null`，设备未绑定则拒绝连接（未开通）
+
+> manager 服务（设备绑定查询）当前未接入，后续作为扩展。
+
 ## 依赖
 
 - WebSocket: `github.com/gorilla/websocket`