one_divine_lot/docs/02-计划/计划-Tab设置统一管理.md

计划：Tab 设置——统一管理所有会话 tab（内置 + 策略分组，显示/隐藏 + 拖动排序）（阶段航点）

编号：PLAN-010 ｜ 粒度：阶段航点（大粒度） ｜ 创建：2026-09-02 ｜ 状态：执行中 派生自终极目标：目标-002（分仓管理工具）、目标-003（按策略监控市场） 依据需求：R-011（已定稿，2026-09-02，Q1-Q5 确认） —— 符合入范围门槛 设计约束：产品约束-009、UI约束-003、技术约束-014（R-011 新增沉淀）、技术约束-004/005/006（沿用）

目标

将设置页「通用设置」升级为 「Tab 设置」，成为所有会话 tab（系统内置 + 策略分组）唯一的顺序与显隐入口：两类 tab 混排一张表，每行 = 拖动手柄 + 名称 + 显示/隐藏开关；任何 tab 均不支持重命名与删除；拖动落点立即持久化。

范围

做：

1. 数据模型统一（src/settings.js）：settings.tabs 从布尔对象 → 有序数组 [{id, kind: builtin|strategy, refKey|refId, name, visible, order}]；strategies 收窄为 {id, name}；读取时旧格式静默归一化（旧 tabs 布尔对象 → 三个内置条目保留原显隐；旧策略按 order 接续追加，旧隐藏策略迁移后 visible=true）；新增整表更新（顺序 + 显隐）；DEFAULT_TABS 升级为默认数组；
2. API 层（src/api/strategies.js）：tabs/update 语义改为整表更新（顺序 + 显隐）；strategies/add 联动追加 tab 条目（末尾）；strategies/remove 联动删除对应 tab 条目；废弃 strategies/move；strategies/update 仅剩重命名；
3. 客户端注册（src/client/index.js）：合并 registerGeneralTabs + registerStrategyTabs 为统一注册（读 tabs 数组按 order 排序、过滤 visible；builtin 走内置 render、strategy 走 StrategyTab），移除硬编码 order 间隔（10/11/12 与 13+）；
4. 设置页 UI（src/client/views/SettingsSection.jsx）：
   • 「Tab 设置」子 tab 取代「通用设置」：混排表格，内置行「内置」徽标、策略行「策略」徽标；每行 = 拖动手柄 + 名称 + 显隐开关；无任何重命名/删除按钮；
   • 拖动：原生 HTML5 Drag & Drop，落点重排 → 立即调 tabs/update 持久化 → 提示「刷新页面后生效」；
   • 「策略分组」子 tab 瘦身：只留 新增/重命名/删除，移除排序箭头与显隐开关，加提示「顺序与显示请在「Tab 设置」中调整」。

不做：

• 策略的命名/删除入口迁移（仍在「策略分组」子 tab）；
• 内置 tab 的重命名/删除（禁）；
• tab 注册热更新（沿用「刷新页面后生效」机制，无事件机制）；
• 其他设置子 tab（QMT 连接配置）改动（仅 UI约束-002 文案「通用设置」→「Tab 设置」对齐）。

程序结构

src/
├── settings.js                # 改：tabs 有序数组 + 归一化迁移 + 整表更新；strategies 收窄
├── api/strategies.js          # 改：tabs/update 整表；add/remove 联动 tabs；废弃 move
src/client/
├── index.js                   # 改：统一注册（读 tabs 数组）
└── views/SettingsSection.jsx  # 改：「Tab 设置」子 tab + 拖动排序 + 策略分组瘦身

实现步骤

1. 文档骨架：PLAN-010 + 迭代 09 文档（本步）；
2. settings.js：tabs 有序数组 schema + DEFAULT_TABS + 归一化（getTabs 旧格式转新）+ updateTabs 整表 + strategies 收窄（去 visible/order 读写）；
3. api/strategies.js：tabs/update 整表语义；strategies/add 追加 tab；strategies/remove 联动删 tab；废弃 move（API 表 + handler）；
4. client/index.js：统一注册函数（读 tabs 数组），移除硬编码 order；
5. SettingsSection.jsx：「Tab 设置」子 tab（混排表格 + 徽标 + 显隐开关 + 拖动排序 + 立即持久化）；策略分组子 tab 瘦身；
6. 构建测试：pnpm run build + typecheck + 独立数据目录回归（技术约束-011，注意只读端点可直连、写操作走临时目录）；
7. 验收 + 复盘。

验收要点

• 「通用设置」子 tab 更名为「Tab 设置」，表格混排内置 + 策略全部 tab；
• 内置行带「内置」徽标、策略行带「策略」徽标；
• 每行可拖动排序，落点立即持久化（刷新页面后生效）；
• 每行有显示/隐藏开关，切换立即持久化；
• 任何行均无重命名/删除按钮；
• 策略分组子 tab 只留 新增/重命名/删除，无排序箭头/显隐开关，有指引提示；
• 新增策略出现在 Tab 设置列表末尾；删除策略后对应 tab 条目消失；
• 老配置（布尔对象 tabs + 策略 order/visible）读取时自动归一化，无报错、无数据丢失；
• 会话 tab 栏按新顺序与显隐注册（内置与策略可交错）；
• 现有功能不回归（全部持仓/交易记录/策略持仓/QMT 切换）。