chronaxis 0.1.0.dev0__py3-none-any.whl

chronaxis/configuration/resolution.py

@@ -0,0 +1,150 @@
+"""按请求生成可独立加载的有效配置；只读配置，不读取业务输入。"""
+from copy import deepcopy
+from dataclasses import asdict
+from pathlib import Path
+
+from . import load_configuration, parse_configuration
+from .file_tools import path_fields,validate_document,serialize_configuration,output_format,write_new_configuration
+
+
+def _duration(value):
+    """纳秒用整数文本输出，不经浮点。参数: int。返回: 时长str。异常: 无。"""
+    return str(value)+'ns'
+
+
+def _interval(choice):
+    """输出合法间隔对象，不为actual/dbc补伪周期。参数: IntervalChoice。返回: dict。异常: 无。"""
+    result={'mode':choice.mode}
+    if choice.step_ns is not None:result['value']=_duration(choice.step_ns)
+    if choice.driver is not None:result['driver']=choice.driver
+    return result
+
+
+def _signal_defaults(raw,plan):
+    """复用当前编译的信号事实；只在展开或内部复核副本填写，不再读DBC。"""
+    from ..planning.signal_groups import declared_signals
+    for signal,typed in zip(declared_signals(raw['signals']),plan.signals):
+        signal.setdefault('dtype',typed.definition.dtype.value)
+        signal.setdefault('unit',typed.definition.unit)
+        if typed.definition.dtype.value=='enum':
+            signal.setdefault('choices',[list(pair) for pair in typed.definition.choices])
+
+
+def _analysis_defaults(raw,plan):
+    """显式化已编译模型的适用默认值。参数: 独立原生配置、计划。返回: None。异常: 内部契约错误。
+
+    只填写实际有含义且可重新加载的字段；不猜单位/方向/阈值，不写无关规则参数或DBC周期。
+    """
+    _signal_defaults(raw,plan)
+    raw.setdefault('execution',{}).update(asdict(plan.execution))
+    raw.setdefault('diagnostics',{}).update(asdict(plan.diagnostics))
+    outputs=raw.setdefault('outputs',{})
+    for key in ('tables','manifest','contributions'):outputs.setdefault(key,getattr(plan.outputs,key))
+    for key in ('signal_csv','can_frames'):
+        option=getattr(plan.outputs,key)
+        if option is None:outputs.setdefault(key,None);continue
+        item=outputs[key];item.setdefault('scope',option.scope)
+        grid=option.spec.resampling if key=='signal_csv' else option.resampling
+        if grid is not None:item['resampling'].setdefault('origin',_duration(grid.origin_ns))
+        if key=='can_frames':
+            item.setdefault('source_time_reference',option.spec.source_time_reference)
+            item.setdefault('output_offset',_duration(option.spec.output_offset_ns))
+    for index,(source,typed) in enumerate(zip(raw['sources'],plan.sources)):
+        # --defaults展开有效来源默认值；普通resolve仍保留用户简写。
+        from ..planning.input_defaults import source_defaults
+        source.update(source_defaults(source,index,inferred_type=typed.source_type))
+        source['time'].setdefault('offset','0s')
+        if typed.source_type=='signal_csv':
+            for key in ('encoding','delimiter'):source.setdefault(key,getattr(typed.config,key))
+            source.setdefault('missing_values',list(typed.config.missing_values))
+        elif typed.source_type in ('can_blf','can_asc','asc_or_blf','raw_can_csv'):
+            source.setdefault('reader_options',{}).setdefault('decode_policy',typed.config.decode_policy)
+            if typed.source_type=='can_blf':
+                for key in ('decode_scope','input_check'):source.setdefault(key,getattr(typed.config,key))
+    from ..planning.signal_groups import declared_signals
+    for signal,typed in zip(declared_signals(raw['signals']),plan.signals):
+        for key in ('scale','offset','sample_policy','same_time_policy'):
+            signal.setdefault(key,getattr(typed.definition,key))
+    for typed,expression in zip(plan.derived,plan.derived_expressions):
+        raw['derived'][typed.definition.name].setdefault('unit',expression.root.unit)
+    by_rule={item.rule_id:item for item in plan.rules}
+    for rule in raw.get('rules',[]):
+        typed=by_rule[rule['name']];kind=typed.rule_type
+        if kind=='condition_duration':rule.setdefault('selection_origin',typed.selection_origin)
+        elif kind in ('debounce','hysteresis'):
+            rule.setdefault('enter_delay',_duration(typed.stability.enter_ns))
+            rule.setdefault('exit_delay',_duration(typed.stability.exit_ns))
+        elif kind=='start_end':
+            rule.setdefault('emit_initial',typed.start_end.emit_initial)
+            rule.setdefault('timeout',None if typed.start_end.timeout_ns is None else _duration(typed.start_end.timeout_ns))
+        else:
+            rule.setdefault('emit_initial',typed.emit_initial)
+            if kind=='window_delta':
+                rule.setdefault('retrigger',typed.retrigger)
+                for key in ('monotonic','coverage_policy'):rule.setdefault(key,getattr(typed.window_delta,key))
+    for window,typed in zip(raw.get('windows',[]),plan.windows):
+        for key in ('pre','post'):window.setdefault(key,_duration(getattr(typed,key+'_ns')))
+        window.setdefault('merge',typed.merge)
+    for calculation,typed in zip(raw.get('calculations',[]),plan.calculations):
+        for key in ('unit','partial_policy','minimum_coverage'):calculation.setdefault(key,getattr(typed,key))
+        if typed.method is not None:calculation.setdefault('method',typed.method)
+    for sequence,typed in zip(raw.get('sequences',[]),plan.sequences):sequence.setdefault('max_pending',typed.max_pending)
+    intervals=raw.setdefault('intervals',{})
+    intervals.setdefault('default',_interval(plan.intervals.default))
+    # 每个消费者的驱动已由静态依赖确定；DBC周期仍须运行时读取，绝不虚构数值。
+    if plan.intervals.resolved:
+        intervals['overrides']={name:_interval(choice) for name,choice in plan.intervals.resolved}
+
+
+def resolved_configuration(source, *, defaults=False):
+    """展开预设并固定路径。参数: 输入配置、是否填默认。返回: 原生配置。异常: 配置/IO错误。
+
+    原配置不写回；省略defaults时保原显式值。公开预设构建器只在独立副本执行。
+    """
+    from ..presets import expand_presets
+    source=Path(source).absolute();document=load_configuration(source)
+    from .imports import expand_document_imports
+    document=expand_document_imports(document)
+    name,plan=validate_document(document,source.parent,return_plan=True);raw=deepcopy(document.data)
+    if name=='batch':
+        if defaults:
+            raw.setdefault('process_count',plan.process_count)
+            for key in ('fail_fast','backend'):raw.setdefault(key,getattr(plan,key))
+    else:
+        from ..planning.config_groups import normalize_configuration
+        analysis=normalize_configuration(raw['analysis'] if name=='mapping' else raw)
+        if name=='mapping':raw['analysis']=analysis
+        else:raw=analysis
+        if analysis.get('presets'):
+            expand_presets(analysis,tuple(item.definition for item in plan.signals))
+        analysis.pop('presets',None)
+        if defaults:_analysis_defaults(analysis,plan)
+    # 默认展开和预设内部片段统一还原成当前公共分组，不输出第二套配置语法。
+    if name!='batch':
+        from ..planning.config_groups import public_configuration
+        if name=='mapping':raw['analysis']=public_configuration(raw['analysis'])
+        else:raw=public_configuration(raw)
+    # 使用词法绝对定位，保留..与符号链接的原路径解释；不stat/open业务文件。
+    for owner,key in path_fields(raw,name):
+        owner[key]=str((source.parent/Path(owner[key])).absolute())
+    # 导出前复核全部有效字段；失败时还没有创建输出文件。
+    validation=deepcopy(raw)
+    if name!='batch':
+        _signal_defaults(validation['analysis'] if name=='mapping' else validation,plan)
+    checked=parse_configuration(serialize_configuration(validation,'json'),format='json',source=str(source))
+    validate_document(checked,source.parent)
+    return raw
+
+
+def resolve_configuration(source, *, output=None, format=None, defaults=False):
+    """显示或导出有效配置。参数: 输入、可选新文件/格式/默认值。返回: 文本或Path。异常: 配置/IO错误。
+
+    无输出文件时默认YAML写给调用者；有文件时扩展名定格式，显式格式不一致则拒绝。
+    """
+    chosen='yaml' if output is None else output_format(Path(output))
+    if format is not None:
+        if output is not None and format!=chosen:raise ValueError('--format与输出扩展名不一致')
+        chosen=format
+    raw=resolved_configuration(source,defaults=defaults)
+    text=serialize_configuration(raw,chosen)
+    return text if output is None else write_new_configuration(output,text)

