# R-004 QMT 连接配置（多配置管理）· 初步需求草稿

> 状态：**讨论中**（初步草稿，待老师确认后定稿）｜ 登记日期：2026-08-28
> 来源：老师指令（2026-08-28）
> 关联：docs/05-需求池/需求池索引.md（R-004）

## 需求概述

在神之一手的**设置页面**新增一个子 tab「QMT 连接配置」，用于管理多个 QMT Bridge 连接配置：

- **多配置管理**：可维护多个连接配置（增 / 删 / 改 / 查）；
- **一次只能激活一个**：从多个配置中单选激活一个，被激活的配置为当前生效连接；
- **可设置默认**：标记某配置为默认（语义待确认，见「待确认问题」）。

## 现状分析：插件当前使用的 QMT 连接信息

> 通过代码审查得出（src/data-source/qmt-bridge-rest.js、src/index.js、cordis.patch.yml）：

| 配置项 | 当前值 | 是否必配 | 说明 |
|---|---|---|---|
| **HTTP 基础地址（baseUrl）** | `http://192.168.3.43:8610` | **是（唯一必配）** | 由宿主 cordis.patch.yml 注入 `config.qmtBaseUrl`；数据源所有 REST 请求基于此地址 |
| **请求超时（timeoutMs）** | 15000ms | 否（有默认值） | 代码常量 REQUEST_TIMEOUT_MS=15000，当前未暴露到配置，使用默认值 |

**分析结论**：
1. **核心只需配置一个 HTTP 地址**（baseUrl）—— 插件与 QMT Bridge 的所有通信都基于它（/health、/trade/*、/data/* 等 REST 端点）；
2. **可选配置一个请求超时**（timeoutMs）—— 仅在需要调整超时时才需配置，可提供默认值；
3. **当前不需要其他连接参数**：无认证（QMT Bridge REST 端点无鉴权）、无账户/密码、无额外 header —— 未来若 QMT Bridge 增加鉴权，再扩展配置字段。

## 功能范围（初步）

**做**：
1. 设置页新增「QMT 连接配置」子 tab（与现有「通用设置 / 策略分组」并列）；
2. **配置 CRUD**：
   - 新增：名称（识别用，如「本机 QMT」）+ HTTP 地址（必填）+ 请求超时（可选，默认 15000ms）；
   - 编辑 / 删除 / 重命名；
3. **激活**：单选激活，**一次只能激活一个**；激活的配置为当前生效连接；
4. **默认**：标记某配置为默认（待确认语义）；
5. **生效**：激活/修改配置后，插件数据源切换（生效机制待确认，见「待确认问题」）。

**不做（初步）**：
- 认证/多账户支持（QMT Bridge 当前无鉴权，未来扩展）；
- 连接状态监控（如断线重连策略）—— 后续。

## 待确认问题（单独讨论）

> 7 个待确认问题已单独记录于 **docs/05-需求池/R-004-待确认问题.md**，逐条讨论、逐条收敛，不在此文件内讨论。

- [ ] 待确认问题清单：见 `R-004-待确认问题.md`（Q1-Q7，全部未确认）