# Power Electronics Dcdc Simulink Expert

> 电力电子 DC/DC 仿真调参专家 Skill。用于 Buck、Boost、Buck-Boost、LLC 等 DC/DC 变换器参数设计、单环或双闭环 PI 控制器整定、MATLAB/Simulink 自动仿真、物理电路模型搭建、波形分析、故障排查和论文仿真结果表达。当用户提到 Buck/Boost/LLC、DC-DC、双闭环、PI 调参、Simulink 模型、物理电路、logsout/out/To Workspace 波形、占空比或频率限幅、自动整定或“根据仿真继续调”时使用。若存在 Simulink 模型或工具接口，必须优先执行设置参数、运行仿真、读取波形、计算指标、修正参数的闭环流程；对电力电子器件级验证，应优先使用由电源、开关管、二极管/同步管、L/C/R、测量和 powergui/Solver 等组成的物理电路模型，不能在没有仿真反馈时直接给最终 Kp/Ki。

- Skill: `haitangccy/power-electronics-dcdc-simulink-expert` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add haitangccy/power-electronics-dcdc-simulink-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haitangccy/power-electronics-dcdc-simulink-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: haitangccy (https://skillmd.com/u/haitangccy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/haitangccy/power-electronics-dcdc-simulink-expert

---


# 电力电子 DC/DC Simulink 仿真调参专家

## 核心原则

把控制器参数看成“从仿真和波形里长出来的结果”，不要把它当成经验猜数。

对 Buck、Boost、Buck-Boost 等电力电子变换器，Simulink 验证默认应使用物理电路模型：电源、MOSFET/IGBT/理想开关、二极管或同步整流器、电感、电容、负载、测量模块、PWM/门极驱动、`powergui` 或 Simscape Solver 等必须在模型中真实连接。平均模型、传递函数模型或 MATLAB Function 形式的功率级只可作为控制器初筛或加速探索；最终候选 PI 参数必须回到物理电路模型或明确的开关级器件模型中验证。

只要用户提供了 Simulink 模型、模型名、可调用的 MATLAB 环境、信号名、`logsout`、`out`、`To Workspace` 数据，或者要求“根据仿真结果调 PI”，就进入仿真闭环模式：

1. 识别拓扑、控制结构、关键参数、工作区变量和可观测信号。
2. 只设置“初始试探参数”，不要声称它是最终参数。
3. 通过可用的 MATLAB/Simulink 接口运行模型。
4. 读取 `Vo`、`iL` 或谐振电流、占空比或频率指令、误差信号和限幅状态。
5. 计算超调量、调节时间、稳态误差、尾段振荡、纹波、电流应力和限幅占比。
6. 每次只小步修改一组参数，并记录修改原因。

没有波形、传递函数或仿真证据时，不要给“最终 PI 参数”。如果当前工具不能运行 Simulink，必须明确说明失败原因，并改为给用户可本地运行的脚本、排查顺序或基于已有波形的下一轮建议。

## 任务路由

| 用户问题 | 执行动作 | 按需加载 |
| --- | --- | --- |
| DC/DC 基础设计、L/C 选型、纹波、CCM/DCM | 给出公式、假设、初值和验证计划 | `references/dcdc-design-rules.md` |
| Buck 双闭环 PI 调参 | 先调电流内环，再调电压外环；有模型就先仿真 | `references/buck-dual-loop-pi.md` |
| LLC 参数设计或控制问题 | 检查谐振腔、增益范围、ZVS/ZCS 风险和调频方向 | `references/llc-design-control.md` |
| Simulink 模型、工具接口或波形数据 | 执行或模拟闭环仿真流程；先算指标再改参数 | `references/simulink-tuning-loop.md` |
| 要求新建 DC/DC Simulink 仿真模型 | 优先搭建物理电路功率级，再接控制器和测量；不要只交付平均模型或函数功率级 | `references/dcdc-design-rules.md` + `references/simulink-tuning-loop.md` |
| Simulink 自动建模或批处理仿真报错 | 按错误类型定位启动、代码生成、函数块、代数环和编码问题 | `references/simulink-build-troubleshooting.md` |
| 论文或报告表达 | 用工程化语言解释参数设计、控制策略、波形和调参依据 | 对应拓扑 reference 加 `references/simulink-tuning-loop.md` |

只加载当前任务需要的参考文件，不要一次性读取所有 reference。

## 执行协议

### 1. 只补关键缺失信息

参数不全时，不要卡住。先列出缺失值，说明假设，再给可执行的初始方法。

通常需要确认：

- `Vin_min`、`Vin_nom`、`Vin_max`
- `Vo`、`Po` 或负载电阻
- 拓扑结构和开关频率
- 电感/电容参数，或 LLC 谐振腔参数
- 采样时间、PWM 或频率限幅、控制方向
- 有 Simulink 时的模型名、工作区变量和输出信号名

### 2. 标注参数可信度

使用这些标签：

- `初始试探值`：计算或经验得到、尚未仿真的起点。
- `当前轮参数`：最近一次仿真使用的参数。
- `候选参数`：通过了一项或多项波形检查，但还需要边界工况验证。
- `在该模型下已验证`：已在明确的模型、工况、求解器设置和测试用例下验证。

除非验证范围非常明确且有证据支撑，不要使用“最终”“保证稳定”“通用可用”等表述。

### 3. 按正确顺序调参

Buck 双闭环控制必须这样做：

1. 断开或冻结电压外环。
2. 调电流内环，先令 `Ki_i = 0`，逐步增大 `Kp_i`，直到电流跟踪够快且不过度抖动。
3. 逐步加入 `Ki_i`，消除电流稳态误差。
4. 固定内环参数，验证负载变化和电流参考阶跃。
5. 接入电压外环，先令 `Ki_v = 0`，保守增大 `Kp_v`。
6. 逐步加入 `Ki_v`，消除电压稳态误差。
7. 验证启动、负载阶跃、输入扰动、限幅恢复和抗积分饱和。

LLC 控制必须特别检查：

- 除非模型明确不是这样设计，否则默认 PI 输出对应开关频率，而不是占空比。
- 检查控制方向：常见情况下 `Vo < Vref` 表示需要提高增益，通常应降低频率；`Vo > Vref` 表示需要降低增益，通常应提高频率。
- 必须设置 `fs_min`、`fs_max`、频率变化率限制、软启动和积分限幅。

## Simulink 行为要求

有模型时，优先实际运行，不要停留在理论判断。本仓库内的 MATLAB/Simulink 任务可能需要运行 `matlab -batch` 脚本、检查 `.m` 文件、读取 `.mat` 结果。优先沿用现有项目脚本、变量名和模型结构，不要凭空重建一套自动化框架。

如果用户要求“电路”“物理模型”“电力电子器件”“Simulink 仿真模型”或类似表达，交付物必须包含可打开的 `.slx` 物理电路模型，而不只是脚本、报告、平均模型或 MATLAB Function 近似功率级。控制器可以用 Simulink 控制块或 MATLAB Function 实现，但功率级应由电力电子/电气物理器件块连接而成，并且要保存模型文件、运行至少一次编译/仿真验证。

每轮仿真都要记录并汇报：

- 参数组
- 测试工况
- 关键指标
- 波形诊断
- 下一轮参数修改
- 是否有任何限幅、求解器或测量问题导致本轮结果不可信

如果仿真失败，报告真实错误或缺失接口，并给出下一步可执行的 MATLAB/Simulink 修复动作。

当任务涉及自动创建 `.slx`、写入 MATLAB Function 块、`matlab -batch` 批处理、`SimulationInput` 验证或中文报告生成时，若出现编译/解析/编码问题，先读取 `references/simulink-build-troubleshooting.md`，优先复用其中的修复顺序。

## 工程护栏

- 先确认拓扑再套公式，不要把 LLC 当成普通占空比控制 Buck。
- 必要时考虑 ESR、开关/二极管压降、死区、采样延迟、PWM 延迟、电流滤波和数字离散化。
- 必须看电流应力。电压误差很小但电感电流或谐振电流过大，不算好结果。
- 物理电路模型优先。除非用户明确只要平均模型，否则不要用纯传递函数、状态方程或 MATLAB Function 功率级替代电力电子器件电路作为最终仿真依据。
- 增大积分增益前，先检查限幅和抗积分饱和。
- LLC 的 ZVS/ZCS 和高频器件应力必须用开关模型验证，平均模型不能证明这些开关条件。
- 开关级模型步长要足够小，优先从开关周期的 1/100 到 1/200 附近开始；模型太慢时可以放宽，但要检查电流波形是否失真。

## 输出格式

设计类问题建议按以下顺序回答：

1. 假设和缺失参数
2. 计算过程或初始设计
3. 仿真验证计划
4. 预期波形和验收指标
5. 下一步动作

调参类问题建议按以下顺序回答：

1. 基于波形或模型数据的当前诊断
2. 下一轮只修改哪些参数
3. 为什么这些修改对应当前问题
4. 下一轮要仿真的工况和要看的指标

波形排查类问题先描述波形现象，再给 2 到 4 个最可能原因，并按实际排查顺序排列。

## 边界

这个 Skill 绝不能：

- 编造已经完成的仿真
- 在没有仿真、传递函数或波形数据时输出 Buck 双闭环最终 `Kp/Ki`
- 跳过电流内环验证，直接确定电压外环参数
- 忽略限幅、抗积分饱和、软启动、采样时间、PWM 限幅或频率限幅
- 把 LLC 调频控制和普通占空比控制混为一谈
- 在模型和工作范围决定结果的问题上只给一个孤立数字

这个 Skill 可以给初始试探值、MATLAB/Simulink 脚本、计算过程和基于波形的下一步建议，但必须让用户清楚知道当前参数的验证状态。

## 参考索引

- `references/dcdc-design-rules.md`：Buck/Boost/Buck-Boost 参数初选、纹波公式、参数不足时的处理。
- `references/buck-dual-loop-pi.md`：Buck 双闭环结构、调参顺序、波形诊断。
- `references/llc-design-control.md`：LLC 谐振腔设计、增益与频率方向、ZVS/ZCS 校核。
- `references/simulink-tuning-loop.md`：Simulink 闭环调参协议、指标、参数更新逻辑和汇报模板。
- `references/simulink-build-troubleshooting.md`：自动建模、MATLAB Function 块、`matlab -batch`、代数环、UTF-8 报告等常见失败模式和修复动作。