chronaxis/configuration/template_catalog.py

@@ -0,0 +1,68 @@
+"""读取随包发布的合成场景模板；初始化命令与模板验收使用同一套资源。
+
+目录中保存最小版和完整注释版YAML及小型合成输入。本模块仅提供有限模板清单
+和文件内容，不创建用户目录、不执行分析、不把模板阈值当作真实设备参数。
+"""
+from dataclasses import dataclass
+from importlib.resources import files
+import json
+from pathlib import PurePosixPath
+
+
+@dataclass(frozen=True)
+class ConfigurationTemplate:
+    """可选场景及其入口；名称用于CLI选择，说明同时注明合成数据和预期行为。"""
+    name: str
+    title: str
+    config_type: str
+    entrypoint: str
+    expected: str
+
+
+def _catalog():
+    """读取包内固定清单。参数: 无。返回: dict。异常: 缺失或损坏资源不隐藏。"""
+    root=files('chronaxis.configuration').joinpath('templates')
+    return root,json.loads(root.joinpath('catalog.json').read_text(encoding='utf-8'))
+
+
+def available_templates():
+    """列出当前所有场景。参数: 无。返回: ConfigurationTemplate tuple。异常: 包资源错误。"""
+    _,catalog=_catalog()
+    return tuple(ConfigurationTemplate(item['name'],item['title'],item['config_type'],
+        item['entrypoint'],item['expected']) for item in catalog['templates'])
+
+
+def _relative_path(text):
+    """限制包内及新目录内的相对路径。参数: 文本。返回: PurePosixPath。异常: ValueError。
+
+    清单由项目维护；仍拒绝绝对路径、返回父目录和Windows反斜线，防止资源误配越界。
+    """
+    path=PurePosixPath(text)
+    if not text or not path.parts or '\\' in text or ':' in text or path.is_absolute() or '..' in path.parts:
+        raise ValueError('模板资源必须使用目录内的相对路径')
+    return path
+
+
+def template_files(name,*,style='annotated'):
+    """取得一个场景的完整文件集。参数: 场景名、minimal/annotated。返回: (相对路径,bytes) tuple。
+
+    异常: 未知场景/风格为ValueError，包内文件错误直接传播；不读取用户配置或写文件。
+    两种风格只有注释不同，批量子计划也按同一风格选择。资源不含环境变量或模板执行。
+    """
+    if style not in ('minimal','annotated'):
+        raise ValueError('模板风格需要minimal或annotated')
+    root,catalog=_catalog()
+    match=next((item for item in catalog['templates'] if item['name']==name),None)
+    if match is None:
+        raise ValueError('未知配置场景：'+str(name))
+    entries=[dict(source=name+'/'+style+'.yaml',target=match['entrypoint']),*match['files']]
+    result=[]
+    targets=set()
+    for item in entries:
+        source=_relative_path(item['source'].replace('{style}',style))
+        target=_relative_path(item['target'])
+        if target.as_posix().casefold() in targets:
+            raise ValueError('模板输出路径重复：'+str(target))
+        targets.add(target.as_posix().casefold())
+        result.append((target.as_posix(),root.joinpath(*source.parts).read_bytes()))
+    return tuple(result)

