docs: R003 归档整理(讨论记录整合入归档,根目录清理)

- 已完成/R-003.md 整合完整讨论记录(与 R-002 归档格式一致)
- 删除根目录 R-003.md(已完成需求从根目录移除)
- 需求池索引更新
- 新增 R-004 需求登记(老师新开需求)
This commit is contained in:
2026-08-29 16:45:56 +08:00
parent cba31428dc
commit 5a723d514e
5 changed files with 185 additions and 113 deletions
+48
View File
@@ -0,0 +1,48 @@
# R-004 QMT 连接配置(多配置管理)· 初步需求草稿
> 状态:**讨论中**(初步草稿,待老师确认后定稿)| 登记日期:2026-08-28
> 来源:老师指令(2026-08-28
> 关联:docs/05-需求池/需求池索引.mdR-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,全部未确认)