kyugao
5a723d514e
- 已完成/R-003.md 整合完整讨论记录（与 R-002 归档格式一致） - 删除根目录 R-003.md（已完成需求从根目录移除） - 需求池索引更新 - 新增 R-004 需求登记（老师新开需求）
49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
# 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，全部未确认）
|