chronaxis/configuration/templates/batch/analysis-annotated.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3               # 配置格式版本，不是业务参数
+dataset:                        # 只保留本次任务名称；省略domain表示读取完整输入
+  name: batch_energy_example    # 为此分析对象取名称，供表达式、规则或结果引用
+sources:                        # 输入报文路径与对应DBC；格式按扩展名识别
+  - path: data/power.asc        # 相对本配置所在目录的输入路径
+    dbc_by_channel:             # 把日志通道对应到实际DBC；不能靠名称猜测
+      '1': data/teaching.dbc
+signals:                        # 只声明本次分析使用的信号
+  - name: power                 # 为此分析对象取名称，供表达式、规则或结果引用
+    field:                      # 按报文ID和DBC信号名定位
+      frame_id: '0x200'         # 0x为十六进制；无前缀为十进制
+      signal: Power             # DBC里的原信号名
+calculations:                   # 需要输出的计算结果
+  - name: energy                # 为此分析对象取名称，供表达式、规则或结果引用
+    operation: integral         # 选择统计或积分方法
+    expr: power                 # 使用分析信号名或白名单表达式

chronaxis/configuration/templates/batch/analysis-minimal.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3
+dataset:
+  name: batch_energy_example
+sources:
+  - path: data/power.asc
+    dbc_by_channel:
+      '1': data/teaching.dbc
+signals:
+  - name: power
+    field:
+      frame_id: '0x200'
+      signal: Power
+calculations:
+  - name: energy
+    operation: integral
+    expr: power

