# 技术实现方案：09-Tab 设置统一管理

> 迭代编号：09 ｜ 依据：PLAN-010、R-011、产品约束-009、UI约束-003、技术约束-014

## 1. 数据模型（src/settings.js）

### 1.1 tabs 有序数组（新 schema）

```js
tabs: z.array(z.object({
  id: z.string().required(),        // 唯一 id：'tab-all-positions' / 'tab-strategy-<id>'
  kind: z.enum(['builtin', 'strategy']).required(),
  refKey: z.string().optional(),    // builtin 专用：'allPositions' | 'tradeRecords' | 'watchlist'
  refId: z.string().optional(),     // strategy 专用：策略 id
  name: z.string().required(),      // 展示名（策略行 join 时刷新）
  visible: z.boolean().default(true),
  order: z.number().default(0),
})).default(DEFAULT_TABS)
```

### 1.2 归一化迁移（读取时）

getTabs(scope) 逻辑：
- 读取 settings.tabs：若为数组 → 直接返回（按 order 排序）；
- 若为旧布尔对象（或缺失）→ 生成默认内置三条（全部持仓/交易记录/关注列表，保留原显隐值），策略按 strategies 旧 order 接续追加（旧 hidden → visible=true）；
- 首次写入时落库归一化后的数组（幂等，不重复迁移）。

### 1.3 strategies 收窄

strategies schema 去掉 visible/order（仅 {id, name}）；getStrategies 不再排序/过滤 visible；策略展示名统一由 getTabs join strategies 得出（Q4 自动跟随改名）。

## 2. API 层（src/api/strategies.js）

| 端点 | 变更 |
|---|---|
| tabs | 返回合并后的完整 tabs 数组（含策略行 name join） |
| tabs/update | 整表更新 { tabs }（顺序 + 显隐）；策略行 name 由服务端 join 刷新，客户端可只传 id 顺序 |
| strategies/add | 联动 append tab 条目（末尾，order = max+1） |
| strategies/remove | 联动删除对应 tab 条目（refId === 策略 id） |
| strategies/move | **废弃**（从 METHODS 移除） |
| strategies/update | 仅剩重命名（联动刷新 tabs 中策略行 name） |

## 3. 客户端注册（src/client/index.js）

合并 registerGeneralTabs + registerStrategyTabs → registerAllFromTabs(tabs)：
```js
const sorted = tabs.slice().sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
for (const t of sorted) {
  if (t.visible === false) continue;
  const render = t.kind === 'builtin' ? GENERAL_RENDER[t.refKey] : (props) => createElement(StrategyTab, { ...props, strategyId: t.refId, strategyName: t.name });
  // slots.register conversation.view, order: t.order
}
```
- GENERAL_RENDER = { allPositions, tradeRecords, watchlist } 映射常量；
- 移除硬编码 order 10/11/12 与 13+ 间隔（直接用 t.order）；
- fetchTabConfig → fetchTabs 返回数组。

## 4. 设置页 UI（src/client/views/SettingsSection.jsx）

### 4.1 「Tab 设置」子 tab

- 子 tab 导航：general → tabs（更名），标签「Tab 设置」；
- 表格列：拖动手柄（≡）｜ 名称（内置行带「内置」徽标、策略行带「策略」徽标）｜ 显示（Switch）；
- **无重命名/删除按钮（任何行）**；
- 拖动（原生 DnD）：
  - tr draggable，onDragStart 记 id；onDragOver 阻止默认 + 计算插入位；onDrop 重排数组；
  - 落点 → 立即调 tabs/update（整表提交）→ 提示「已保存，刷新页面后生效」；
- 显隐开关：切换 → 立即调 tabs/update → 提示。

### 4.2 策略分组瘦身

- 移除排序箭头列（↑↓）与显示列（Switch）；
- 保留：新增输入框 + 新增按钮 / 重命名 / 删除（确认弹窗 + 份额回未分配沿用）；
- 顶部加提示：顺序与显示请在「Tab 设置」中调整。

## 5. 兼容与风险

- **迁移**：读取归一化幂等；旧策略 visible=false 迁移后 visible=true（Q3，产品约束-009 一致）；
- **名称 join**：tabs 存 refId，展示时 join strategies；策略改名后 tabs 行 name 自动跟随（Q4）；
- **注册**：refresh = 刷新页面重载插件（无事件机制，沿用）；
- **RPC**：strategies/move 废弃需同步移除客户端调用（settings UI 不再有箭头）；
- **回归**：技术约束-011 —— 写操作测试用独立数据目录（ODL_TEST_DATA_DIR / dataDir 参数）。