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 (主题适配约定)
2026-09-02 14:01:08 +08:00
parent 4ac8a29805
commit f1e7e785a1
16 changed files with 536 additions and 1 deletions
@@ -0,0 +1,61 @@
 # 计划：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 切换）。
@@ -0,0 +1,55 @@
 # 计划：UI 适配 DSH 主题（浅色 / 深色 / 跟随系统）（阶段航点）
 > 编号：PLAN-011 ｜ 粒度：阶段航点 ｜ 创建：2026-09-02 ｜ 状态：**执行中**
 > 派生自终极目标：目标-001（神之一手工具集）
 > 依据需求：**R-012（已定稿，2026-09-02，暂定跟随系统）** —— 符合入范围门槛
 > 设计约束：UI约束-003（Tab 设置）、UI约束-002（QMT 卡片）沿用；本次新增色值 token 化约定
 ## 目标
 神之一手客户端 UI 全部硬编码色值替换为宿主 `--dsw-*` token，使各页面在 DSH 浅色 / 深色 / 跟随系统主题下均可读、协调，随主题切换自动适配，不自行维护主题偏好。
 ## 范围
 **做**：
 1. 客户端 10 个文件 141 处硬编码颜色按语义映射表替换为 `var(--dsw-*)` 或 `color-mix`（随主题淡色底）；
 2. 确认 QmtConnectionChip 已用 token 与硬编码混杂处统一；
 3. 涨跌色（红涨绿跌）→ 宿主 state-error/success；主按钮 / 徽标 / 提示底色 → 宿主语义 token + color-mix；
 4. 构建 + typecheck + 深浅主题人工验收。
 **不做**：
 - 自定义 `--odl-*` 覆盖 token（D5 暂缓）；
 - 布局 / 间距 / 圆角改动；
 - 服务端 / API / 数据改动；
 - 插件自维护主题偏好（跟随宿主）。
 ## 涉及文件
 ```
 src/client/views/
 ├── SettingsSection.jsx    # 55 处（最大）
 ├── StrategyTab.jsx        # 24
 ├── TradeRecordsTab.jsx    # 21
 ├── QmtConnectionChip.jsx  # 13（部分已 token）
 ├── RangeSelector.jsx      # 7
 ├── PriceCell.jsx          # 5（涨跌色）
 ├── AllPositionsTab.jsx    # 4
 ├── LoadState.jsx          # 3
 ├── Toast.jsx              # 2
 └── PlaceholderTab.jsx     # 1
 ```
 ## 实现步骤
 1. **文档骨架**：PLAN-011 + 迭代 10（本步）；
 2. **批量替换**：按文件逐处替换（先小文件确认模式，再大文件）；
 3. **验证**：build + typecheck；人工切 DSH 浅/深主题检查各页；
 4. **验收 + 复盘**。
 ## 验收要点
 - 浅色主题下观感与现状基本一致（无突兀色差）；
 - 深色主题下所有页面可读（背景/文字/边框/按钮/涨跌/徽标/提示/下拉菜单均协调）；
 - 跟随系统切换实时生效；
 - 无残留硬编码色（#xxx / rgb / rgba 全部清理，注释可留）；
 - 布局与交互不变（仅色值）。
@@ -10,7 +10,10 @@
 | 编号 | 约束说明 | 添加日期 | 生效状态 | 失效日期 | 最后一次变更描述 |
 |---|---|---|---|---|---|
 | UI约束-001 | 会话头部 QMT 连接切换 chip：紧凑形态 `QMT: <激活配置名> ▾`，与 PTC 模式标签并排；下拉菜单列出全部配置（当前激活项勾选标记），点选即激活；操作结果用顶部轻提示反馈（成功绿/失败红，约 3s 消失，沿用现有 Toast 体系） | 2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q9/Q10 确认的头部控件形态 |