chronaxis/configuration/templates/batch/annotated.yaml

@@ -0,0 +1,6 @@
+%YAML 1.2
+---
+batch_version: 1           # 声明独立批量任务文件的结构版本；当前填写整数1
+jobs:                      # 列出互相独立的分析任务，每项引用一份分析配置
+  - plan: analysis.yaml    # 指定该任务的分析配置文件；相对于批量配置文件所在目录
+  - plan: analysis.yaml    # 指定该任务的分析配置文件；相对于批量配置文件所在目录

chronaxis/configuration/templates/batch/minimal.yaml

@@ -0,0 +1,6 @@
+%YAML 1.2
+---
+batch_version: 1
+jobs:
+  - plan: analysis.yaml
+  - plan: analysis.yaml

chronaxis/configuration/templates/can-asc/annotated.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3             # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                      # 设置本次分析名称及可选的对象、会话和时间范围
+  name: can_asc_example       # 命名本次分析数据集；名称写入结果身份字段
+sources:                      # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - path: data/sample.asc     # 指定单个输入文件；相对路径从本配置文件所在目录计算
+    dbc_by_channel:           # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/sample.dbc    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                      # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - name: voltage             # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    field:                    # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      signal: Voltage         # 填写DBC中的信号名称，大小写须一致
+      frame_id: '0x100'       # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+calculations:                 # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: voltage_area        # 为这项计算结果取唯一名称；结果表用它区分计算项
+    expr: voltage             # 指定参与计算的数值或信号表达式；引用前面已定义的信号
+    operation: integral       # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量

chronaxis/configuration/templates/can-asc/minimal.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3
+dataset:
+  name: can_asc_example
+sources:
+  - path: data/sample.asc
+    dbc_by_channel:
+      '1': data/sample.dbc
+signals:
+  - name: voltage
+    field:
+      signal: Voltage
+      frame_id: '0x100'
+calculations:
+  - name: voltage_area
+    expr: voltage
+    operation: integral

chronaxis/configuration/templates/can-blf/annotated.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3             # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                      # 设置本次分析名称及可选的对象、会话和时间范围
+  name: can_blf_example       # 命名本次分析数据集；名称写入结果身份字段
+sources:                      # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - path: data/sample.blf     # 指定单个输入文件；相对路径从本配置文件所在目录计算
+    dbc_by_channel:           # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/sample.dbc    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                      # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - name: voltage             # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    field:                    # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      signal: Voltage         # 填写DBC中的信号名称，大小写须一致
+      frame_id: '0x100'       # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+calculations:                 # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: voltage_area        # 为这项计算结果取唯一名称；结果表用它区分计算项
+    expr: voltage             # 指定参与计算的数值或信号表达式；引用前面已定义的信号
+    operation: integral       # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量

