From 5a399051467445a0186fbc788e4c3a0bafe6824b Mon Sep 17 00:00:00 2001
From: xiaosi <2652281683@qq.com>
Date: Mon, 31 Aug 2026 09:37:14 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=20TDesign=20Wave=20B?=
 =?UTF-8?q?=20=E6=8C=89=E9=92=AE=E4=B8=8E=E5=88=86=E9=A1=B5=E8=BF=81?=
 =?UTF-8?q?=E7=A7=BB=E8=AE=BE=E8=AE=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

覆盖标准按钮映射、真分页/假分页策略与按页并行切分。
---
 .../2026-08-28-tdesign-shell-wave-b-design.md | 83 +++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-08-28-tdesign-shell-wave-b-design.md

diff --git a/docs/superpowers/specs/2026-08-28-tdesign-shell-wave-b-design.md b/docs/superpowers/specs/2026-08-28-tdesign-shell-wave-b-design.md
new file mode 100644
index 0000000..8e4b936
--- /dev/null
+++ b/docs/superpowers/specs/2026-08-28-tdesign-shell-wave-b-design.md
@@ -0,0 +1,83 @@
+# TDesign 全面替换 — Wave B（按钮体系 + 分页）
+
+## 背景
+
+Wave A 已完成全局 Toast/Confirm、业务 `t-dialog`、Monitor 搜索/勾选。全站仍以原生 `<button>` 为主（约 150+ 模板开口），仅 `LoginView` 使用 `t-button`；无 `t-pagination`，分页为手写 `table-footer`。
+
+目标方向不变：**基本上都使用组件库，除非特定**。
+
+## 目标
+
+1. 管理页与常规壳层的标准命令按钮迁到 `t-button`。
+2. 真分页迁到 `t-pagination`（Users / Firmwares / OpLogs / Account）。
+3. Devices 假分页换成 `t-pagination` 展示形态（不改后端，不假装可翻页成功）。
+4. `TasksView` 删除任务的 `window.confirm` 收口到 `ui.confirm`。
+
+## 非目标
+
+- 不改后台 API / pageSize 契约。
+- 不做 Wave C（Tab/分段、`t-table`）。
+- 不做完整主题 token 重绘。
+- **永久保留原生：**
+  - Monitor 地图底图切换（`.map-type` 卫星/地图）
+  - Monitor / Control 强定制飞行控制条（workflow / stage / quick-actions / `control-command`）
+  - `LivePlayer` 覆盖层 `play-control`
+- Login 方式切换 tab 若仍是分段按钮，本轮可暂留；正式 Tab 归 Wave C。
+
+## 按钮映射
+
+| 旧 class / 角色 | TDesign |
+|-----------------|---------|
+| `primary-command` / 主操作 | `t-button` `theme="primary"` |
+| `plain-command` / `cancel` / 次操作 | `t-button` `variant="outline"`（或 `theme="default"`） |
+| `icon-command` / 仅图标刷新等 | `t-button` `shape="square"` `variant="outline"`，内容保留原 SVG/`t-icon` |
+| `table-text-action` / `text-button` / 行内文字操作 | `t-button` `variant="text"` `theme="primary"`（危险操作可用 `theme="danger"`） |
+| 弹窗 footer 取消/确认 | 同上 outline / primary；`loading`/`disabled` 对齐现逻辑 |
+
+约定：
+
+- 优先保留原 `@click` / `:disabled` / 文案；不改业务语义。
+- 不引入 `AppButton` 封装层（避免本轮额外抽象）。
+- 必要的密度/间距用页面 `:deep` 或既有 class 挂在 `t-button` 上微调，不回退到原生 button。
+
+## 分页映射
+
+### 真分页（替换）
+
+| 页面 | 现态 | 目标 |
+|------|------|------|
+| `UsersView` | `table-footer`，`pageSize=20` | `t-pagination`：`v-model:current` ↔ `pageNum`，`:total`，`:page-size="pageSize"`，`@change`/`@current-change` 触发 `load` |
+| `FirmwaresView` | `pageSize=10` | 同上 |
+| `OperationLogsView` | `pageSize=20` | 同上 |
+| `AccountView` | 4 处「上一页/下一页」（orders/usage/sim/simRecharge） | 各一块 `t-pagination`，绑定既有 `*PageNum` / `*Total` / pageSize=10 |
+
+### 假分页
+
+- `DevicesView`：现 footer 固定第 1 页且前后禁用。改为 `t-pagination`：`total` 用当前列表长度或接口 total（若无则列表 length），`page-size` 足够大或 `disabled`/`page-size` 等于 total，**不发假翻页请求**。若体验上“只有一页”，可隐藏分页（`v-if="total > pageSize"`）；本轮允许直接隐藏。
+
+### 无分页 UI（不动）
+
+- Tasks / Alarms / Media 等 `pageSize=100` 一次拉全：本轮不新增分页。
+
+## 执行切分（按页并行）
+
+1. **B1** Users + OpLogs + Firmwares：工具栏/行操作按钮 + 真分页  
+2. **B2** Devices + Account + `DockEditModal`：标准按钮 + Devices 假分页处理 + Account 多段分页  
+3. **B3** Tasks / Alarms / Media / System / Replay / SideMenu / DeviceDetail / TopBar（常规按钮；不含飞行控制与 map-type）  
+4. **B4** `TasksView` `window.confirm` → `ui.confirm`  
+5. **验收** 浏览器抽检 + 静态扫描
+
+Monitor/Control 飞行控制与 map-type **明确排除**，不进入 B3。
+
+## 验收
+
+1. 目标页常规 `primary/plain/icon/text` 命令按钮为 `t-button`；无对应旧 class 的原生 button（保留清单除外）。  
+2. Users / Firmwares / OpLogs / Account 分页为 `t-pagination`，翻页仍拉数。  
+3. Monitor `.map-type`、Monitor/Control 飞行控制、`LivePlayer` play-control 仍为原生。  
+4. 删除任务走 `ui.confirm`，无 `window.confirm`。  
+5. 登录、监控指令下发主路径不回归。
+
+## 后续
+
+- **Wave C：** Tab/分段 + `t-table`（含 Login 方式切换若仍原生）。
+- 可选：Devices 真分页接后端；控制条视觉 token 化评估。