-| UI约束-002 | 设置页「QMT 连接配置」子 tab：与「通用设置 / 策略分组」并列的第三个子 tab；配置以**卡片形式**展示（自适应网格 minmax(260px,1fr)，激活卡片绿色描边）：卡片含名称 + 激活/默认徽标 + HTTP 地址 + 行内操作（激活 / 设为默认 / 编辑 / 测试连接 / 删除）+ 新增/编辑表单（纵排两字段）；删除沿用现有确认弹窗模式，删除最后一条时给出禁止提示；超时不设输入框（Q5）；长文本（地址/错误信息）单行省略 + 悬停看全文，组件设 minWidth:0 防撑行 | 2026-08-29 | 生效 | - | 变更（2026-08-29 老师反馈）：列表形式改卡片形式，约束组件宽度、长文本省略不换行；原定稿：设置页子 tab 形态沿用现有设置交互体系 |
+| UI约束-002 | 设置页「QMT 连接配置」子 tab：与「Tab 设置 / 策略分组」并列的第三个子 tab；配置以**卡片形式**展示（自适应网格 minmax(260px,1fr)，激活卡片绿色描边）：卡片含名称 + 激活/默认徽标 + HTTP 地址 + 行内操作（激活 / 设为默认 / 编辑 / 测试连接 / 删除）+ 新增/编辑表单（纵排两字段）；删除沿用现有确认弹窗模式，删除最后一条时给出禁止提示；超时不设输入框（Q5）；长文本（地址/错误信息）单行省略 + 悬停看全文，组件设 minWidth:0 防撑行 | 2026-08-29 | 生效 | - | 变更（2026-08-29 老师反馈）：列表形式改卡片形式，约束组件宽度、长文本省略不换行；原定稿：设置页子 tab 形态沿用现有设置交互体系；变更（2026-09-02 R-011 定稿）：「通用设置」更名为「Tab 设置」 |
 | UI约束-003 | 设置页「Tab 设置」子 tab：表格列出**全部会话 tab（系统内置 + 策略分组）混排**，内置行带「内置」徽标、策略行带「策略」徽标；每行 = 拖动手柄（原生 HTML5 Drag & Drop）+ 名称 + 显示/隐藏开关；**任何行均无重命名/删除按钮**；拖动落点确认后**立即持久化**（每次 drop 提交整表，沿用「刷新页面后生效」提示机制）；「策略分组」子 tab 只保留 新增/重命名/删除，移除排序箭头与显隐开关，并提示「顺序与显示请在「Tab 设置」中调整」 | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1/Q4/Q5 确认）：拖动排序 + 显隐开关，禁重命名/删除 |
 | UI约束-004 | 神之一手 UI 适配 DSH 主题：所有颜色引用宿主 `--dsw-*` token（带 fallback `var(--dsw-alias-xxx, #原色)`），随 DSH 浅色 / 深色 / 跟随系统自动切换，不自行维护主题偏好（跟随宿主）；语义映射：表面底→bg-layer-1、次级面→bg-layer-2、hover→interactive-bg-hover、主/次/弱文字→label-primary/secondary/tertiary、边框→border-l1..l4、红（涨/删/错）→state-error-primary、绿（跌/成/激活）→state-success-primary、蓝（信息/业务）→state-business-primary、实心按钮字→button-contrast-fill、遮罩→bg-mask-1、阴影→shadow-lv3；淡底用 color-mix(in srgb, var(--语义色) 10-12%, transparent)；禁止硬编码色值（#hex/rgb）进运行代码 | 2026-09-02 | 生效 | - | R-012 定稿（2026-09-02，暂定跟随系统）+ 迭代 10 实施：141 处硬编码色 token 化，宿主机制实证（body[data-ds-dark-theme] + alias token 双值定义） |
 <!-- 示例条目（确认格式后删除）：
 | UI约束-001 | 示例：求签页面必须保持单屏完整，不出现滚动 | 2026-08-26 | 生效 | - | 讨论确认：移动端优先，避免滚动打断仪式感 |