chronaxis/configuration/templates/can-blf/minimal.yaml

@@ -0,0 +1,18 @@
+%YAML 1.2
+---
+config_version: 3
+dataset:
+  name: can_blf_example
+sources:
+  - path: data/sample.blf
+    dbc_by_channel:
+      '1': data/sample.dbc
+signals:
+  - name: voltage
+    field:
+      signal: Voltage
+      frame_id: '0x100'
+calculations:
+  - name: voltage_area
+    expr: voltage
+    operation: integral

chronaxis/configuration/templates/can-export/annotated.yaml

@@ -0,0 +1,23 @@
+%YAML 1.2
+---
+config_version: 3             # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                      # 设置本次分析名称及可选的对象、会话和时间范围
+  name: can_export_example    # 命名本次分析数据集；名称写入结果身份字段
+sources:                      # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - path: data/sample.asc     # 指定单个输入文件；相对路径从本配置文件所在目录计算
+    dbc_by_channel:           # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/sample.dbc    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                      # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - name: voltage             # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    field:                    # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      signal: Voltage         # 填写DBC中的信号名称，大小写须一致
+      frame_id: '0x100'       # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+calculations:                 # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: voltage_area        # 为这项计算结果取唯一名称；结果表用它区分计算项
+    expr: voltage             # 指定参与计算的数值或信号表达式；引用前面已定义的信号
+    operation: integral       # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量
+outputs:                      # 选择额外导出的数据及格式；默认结果表由运行入口提供
+  can_frames:                 # 配置原始或重建CAN帧的额外导出；与信号CSV分别设置
+    format: asc               # 选择输出报文文件格式；asc为文本，blf为二进制
+metadata:                     # 保存说明性信息；字段不会自动校准数据或更改计算公式
+  device_label: home          # 示例制作于home；实际使用改为本次设备标签（home/work），不会自动识别

chronaxis/configuration/templates/can-export/minimal.yaml

@@ -0,0 +1,23 @@
+%YAML 1.2
+---
+config_version: 3
+dataset:
+  name: can_export_example
+sources:
+  - path: data/sample.asc
+    dbc_by_channel:
+      '1': data/sample.dbc
+signals:
+  - name: voltage
+    field:
+      signal: Voltage
+      frame_id: '0x100'
+calculations:
+  - name: voltage_area
+    expr: voltage
+    operation: integral
+outputs:
+  can_frames:
+    format: asc
+metadata:                       # 当前导出API要求来源标签；普通分析不需要此字段
+  device_label: home            # 示例制作于home；实际使用改为本次设备标签（home/work），不会自动识别

chronaxis/configuration/templates/catalog.json

