From fa4112201b158b5e554d6ec7285ba41a8f168f93 Mon Sep 17 00:00:00 2001
From: xiaosi <2652281683@qq.com>
Date: Mon, 31 Aug 2026 15:03:54 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E8=B7=AF=E7=BA=BF?=
 =?UTF-8?q?=E5=9B=BE=E5=B9=B6=E5=A2=9E=E5=8A=A0=20DeviceDetail=20=E5=8D=A1?=
 =?UTF-8?q?=E7=89=87=E8=AE=A1=E5=88=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

P0 Monitor 收口完成，进入状态矩阵/环境卡抽离。
---
 ...26-08-28-device-detail-status-env-cards.md | 23 ++++++++++
 ...-28-strong-custom-ui-extraction-roadmap.md | 12 +++---
 ...8-device-detail-status-env-cards-design.md | 43 +++++++++++++++++++
 3 files changed, 72 insertions(+), 6 deletions(-)
 create mode 100644 docs/superpowers/plans/2026-08-28-device-detail-status-env-cards.md
 create mode 100644 docs/superpowers/specs/2026-08-28-device-detail-status-env-cards-design.md

diff --git a/docs/superpowers/plans/2026-08-28-device-detail-status-env-cards.md b/docs/superpowers/plans/2026-08-28-device-detail-status-env-cards.md
new file mode 100644
index 0000000..4dfec97
--- /dev/null
+++ b/docs/superpowers/plans/2026-08-28-device-detail-status-env-cards.md
@@ -0,0 +1,23 @@
+# DeviceDetail Status/Env Cards Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 抽出状态矩阵与环境监测展示组件。
+
+**Spec:** `docs/superpowers/specs/2026-08-28-device-detail-status-env-cards-design.md`
+
+### Task 1
+
+- Create `src/components/DeviceStatusMatrix.vue`
+- Create `src/components/DeviceEnvironmentValues.vue`
+- Modify `DeviceDetailView.vue`：机巢 overview 两处改用组件；页面用 computed 组装 items
+
+Commit: `refactor: 抽取 DeviceDetail 状态矩阵与环境卡`
+
+### Task 2 冒烟（Main）
+
+设备详情 overview：status-matrix / environment-values 仍在；无 console error。
+
+## 约束
+
+跳过全量测试；精确 git add；中文 commit
diff --git a/docs/superpowers/plans/2026-08-28-strong-custom-ui-extraction-roadmap.md b/docs/superpowers/plans/2026-08-28-strong-custom-ui-extraction-roadmap.md
index 6536381..15891f8 100644
--- a/docs/superpowers/plans/2026-08-28-strong-custom-ui-extraction-roadmap.md
+++ b/docs/superpowers/plans/2026-08-28-strong-custom-ui-extraction-roadmap.md
@@ -16,19 +16,19 @@
 | MonitorDeviceList | 左侧设备列表 |
 | MonitorMapChrome | 地图工具条/图例/比例尺 |
 | useCommandProgress | 指令进度状态机 composable |
+| useMonitorLive | 直播会话 composable |
 
 ## 进行中 / 待做（严格按序）
 
 ### P0 Monitor 收口
 
-1. **[当前冒烟后] useMonitorLive（可选）** — join/leave/heartbeat；`MonitorView` script 仍偏大时做
-2. P0 收口后更新本表「已完成」
+~~P0 已完成~~
 
 ### P1 其它大页薄抽离
 
-3. **DeviceDetail 状态/环境卡**（若模板仍大段内联 article）
-4. **Tasks 非编辑器区**剩余列表壳（RouteCard 已完成则跳过）
-5. **Login 非验证码区**若仍有可抽展示块再评估
+1. **[当前] DeviceDetail 状态矩阵 + 环境卡**
+2. **Tasks 非编辑器区**剩余列表壳（RouteCard 已完成则跳过）
+3. **Login 非验证码区**若仍有可抽展示块再评估
 
 ### P2 明确不做
 
@@ -47,6 +47,6 @@
 
 ## 完成定义
 
-- Monitor 模板仅剩 layout 壳 + 组件拼装 + 1 个 dialog 级入口
+- Monitor 模板仅剩 layout 壳 + 组件拼装 + dialog 入口
 - 无「等用户说继续」的停顿
 - 每次用户会话恢复：读本文件，从第一个未勾选项继续
diff --git a/docs/superpowers/specs/2026-08-28-device-detail-status-env-cards-design.md b/docs/superpowers/specs/2026-08-28-device-detail-status-env-cards-design.md
new file mode 100644
index 0000000..59c2abf
--- /dev/null
+++ b/docs/superpowers/specs/2026-08-28-device-detail-status-env-cards-design.md
@@ -0,0 +1,43 @@
+# DeviceDetail 状态矩阵与环境卡设计
+
+## 目标
+
+从 `DeviceDetailView` 概览页抽出两个薄展示组件：
+
+1. `DeviceStatusMatrix.vue` — `.status-matrix`（机巢运行状态 6 格）
+2. `DeviceEnvironmentValues.vue` — `.environment-values`（环境监测 6 格）
+
+页面继续算 `doorText` / `withUnit` / `booleanText` 等，组件只收**已格式化**的条目。
+
+## 契约
+
+### DeviceStatusMatrix
+
+```js
+items: Array<{ icon: string, label: string, value: string, ok?: boolean }>
+```
+
+可选 emit：无（纯展示）。外层 `data-section` + title 仍可由页面包，或组件带可选 `title` + `action` slot。
+
+推荐：组件只渲染 matrix 本体；section 壳留页面，改动最小。
+
+### DeviceEnvironmentValues
+
+```js
+items: Array<{ icon: string, label: string, value: string }>
+```
+
+## 非目标
+
+- 不抽充电系统 value-table、绑定卡、drone 概览（可后续）
+- 不迁 rt()/doorValue 计算
+
+## 实现
+
+1. 两组件 + DeviceDetailView overview 机巢分支接线
+2. Commit: `refactor: 抽取 DeviceDetail 状态矩阵与环境卡`
+3. 冒烟：打开某机巢详情概览，矩阵/环境格可见
+
+## 约束
+
+精确 git add；中文 commit