@@ -18,6 +18,7 @@
 | 产品约束-006 | QMT 连接会话头部快捷切换：会话窗口顶栏（PTC 模式标签旁）常驻下拉控件（chip 显示 `QMT: <激活配置名>`），点开列出全部配置（激活项勾选），点选即激活并轻提示反馈；头部控件仅做切换，配置管理（增删改/测试连接/默认标记）仍在设置页子 tab | 2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q9/Q10 确认（入口=会话头部 PTC 旁，菜单仅切换激活） |
 | 产品约束-008 | 交易记录支持**按策略过滤**：交易记录 tab 提供策略过滤下拉（全部 / 各策略 / 未关联），对今日（QMT 实时）与历史（本地 SQLite）均生效；策略归属 = 委托时间 join 持仓生命周期窗口推导（一码多策略取份额最大，未命中=未关联）；历史范围展示本地积累数据（不再「接口开发中」占位） | 2026-09-01 | 生效 | - | 新增（2026-09-01 R-009 定稿 + 迭代 07 实施）：策略过滤 + 历史本地展示 |
 | 产品约束-009 | 会话 tab 统一由「Tab 设置」管理：设置页「Tab 设置」子 tab 是**所有会话 tab（系统内置 + 策略分组）的唯一顺序与显隐入口**，两类 tab 混排；每行 = 拖动排序 + 显示/隐藏开关；**任何 tab 均不支持重命名与删除**（内置 tab 名称只读，策略命名/删除仍在「策略分组」子 tab）；策略改名后 Tab 设置中的名称自动跟随（只存引用）；新增策略默认追加到列表末尾；删除策略联动删除 Tab 设置中对应条目；顺序与显隐唯一数据源 = settings.tabs 有序数组 | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1-Q5 确认）：Tab 设置 = 显示/隐藏 + 拖动排序（落点立即持久化），全 tab 禁重命名/删除 |
 <!-- 示例条目（确认格式后删除）：
 | 产品约束-001 | 示例：求签功能必须保证抽取结果的不可预测性 | 2026-08-26 | 生效 | - | 讨论确认：为保证公平性，抽取必须不可预测 |
 -->
