From 99fd4ccdf5d410e78a3785375036c34a2132ee04 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期日, 11 十月 2026 01:51:41 +0800
Subject: [PATCH] 新威对外接口改为后端直连管道，撤销机器端取数程序
---
battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java | 15 ++++++++++-----
1 files changed, 10 insertions(+), 5 deletions(-)
diff --git a/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java b/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
index 22b3918..179ccd9 100644
--- a/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
+++ b/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
@@ -21,7 +21,9 @@
/**
* 返回该通道的工步统计。来源有工步层时读设备工步层并原样交出；来源没有工步层时由适配器
- * 从采样段推导（ADR-0067），此时记录里的方向是推导出的方向名称（见 {@link StepRecord}）。
+ * 从采样段推导（ADR-0067）。两种形态的记录里 {@code stepName} 都是**方向名称**
+ * （{@link com.battery.device.api.StepDirectionResolver.Direction#displayName()}）：来源给出工步类型时按该类型解释，
+ * 来源没有类型列时按已核对的列语义判定；判定不出方向时留空，不写默认名。
* 未结束的段不交出，也不推导来源根本没有的工步层。
*/
List<StepRecord> stepRecords(ChannelIdentity channel);
@@ -101,11 +103,14 @@
/**
* 一条设备工步层记录。来源给出工步类型时 {@code stepType} 原样保留（新威为数字枚举），
- * 方向由调用方按该类型解释，适配器不按电流符号改写它。
+ * 适配器不按电流符号改写它。
*
- * <p>来源**没有**工步类型列时（推式来源的厂商库里既没有工步层也没有循环汇总表，ADR-0067），
- * 适配器交出的是按已核对列语义判定出的方向名称（{@code charge} / {@code discharge} / {@code rest}），
- * 判定不出来时留空；此时该工步的其余一切仍是设备采样行上的原文事实。
+ * <p>{@code stepName} 是**方向名称**（`充电` / `放电` / `搁置`，ADR-0067 §4b）：来源给出工步类型时
+ * 按该类型解释（新威的 {@code 1}/{@code 2}/{@code 4}），来源没有类型列时（推式来源的厂商库里既没有
+ * 工步层也没有循环汇总表，ADR-0067）按已核对列语义判定。方向判不出来时留空——**不是设备给的名称**，
+ * 界面据此标注来源，调用方不得用默认名把未知说成已知。
+ *
+ * <p>来源没有工步层时，除方向名称外该工步的其余一切仍是设备采样行上的原文事实。
*
* <p>{@code endVoltageV} 与 {@code endCurrentA} 是该工步结束时的设备读数。
* {@code capacityAh} 与 {@code energyWh} 是该工步自身累计的单项值，只在方向已确认时给出；
--
Gitblit v1.7.1