kyugao
5a723d514e
- 已完成/R-003.md 整合完整讨论记录（与 R-002 归档格式一致） - 删除根目录 R-003.md（已完成需求从根目录移除） - 需求池索引更新 - 新增 R-004 需求登记（老师新开需求）
2.8 KiB
2.8 KiB
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，当前未暴露到配置，使用默认值 |
分析结论：
- 核心只需配置一个 HTTP 地址（baseUrl）—— 插件与 QMT Bridge 的所有通信都基于它（/health、/trade/、/data/ 等 REST 端点）；
- 可选配置一个请求超时（timeoutMs）—— 仅在需要调整超时时才需配置，可提供默认值；
- 当前不需要其他连接参数：无认证（QMT Bridge REST 端点无鉴权）、无账户/密码、无额外 header —— 未来若 QMT Bridge 增加鉴权，再扩展配置字段。
功能范围（初步）
做：
- 设置页新增「QMT 连接配置」子 tab（与现有「通用设置 / 策略分组」并列）；
- 配置 CRUD：
- 新增：名称（识别用，如「本机 QMT」）+ HTTP 地址（必填）+ 请求超时（可选，默认 15000ms）；
- 编辑 / 删除 / 重命名；
- 激活：单选激活，一次只能激活一个；激活的配置为当前生效连接；
- 默认：标记某配置为默认（待确认语义）；
- 生效：激活/修改配置后，插件数据源切换（生效机制待确认，见「待确认问题」）。
不做（初步）：
- 认证/多账户支持（QMT Bridge 当前无鉴权，未来扩展）；
- 连接状态监控（如断线重连策略）—— 后续。
待确认问题（单独讨论）
7 个待确认问题已单独记录于 docs/05-需求池/R-004-待确认问题.md，逐条讨论、逐条收敛，不在此文件内讨论。
- 待确认问题清单：见
R-004-待确认问题.md（Q1-Q7，全部未确认）