docs(迭代09/10): Tab 设置统一管理 + UI 主题适配 全量文档
迭代09 (R-011 Tab 设置统一管理): - 需求 R-011 (定稿 Q1-Q5) + 需求池索引 - 计划 PLAN-010 + 迭代09 四件套 (目标/技术方案/验收/复盘) - 约束: 产品约束-009 / UI约束-003 / 技术约束-014 - UI约束-002 修订: 通用设置→Tab 设置 迭代10 (R-012 UI 适配 DSH 主题): - 需求 R-012 (定稿: 暂定跟随系统) + 需求池索引 - 计划 PLAN-011 + 迭代10 四件套 - 约束: UI约束-004 (主题适配约定)
This commit is contained in:
@@ -0,0 +1,70 @@
|
||||
# R-011 Tab 设置：统一管理所有 tab（内置 + 策略分组混排，显示/隐藏 + 拖动排序）
|
||||
|
||||
> 状态：**已定稿**（2026-09-02，老师确认 Q1-Q5）｜ 登记日期：2026-09-02
|
||||
> 来源：老师指令（2026-09-02，设置页 tab 化扩展的二次演进）
|
||||
> 优先级：P1（设置体验优化，无数据风险）
|
||||
|
||||
## 需求描述
|
||||
|
||||
设置页的「通用设置」子 tab 升级为 **「Tab 设置」**，成为**统一管理所有会话 tab（系统内置 + 策略分组）的唯一入口**：两类 tab 混排在一张表里，每行提供**显示/隐藏开关** + 通过**拖动**调整顺序；**任何 tab 都不支持重命名与删除**（策略的命名/删除仍在「策略分组」子 tab，内置 tab 名称只读）。
|
||||
|
||||
## 现状（代码审查 2026-09-02）
|
||||
|
||||
| 项 | 现状 |
|
||||
|---|---|
|
||||
| 内置 tab | client/index.js 的 GENERAL_TABS 硬编码 order 10/11/12（全部持仓/交易记录/关注列表），注册时排在策略之前，**不可与策略交错** |
|
||||
| 策略 tab | settings.strategies 数组 {id,name,visible,order}，注册时按 order 排序、从 order 13 起（永远在内置之后） |
|
||||
| 显隐控制 | settings.tabs 布尔对象 {allPositions,tradeRecords,watchlist}（通用设置三个开关）+ 策略各自 visible |
|
||||
| 排序交互 | 「策略分组」子 tab 用 ↑↓ 上下箭头移动策略 |
|
||||
|
||||
**结构性障碍**：两套数据、两套 order 空间（内置 10/11/12，策略 13+），内置永远在策略前，无法混合拖动。
|
||||
|
||||
## 讨论结论（2026-09-02 老师确认）
|
||||
|
||||
- **D1** 策略的「命名」和「删除」**不归 Tab 设置管**：仍在「策略分组」子 tab 操作；「策略分组」里原来的 ↑↓ 排序箭头与显隐开关移除（被 Tab 设置取代）。
|
||||
- **D2** 子 tab 名称 = **「Tab 设置」**（不是「特指」）；管理对象 = 系统内置 tab（标记「内置」）+ 策略分组 tab（标记「策略」），两类混排。
|
||||
- **D3** 策略侧**同步变更**：顺序与显隐统一为**一份数据源**（tabs 有序数组）；策略分组 tab 的展示与 Tab 设置完全一致；删除策略时**联动删除**统一列表中的对应条目。
|
||||
- **D4** 顺序调整用**拖动**（原生 HTML5 Drag & Drop，零新依赖），不用上下箭头；**落点确认后立即持久化**（Q1）。
|
||||
- **D5**（2026-09-02 Q5 修订，原「去掉显隐开关」作废）**Tab 设置只含「显示/隐藏 + 排序」**：所有 tab（内置 + 策略）均有显隐开关与拖动排序；**任何 tab 均不支持重命名与删除**（Q5）。
|
||||
- **D6** 老配置**自动迁移**：现网 tabs 布尔对象 + 策略自带 order/visible → 启动时静默归一化为统一数组，无需用户操作。
|
||||
- **D7** 隐藏边界：接受「没有任何神之一手 tab」的状态（全部隐藏时会话窗不显示任何神之一手 tab，不视为异常）。
|
||||
|
||||
## 目标数据模型（定稿）
|
||||
|
||||
统一 settings.tabs 为**有序数组**（唯一顺序与显隐来源；策略行名称来自 strategies join，自动跟随改名）：
|
||||
|
||||
```js
|
||||
// settings.tabs（定稿）
|
||||
tabs: [
|
||||
{ id: 'tab-all-positions', kind: 'builtin', refKey: 'allPositions', name: '全部持仓', visible: true, order: 0 },
|
||||
{ id: 'tab-trade-records', kind: 'builtin', refKey: 'tradeRecords', name: '交易记录', visible: true, order: 1 },
|
||||
{ id: 'tab-watchlist', kind: 'builtin', refKey: 'watchlist', name: '关注列表', visible: true, order: 2 },
|
||||
{ id: 'tab-strategy-grid-supermarket', kind: 'strategy', refId: 'grid-supermarket', name: '网格超市', visible: true, order: 3 },
|
||||
{ id: 'tab-strategy-manual-t', kind: 'strategy', refId: 'manual-t', name: '手动做T', visible: true, order: 4 },
|
||||
]
|
||||
// strategies 收窄为定义表：{ id, name }（无 visible / order）
|
||||
```
|
||||
|
||||
- 内置行的 name 与常量对齐（防漂移），策略行的 name 来自 strategies join（改名自动跟随，因为只存 refId，Q4）；
|
||||
- **迁移规则**（D6 + Q3）：旧 tabs 布尔对象 → 生成三个内置条目（**保留原显隐**）；旧策略按各自 order 接续追加为策略条目，**旧隐藏的策略迁移后变为显示**（visible=true，Q3）；
|
||||
- 新增策略**追加到列表末尾**（Q2）。
|
||||
|
||||
## 涉及改动面（技术方案，定稿）
|
||||
|
||||
1. **src/settings.js**：tabs 从布尔对象 → 有序数组；新增读取归一化（旧格式自动转新）+ 整表更新（order + visible）；strategies 相关函数收窄（去掉 visible/order 语义）；DEFAULT_TABS 升级为默认顺序数组。
|
||||
2. **src/api/strategies.js**：tabs/update 语义改为整表更新（顺序 + 显隐，拖动落点/开关切换各提交一次）；strategies/add 联动追加 tab 条目（末尾）；strategies/remove 联动删除对应 tab 条目（D3）；废弃 strategies/move；strategies/update 仅剩重命名。
|
||||
3. **src/client/index.js**：合并 registerGeneralTabs + registerStrategyTabs 为统一注册（读 tabs 数组按 order 排序、过滤 visible，builtin 走内置 render、strategy 走 StrategyTab），去掉 10/11/12 与 13+ 硬编码间隔。
|
||||
4. **src/client/views/SettingsSection.jsx**：
|
||||
- 「Tab 设置」子 tab 取代「通用设置」：表格列出全部 tab（内置行带「内置」徽标、策略行带「策略」徽标），每行 = 拖动手柄 + 名称 + **显隐开关**；**无重命名/删除按钮（任何行）**；
|
||||
- 拖动：draggable + onDragStart/onDragOver/onDrop，落点重排 → 立即调 tabs/update 持久化（Q1）→ 刷新（沿用「刷新页面后生效」机制）；
|
||||
- 「策略分组」子 tab 瘦身：只留 新增策略 / 重命名 / 删除（删除确认弹窗 + 份额回未分配沿用），移除排序箭头与显隐开关，加提示「顺序与显示请在「Tab 设置」中调整」。
|
||||
|
||||
## 定稿记录（Q1-Q5，2026-09-02 老师确认）
|
||||
|
||||
- **Q1** 拖动落点确认后**立即持久化**（每次 drop 提交整表）→ 确认。
|
||||
- **Q2** 新增策略默认**追加到列表末尾** → 确认。
|
||||
- **Q3** 迁移时旧「隐藏」的策略**变为显示**（visible=true）→ 确认。
|
||||
- **Q4** 策略改名后 Tab 设置中的名称**自动跟随**（join strategies）；Tab 设置不支持改名，策略名称在「策略分组」改 → 确认。
|
||||
- **Q5** Tab 设置中只有**显示/隐藏 + 排序**，**全部 tab 都不支持重命名与删除** → 确认（同时修订 D5：显隐开关保留）。
|
||||
|
||||
> 三要素满足（边界清楚 / 核心逻辑明确 / 老师确认 Q1-Q5），**已定稿**，可进入计划范围。
|
||||
@@ -0,0 +1,46 @@
|
||||
# R-012 UI 适配 DSH 主题（浅色 / 深色 / 跟随系统）
|
||||
|
||||
> 状态：**已定稿（暂定：跟随系统，语义色映射可再调）**（2026-09-02，老师确认方向「暂定跟随系统」）｜ 登记日期：2026-09-02
|
||||
> 来源：老师指令（2026-09-02）
|
||||
> 优先级：P1（UI 体验）
|
||||
|
||||
## 需求描述
|
||||
|
||||
神之一手插件 UI 适配 DSH 的浅色 / 深色 / 跟随系统主题：将客户端全部硬编码颜色替换为宿主主题 token（`--dsw-*` CSS 变量），插件各页面随 DSH 主题切换自动适配，不自行维护主题偏好（跟随宿主）。
|
||||
|
||||
## 现状（代码审查 2026-09-02）
|
||||
|
||||
- 客户端 10 个文件共 **141 处硬编码颜色**：SettingsSection.jsx 55 / StrategyTab.jsx 24 / TradeRecordsTab.jsx 21 / QmtConnectionChip.jsx 13 / RangeSelector.jsx 7 / PriceCell.jsx 5 / AllPositionsTab.jsx 4 / LoadState.jsx 3 / Toast.jsx 2 / PlaceholderTab.jsx 1；
|
||||
- 宿主机制（已查明）：深色主题时宿主挂 `body[data-ds-dark-theme]`，并注入 `--dsw-*` token（`--dsw-alias-bg-base/layer-1/layer-2`、`label-primary/secondary/tertiary/caption`、`border-l1..l4`、`state-success/error/business-primary`、`brand-primary`、`button-primary-fill/hover`、`button-contrast-fill`、`interactive-bg-hover/active`、`bg-mask-1`、`tooltip-bg` 等），随 light/dark/system 自动切换；
|
||||
- 先例：QmtConnectionChip 部分样式已引用 `var(--dsw-alias-label-secondary, #666)`，token 可用。
|
||||
|
||||
## 决策（2026-09-02 老师确认：暂定跟随系统）
|
||||
|
||||
- **D1** 主题偏好跟随宿主（light/dark/system），插件不自行监听/维护；
|
||||
- **D2** 全部颜色映射到宿主 `--dsw-*` token（语义映射表见下）；涨跌色 A 股红涨绿跌 → 宿主语义：涨=红=`state-error-primary`、跌=绿=`state-success-primary`（宿主在深浅主题下保证可读）；
|
||||
- **D3** 实心主按钮 / 徽标 / 提示底色等语义色（success/error/business）跟随宿主对应 token；淡色底用 `color-mix(in srgb, <primary> 10%, transparent)` 跟随主题；
|
||||
- **D4** 仅做色值 token 化（最小改动），不动布局 / 间距 / 圆角；
|
||||
- **D5** 若宿主 token 观感不满意，后续可加插件级 `--odl-*` 覆盖变量（本迭代不做，暂定）。
|
||||
|
||||
## 语义映射表（实施基准）
|
||||
|
||||
| 原色 | 语义 | 替换 |
|
||||
|---|---|---|
|
||||
| #fff（表面底） | 表格/卡片/弹窗/输入框/菜单/按钮白底 | var(--dsw-alias-bg-layer-1) |
|
||||
| rgba(0,0,0,.4)（遮罩） | 弹窗遮罩 | var(--dsw-alias-bg-mask-1) |
|
||||
| #f5f5f5（hover/静态行底） | 次级面/hover | var(--dsw-alias-interactive-bg-hover) 或 bg-layer-2（静态） |
|
||||
| #e8f5e9/#f1f8f2（激活浅绿底） | 选中/激活 | color-mix(in srgb, var(--dsw-alias-state-success-primary) 10%, transparent) |
|
||||
| #fdecea（错误浅红底） | 错误提示底 | color-mix(in srgb, var(--dsw-alias-state-error-primary) 10%, transparent) |
|
||||
| #e3f2fd（信息浅蓝底） | 信息提示底 | color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent) |
|
||||
| #333/#222 | 主文字 | var(--dsw-alias-label-primary) |
|
||||
| #555/#666 | 次文字 | var(--dsw-alias-label-secondary) |
|
||||
| #888/#999/#aaa | 弱文字/caption | var(--dsw-alias-label-tertiary) |
|
||||
| #1565c0（蓝字） | 业务/信息字 | var(--dsw-alias-state-business-primary) |
|
||||
| #eee（细线） | 行分隔/表头细线 | var(--dsw-alias-border-l1) |
|
||||
| #ddd/#ccc（描边/强调） | 控件描边/分隔 | var(--dsw-alias-border-l2) |
|
||||
| #90caf9/#ce93d8（徽标淡描边） | 徽标描边 | var(--dsw-alias-border-l3)（描边中性化，文字保留语义色） |
|
||||
| #d32f2f/#c62828（红字/实心红） | 涨/错误/删除/危险 | var(--dsw-alias-state-error-primary)；实心底同上，文字 var(--dsw-alias-button-contrast-fill) |
|
||||
| #2e7d32（绿字/实心绿） | 跌/成功/激活/主按钮 | var(--dsw-alias-state-success-primary)；实心底同上，文字 var(--dsw-alias-button-contrast-fill) |
|
||||
| #fff（实心按钮上文字） | 按钮文字 | var(--dsw-alias-button-contrast-fill) |
|
||||
|
||||
> 实施细则：仅 inline style / 变量赋值中的颜色字面量替换；注释中的色值可保留或同步（不影响运行）；个别语义不确定处保留原色并在迭代记录中列出待老师验收。
|
||||
@@ -22,6 +22,8 @@
|
||||
| R-008 | 数据存储管理（JSON → SQLite） | 数据存储从 JSON data store 升级为 SQLite（node:sqlite）：仅存储引擎替换 + strategies/allocation/market_quotes 三表 + 一次性迁移脚本（启动自动迁移）+ JSON 废弃；策略仍存 DSH settings；不建 trades 表（R-007 时再建）。**2026-09-01 定稿（T-008 转正，D1-D8 确认），2026-09-01 完成（迭代 06 验收通过），已归档至 已完成/R-008.md** | 老师指令（2026-09-01，T-008 转正） | P1 | 已定稿 | 2026-09-01 | 06-数据存储SQLite | **已实现（已归档）** |
|
||||
| R-009 | 交易记录本地存储（SQLite）+ 策略关联 | 在 SQLite 新增交易记录表（trade_orders + trade_fills，委托/成交两表），QMT 当日交易数据本地持久化（跨日积累成历史库）；**归属由用户在交易记录 tab 手动设置（trade_orders 冗余存 strategy_id + holding_id，UPSERT 不覆盖归属列，可随时改）**；本地历史查询端点（trades/history 策略过滤）+ 交易记录 tab 策略过滤与历史范围本地展示；QMT code 归一化 + tradeDate 兜底。**2026-09-01 定稿（Q1-Q8 + 二次定稿 Q1-Q4），2026-09-01 完成（迭代 07 验收通过），已归档至 已完成/R-009.md** | 老师指令（2026-09-01） | P1 | 已定稿 | 2026-09-01 | 07-交易记录本地存储SQLite与策略关联 | **已实现（已归档）** |
|
||||
| R-010 | 策略持仓行展开关联交易记录（Holding → 交易汇总） | 策略持仓 tab 每个持仓行（Holding）可展开，展开显示与该 holding 关联的交易记录（仅委托汇总，不分笔成交）；strategy-positions 附加 holding_id + 新增 trades/by-holding 端点 + 持仓行展开 UI + 成本价/最后一笔成交价两列 + 神之一手 tab 隐藏输入框。**2026-09-02 定稿（Q1-Q4 确认），2026-09-02 完成（老师确认），已归档至 已完成/R-010.md** | 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 08-策略持仓行展开关联交易记录 | **已实现（已归档）** |
|
||||
| R-011 | Tab 设置：统一管理所有 tab（内置 + 策略分组混排，显示/隐藏 + 拖动排序） | 设置页「通用设置」升级为「Tab 设置」，统一管理所有会话 tab（系统内置 + 策略分组）的唯一入口：两类混排、**拖动排序**（原生 HTML5 DnD，落点立即持久化）+ **显隐开关**；**任何 tab 均不支持重命名/删除**（策略命名/删除仍在「策略分组」子 tab）；顺序/显隐统一为一份数据源（tabs 有序数组，策略行名 join strategies 自动跟随改名），删除策略联动删除对应条目；新增策略追加末尾；老配置自动迁移（旧隐藏策略迁移后显示）。**2026-09-02 定稿（Q1-Q5 确认）并完成（迭代 09 验收通过）**，详见 docs/05-需求池/R-011.md | 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 09-Tab设置统一管理 | **已实现（迭代 09 完结）** |
|
||||
| R-012 | UI 适配 DSH 主题（浅色 / 深色 / 跟随系统） | 神之一手 UI 适配 DSH 浅色/深色/跟随系统主题：141 处硬编码色值替换为宿主 `--dsw-*` token，随主题自动切换；不自行维护主题偏好（**暂定跟随系统**）；涨跌红涨绿跌 → 宿主 state-error/success；仅色值 token 化不动布局。**2026-09-02 定稿（暂定跟随系统）并完成（迭代 10）**，详见 docs/05-需求池/R-012.md | 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 10-UI主题适配 | **已实现（迭代 10 完结）** |
|
||||
|
||||
## 渐进明细规划素材
|
||||
|
||||
|
||||
Reference in New Issue
Block a user