@@ -23,6 +23,7 @@
 | 技术约束-009 | 会话头部快捷切换控件挂载 DSH 开放 slot `conversation.session.header.actions`（多实例挂载点，按 order 排序多插件共存）：客户端插件以独立 id 并排注册（DSH 内置 PTC 标签 order=-10，本控件 order=-9），不改动 DSH 宿主；控件经 ConnectionProvider 包装复用现有 RPC 通道与 /odl/api/* 端点 | 2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q9 确认；宿主代码审查核实 slot 机制与内置插件注册方式 |
 | 技术约束-013 | 交易记录本地存储（R-009）：QMT 当日交易数据（委托/成交）由服务端 TradeSync 定时同步落 SQLite（启动预热 + 60s 定时 + UPSERT 幂等，只同步当日）；trade_orders（委托主行，order_id 主键 + insert_ts 派生时间列 + **strategy_id/holding_id 手动归属列**）+ trade_fills（成交明细，trade_id 主键、order_id 外键）两表；**委托归属由用户在交易记录 tab 手动设置**（候选 = 该 code 当前持仓策略 + 未关联，全手动选、可随时改、以最终为准）；**UPSERT 不覆盖归属列**（手动指定为插件逻辑）；本地历史查询走 trades/history 端点（策略过滤 = 用户设置的归属）；今日实时仍走 QMT Bridge；QMT 委托/成交 code 无后缀、持仓带后缀 —— 数据源映射层统一 normalizeInstrumentCode 归一化；委托交易日 = insertDate（tradeDate 兜底） | 2026-09-01 | 生效 | - | 新增（2026-09-01 R-009 定稿 + 迭代 07 实施）：两表 + 定时同步 + 本地历史查询；变更 1（2026-09-01）：+code 归一化 + tradeDate 兜底；变更 2（2026-09-01 老师二次定稿）：归属改**手动设置**（trade_orders 冗余 strategy_id+holding_id，UPSERT 不覆盖归属列），弃算法推导 |
 | 技术约束-014 | 会话 tab 注册与顺序显隐（R-011）：客户端注册统一读 **settings.tabs 有序数组**（唯一顺序与显隐来源，内置条目 refKey + 策略条目 refId），按 order 排序、过滤 visible 后注册（builtin 走内置 render、strategy 走 StrategyTab），移除硬编码 order 间隔（原内置 10/11/12、策略 13+）；settings.tabs 从布尔对象升级为有序数组，读取时对旧格式（布尔对象 + 策略自带 order/visible）静默归一化迁移（旧隐藏策略迁移后显示），写入即落库；策略定义表收窄为 {id,name}（去除 visible/order）；tabs/update 语义改为整表更新（顺序 + 显隐），strategies/add 联动追加 tab 条目（末尾），strategies/remove 联动删除对应 tab 条目，废弃 strategies/move | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1-Q5 确认）：统一 tabs 有序数组 + 自动迁移 + 联动增删 |
 <!-- 示例条目（确认格式后删除）：
 | 技术约束-001 | 示例：技术栈以 Node.js / TypeScript 为准，不引入未讨论的新框架 | 2026-08-26 | 生效 | - | 讨论确认：优先复用 DSH 既有能力，新框架需论证 |
 -->
@@ -0,0 +1,82 @@
 # 技术实现方案：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 参数）。
@@ -0,0 +1,41 @@
 # 迭代复盘：09-Tab 设置统一管理（内置 + 策略分组，显示/隐藏 + 拖动排序）
 > 复盘日期：2026-09-02 ｜ 迭代状态：**已完成（老师确认）**
 > 关联需求：R-011（Tab 设置：统一管理所有 tab，已定稿 Q1-Q5）
 > 关联计划：PLAN-010（计划-Tab设置统一管理）
 ## 结果
 迭代 09 达成：设置页「通用设置」升级为「Tab 设置」，成为所有会话 tab（系统内置 + 策略分组）**唯一的顺序与显隐入口**：两类 tab 混排一张表，每行 = 拖动手柄（原生 HTML5 DnD）+ 名称（内置带「内置」徽标、策略带「策略」徽标）+ 显示/隐藏开关；**任何 tab 均不支持重命名与删除**；拖动落点立即持久化；策略分组子 tab 瘦身为 新增/重命名/删除。
 ## 过程事实
 1. **需求定稿（R-011）**：老师提出设置页默认 tab 与策略 tab 一起排序（内置标记、不可重命名/删除）→ AI 分析现状（两套数据、两套 order 空间，内置恒在策略前）→ 提出统一 tabs 有序数组方案 → 老师确认 D1-D7 + Q1-Q5（拖动落点立即持久化 / 新增追加末尾 / 旧隐藏策略迁移后显示 / 名称 join 自动跟随 / 全部 tab 禁重命名删除）；
 2. **数据层（settings.js）**：tabs 从布尔对象 → 统一有序数组（kind: builtin|strategy + refKey/refId + visible + order）；strategies 收窄为 {id, name}；旧格式读取时静默归一化迁移（schema union 兼容存量 + normalizeTabs 转换）；addStrategy/removeStrategy 联动 tabs；
 3. **API 层（strategies.js）**：tabs/update 语义改整表（顺序 + 显隐）；strategies/add 联动追加 tab（末尾）；strategies/remove 联动删除 tab 条目；废弃 strategies/move；
 4. **客户端注册（client/index.js）**：合并 registerGeneralTabs + registerStrategyTabs 为统一注册（读 tabs 数组按 order 排序、过滤 visible，builtin 走内置 render、strategy 走 StrategyTab），移除硬编码 order 间隔（10/11/12 与 13+）；
 5. **设置页 UI（SettingsSection.jsx）**：「Tab 设置」子 tab（混排表格 + 徽标 + 显隐开关 + 拖动排序 + 落点立即持久化）；策略分组瘦身（移除排序箭头与显隐开关，加指引提示）；
 6. **验证**：回归测试 35 项全通过（scripts/test-r011-tabs.mjs 数据层 23 项 + test-r011-api.mjs API 层 12 项）+ 真实 schema resolve 验证（旧配置归一化正确）+ 构建 + typecheck 通过。
 ## 经验教训（复盘沉淀）
 ### 1. schemastery 无 z.enum / .optional()，schema 兼容存量用 z.union 双分支
 - schemastery 只有 z.union([z.const(...), ...]) 无 z.enum，可选字段不调 .required() 即可；
 - **关键**：DSH settings 的 resolve 会用 schema 校验存量 user 层——新 schema 直接替换会导致旧配置（布尔对象 tabs）校验失败、插件启动报错；
 - **沉淀**：settings schema 变更必须先验证存量兼容——用 z.union 双分支（旧格式 + 新格式），旧值通过校验、读取时再归一化；改动 settings schema 前跑 schema-resolve 测试。
 ### 2. 读取时归一化 + schema 双分支 = 无感迁移
 - 本次没有写一次性迁移脚本，而是「schema 接受旧格式 + normalizeTabs 读取时转新」：存量用户升级零操作、零报错；
 - 归一化结果在首次写操作（updateTabs/add/remove）时落库为数组，之后自然持久化；
 - **沉淀**：settings 结构变更优先「schema 兼容 + 读取归一化」而非迁移脚本，符合 R-006/R-008 的迁移经验（幂等、无需用户操作）。
 ### 3. 前端字符串与 JSX 引号冲突
 - 写 JSX 组件代码时，代码里同时有 JS 单双引号与 JSX 属性引号，用模板字符串包整段时内部反引号/插值冲突，多次报错；
 - **沉淀**：批量生成代码用数组 join（每行独立字符串），避免模板字符串嵌套转义地狱。
 ## 遗留/后续
 1. **Tab 设置拖动交互**：当前实现为整行 draggable（原生 DnD），落点插入到目标行位置；后续可优化为拖动手柄专属拖拽 + 拖拽中的视觉反馈（插入线）；
 2. **关注列表 tab**：仍为占位（PlaceholderTab），后续迭代实现；
 3. **迁移落库时机**：旧配置首次读取不落库（纯读），首次写操作时才持久化新数组——如老师希望启动即落库可加一次性迁移（当前行为无感知差异，可接受）；
 4. **多 DSH 实例/多用户**：tabs 顺序为全局设置（非按会话），符合现状（strategies 亦为全局）。
@@ -0,0 +1,26 @@
 # 迭代目标：09-Tab 设置统一管理（内置 + 策略分组，显示/隐藏 + 拖动排序）
 > 迭代编号：09 ｜ 创建：2026-09-02 ｜ 状态：进行中
 > 依据计划：PLAN-010 ｜ 需求：R-011（已定稿，2026-09-02，Q1-Q5 确认）
 ## 目标描述
 将设置页「通用设置」升级为「Tab 设置」，成为所有会话 tab（系统内置 + 策略分组）**唯一的顺序与显隐入口**：两类 tab 混排一张表，每行 = 拖动手柄 + 名称 + 显示/隐藏开关；任何 tab 均不支持重命名与删除；拖动落点立即持久化。
 ## 目标分解
 1. **数据模型统一**（settings.js）：tabs 布尔对象 → 有序数组，旧格式自动归一化；strategies 收窄为 {id, name}；
 2. **API 层**（api/strategies.js）：tabs/update 整表（顺序 + 显隐）；strategies/add 联动追加 tab；strategies/remove 联动删除 tab；废弃 strategies/move；
 3. **客户端注册**（client/index.js）：合并为统一注册，读 tabs 数组（order 排序 + visible 过滤），移除硬编码 order；
 4. **设置页 UI**（SettingsSection.jsx）：「Tab 设置」子 tab（混排 + 徽标 + 显隐开关 + 拖动排序）+ 策略分组瘦身（仅 新增/重命名/删除 + 指引提示）。
 ## 讨论过程
 - 2026-09-02 老师提出需求：设置页默认几个 tab 与策略 tab 一起排序，内置标记、不可重命名/删除；
 - 2026-09-02 AI 分析现状（两套数据/两套 order 空间），提出统一 tabs 有序数组方案；
 - 2026-09-02 老师确认 D1-D7：Tab 设置只做 显示/隐藏 + 排序（拖动），策略命名/删除留策略分组；
 - 2026-09-02 老师确认 Q1-Q5：拖动落点立即持久化 / 新增追加末尾 / 旧隐藏策略迁移后显示 / 名称 join 自动跟随 / 全部 tab 禁重命名删除，R-011 定稿。
 ## 对老师的配合需求
 - 验收时验证：拖动排序落点立即生效（刷新后 tab 栏按新顺序）；显隐开关切换后刷新生效；策略分组瘦身后的新增/重命名/删除仍正常；老配置自动迁移无报错。
@@ -0,0 +1,26 @@
 # 验收标准：09-Tab 设置统一管理
 > 迭代编号：09 ｜ 依据：PLAN-010 验收要点 + R-011 定稿
 ## 验收标准线
 1. 「通用设置」子 tab 更名为「Tab 设置」，表格混排内置 + 策略全部 tab；
 2. 内置行带「内置」徽标、策略行带「策略」徽标；
 3. 每行可拖动排序，落点**立即持久化**（刷新后会话 tab 栏按新顺序，内置与策略可交错）；
 4. 每行有显示/隐藏开关，切换立即持久化（刷新后隐藏的 tab 消失/显示的出现）；
 5. **任何行均无重命名/删除按钮**；
 6. 策略分组子 tab 只留 新增/重命名/删除，无排序箭头/显隐开关，有指引提示；
 7. 新增策略出现在 Tab 设置列表末尾；删除策略后对应 tab 条目消失（份额回未分配沿用）；
 8. 老配置（布尔对象 tabs + 策略 order/visible）读取自动归一化，无报错、无数据丢失；
 9. 会话 tab 栏按新顺序与显隐注册；
 10. 现有功能不回归（全部持仓/交易记录/策略持仓/QMT 切换/删除策略份额回退）。
 ## 验收方法
 - 构建：pnpm run build + typecheck 通过；
 - 单元/回归脚本：独立数据目录跑策略 CRUD + tabs 读写（技术约束-011）；
 - 手动（需 DSH 运行 + 老师确认）：设置页 Tab 设置拖动排序 / 显隐切换 / 策略分组瘦身 / 老配置迁移；会话 tab 栏顺序与显隐验证。
 ## 验收目标
 - 全部 10 条验收标准线通过，迭代 09 标记「验收通过」，R-011 实现状态更新，归档流程走查。
@@ -0,0 +1,43 @@
 # 技术实现方案：10-UI 适配 DSH 主题
 > 迭代编号：10 ｜ 依据：PLAN-011、R-012
 ## 1. 主题机制（已查明）
 - 宿主深色主题挂 `body[data-ds-dark-theme]`；
 - 宿主注入 `--dsw-*` CSS 变量（定义在宿主 runtime，随 light/dark/system 切换）；
 - 插件内联 style 直接引用 `var(--dsw-alias-xxx)` 即可自动适配。
 ## 2. 语义映射（实施基准，来自 R-012）
 ```
 背景:      #fff(表面) → var(--dsw-alias-bg-layer-1)
 遮罩:      rgba(0,0,0,.4) → var(--dsw-alias-bg-mask-1)
 hover面:   #f5f5f5 → var(--dsw-alias-interactive-bg-hover)
 激活绿底:  #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 → 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)
 红(涨/错/删): #d32f2f/#c62828 → var(--dsw-alias-state-error-primary)
 绿(跌/成/主): #2e7d32 → var(--dsw-alias-state-success-primary)
 实心按钮字: #fff → var(--dsw-alias-button-contrast-fill)
 ```
 ## 3. 替换细则
 - 替换范围：inline style 对象、模板字符串中的颜色字面量；
 - `color-mix(in srgb, var(--xxx) 10%, transparent)` 用于需要「淡底 + 文字同色」的提示/激活态；
 - 带透明度的原色（如 rgba(255,215,0,.5) 价格闪动高亮）保留动画语义，改 `color-mix(in srgb, var(--dsw-alias-state-warn-primary) 50%, transparent)`；
 - 注释中色值仅作说明可保留（不影响运行，验收时以无运行色为准）；
 - 每文件替换后 `node --check` 校验 JSX 语法。
 ## 4. 风险
 - **语义偏差**：个别颜色无法精确定位语义 → 保留原色并在验收清单标注，交老师确认；
 - **color-mix 兼容性**：现代浏览器（Chrome 111+/Safari 16.2+）支持，DSH 目标为 Chromium 系，可接受；
 - **fallback**：`var(--xxx, <原色>)` 提供兜底，宿主 token 缺失时视觉不变（更安全）。
@@ -0,0 +1,38 @@
 # 迭代复盘：10-UI 适配 DSH 主题（浅色 / 深色 / 跟随系统）
 > 复盘日期：2026-09-02 ｜ 迭代状态：**已完成（老师确认）**
 > 关联需求：R-012（UI 适配 DSH 主题，已定稿：暂定跟随系统）
 > 关联计划：PLAN-011（计划-UI主题适配）
 ## 结果
 迭代 10 达成：神之一手客户端 11 个文件共 141 处硬编码颜色全部替换为宿主 `--dsw-*` token（含 fallback），插件在 DSH 浅色 / 深色 / 跟随系统主题下自动适配；不自行维护主题偏好（跟随宿主）；仅色值 token 化，布局与交互不变。
 ## 过程事实
 1. **需求定稿（R-012）**：老师提出适配 DSH 浅/深/系统主题 → AI 查明宿主机制（body[data-ds-dark-theme] + --dsw-* token，深色挂 data-ds-dark-theme、alias token 双值定义）→ 老师确认「暂定跟随系统」（D1-D5 + 语义映射表）；
 2. **替换实施**：PriceCell / LoadState / Toast / PlaceholderTab / RangeSelector / AllPositionsTab / StrategyTab / TradeRecordsTab / QmtConnectionChip / SettingsSection 共 10 文件（+market 目录无颜色）；
 3. **语义映射执行**：白底→bg-layer-1、淡灰底→bg-layer-2、hover→interactive-bg-hover、主/次/弱文字→label-primary/secondary/tertiary、边框→border-l1/l2/l3/l4、红（涨/删/错）→state-error-primary、绿（跌/成/激活）→state-success-primary、蓝（信息/业务）→state-business-primary、实心按钮字→button-contrast-fill、遮罩→bg-mask-1、阴影→shadow-lv3；
 4. **淡色底**：激活/提示底色用 color-mix(in srgb, var(--语义色) 10-12%, transparent)，深浅主题自适应；
 5. **验证**：typecheck + build 通过；headless Chrome 实证宿主 token 系统完整（238 处 dsw-alias 引用、浅/深双值定义、data-ds-dark-theme 选择器）；残留硬编码色 = 0。
 ## 经验教训（复盘沉淀）
 ### 1. 宿主主题机制：body[data-ds-dark-theme] + --dsw-* token（已实证）
 - DSH 主题不是 data-theme 属性切换，而是宿主在深色时给 body 挂 `data-ds-dark-theme`，token 以「alias 链 → static 值」双主题注入（light: neutral-bluish-00 白系；dark: neutral-bluish-875 深系）；
 - **沉淀**：插件适配宿主主题只须引用 `var(--dsw-alias-xxx, fallback)`，fallback 保证 token 缺失时浅色可用；不要自建主题偏好。
 ### 2. var() 带 fallback 是安全的迁移策略
 - 每处替换写成 `var(--dsw-alias-xxx, #原色)`：宿主 token 定义齐全时自动适配；万一某 token 缺失（宿主版本差异），退回原浅色值不破相；
 - **沉淀**：对宿主 token 的依赖一律带 fallback，兼容宿主版本演进。
 ### 3. 批量替换的 edit 冲突处理
 - 多个相同 style 片段（如表头、输入框、删除按钮）导致 old_string 多处匹配：用 replace_all 处理真正相同的模式，或用带上下文的更精确 old_string；
 - **沉淀**：批量替换前先 grep 去重确认唯一性，相同模式直接用 replace_all，不同上下文逐条处理。
 ## 遗留/后续
 1. **语义色待老师验收**：深色下个别语义色（state-error 红 / state-success 绿在深色底的对比度、紫/蓝徽标）观感需老师切主题确认；若个别不满意可后续加 `--odl-*` 覆盖（D5 暂缓项）；
 2. **color-mix 兼容性**：现代 Chromium 支持；若遇旧内核浏览器个别淡底失效，fallback 无（color-mix 无 fallback 语法）——可后续降级处理；
 3. **Toast 样式**：随宿主语义色变化，实心绿/红底 + 白字在深色下对比度已由 token 保证；
 4. **shadows**：boxShadow 用了 shadow-lv3 token（宿主完整 shadow 值），个别较浅卡片阴影在深色下可能几乎不可见——可后续微调。
@@ -0,0 +1,18 @@
 # 迭代目标：10-UI 适配 DSH 主题（浅色 / 深色 / 跟随系统）
 > 迭代编号：10 ｜ 创建：2026-09-02 ｜ 状态：进行中
 > 依据计划：PLAN-011 ｜ 需求：R-012（已定稿，2026-09-02，暂定跟随系统）
 ## 目标描述
 神之一手客户端 UI 全部硬编码色值替换为宿主 `--dsw-*` token，使插件在 DSH 浅色 / 深色 / 跟随系统主题下均可读、协调，随主题自动切换。
 ## 目标分解
 1. 10 个文件 141 处硬编码色按语义映射替换为宿主 token / color-mix；
 2. 涨跌红涨绿跌 → 宿主 state-error/success；主按钮/徽标/提示底色 → 宿主语义色；
 3. 构建 + typecheck + 深浅主题人工验收。
 ## 对老师的配合需求
 - 验收：DSH 设置切换 浅色/深色/跟随系统，检查各页面可读性与协调性。
@@ -0,0 +1,22 @@
 # 验收标准：10-UI 适配 DSH 主题
 > 迭代编号：10 ｜ 依据：PLAN-011 验收要点 + R-012
 ## 验收标准线
 1. 浅色主题下插件各页面观感与现状基本一致（无突兀色差）；
 2. 深色主题下所有页面可读（背景/文字/边框/按钮/涨跌/徽标/提示/下拉菜单协调）；
 3. DSH 设置切换 浅色/深色/跟随系统 实时生效；
 4. 涨跌色（红涨绿跌）在深浅两主题下均醒目可辨；
 5. 运行代码无残留硬编码色（#xxx / rgb / rgba），注释可留；
 6. 布局与交互不变（仅色值）；
 7. build + typecheck 通过。
 ## 验收方法
 - build + typecheck；
 - 老师切 DSH 浅/深主题人工检查：设置页（Tab 设置/策略分组/QMT 卡片）、全部持仓、交易记录、策略持仓、会话头部 QMT chip 下拉、Toast。
 ## 验收目标
 - 7 条验收线通过，迭代 10 标记「验收通过」，R-012 更新实现状态。
@@ -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 完结）** |
 ## 渐进明细规划素材