@@ -0,0 +1,233 @@
+{
+  "device_label": "home",
+  "data_kind": "synthetic",
+  "templates": [
+    {
+      "name": "can-asc",
+      "title": "CAN ASC与DBC",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "原始字节1/3/1经DBC的2x+1得到3/7/3V，各持续1s，积分13V·s；第4帧为无关消息。",
+      "files": [
+        {
+          "source": "shared/sample.asc",
+          "target": "data/sample.asc"
+        },
+        {
+          "source": "shared/sample.dbc",
+          "target": "data/sample.dbc"
+        }
+      ]
+    },
+    {
+      "name": "can-blf",
+      "title": "CAN BLF与DBC",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "原始字节1/3/1经DBC的2x+1得到3/7/3V，各持续1s，积分13V·s；第4帧为无关消息。",
+      "files": [
+        {
+          "source": "shared/sample.blf",
+          "target": "data/sample.blf"
+        },
+        {
+          "source": "shared/sample.dbc",
+          "target": "data/sample.dbc"
+        }
+      ]
+    },
+    {
+      "name": "charge-session",
+      "title": "充电活动：明确角色、单位与方向（ASC与DBC）",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "活动[0s,2s)，400V×10A×2s=8000J，输出8000/3600Wh；10A×2s=20As，输出20/3600Ah。",
+      "files": [
+        {
+          "source": "shared/charge-session.asc",
+          "target": "data/charge-session.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "fault-window",
+      "title": "故障事件与前后窗口（ASC与DBC）",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "2s报警由假变真；向前1s、向后2s，输出片段[1s,4s)。",
+      "files": [
+        {
+          "source": "shared/fault-window.asc",
+          "target": "data/fault-window.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "command-response",
+      "title": "请求响应：匹配与等待到期（ASC与DBC）",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "1s请求在2s响应，延迟1s；4s请求在6s达到2s等待上限，无响应。",
+      "files": [
+        {
+          "source": "shared/command-response.asc",
+          "target": "data/command-response.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "threshold",
+      "title": "阈值预设：进入与恢复门槛（ASC与DBC）",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "85°C在0s进入，77°C保持活动，75°C在9s退出；活动时长9s。80/75°C只是合成例子。",
+      "files": [
+        {
+          "source": "shared/threshold.asc",
+          "target": "data/threshold.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "stability",
+      "title": "迟滞与去抖对照（ASC与DBC）",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "迟滞活动[1s,4s)，均值247/3°C；进入/退出各稳定1s的去抖活动[2s,4s)，均值81°C。",
+      "files": [
+        {
+          "source": "shared/stability.asc",
+          "target": "data/stability.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "can-export",
+      "title": "CAN原帧导出",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "分析积分13V·s；自动观测范围[0s,3s)内的3条原帧按原顺序导出，不重采样。",
+      "files": [
+        {
+          "source": "shared/sample.asc",
+          "target": "data/sample.asc"
+        },
+        {
+          "source": "shared/sample.dbc",
+          "target": "data/sample.dbc"
+        }
+      ]
+    },
+    {
+      "name": "signal-export",
+      "title": "信号导出与独立插值网格",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "分析积分仍为38J。原采样与500ms线性网格分别导出；网格0到5.5s共12点，前3点为2/3/4W。",
+      "files": [
+        {
+          "source": "shared/power.asc",
+          "target": "data/power.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "batch",
+      "title": "两个独立任务的批量清单",
+      "config_type": "batch",
+      "entrypoint": "batch.yaml",
+      "expected": "两个任务各自读取同一合成输入，均完成且各得38J；它们不是同会话时间切片。",
+      "files": [
+        {
+          "source": "batch/analysis-{style}.yaml",
+          "target": "analysis.yaml"
+        },
+        {
+          "source": "shared/power.asc",
+          "target": "data/power.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        }
+      ]
+    },
+    {
+      "name": "ini-mapping",
+      "title": "旧INI导入与唯一信号自动映射",
+      "config_type": "mapping",
+      "entrypoint": "mapping.yaml",
+      "expected": "以sclicer_single导入source.ini，原文保持；Power>3的活动为[1s,6s)，窗口相同；会话积分仍38J。",
+      "files": [
+        {
+          "source": "shared/power.asc",
+          "target": "data/power.asc"
+        },
+        {
+          "source": "shared/teaching.dbc",
+          "target": "data/teaching.dbc"
+        },
+        {
+          "source": "shared/source.ini",
+          "target": "source.ini"
+        }
+      ]
+    },
+    {
+      "name": "raw-can-csv",
+      "title": "原始CAN CSV显式布局",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "原始字节1/3/1经DBC的2x+1得到3/7/3V，各持续1s，积分13V·s；第4帧为无关消息。",
+      "files": [
+        {
+          "source": "shared/sample.csv",
+          "target": "data/sample.csv"
+        },
+        {
+          "source": "shared/sample.dbc",
+          "target": "data/sample.dbc"
+        }
+      ]
+    },
+    {
+      "name": "signal-csv",
+      "title": "信号CSV：积分与两种均值",
+      "config_type": "analysis",
+      "entrypoint": "plan.yaml",
+      "expected": "功率2/4/8/10W分别持续1/2/1/2秒，积分38J；样本均值6W，时间加权均值38/6W。",
+      "files": [
+        {
+          "source": "shared/signals.csv",
+          "target": "data/signals.csv"
+        }
+      ]
+    }
+  ],
+  "updated_at": "2026-10-28T17:13:13+08:00",
+  "change": "ASC/BLF教学模板采用必要配置，DBC提供示例周期。"
+}